构建一个带有工具的对话系统需要实现一个循环,该循环持续调用Claude,直到它不再请求使用工具为止。当Claude不再请求工具时,这表明它已经为用户准备好了最终响应。
检测工具请求
判断Claude是否想要使用工具的关键在于响应消息的stop_reason字段。当Claude决定需要调用工具时,该字段会被设置为"tool_use"。这为我们提供了一种简洁的方式来检查是否需要继续对话循环:
python
if response.stop_reason != "tool_use":
break # Claude is done, no more tools needed对话循环
主对话函数遵循一个简单的模式:
python
def run_conversation(messages):
while True:
response = chat(messages, tools=[get_current_datetime_schema])
add_assistant_message(messages, response)
print(text_from_message(response))
if response.stop_reason != "tool_use":
break
tool_results = run_tools(response)
add_user_message(messages, tool_results)
return messages这个循环会持续进行,直到Claude提供最终答案而不再请求任何工具。
处理多个工具调用
Claude可以在单个响应中请求多个工具。消息内容包含一个块列表,我们需要分别处理每个工具使用块:

run_tools函数通过筛选工具使用块并逐一处理来实现这一点:
python
def run_tools(message):
tool_requests = [
block for block in message.content if block.type == "tool_use"
]
tool_result_blocks = []
for tool_request in tool_requests:
# 处理每个工具请求……工具结果块
对于每个工具使用块,我们需要创建一个相应的工具结果块。这些块有特定的必需字段:

工具结果块必须包含与原始工具使用块相同的ID,但要放在tool_use_id字段中:
python
tool_result_block = {
"type": "tool_result",
"tool_use_id": tool_request.id,
"content": json.dumps(tool_output),
"is_error": False
}错误处理
健壮的工具执行需要处理潜在的错误。当工具执行失败时,我们仍然需要返回一个工具结果块,但要附带错误信息:
python
try:
tool_output = run_tool(tool_request.name, tool_request.input)
tool_result_block = {
"type": "tool_result",
"tool_use_id": tool_request.id,
"content": json.dumps(tool_output),
"is_error": False
}
except Exception as e:
tool_result_block = {
"type": "tool_result",
"tool_use_id": tool_request.id,
"content": f"Error: {e}",
"is_error": True
}可扩展的工具路由
为了支持多个工具,请创建一个单独的路由函数,而不是硬编码工具名称:
python
def run_tool(tool_name, tool_input):
if tool_name == "get_current_datetime":
return get_current_datetime(**tool_input)
elif tool_name == "other_tool":
return other_tool_function(**tool_input)
# 根据需要添加更多工具这种方法使得添加新工具变得容易,而无需修改核心对话逻辑。
完整工作流程
完整的多轮对话工作方式如下:
- 将用户消息与可用工具一起发送给Claude
- Claude以文本和/或工具使用块进行响应
- 执行任何请求的工具并创建工具结果块
- 将工具结果作为用户消息发送回Claude
- 重复此过程,直到Claude提供不含工具请求的最终响应
这创造了一种无缝的体验,Claude可以在多个对话轮次中进行多次工具调用,以收集所有所需信息,然后再向用户提供全面的最终答案。