必须将query作为一级纯字符串键传入/v1/responses post请求体，配全authorization和content-type请求头，否则无法触发联网搜索。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎的联网问答接口中正确传递查询参数，必须确保query字段被识别为用户原始提问语义，而非预设模板或结构化键值对。这一步出错会导致大模型跳过联网搜索，仅依赖本地缓存作答。
确认API调用路径与基础结构
使用火山引擎Responses API发起联网问答请求时，必须调用/v1/responses端点，且HTTP方法为POST。GET方式不支持携带复杂body，无法传入query参数。
请求头中必须包含Authorization: Bearer {your_api_key}和Content-Type: application/json，缺一不可，否则返回401或415错误。
构造合法的JSON body并设置query字段
在请求体（body）中，query必须作为一级键存在，值为纯字符串，不能嵌套在message、input或text等二级字段下。
正确示例：
{"query": "2026年巴黎奥运会中国代表团首金获得者是谁？", "bot_id": "bot-xxx", "stream": false}
【query字段不可为空字符串或仅含空格】，否则触发降级逻辑，自动关闭联网搜索。实测发现当query=" "（全角空格）或query=""时，响应中search_result字段为空数组，且response文本明显缺乏时效信息。
避免query被污染的三种常见错误
方法一：勿将用户问题拼接进system prompt
错误做法是把query塞进system字段里，例如{"system": "请回答以下问题：今天天气如何？", "bot_id": "..."}——此时模型视其为指令而非待检索问题，不会触发webSearch函数。
方法二：不要用URL编码包裹query值
虽然API支持UTF-8，但手动对中文query做encodeURIComponent（如%e4%bb%8a%e5%a4%a9）反而导致解析失败。实测显示，直接传原始中文字符串即可，火山引擎后端已自动处理编码。
方法三：禁止在query中混入调试标记或换行符
例如query: "DEBUG:演员张译最新电影？\n（2026年7月）"——换行符\n会被部分SDK截断，导致query实际只传了前半句；括号内时间标注也会干扰大模型对时效性需求的判断，降低按需开启模式下的触发概率。
验证query是否生效的即时判断法
第一步：发送请求后，检查返回JSON中的search_result字段是否为非空数组。若为空，则query未被识别或未触发搜索。
第二步：查看返回中的response字段是否包含类似“根据最新公开信息”“截至2026年8月”等时效锚点表述。没有这类措辞，基本可判定联网未执行。
第三步：比对log_id字段，复制该ID到火山方舟控制台→「调用日志」页筛选，查看详细trace。在function_call节点下确认是否出现webSearch调用记录及对应参数快照。
