14.The web search tool
此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org
==================================================
重要提示：您的组织必须在设置控制台中启用Web搜索工具才能使用它。您可以在此处找到该设置：https://console.anthropic.com/settings/privacyhttps://console.anthropic.com/settings/privacy
Claude包含一个内置的网络搜索工具，让它能够搜索互联网获取最新或专业信息来回答用户问题。与其他需要您提供实现的工具不同，Claude会自动处理整个搜索过程——您只需要提供一个简单的模式来启用它。
设置Web搜索工具
要使用网络搜索工具，您需要创建一个包含以下必需字段的模式对象：
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5
}
max_uses字段限制Claude可以执行的搜索次数。Claude可能会根据初始结果进行后续搜索，因此这可以防止过多的API调用。单次搜索会返回多个结果，但Claude可能会决定需要进行额外的搜索。
响应的工作原理
当Claude使用网络搜索工具时，响应包含几种类型的块：
- 文本块 - Claude对其正在执行操作的解释
- ServerToolUseBlock - 显示Claude使用的确切搜索查询
- WebSearchToolResultBlock - 包含搜索结果
- WebSearchResultBlock - 包含标题和URL的单个搜索结果
- 引用块 - 支持Claude陈述的文本
响应结构让您可以准确看到Claude搜索了什么以及找到了哪些来源。引用包括Claude用来支持其答案的具体文本，以及来源URL。
限制搜索域名
您可以使用allowed_domains字段将搜索限制在特定域名内。当您需要可靠、权威的来源时，这特别有用：
web_search_schema = {
"type": "web_search_20250305",
"name": "web_search",
"max_uses": 5,
"allowed_domains": ["nih.gov"]
}
例如，当询问医疗或运动建议时，限制到PubMed (nih.gov)等域名可以确保您获得基于证据的信息，而不是随机的博客内容。
渲染搜索结果
响应中的不同块类型专为特定的UI渲染而设计：
- 将文本块渲染为常规内容
- 在顶部将网络搜索结果显示为来源列表
- 在文本中内联显示引用，包括来源域名、页面标题、URL和引用文本
这种结构帮助用户理解Claude是如何得出答案的，并提供了关于所使用信息源的透明度。引用格式清楚地表明了哪些具体信息来自哪些来源，从而建立了对AI回答的信任。
Practical Usage
Web搜索工具最适用于：
- 时事和最新发展
- Claude训练数据中没有的专业信息
- 事实核查和寻找权威来源
- 需要最新信息的研究任务
只需在进行API调用时将该schema包含在您的工具数组中，Claude就会自动决定何时进行web搜索来帮助回答用户的问题。
==================================================
此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org