加载中
加载中

Claude 内置了一个网络搜索工具,使其能够搜索互联网以获取最新或专业信息来回答用户问题。与其他需要您提供具体实现的工具不同,Claude 会自动处理整个搜索过程——您只需提供一个简单的模式(schema)来启用它。

我们的服务器询问最新的量子计算进展,然后 Claude 搜索网络并根据三个结果进行回答。

设置网络搜索工具

要使用网络搜索工具,您需要创建一个包含以下必需字段的模式对象:

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search", 
    "max_uses": 5
}

max_uses 字段限制了 Claude 可以执行的搜索次数。Claude 可能会根据初始结果进行后续搜索,因此这可以防止过多的 API 调用。

工作原理

当您在工具列表中包含网络搜索模式时,Claude 会根据您的问题自动决定何时进行搜索。例如,询问"增长腿部肌肉最好的运动是什么?"可能会触发对当前健身研究的搜索。

响应中包含几种类型的内容块:

  • TextBlock - Claude 对其正在执行操作的说明
  • ServerToolUseBlock - 显示 Claude 使用的确切搜索查询
  • WebSearchToolResultBlock - 包含搜索结果
  • WebSearchResultBlock - 带有标题和 URL 的单个搜索结果
  • CitationsWebSearchResultLocation - 支持 Claude 陈述的具体文本引用

限制搜索域名

您可以使用 allowed_domains 字段将搜索限制在特定域名内。当您希望使用权威来源时,这一点尤其有用:

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search",
    "max_uses": 5,
    "allowed_domains": ["nih.gov"]
}

这可以确保 Claude 只搜索可信域名(如政府卫生网站),而不是信息可能不可靠的随机健身博客。

渲染搜索结果

响应结构的设计便于进行丰富的 UI 渲染。您通常可以:

  • 将文本块显示为常规内容
  • 将网络搜索结果显示为顶部的参考列表
  • 内联渲染引用,并附带指向原始资料的链接
  • 高亮引用的文本,以展示 Claude 如何支持其陈述

这创造了一种透明的体验,用户可以验证 Claude 的来源,并理解它是如何得出结论的。引用系统通过展示 Claude 响应背后的证据,有助于建立信任。