The web search tool

🌐 Claude 网络搜索工具 (Web Search Tool) 学习笔记

一、工具概述与机制

• 功能定义： 网络搜索工具允许 Claude 搜索最新的或专业的信息，以回答用户的问题。
• 运行机制： 搜索过程完全由 Claude 内部执行，用户无需提供外部实现代码，使用起来非常便捷。
• 核心控制： 通过在请求中提供一个“Schema”（模式/结构定义）来启用和控制网络搜索功能。

二、网络搜索 Schema 关键要素

• Schema 作用： 这是一个定义，用于告知 Claude 如何执行搜索。
• 关键字段：
• type：指定工具类型（例如 web_search_2025_0305）。
• name：工具的名称（例如 web_search）。
• max_uses：限制 Claude 总共可以执行搜索的次数（例如，设置为五次）。
• 搜索过程： 单次搜索可能返回多个结果，Claude 会根据内容决定是否进行后续的追问搜索。

三、搜索请求的响应结构

当执行搜索请求后，返回的响应包含多个不同的内容块（Blocks）：

• 文本块 (Text Block)： 框架性内容，用于引导或总结回答。
• 服务器工具使用块 (Server Tool Use Block)： 包含 Claude 实际用于搜索的查询语句（Query）。
• 网络搜索工具结果块 (Web Search Tool Result Block)： 包含 Claude 从网络获取到的原始搜索结果列表。
• 引用列表 (Citations List)： 文本块中用于支持 Claude 所做陈述的特定网页引用。

四、高级控制与优化

• 领域约束 (Domain Constraint)： 推荐使用 allowed domains 字段来限制 Claude 的搜索范围。
• 目的： 确保 Claude 仅在特定、可靠的网站（如政府维护的学术网站）上查找信息，从而提高答案的准确性和科学性。
• 应用： 通过指定域名（如 nih. gov），可以约束 Claude 不搜索其他任何网站。

五、用户界面 (UI) 展示策略

• 渲染策略：
• 将所有文本块渲染为普通文本。
• 对于 web search result block 和 citation web search result location，应在用户界面中特别突出显示。
• 目的： 明确告知用户 Claude 是如何获取信息的，增强答案的可信度。

Takeaways

• 网络搜索功能通过提供一个“Schema”（模式/结构定义）来启用和控制。
• Schema 包含 max_uses（限制总搜索次数）和 allowed domains（限制搜索范围）等关键控制字段。
• 搜索请求的响应包含多个结构化内容块，包括查询语句、原始搜索结果块和引用列表。
• 推荐使用 allowed domains 字段来约束搜索范围，以确保信息来源的可靠性和答案的准确性。