search_type 参数必须正确配置，合法取值仅支持 text、multimodal、auto 三种：text 表示强制执行纯文本搜索；multimodal 需要携带 image 或 video_frame 且账号已开通相关权限；auto 则由服务端自动选择合适的检索路径。

在火山引擎联网问答场景中，如需精准控制搜索策略，必须正确设置 search_type 参数。若配置错误，大模型可能会调用不匹配的检索通道，从而造成结果缺少图片信息、无法识别视频帧，或遗漏部分结构化数据。

明确 search_type 的可选值及适用场景

search_type 是联网搜索请求体中的核心字段，用于决定底层采用纯文本检索、多模态检索，还是自动路由的混合策略。它本身不参与自然语言理解，但会直接影响请求的执行路径和搜索结果类型。

当前仅支持三个合法取值：【text】、【multimodal】、【auto】。如果传入其他字符串，例如 "image"、"video"、"hybrid"，系统会直接返回 400 错误，请求也会被中断。

text：强制走纯文本搜索通道，忽略所有图片和视频输入，适用于明确只处理天气、新闻、政策解读等纯文字问答的业务场景。

multimodal：强制启用多模态理解能力，要求请求中必须包含 base64 编码的 image 字段或 video_frame 字段，否则会返回 400 错误；如果 VisionConfig.Enable 未开启，该取值通常会被自动降级为 text。

在 Responses API 中配置 search_type

调用火山引擎 Responses API 时，search_type 必须写在 ParamsString 内部 JSON 的顶层字段中，不能放在 Config 或其他子对象内，否则可能导致参数不生效。

第一步：先确认当前使用的 bot_id 已在控制台开通 multimodal 权限。若未开通，即使传入 multimodal，服务端也会拦截请求，并返回 403 错误码。

第二步：构造 ParamsString，示例如下：

{"bot_id":"your_bot_id","stream":true,"search_type":"multimodal"}

注意：search_type 的值必须为小写字符串，且前后不能带空格。比如大写形式 "Multimodal" 或额外包裹引号的 '"multimodal"' 都可能导致参数解析失败。

第三步：将上述 ParamsString 进行 URL 编码后，填入 Responses API 请求体中的 params_string 字段，然后再发起 POST 请求。

按业务类型选择 search_type 的方法

方法一：纯时效性问答场景（如查询股价、赛事比分、最新政策信息）→ 固定设置为 【text】

方法二：AI 视频陪看或图片识别场景（如用户上传剧照询问“这个演员是谁”或“她最近演了什么剧”）→ 必须设置为 【multimodal】，并确保请求中包含 image 字段

方法三：通用对话 Agent 场景（无法提前判断用户是否会上传图片）→ 设置为 【auto】，由服务端根据输入内容自动路由：有图走 multimodal，无图走 text