加载中
加载中

在使用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决定使用某个工具时,它会返回一条助手消息,其中内容列表包含多个块。这与您之前使用的简单纯文本响应相比,是一个重大变化。

助手消息的文本块和ToolUse块,输入的date_format为"%H:%M:%S";这些块也被称为"部分"。

一条多块消息通常包含:

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

ToolUse块包括:

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

使用多块消息管理对话历史

请记住,Claude不会存储对话历史——您需要手动管理它。在处理工具响应时,您必须保留完整的内容结构,包括所有的块。

以下是如何将多块助手消息正确地附加到您的对话历史中:

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

这样可以同时保留文本块和工具使用块,这对于在您进行后续API调用时维护对话上下文至关重要。

完整的工具使用流程

笔记本单元格,包含向"role"和"content"字典添加内容的add_user_message和add_assistant_message,以及一个聊天函数。

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

  1. 将用户消息与工具模式一起发送给Claude
  2. 接收包含文本块和工具使用块的助手消息
  3. 提取工具信息并执行实际的函数
  4. 将工具结果连同完整的对话历史一起发送回Claude
  5. 接收来自Claude的最终响应

每个步骤都需要谨慎处理消息结构,以确保Claude拥有提供准确响应所需的完整上下文。

更新辅助函数

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

这种多块消息处理对于构建能够无缝集成Claude工具能力同时维护适当对话流程的强大应用程序至关重要。