The web search tool

网页搜索工具 (Web Search Tool) 学习笔记

一、 核心概念

• 定义： 网页搜索工具是内置于 Claude 的功能，允许模型搜索互联网以获取最新或专业的信息来回答用户问题。
• 功能区别： 与文本编辑器工具不同，用户无需提供实际的搜索实现代码，搜索过程完全由 Claude 完成。
• 目的： 确保回答基于最新的事实和数据，而非模型内部的旧知识。

二、 工具启用与配置 (Schema)

• 启用方式： 必须在请求中提供一个特定的“网页搜索模式”（Web Search Schema）来激活该功能。
• 关键字段：
• type：指定工具类型（例如 web_search_2025_0305）。
• name：工具的名称（例如 web_search）。
• max_uses：设置 Claude 可以执行搜索的总次数（例如 5 次）。
• 搜索流程： 单次搜索可能返回多个结果，Claude 会根据内容决定是否进行后续的二次搜索。

三、 执行过程与响应结构

当运行包含搜索模式的请求时，响应内容（Content List）会包含多个不同的“块”（Blocks）：

• 文本块 (Text Block)： 包含 Claude 的初始框架或最终答案。
• 服务器工具使用块 (Server Tool Use Block)： 包含 Claude 实际执行搜索时使用的查询语句（Query）。
• 网页搜索工具结果块 (Web Search Tool Result Block)： 包含 Claude 从搜索中获取到的原始结果列表。
• 引用文本块 (Text Block with Citation)： Claude 在回答问题时，会使用特定文本块来引用和支持其论点的来源。

四、 进阶控制与优化

• 限制搜索范围 (Constraint)： 通过在 Schema 中添加 allowed_domains 字段，可以限制 Claude 只能在指定的域名内进行搜索。
• 目的： 提高信息质量和准确性，确保获取的资料符合特定标准（例如，仅搜索政府或学术机构的网站）。

五、 用户界面 (UI) 展示建议

• 文本块处理： 将所有普通文本块渲染为普通文本。
• 结果展示： 针对“网页搜索工具结果块”和“引用文本块”，应在用户界面中进行特殊渲染，明确告知用户信息来源，例如显示域、标题、URL 和被引用的具体文本。

Takeaways

• 网页搜索工具允许模型访问互联网获取最新或专业信息，确保回答基于事实而非内部旧知识。
• 启用该功能必须提供特定的“网页搜索模式”（Web Search Schema），关键配置包括工具类型（type）和最大使用次数（max_uses）。
• 请求响应包含多个块（Blocks），包括服务器工具使用块（记录查询）、网页搜索工具结果块（原始数据）和引用文本块（支持论点的来源）。
• 可通过在 Schema 中添加 allowed_domains 字段来限制搜索范围，从而提高信息质量和准确性。