首页 > 教程攻略 > ai资讯 >火山引擎联网问答browsing_mode参数设置方法

火山引擎联网问答browsing_mode参数设置方法

来源:互联网 时间:2026-08-26 20:55:26

必须显式配置browsing_mode参数才能启用实时网络检索,仅Responses API支持该参数,取值为always或on_demand,小写且不可拼错。

火山引擎联网问答browsing_mode参数设置方法

要在火山引擎的联网问答功能中正确启用实时网络检索,必须显式配置

browsing_mode

参数,否则大模型将仅依赖本地知识库作答,无法获取最新网页信息。

确认当前接入方式是否支持 browsing_mode

这个参数只有在通过Responses API接入Web Search插件时才会起作用,对于控制台可视化对话界面的简易开启模式是不适用的。要是你正在使用「深度研究Agent」或者「大模型服务平台」的低代码配置页,那就不需要手动设置这个参数了,因为系统已经把它封装成了「总是开启/按需开启」的开关。

只有调用 Responses API 时才需在请求体中显式传入 browsing_mode 字段。

API 请求中设置 browsing_mode 的两种取值

方法一:设为

always

在 API 请求 JSON body 中添加 "browsing_mode": "always"。此模式下每次请求都会触发联网搜索,适合竞品监控、新闻追踪等强时效性场景。注意:会显著增加响应延迟与 token 消耗。

方法二:设为

on_demand

设置 "browsing_mode": "on_demand"。此时由大模型自主判断用户问题是否含时效性意图(如“最近”“最新”“今天”“2026年”等关键词),仅当判定必要时才发起搜索。这是默认推荐模式,能平衡效果与成本。

【browsing_mode 字段必须为小写字符串,且值只能是 always 或 on_demand,其他任何拼写(如 Always、ON_DEMAND、auto)均会导致参数被忽略】

完整请求示例(含 browsing_mode)

第一步:构造基础请求体

第二步:在 functions 数组中声明 webSearch 函数,并确保其 FunctionName 为

webSearch

第三步:在顶层参数中加入 "browsing_mode": "on_demand",位置需与 messages、functions 同级

第四步:发送 POST 请求至 Responses API 端点(如 /v1/responses

第五步:收到响应后检查 response.choices[0].message.content 是否包含来自网页的新鲜信息,而非仅基于训练数据的泛化回答