内置搜索与 MCP 替代

核对自动注册、DashScope 凭据、超时、调用预算与旧配置迁移。

This page has not been translated into English yet. The original Chinese version is shown below.

当前内置 web_search 使用 DashScope Responses 的服务端 web_search 和 web_extractor，由辅助模型汇总结果及来源。它与早期已移除的多提供商同名工具是不同实现。

什么时候自动出现

主模型配置	默认注册
ModelStudio Standard API Key 或 Token Plan	可自动注册
已识别 DashScope Responses host 的 OpenAI 兼容配置，具备直接 key	可自动注册
Coding Plan	不自动注册，端点未验证支持该搜索接口
其他提供商、自定义未知 host、本地模型	不自动注册

搜索由相应 DashScope key 计费，不是主模型对话中的免费能力。权限按模式和规则处理，default 首次会请求确认；auto 可由分类器判断。bare 和 safe mode 始终关闭搜索。

关闭可用 tools.webSearch.enabled:false 或 ENABLE_WEB_SEARCH=false。自动路径条件不满足时静默不注册；显式启用却配置错误会给启动提示。

显式选择后端

主模型不使用 DashScope 时，可另设受支持的 modelProviders 条目，再将 tools.webSearch.model 指向其 modelId 或 authType:modelId。条目需通过 envKey 提供直接凭据；Qwen OAuth 不能作为搜索后端。

也可只用环境：

export ENABLE_WEB_SEARCH=true
export WEB_SEARCH_MODEL=qwen3.8-flash
export WEB_SEARCH_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1

还需在环境中提供 WEB_SEARCH_API_KEY，或回退 DASHSCOPE_API_KEY；不把真实 key 写进示例。上述模型来自官方当前示例与自动路径默认，是否仍由端点提供以实际服务为准。

WEB_SEARCH_BASE_URL 优先于目录解析，此时 WEB_SEARCH_MODEL 是该端点的纯模型 ID。只有设置 enabled:true 而同时给出环境专用后端却没有 model，不会自动补成完整配置。

超时和额度

设置	环境覆盖	默认与上限
tools.webSearch.webExtractor	WEB_SEARCH_EXTRACTOR	true；打开搜索结果页，另有服务端计费
tools.webSearch.timeoutMs	WEB_SEARCH_TIMEOUT_MS	120000ms，最大 600000；无效值回默认
tools.webSearch.maxPerSession	WEB_SEARCH_MAX_PER_SESSION	200，最大 10000；无效值回默认

至少一次搜索调用完成后超时，可返回部分结果；首次搜索未完成就超时会报错，不能把未执行搜索的叙述当证据。若搜索完成但没有最终叙述，最多保留六千字符原始页文本并标注。

QWEN_CODE_TOOL_EXECUTION_TIMEOUT_MS 若比搜索预算更小会先触发并丢掉部分结果，因此需要与搜索预算协调。会话额度与 subagents 共享，失败但已发送请求也计一次；按工具调用次数计，不是一次工具内部检索次数。/clear、/resume 或分支等会话变化重置额度。

切换模型和旧配置

是否注册在启动时决定。已注册后，自动后端随当前模型在下一次搜索解析；切到不支持的服务会失败。启动时没有该工具，再切到支持的配置仍需重启注册。显式模型和环境后端按各自配置解析。

旧根级 webSearch.provider、advanced.tavilyApiKey 和旧搜索 CLI flags 不适用于新版。DashScope 使用 tools.webSearch；Tavily、GLM、Firecrawl 等可通过 MCP 接入，按相应服务当前文档核对套餐和额度，不沿用 Qwen 旧页的历史数字。

例如官方列出的 Bailian HTTP MCP 配置：

{
  "mcpServers": {
    "WebSearch": {
      "httpUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
      "headers": {"Authorization": "Bearer ${DASHSCOPE_API_KEY}"}
    }
  }
}

MCP 请求和结果由对应服务处理，其来源与费用不等同内置 Responses 搜索。连接方式与过滤见MCP 配置。