加载中
加载中

当Claude请求一次工具调用后,您需要执行该函数并将结果发送回去。这样就完成了工具使用工作流程,为Claude提供其所请求的信息。

运行工具函数

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

python
response.content[1].input

这会给您一个字典,其中包含Claude想要传递给您函数的参数。由于您的函数需要的是关键字参数而不是字典,您可以使用Python的解包语法:

python
get_current_datetime(**response.content[1].input)

Notebook单元格运行上述解包调用,返回时间字符串"14:41:05"。

工具结果块

运行工具函数后,您需要使用工具结果块将结果发送回Claude。该块位于用户消息内部,用于告知Claude您在执行该工具时发生了什么。

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

工具结果块有几个重要的属性:

  • tool_use_id - 必须与此ToolResult所对应的ToolUse块的id相匹配
  • content - 运行您的工具所得到的输出,序列化为字符串
  • is_error - 如果发生了错误,则为True

处理多个工具调用

Claude可以在单次响应中请求多个工具调用。例如,如果用户询问“10 + 10等于多少,30 + 30又等于多少?”,Claude可能会返回两个独立的ToolUse块。

Claude发送计算器工具使用块ab3(对应10 + 10)和po9(对应30 + 30);结果按po9输出60、然后ab3输出20的顺序返回。

每次工具调用都会获得一个唯一的ID,在发送结果时您必须匹配这些ID。这能确保Claude知道哪个结果对应哪个请求,即使结果是以不同的顺序到达的。

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

构建后续请求

您发送给Claude的后续请求必须包含完整的对话历史记录,外加新的工具结果。以下是其结构:

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

完整的消息历史记录现在包含:

  • 原始用户消息
  • 带有工具使用块的助手消息
  • 带有工具结果块的用户消息

发出最终请求

发送后续请求时,即使您并不期望Claude再次进行工具调用,您仍然必须包含工具模式(tool schema)。Claude需要该模式来理解您对话历史记录中的工具引用。

python
client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema]
)

我们的服务器向Claude发送工具模式、问题“Whats the current time?”、工具使用块和工具结果块。

随后Claude将返回一条最终消息,把工具结果融入到一个自然的回复中呈现给用户。至此,工具使用工作流程已经完成——您已经成功地让Claude能够通过您的自定义函数访问实时信息。