火山引擎联网问答业务对接完整配置流程

需开通火山引擎联网问答Agent Pro版，勾选“启用联网搜索”，复制19位BotId填入配置JSON的ParamsString中，并用API Key或Access Key鉴权后调用chat接口验证实时信息返回。

你需要为业务系统接入火山引擎联网问答能力，让智能体在对话中自动调用实时网络信息，解决大模型知识滞后、政策更新慢、赛事结果查不到等实际问题。

开通联网问答Agent Pro版

登录火山引擎控制台 → 进入「智能体中心」→ 在「我的智能体」列表中点击右上角「创建智能体」→ 选择「联网问答Agent Pro版」模板 → 填写智能体名称（如“客服答疑Pro”）并完成基础配置。

注意：免费试用额度仅对Pro版开放，基础版不支持联网搜索功能；【必须勾选“启用联网搜索”开关，否则后续所有配置均无效】。

创建成功后，页面跳转至智能体详情页，复制顶部显示的BotId（一串19位数字字符串），该ID将用于API请求和插件配置。

配置API Key与鉴权方式

方法一：API Key接入（推荐测试阶段使用）

进入「API管理」→ 「创建API Key」→ 选择服务为「ask_echo」→ 点击「生成」→ 复制生成的密钥字符串（Bearer后那一长串字符）。

方法二：Access Key接入（生产环境强制要求）

进入「访问控制（IAM）」→ 「用户管理」→ 创建子用户并授予「VolcEngineFullAccess」策略 → 返回「API管理」→ 切换至「Access Key」标签页 → 为该子用户创建AK/SK对 → 下载保存SK文件（仅此一次可见，丢失需重新生成）。

提示：Access Key方式需在请求Header中携带X-Date、Authorization等签名字段，建议直接使用火山引擎最新SDK生成签名，手写极易因时间戳偏差或编码错误导致403。

设置联网搜索触发逻辑

第一步：进入智能体编辑页 → 左侧菜单选择「能力配置」→ 点击「联网搜索」模块。

第二步：选择触发模式：

• 总是开启：每次用户提问都执行联网，适合新闻播报类场景；

• 按需开启：由模型自动判断是否需要联网（默认），适用于通用客服场景。

第三步：填写核心参数JSON（粘贴到「自定义函数配置」文本框）：

{

"Config": {

"FunctionDescription": "查询时效性信息，如最新政策、赛事比分、股票行情等",

"ComfortWords": "正在为您实时查询最新信息，请稍候",

"FunctionName": "webSearch",

"DisableImageSearch": false,

"ParamsString": "{"bot_id":"【此处替换为你的BotId】","stream":true}"

}

}

这一步必须把前面复制的BotId填进ParamsString里，漏填或格式错误会导致联网搜索完全不触发；【ParamsString中的bot_id值必须用英文双引号包裹，且不能有多余空格或换行】。

调用智能体会话API验证效果

使用Postman或curl发送POST请求：

URL：https://open.feedcoopapi.com/agent_api/chat

Header：Authorization: Bearer + Content-Type: application/json

Body：{ "BotId": "7429717161499017747", "Messages": [{"Role": "user", "Content": "今天A股创业板指收盘涨了多少？"}] }

收到响应后检查Result.Message.Content中是否含实时数据（如“截至今日15:00，创业板指报1682.34点，上涨1.27%”），若返回“暂无相关信息”或内容明显过时，说明BotId未填对或联网搜索未真正启用。

这一步操作起来很简单，直接把上面JSON发出去就行，但要注意Body里的BotId必须和你在控制台看到的一模一样，一个数字都不能错。