加载中
在使用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参数接受一个描述Claude可以调用的可用函数的JSON模式列表。
理解多块消息
当Claude决定使用某个工具时,它会返回一条助手消息,其中内容列表包含多个块。这与您之前使用的简单纯文本响应相比,是一个重大变化。

一条多块消息通常包含:
- 文本块(Text Block) - 用人类可读的文本说明Claude正在做什么(例如"我可以帮您查询当前时间。让我为您查找这些信息")
- ToolUse块(ToolUse Block) - 指示您的代码应该调用哪个工具以及使用什么参数
ToolUse块包括:
- 用于跟踪该工具调用的ID
- 要调用的函数名称(例如"get_current_datetime")
- 格式化为字典的输入参数
- 类型标识"tool_use"
使用多块消息管理对话历史
请记住,Claude不会存储对话历史——您需要手动管理它。在处理工具响应时,您必须保留完整的内容结构,包括所有的块。
以下是如何将多块助手消息正确地附加到您的对话历史中:
messages.append({
"role": "assistant",
"content": response.content
})这样可以同时保留文本块和工具使用块,这对于在您进行后续API调用时维护对话上下文至关重要。
完整的工具使用流程

工具使用流程遵循以下模式:
- 将用户消息与工具模式一起发送给Claude
- 接收包含文本块和工具使用块的助手消息
- 提取工具信息并执行实际的函数
- 将工具结果连同完整的对话历史一起发送回Claude
- 接收来自Claude的最终响应
每个步骤都需要谨慎处理消息结构,以确保Claude拥有提供准确响应所需的完整上下文。
更新辅助函数
如果您一直在使用像add_user_message()和add_assistant_message()这样的辅助函数,您需要更新它们以处理多块内容。当前版本可能仅支持单个文本块,但现在它们需要适应包含工具使用块的更复杂的内容结构。
这种多块消息处理对于构建能够无缝集成Claude工具能力同时维护适当对话流程的强大应用程序至关重要。