加载中
加载中

在 Claude 请求工具调用后,您需要执行该函数并将结果发送回去。这通过向 Claude 提供它所请求的信息来完成工具使用的工作流程。

运行工具函数

当 Claude 响应一个工具使用块时,您需要提取输入参数并调用您的函数。以下是访问工具参数的方法:

python
# 访问工具使用块
tool_use_block = response.content[1]

# 获取输入参数
input_params = tool_use_block.input

# 使用参数调用您的函数
result = get_current_datetime(**input_params)

双星号(**)将字典解包为您的函数所期望的关键字参数。

工具结果块

运行工具后,您需要使用工具结果块将结果发送回 Claude。此块具有几个重要属性:

示例工具结果 JSON,类型为 "tool_result",内容为 "12:47:13",is_error 为 False,并带有匹配的 tool_use_id。

  • tool_use_id - 必须与原始工具使用块中的 ID 匹配
  • content - 您的工具函数的输出,已转换为字符串
  • is_error - 如果执行期间发生错误,则设置为 true

处理多个工具调用

Claude 可以在单个响应中请求多个工具调用。例如,如果用户询问"10 + 10 等于多少,30 + 30 又等于多少?",Claude 可能会发送两个独立的工具使用块:

Claude 发送计算器工具使用块 ab3(用于 10 + 10)和 po9(用于 30 + 30);结果返回为 po9 输出 60,然后 ab3 输出 20。

每个工具使用块都有一个唯一的 ID,在发送结果时您必须匹配这些 ID:

Claude 返回工具使用 ab3(10 + 10)和 po9(30 + 30);我们的服务器回复 po9 输出 60,然后是 ab3 输出 20。

这套 ID 系统确保 Claude 能够正确地将每个结果与其对应的请求相匹配,即使结果以不同的顺序到达。

发送后续请求

您向 Claude 发送的后续请求必须包含完整的对话历史以及新的工具结果:

python
messages.append({
    "role": "user",
    "content": [{
        "type": "tool_result",
        "tool_use_id": response.content[1].id,
        "content": result,
        "is_error": False
    }]
})

对话流程如下所示:

我们的服务器向 Claude 发送工具模式、问题"现在几点了?"、工具使用块和工具结果块。

请记得在后续请求中包含工具模式,即使 Claude 可能不需要再次调用工具。Claude 需要该模式来理解对话历史中的工具引用。

完整工作流程

以下是完整的流程:

  1. 用户提出一个需要使用工具的问题
  2. Claude 用一个工具使用块作出响应
  3. 您执行所请求的工具函数
  4. 您发送一个带有工具结果的后续请求
  5. Claude 使用工具输出给出最终答案

最终请求包括您的完整消息历史、工具结果块和工具模式。然后 Claude 会用一条包含您工具执行所得信息的普通文本消息作出响应。