加载中
在使用Claude的工具功能时,您会遇到一种与之前看到的简单文本响应不同的新型响应结构。Claude现在返回的不再只是单个文本区块,而是可能返回同时包含文本和工具使用信息的多区块消息。
发起启用工具的API调用
要使Claude能够使用工具,您需要在API调用中包含一个tools参数。以下是构造该请求的方式:
python
messages = []
messages.append({
"role": "user",
"content": "What is the exact time, formatted as HH:MM:SS?"
})
response = client.messages.create(
model=model,
max_tokens=1000,
messages=messages,
tools=[get_current_datetime_schema],
)tools参数接受一个JSON模式(schema)列表,用于描述Claude可以调用的可用函数。
理解多区块消息
当Claude决定使用工具时,它会返回一条助手消息,其内容列表中包含多个区块。与您之前使用的简单纯文本响应相比,这是一个重大变化。

一条多区块消息通常包含:
- Text Block(文本区块) - 说明Claude正在做什么的人类可读文本(例如"我可以帮您查询当前时间,让我为您查找这些信息")
- ToolUse Block(工具使用区块) - 给您的代码的指令,说明要调用哪个工具以及使用什么参数
ToolUse区块包括:
- 用于跟踪该工具调用的ID
- 要调用的函数名称(例如"get_current_datetime")
- 按照您的JSON模式格式化的输入参数
- 类型标识"tool_use"
处理带有多区块内容的消息历史
这里是关键部分:Claude不会存储对话历史,因此您必须手动管理它。在处理工具响应时,您需要保留整个内容结构,包括所有区块。
您不能只提取文本,而是需要附加完整的响应内容:
python
messages.append({
"role": "assistant",
"content": response.content
})这样可以同时保留文本区块和工具使用区块,为后续的API调用维持完整的对话上下文。
完整流程
工具使用过程遵循以下模式:

- 将带有工具模式的用户消息发送给Claude
- 接收多区块助手消息(文本+工具使用)
- 提取工具调用信息并执行该函数
- 将工具结果连同完整的消息历史一起发回给Claude
- 接收来自Claude的最终响应
每一步都需要仔细处理消息结构,以维持对话的连续性。其中的关键洞见是:启用工具的对话涉及更复杂的消息格式,但维持完整消息历史这一基本原则保持不变。
更新辅助函数
如果您一直在使用像add_user_message和add_assistant_message这样的辅助函数,您需要更新它们以处理多区块内容。当前版本可能只支持单个文本区块,但现在它们需要适应包含工具使用区块在内的更复杂内容结构。