处理工具调用

本页涵盖工具调用生命周期：从 Claude 的响应中读取 tool_use 块、在您的回复中格式化 tool_result 块，以及发出错误信号。有关自动处理此问题的 SDK 抽象，请参阅 Tool Runner。

Claude 的响应因其使用客户端工具还是服务器工具而异。

处理来自客户端工具的结果

响应将具有 tool_use 的 stop_reason 和一个或多个 tool_use 内容块，其中包括：

• id：此特定工具使用块的唯一标识符。这将用于稍后匹配工具结果。
• name：正在使用的工具的名称。
• input：包含传递给工具的输入的对象，符合工具的 input_schema。

当您收到客户端工具的工具使用响应时，您应该：

1. 从 tool_use 块中提取 name、id 和 input。
2. 在您的代码库中运行与该工具名称对应的实际工具，传入工具 input。
3. 通过发送一条新消息来继续对话，其 role 为 user，content 块包含 tool_result 类型和以下信息：
   • tool_use_id：此结果所针对的工具使用请求的 id。
   • content：工具的结果，可以是字符串（例如，"content": "15 degrees"）、嵌套内容块列表（例如，"content": [{"type": "text", "text": "15 degrees"}]）或文档块列表（例如，）。这些内容块可以使用 、 或 类型。

{
  "role": "user",
  "content": [
    { "type": "text", "text": "Here are the results:" }, // ❌ tool_result 之前的文本
    { "type": "tool_result", "tool_use_id": "toolu_01" /* ... */ }
  ]
}

收到工具结果后，Claude 将使用该信息继续生成对原始用户提示的响应。

处理来自服务器工具的结果

Claude 在内部执行工具，并将结果直接合并到其响应中，无需额外的用户交互。

使用 is_error 处理错误

使用 Claude 的工具时可能会发生几种不同类型的错误：

后续步骤

• 有关在一次转换中运行多个工具，请参阅 Parallel tool use。
• 有关自动化此循环的 SDK 抽象，请参阅 Tool Runner。
• 有关完整的工具使用工作流，请参阅 Define tools。