加载中
当Claude以工具使用请求作出响应时,您的服务器需要实际运行所请求的工具并将结果发送回去。这一步骤涉及从Claude的响应中提取工具使用部分、执行相应的函数,以及正确地格式化结果。
处理多个工具请求
Claude可以在单个响应中发送多个工具使用部分。您的代码需要防御性地处理这种可能性。一条助手消息可能包含一个文本部分,后面跟着一个、两个甚至更多的工具使用部分。

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

提取工具使用部分
首先,创建一个函数来处理聊天请求返回的所有部分:
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始终将参数作为字典对象返回,因此您需要正确地解包它。
创建工具结果部分
运行工具后,您需要将响应格式化为一个工具结果部分:

工具结果部分需要三个关键属性:
- toolUseId - 必须与原始工具使用部分的ID匹配
- content - 来自您工具的输出,序列化为字符串
- status - "success"(成功)或"error"(错误)
理解工具使用ID
当Claude并行请求多个工具时,工具使用ID系统就变得非常重要。例如,如果Claude想要运行计算器工具两次:

每个工具使用都会获得一个唯一的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,从而完成工具使用周期。