加载中
加载中

一旦您具备了核心的工具处理基础设施,在 Claude 实现中添加多个工具就会变得简单直接。本教程通过遵循一个简单的模式,展示了如何集成额外的工具。

我们需要的三个工具:获取当前日期时间、向日期时间添加时长以及设置提醒,详见下文。

我们要添加的工具

我们的提醒系统需要三项主要能力:

  • 获取当前日期时间 - Claude 需要知道当前的日期和时间
  • 向日期时间添加时长 - Claude 在日期时间加法上并不完美
  • 设置提醒 - 需要一种设置提醒的方法

好消息是,大部分实现工作已经完成。add_duration_to_datetime 函数可以处理各种时间单位(秒、分钟、小时、天、周、月),并返回格式正确的日期时间字符串。

定义 set_reminder 的笔记本,它会打印时间戳和内容,随后是 add_duration_to_datetime_schema 的开头。

set_reminder 函数是一个简单的占位实现,它只是打印出确认详情,而不会真正设置系统提醒。

将工具添加到对话中

这个过程遵循我们之前建立的相同模式。首先,更新 run_conversation 函数以包含新的工具模式(tool schema):

python
response = chat(messages, tools=[
    get_current_datetime_schema,
    add_duration_to_datetime_schema,
    set_reminder_schema
])

笔记本单元格,其中 run_tool 仅处理 get_current_datetime,run_tools 针对消息中的每个 "tool_use" 区块调用它。

这会告诉 Claude 在对话过程中可以使用的所有可用工具。

处理工具执行

接下来,更新 run_tool 函数以处理新的工具调用:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)

笔记本单元格展示了上面的 run_tool 函数,随后是 run_tools 的开头,它会收集 tool_use 区块。

这种模式是一致的:检查工具名称,使用提供的输入调用相应的函数,并返回结果。

测试多工具使用

让我们用一个需要多个工具的复杂请求来进行测试:“为我的医生预约设置一个提醒。那是在 2050 年 1 月 1 日之后的第 177 天。”

这个请求迫使 Claude:

  1. 计算 2050 年 1 月 1 日之后 177 天的日期
  2. 为计算出的日期设置提醒

笔记本输出中,set_reminder 打印出 "Setting the following reminder for 2050-06-27T00:00:00: Doctor's appointment"。

Claude 通过以下方式处理这个请求:首先解释它需要做什么,然后使用 add_duration_to_datetime 工具计算出 2050 年 6 月 27 日,最后使用正确的日期调用 set_reminder。

理解消息流

查看对话历史可以揭示 Claude 如何在单个响应中管理多个工具。助手消息同时包含一个解释该过程的文本区块和用于第一次计算的工具使用区块。

消息列表显示了 add_duration_to_datetime 调用、其结果 "Monday, June 27, 2050 12:00:00 AM",然后是 set_reminder。

在收到工具结果后,Claude 会继续发送另一条消息,其中同时包含文本和另一个用于设置提醒的工具使用区块。这展示了 Claude 如何将多个工具调用串联在一起,以完成复杂的任务。

关键要点

一旦您搭建好了基本的工具基础设施,添加新工具就遵循一个简单的三步流程:

  • 将工具模式(schema)添加到 run_conversation 中的工具列表中
  • 在 run_tool 函数中为新工具添加一个分支
  • 实现实际的工具函数

该框架会自动处理所有消息传递、工具结果格式化和对话流程。这使得构建能够按顺序执行多个相关任务的复杂 AI 助手变得容易。