通过接入火山引擎的联网问答 Agent，可以让 AI 智能体具备实时从互联网检索信息并进行总结回答的能力。例如，查询最新资讯、获取天气信息、询问实时股价等。关于联网问答 Agent 的更多信息，请参见[联网问答 Agent 服务](https://docs.volcengine.com/docs/85508/1510774)。 ## 使用限制 * 仅支持使用火山引擎提供的联网问答 Agent 服务。 * 使用的模型必须为火山方舟模型或第三方大模型，且需具备 Function Calling 能力。 ## 实现方式 ### 步骤 1：开通联网问答 Agent 服务 1. 登录[联网问答 Agent 控制台](https://console.volcengine.com/ask-echo)。 2. 选择**联网问答Agent**，按需创建一个联网问答 Agent 并正式开通，然后记录下 Agent ID。

说明

建议将联网意图配置为强制联网，以跳过 LLM 的联网意图判断，确保每个问题都基于最新信息回答。

更多配置说明，请参见[联网问答 Agent 操作指南](https://docs.volcengine.com/docs/85508/1512748)。 3. 创建一个 API Key，并记录下 API Key 值。具体操作，请参见[智能体API认证方式](https://docs.volcengine.com/docs/85508/2628937?lang=zh#j8aiWtvI)。 ### 步骤 2：配置 AibotCreate 接口您只需要在调用 `AibotCreate` 时，通过 FunctionName 和 FunctionDescription 来声明和定义联网工具，系统会自动根据 FunctionName 和 FunctionDescription 定义函数，并智能地决定何时调用这个“内置”的联网工具。调用 [AibotCreate](https://docs.volcengine.com/docs/6348/1807449) 接口时，在 `Config` 对象中配置 `WebSearchAgentConfig` 参数。参数说明如下： |字段 |说明 | |---|---| |`Enable` |必填，设置为 true。 | |`APIKey` |必填，填入在[步骤 1](https://docs.volcengine.com/docs/6348/1969946#step1) 获取的 API Key 值。 | |`ParamsString` |必填，填入联网问答 Agent 服务参数内容（JSON 字符串）。格式和内容要求，请参见 [ParamsString 说明](https://docs.volcengine.com/docs/6348/1969946#paramsstring)。 | |`FunctionName` |工具调用名称（例如 `webSearch`），用于在内部标识此联网工具。

注意

不能与 Function calling 中的（LLMConfig.Tools）定义的工具重名。

| |`FunctionDescription` |必填，用自然语言描述您希望 AI 在什么情况下联网。它会作为 Prompt 的一部分，帮助 LLM 更精准地判断是否需要触发联网搜索。

说明

为避免逻辑混乱，联网 Agent 的用途建议不要与 Function Calling 相同。

| |`ComfortWords` |可选。安抚语。当智能体触发联网搜索时，会先通过 TTS 播报这段安抚语，提高用户在等待搜索结果时的体验。如果留空，则不播报。

说明

安抚语结尾需要带标点符号。

| #### ParamsString 说明 `ParamsString` 参数是一个经过压缩和转义的 JSON 字符串，用于向联网 Agent 服务传递基础配置和可选的附加上下文。它本质上是联网 Agent 服务 API 请求体 `ChatCompletionRequest` 经压缩并转义后的 JSON 字符串。配置 `ParamsString` 参数前需先进行以下操作： 1. 参考 [联网问答 Agent API 文档](https://docs.volcengine.com/docs/85508/1510834) 的请求参数 `ChatCompletionRequest`，构建 JSON 字符串。 * `bot_id`：必填。对应在[步骤 1](https://docs.volcengine.com/docs/6348/1969946#step1) 获取的 Agent ID 值。 * `stream` 必填，且必须设置为 `true`。 * 其他参数（如 `messages`、`knowledge`等）：根据实际需求进行配置。比如为 Agent 的回答单独提供上下文（传入 messages），或单独提供用户的即时状态（传入 knowledge）时，增加这些字段会让回复更智能。示例： * 最简配置（仅包含必填项）： ```JSON { "bot_id": "7429...747", "stream": true } ``` * 高级配置（包含上下文） ```JSON { "bot_id": "7429...747", "stream": true, "user_id": "user_123", "messages": [ { "role": "user", "content": "想去西安玩几天，有什么推荐的。" }, { "role": "assistant", "content": "好的，西安是历史名城，有兵马俑、大雁塔等著名景点。您计划什么时候去呢？" } ], "knowledge": "当前用户正在规划去西安的旅行" } ``` 2. 压缩并转义 JSON 字符串，得到 `ParamsString` 的值。将构建的 JSON 对象进行压缩（移除空格和换行）和转义（如将 `"` 替换为 `\`"）。您可以使用在线工具（如 BeJSON）或代码来完成。例如，`{\"bot_id\":\"7429...747\",\"stream\":true}`。 ## 配置示例 ```JSON "Config": { "WebSearchAgentConfig": { "Enable": true, "ParamsString": "{\"bot_id\":\"7429...747\",\"stream\":true}", "APIKey": "your_agent_api_key", "FunctionName": "webSearch", "FunctionDescription": "用于查询具有时效性的信息，比如今天的天气、最新的新闻事件等。", "ComfortWords": "正在帮您上网查一下，请稍等片刻。" }, // ... 其他 Config 配置 ... } ```

实时音视频