Skip to Content
开发者指南工具网页搜索

网络搜索

Qwen Code 提供两种网络搜索方式：

  1. 内置 web_search 工具（需手动启用）—— 由 DashScope Responses API 的服务端搜索提供支持。使用标准的百炼（DashScope）API key 即可工作；无需额外的 provider 或 MCP 设置。
  2. MCP（模型上下文协议）集成 —— 连接任何外部搜索服务（Tavily、GLM 等）。当你没有 DashScope key 时使用此方式。

内置 web_search（需手动启用）

内置工具会向一个小型辅助模型发出独立的搜索请求，该模型使用 DashScope 的服务端 web_search（和 web_extractor）工具，并返回带来源 URL 的叙述性搜索结果。它永远不会隐式激活——需要两个设置：

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "envKey": "DASHSCOPE_API_KEY",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }
    ]
  },
  "tools": {
    "webSearch": {
      "enabled": true,
      "model": "qwen3.6-plus"
    }
  }
}
设置环境变量覆盖含义
tools.webSearch.enabledENABLE_WEB_SEARCH启用标志。必填。
tools.webSearch.modelWEB_SEARCH_MODEL搜索模型选择器，像 fastModel 一样通过 modelProviders 解析（modelId 或 authType:modelId）。必填——无默认值。推荐：qwen3.6-plus。
tools.webSearch.webExtractorWEB_SEARCH_EXTRACTOR允许搜索代理打开结果页面以获得更有依据的回答（默认 true；由 DashScope 单独计费）。

仅环境变量配置（无需 settings.json）

对于无法写入设置文件的环境（受限容器、仅支持环境变量注入的 CI），该工具可以完全通过环境变量配置——无需 modelProviders 条目：

export ENABLE_WEB_SEARCH=true
export WEB_SEARCH_MODEL=qwen3.6-plus
export WEB_SEARCH_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
export DASHSCOPE_API_KEY=sk-...        # 或者设置 WEB_SEARCH_API_KEY

WEB_SEARCH_BASE_URL 对应 modelProviders 条目的 baseUrl，必须是一个 DashScope 兼容的端点；当设置此变量时，它会优先于 modelProviders 解析，并且 WEB_SEARCH_MODEL 会被用作纯 DashScope 模型 id。API key 优先从 WEB_SEARCH_API_KEY 读取，否则从 DASHSCOPE_API_KEY 读取。配置错误仍会以启动通知的形式呈现。

注意事项：

  • 选择器必须解析到一个通过 envKey 携带直接 API key 的 DashScope 兼容 modelProviders 条目。你的主模型可以是任何 provider——只有搜索侧请求需要 DashScope 条目。Qwen OAuth 无法支持此工具。
  • 如果启用但配置错误，工具将保持关闭状态，启动通知会说明哪个条件失败。
  • 搜索会计入你的 DashScope key 费用（usage.x_tools 计数）。该工具默认要求确认；使用”始终允许”批准会持久化一个标准的 WebSearch 权限规则，与其他工具一样。
  • 没有客户端模型白名单；Responses 端点不支持的模型会在首次使用时明确报错。

MCP 替代方案

如果你没有 DashScope key，可以通过连接外部 MCP 服务器来使用网络搜索——参见以下服务。

⚠️ 历史重大变更：原始内置 web_search 已移除

受影响版本： V0.0.7+ 至最后一个包含原始多 provider 内置网络搜索的版本。

原始内置 web_search 工具（Tavily/Google/GLM/DashScope 多 provider）及其配置已被移除。上述新的需手动启用的内置工具是不同的实现，具有不同的配置。如果你曾使用以下任何内容，请迁移到新的内置工具（DashScope）或 MCP：

已移除操作指南
settings.json 中的 webSearch 块改为在 mcpServers 中配置 MCP 服务器（见下文）
settings.json 中的 advanced.tavilyApiKey使用 Tavily MCP 服务器
环境变量 TAVILY_API_KEY使用 Tavily MCP 服务器
用于网络搜索的 DASHSCOPE_API_KEY使用内置 web_search 工具
用于网络搜索的 GLM_API_KEY使用 GLM WebSearch Prime MCP
CLI 标志 --tavily-api-key / --glm-api-key / --dashscope-api-key通过 settings.json 中的 mcpServers 配置

迁移示例

之前（通过内置工具使用 Tavily）：

{
  "webSearch": {
    "provider": [{ "type": "tavily", "apiKey": "tvly-xxx" }],
    "default": "tavily"
  }
}

之后（通过 MCP 使用 Tavily）：

{
  "mcpServers": {
    "tavily": {
      "httpUrl": "https://mcp.tavily.com/mcp/?tavilyApiKey=tvly-xxx"
    }
  }
}

之前（通过内置工具使用 DashScope）：

{
  "webSearch": {
    "provider": [{ "type": "dashscope", "apiKey": "sk-xxx" }],
    "default": "dashscope"
  }
}

之后（通过 MCP 使用阿里云百炼 WebSearch）：

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

支持的 MCP 网络搜索服务

阿里云百炼 WebSearch

阿里云百炼平台提供的官方网络搜索 MCP 服务，基于 DashScope。如果你有 DashScope key，建议优先使用上方的内置 web_search 工具——它比此 MCP 服务使用更强的搜索路径。

设置

方法 1：CLI 命令

qwen mcp add WebSearch \
  -t http \
  "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp" \
  -H "Authorization: Bearer ${DASHSCOPE_API_KEY}"

方法 2：settings.json

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

将 ${DASHSCOPE_API_KEY} 替换为你的实际 API Key，或者将其设置为环境变量，Qwen Code 会自动读取。

Tavily WebSearch

一个生产级 MCP 服务器，提供实时网络搜索、内容提取、网站地图和爬取功能。

可用工具

  • tavily_search — 实时网络搜索
  • tavily_extract — 从网页中智能提取数据
  • tavily_map — 创建网站的结构化地图
  • tavily_crawl — 系统化地探索网站

设置

方法 1：CLI 命令（远程 MCP）

qwen mcp add tavily \
  -t http \
  "https://mcp.tavily.com/mcp/?tavilyApiKey=${TAVILY_API_KEY}"

方法 2：settings.json（远程 MCP）

{
  "mcpServers": {
    "tavily": {
      "httpUrl": "https://mcp.tavily.com/mcp/?tavilyApiKey=${TAVILY_API_KEY}"
    }
  }
}

将 ${TAVILY_API_KEY} 替换为你的实际 API Key，或者将其设置为环境变量。

方法 3：settings.json（本地 NPX）

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here"
      }
    }
  }
}

GLM WebSearch Prime（智谱AI）

智谱AI 提供的官方网络搜索远程 MCP 服务，专为 GLM 编程计划用户设计。提供实时网络搜索，包括新闻、股票价格、天气等。

可用工具

  • webSearchPrime — 网络搜索，返回页面标题、URL、摘要、站点名称和图标

设置

方法 1：CLI 命令

qwen mcp add web-search-prime \
  -t http \
  "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp" \
  -H "Authorization: Bearer ${GLM_API_KEY}"

方法 2：settings.json

{
  "mcpServers": {
    "web-search-prime": {
      "httpUrl": "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp",
      "headers": {
        "Authorization": "Bearer ${GLM_API_KEY}"
      }
    }
  }
}

将 ${GLM_API_KEY} 替换为你的实际智谱AI API Key，或者将其设置为环境变量。

Last updated on
网页获取记忆