加载中
加载中

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

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

我们要添加的工具

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

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

好消息是,大部分实现工作已经完成。add_duration_to_datetime 函数和 set_reminder 函数已经提供,连同它们对应的模式(schema)。

将工具添加到对话中

首先,更新 run_conversation 函数,将新的工具模式包含在工具列表中:

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

这会让 Claude 了解在对话过程中可以使用的全部三种可用工具。

更新工具路由器

接下来,修改 run_tool 函数以处理新的工具调用。为每个新工具添加 elif 分支:

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)

这个模式很简单:检查工具名称,使用提供的输入调用相应的函数,并返回结果。

测试多工具使用

要测试该系统,请尝试一个需要多个工具的请求:"Set a reminder for my doctors appointment. Its 177 days after Jan 1st, 2050."(为我的医生预约设置一个提醒。它是在 2050 年 1 月 1 日之后的第 177 天。)

这个请求促使 Claude 执行以下操作:

  1. 计算日期(使用 add_duration_to_datetime)
  2. 设置提醒(使用 set_reminder)

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

Claude 通过先说明它需要做什么,然后按顺序进行相应的工具调用来处理这个请求。对话显示 Claude 计算出目标日期为 2050 年 6 月 27 日,然后为该日期设置了提醒。

理解消息流

当您查看对话历史记录时,会看到完整的消息结构:

  • 包含请求的用户消息
  • 同时包含文本块和工具使用块的助手消息
  • 工具结果消息
  • 后续的助手消息

每条助手消息都将一个 TextBlock 与一个 ToolUseBlock 配对,而工具结果为 "Monday, June 27, 2050 12:00:00 AM"。

这展示了 Claude 如何在单条消息中包含多个块——将说明性文本与工具使用请求结合在一起。

添加工具的简单模式

一旦您具备了核心的工具基础设施,添加新工具就遵循以下模式:

  1. 创建工具函数的实现
  2. 定义工具模式
  3. 将该模式添加到 run_conversation 中的工具列表里
  4. 在 run_tool 中为该工具添加一个分支

这种模块化的方法使您能够轻松扩展 AI 助手的能力,而无需重构现有代码。每个新工具都能与现有的对话流程和工具处理逻辑无缝集成。