加载中
加载中

在使用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(文本区块)和ToolUse Block(工具使用区块),输入date_format为"%H:%M:%S";区块也被称为"parts"。

一条多区块消息通常包含:

  • Text Block(文本区块) - 说明Claude正在做什么的人类可读文本(例如"我可以帮您查询当前时间,让我为您查找这些信息")
  • ToolUse Block(工具使用区块) - 给您的代码的指令,说明要调用哪个工具以及使用什么参数

ToolUse区块包括:

  • 用于跟踪该工具调用的ID
  • 要调用的函数名称(例如"get_current_datetime")
  • 按照您的JSON模式格式化的输入参数
  • 类型标识"tool_use"

处理带有多区块内容的消息历史

这里是关键部分:Claude不会存储对话历史,因此您必须手动管理它。在处理工具响应时,您需要保留整个内容结构,包括所有区块。

您不能只提取文本,而是需要附加完整的响应内容:

python
messages.append({
    "role": "assistant",
    "content": response.content
})

这样可以同时保留文本区块和工具使用区块,为后续的API调用维持完整的对话上下文。

完整流程

工具使用过程遵循以下模式:

一个Notebook单元格,其中add_user_message和add_assistant_message添加了"role"和"content"字典,以及一个chat函数。

  1. 将带有工具模式的用户消息发送给Claude
  2. 接收多区块助手消息(文本+工具使用)
  3. 提取工具调用信息并执行该函数
  4. 将工具结果连同完整的消息历史一起发回给Claude
  5. 接收来自Claude的最终响应

每一步都需要仔细处理消息结构,以维持对话的连续性。其中的关键洞见是:启用工具的对话涉及更复杂的消息格式,但维持完整消息历史这一基本原则保持不变。

更新辅助函数

如果您一直在使用像add_user_message和add_assistant_message这样的辅助函数,您需要更新它们以处理多区块内容。当前版本可能只支持单个文本区块,但现在它们需要适应包含工具使用区块在内的更复杂内容结构。