You need to enable JavaScript to run this app.
实时音视频

实时音视频

请输入
  • 文档首页
    • 实时音视频音视频互动智能体（原实时对话式 AI）进阶功能接入联网问答 Agent
复制全文
我的收藏
进阶功能
接入联网问答 Agent
复制全文
我的收藏
接入联网问答 Agent

接入火山引擎的联网问答 Agent，让 AI 智能体具备实时从互联网检索信息并进行总结回答的能力。例如，查询最新资讯、获取天气信息、询问实时股价等。

关于联网问答 Agent 的更多信息，请参见 联网问答 Agent 服务。

使用限制

  • 该功能仅对以下模型生效：
    • 支持函数调用的火山方舟模型。具体支持的模型，请参见支持模型。

      说明

      • 推荐使用模型 doubao-seed-1.6。不建议使用 doubao-seed-1.6-thinking，该模型会强制开启思考模式且不可关闭，在实时对话式 AI 场景可能造成较高时延，影响用户体验。
    • 第三方大模型/Agent。
  • 仅支持使用火山引擎提供的联网问答 Agent 服务。

计费说明

联网问答 Agent 为付费资源，会根据您的实际使用量进行独立计费。详细计费规则和价格，请参见联网问答 Agent 计费说明。

实现方式

步骤 1：开通联网问答 Agent 服务

  1. 登录联网问答 Agent 控制台。
  2. 选择联网问答Agent，按需创建一个联网问答 Agent 并正式开通，然后记录下 Agent ID。

    注意：参数联网意图建议配置为强制联网，以跳过 LLM 的联网意图判断，确保每个问题都基于最新信息回答。更多配置说明，请参见联网问答Agent操作指南。

  3. 选择系统管理 > API Key 管理，创建一个 API Key，并记录下 API Key 值。

步骤 2：配置 StartVoiceChat 接口

你无需自己实现联网工具的逻辑（如发起网络请求、解析网页等），只需要在调用 StartVoiceChat 时，通过 FunctionName 和 FunctionDescription 来声明和定义联网工具，系统会自动根据 FunctionName 和 FunctionDescription 定义函数，并智能地决定何时调用这个“内置”的联网工具。

调用 StartVoiceChat 接口时，配置 Config.WebSearchAgentConfig 对象：

完整参数参见对应接口文档：音视频互动智能体- StartVoiceChat（2025-06-01）、实时对话式 AI-StartVoiceChat（2024-12-01）。

字段

说明

Enable

必填，设置为 true。

APIKey

必填，填入在步骤 1 获取的 API Key 值。

ParamsString

必填，填入联网问答 Agent 服务参数内容（JSON 字符串）。格式和内容要求，请参见 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 文档 的请求参数 ChatCompletionRequest，构建 JSON 字符串。

    • bot_id：必填。对应在步骤 1 获取的 Agent ID 值。

    • stream 必填，且必须设置为 true。

    • 其他参数（如 messages、knowledge等）：根据实际需求进行配置。
      构建示例如下：

    • 最简配置（仅包含必填项）：

      {
   "bot_id": "7429...747",
   "stream": true
}

    • 高级配置（包含上下文）

      {
   "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}。

配置示例

"WebSearchAgentConfig": {
  "Enable": true,
  "ParamsString": "{\"bot_id\":\"7429...747\",\"stream\":true}",
  "APIKey": "your_agent_api_key",
  "FunctionName": "webSearch",
  "FunctionDescription": "用于查询具有时效性的信息，比如今天的天气、最新的新闻事件等。",
  "ComfortWords": "正在帮您上网查一下，请稍等片刻。"
}

其他联网方式

除了接入联网问答 Agent 以外，还可以通过 MCP 或 Function calling 方式实现联网搜索：

联网问答 Agent、MCP 和 Function calling 三者的区别，请参见如何实现联网能力？。

最近更新时间：2025.12.26 00:14:43
这个页面对您有帮助吗？
有用
有用
无用
无用