加载中
加载中

当Claude以工具使用请求作出响应时,您的服务器需要实际运行所请求的工具并将结果发送回去。这一步骤涉及从Claude的响应中提取工具使用部分、执行相应的函数,以及正确地格式化结果。

处理多个工具请求

Claude可以在单个响应中发送多个工具使用部分。您的代码需要防御性地处理这种可能性。一条助手消息可能包含一个文本部分,后面跟着一个、两个甚至更多的工具使用部分。

助手消息部分:一个提供查询当前时间的"Text"部分,以及一个针对get_current_datetime的"toolUse"部分。

整个流程是这样的:Claude发送带有JSON模式的请求,收到一个工具使用部分,然后您的服务器运行该工具并发送回一个工具结果部分,供Claude提供最终响应。

我们的服务器向Claude发送用户消息"What time is it?"、助手文本和工具使用部分,然后是一个工具结果部分。

提取工具使用部分

首先,创建一个函数来处理聊天请求返回的所有部分:

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]

这个推导式过滤了部分列表,只保留包含"toolUse"键的字典,忽略文本部分。

运行实际的工具

创建一个辅助函数来执行所请求的工具:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    else:
        raise Exception(f"Unknown tool name: {tool_name}")

这里的关键细节是使用**tool_input将参数字典解包到您的工具函数中。Claude始终将参数作为字典对象返回,因此您需要正确地解包它。

创建工具结果部分

运行工具后,您需要将响应格式化为一个工具结果部分:

一个助手消息内容列表,包含一个文本部分和两个"toolUse"部分,分别针对get_current_datetime和other_tool。

工具结果部分需要三个关键属性:

  • toolUseId - 必须与原始工具使用部分的ID匹配
  • content - 来自您工具的输出,序列化为字符串
  • status - "success"(成功)或"error"(错误)

理解工具使用ID

当Claude并行请求多个工具时,工具使用ID系统就变得非常重要。例如,如果Claude想要运行计算器工具两次:

Claude发送计算器工具使用ab3,用于10 + 10,以及po9,用于30 + 30;我们的服务器返回po9的输出60和ab3的输出20。 Claude发送计算器工具使用ab3,用于10 + 10,以及po9,用于30 + 30;我们的服务器返回po9的输出60和ab3的输出20。

每个工具使用都会获得一个唯一的ID(如"ab3"和"po9"),您的工具结果必须包含匹配的ID,这样Claude才能知道哪个结果对应哪个请求。

错误处理

将您的工具执行包裹在try-catch块中。Claude对工具错误很智能,如果您返回正确的错误信息,它可能会调整其处理方式:

python
try:
    tool_output = run_tool(tool_name, tool_input)
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": json.dumps(tool_output)}],
            "status": "success"
        }
    }
except Exception as e:
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": f"Error: {e}"}],
            "status": "error"
        }
    }

完整实现

以下是处理工具请求并返回格式化结果的完整函数:

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]
        
        try:
            tool_output = run_tool(tool_name, tool_input)
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": json.dumps(tool_output)}],
                    "status": "success"
                }
            }
        except Exception as e:
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": f"Error: {e}"}],
                    "status": "error"
                }
            }
        
        tool_result_parts.append(tool_result_part)
    
    return tool_result_parts

一旦您获得了工具结果部分,就可以在下一次聊天请求中将它们发送回Claude,从而完成工具使用周期。