网络搜索:来自您信任网站的答案
网络搜索工具让 Claude 在处理您的请求时搜索网络。动态过滤只保留搜索结果中相关的部分,因此在搜索密集型请求中您使用的令牌更少。Meridian 是一家虚构的工程咨询公司,它在提案中引用工程标准。
本视频中的演示录制于 2026 年 9 月。它运行在 Claude Sonnet 5(claude-sonnet-5)上。在更新的模型上结果可能有所不同。
Claude 根据其训练中学到的内容来回答,因此它不知道比这更新的任何内容,也不知道从未出现在其中的任何内容。当一个问题需要这些事实时,就必须有人去查找,而这项苦差事就落在了您身上。
借助网络搜索工具,Claude 自己完成这项苦差事,在处理您的请求时搜索网络,并根据找到的内容作答。
Meridian 的一份提案按条款引用了四项加拿大工程标准,如果任何引用有误,Meridian 都要承担专业责任。因此,在提案发出之前,Meridian 希望对照官方来源核实每一条引用。
将工具添加到您的请求中
网络搜索是一个服务器工具。它运行在 Anthropic 的基础设施上,因此您无需为它编写处理程序,也无需回传 tool_result。
添加它只需要在您的 tools 列表中添加一个条目。 该条目的 type 选择工具的版本,Meridian 将其设置为 web_search_20260209。它的 name 始终是 web_search。工具参考文档(在新标签页中打开)列出了当前的版本,因此请从那里复制 type 的值。
在 Claude 4.6 及更高版本的模型上,web_search_20260209 及更高版本默认使用动态过滤。Claude 运行代码来过滤搜索结果,因此只有相关内容才会进入上下文窗口。
Claude 通常在一次请求中完成所有搜索。您的代码发送该请求,并取回完成的答案。
API 可以暂停一个长时间运行的回合,并返回 stop_reason 为 pause_turn。此时,请将响应的内容作为助手消息回传,并使用相同的 tools,Claude 就会继续。
每次搜索都会单独计费(在新标签页中打开),这是在您为令牌付费之外的费用。并非所有云平台都提供网络搜索(在新标签页中打开)。
指定 Claude 可以使用的网站
到目前为止,请求中没有任何内容限制 Claude 可以搜索哪些网站,这对 Meridian 来说是个问题。开放的网络上充斥着论坛帖子和经销商网站,但 Meridian 只能为官方来源背书。
因此,您需要告诉搜索可以在哪里查找。allowed_domains 是工具条目中的另一个字段,它将搜索结果限制在您指定的网站范围内。 Meridian 指定了四个网站。其中两个属于发布这些标准并为其提供认证的机构,即 csagroup.org 和 cwbgroup.org。另外两个属于政府,即 ontario.ca 和 canada.ca。
allowed_domains 接受一个列表。将每一项写成不带 https:// 的裸域名,其子域名也会被包含在内。
阅读答案及其来源
Claude 的答案可能会分成多个 text 块到达,搜索穿插在其间。因此,请拼接每一个 text 块以获得完整的答案。
每次搜索还会在响应中添加一个 web_search_tool_result 块。它保存了该次搜索返回的结果列表,每个结果都有一个 title 和一个 url。
在 Meridian 的四条引用中,Claude 发现有两条核实无误,第三条除子条款编号外也核实无误,第四条则是错误的。
将程序组合在一起
Meridian 的程序将这些步骤组合在一起。在这个程序中,excerpt 保存了提案中的段落,QUESTION 保存了 Meridian 的问题。
关键要点
- 网络搜索是一个服务器工具,因此您只需在
tools中添加一个条目,而无需编写处理程序。Claude 通常在一次请求中完成所有搜索。 allowed_domains将搜索结果限制在您指定的网站范围内。- 在 Claude 4.6 及更高版本的模型上,
web_search_20260209及更高版本默认开启动态过滤,因此只有相关内容才会进入上下文窗口。