Web Search

这是什么

WebSearch 是一个内置工具（用户可见名为 Web Search）， 由模型自动调用，不是需要用户敲的命令。当会话需要知识截止日期之后的信息时， 模型会自行发起一次搜索，把关键词交给工具，再把结果整合进回答。

工具的输入只有搜索词与可选的域名过滤；真正的「去哪儿搜、怎么搜」由一个适配器层决定。 工厂函数 createAdapter() 从五种后端中选出一个实现统一接口 WebSearchAdapter 的适配器，对上层完全透明：

该工具始终启用，没有 feature flag 门控；标记为只读（isReadOnly）且可并发 （isConcurrencySafe）。它在延迟工具列表里（shouldDefer）， 需要时由模型按语义检索后加载。

前置条件

• 默认后端无需额外准备。 Tavily 适配器直接使用项目默认端点 https://tavily.qianshou-dashi.win/search，不需要任何 API key。
• 只有 Brave 后端强制要求密钥。 未提供时会抛出 BraveSearchAdapter requires BRAVE_SEARCH_API_KEY or BRAVE_API_KEY。
• api 后端依赖当前 Anthropic API 凭证与官方端点，用于服务端搜索；第三方代理端点下 该后端可能不可用，此时应改用其他后端。
• 网络出口需能访问所选后端的主机（tavily.qianshou-dashi.win、 www.bing.com、api.search.brave.com、mcp.exa.ai）。

启用与选择后端

工具本身开箱即用，通常无需任何操作 —— 模型会在需要时自动调用。若想更换搜索后端， 用 /web-tools 面板或环境变量即可。

1. 确认模型可自动调用

   无需配置。WebSearch 随内置工具集加载，模型在需要最新信息时会自行发起搜索。 你可直接在提问里要求「联网查一下」来引导。

2. 用 /web-tools 选择搜索后端

   在会话里执行 /web-tools，切到 Search 标签页，用方向键选择后按空格选定。 面板可配置 Tavily / Brave / Exa，Bing 与 Anthropic API 无需额外配置。

   qsdashi 会话 复制

   # 打开 Web Tools 面板（Search / Fetch 两个标签页）
   /web-tools
   # ↑↓ 导航 · Space 选定 · Enter 进入配置 · Esc 关闭

3. （可选）用环境变量强制指定后端

   WEB_SEARCH_ADAPTER 优先级最高，覆盖设置面板的选择。取值 api / bing / brave / exa / tavily。

   Terminal 复制

   # 临时强制使用 Bing 后端启动
   WEB_SEARCH_ADAPTER=bing qsdashi

4. （仅 Brave）提供 API key

   在 /web-tools 的 Brave 配置项填入，或设置环境变量 BRAVE_SEARCH_API_KEY / BRAVE_API_KEY（设置面板的值优先于环境变量）。

配置

后端选择与端点 / 密钥写入用户级 settings.json，跨会话生效。优先级为： WEB_SEARCH_ADAPTER 环境变量 > webSearchAdapter 设置 > 默认 tavily。

相关环境变量：

常用命令与参数

WebSearch 由模型调用，没有对应的斜杠命令；与之相关的是用于配置后端的 /web-tools。

工具输入参数（模型自动填充）：

实战示例

让模型联网检索（无需命令，正常提问即可）：

# 直接提问即可触发 WebSearch，模型会展示「Searching for ...」进度
<用户> 帮我查一下 React 19 的最新稳定版本，并给出来源

# 工具返回的是 markdown 链接列表，模型会在回答末尾附上 Sources 小节

切换到 Bing 后端（走本地 HTML 解析，不依赖 API key）：

# 显式指定 Bing，适合第三方代理端点无法用 api 后端的场景
WEB_SEARCH_ADAPTER=bing qsdashi

使用 Exa 后端并自定义端点：

{
  "webSearchAdapter": "exa",
  "exaEndpointUrl": "https://mcp.exa.ai/mcp",
  "exaApiKey": "exa-..."
}

常见问题排错