加载中
加载中

为Claude构建工具需要解决一些并非一目了然的挑战。当您希望Claude为未来的日期设置提醒时,您很快就会发现,虽然Claude知道当前日期,但它并不总是知道确切的时间,在复杂的日期运算方面也存在困难,而且没有内置的方式来真正设置提醒。

在一次对话中,用户请求为周四之后一周的医生预约设置提醒,这一目标需要3到4个自定义工具。

解决方案是创建能够处理这些特定任务的自定义工具。对于提醒系统,您需要三个独立的工具:一个用于获取当前日期和时间,另一个用于向日期添加时长,第三个用于实际设置提醒。

为什么这具有挑战性

在处理基于时间的任务时,Claude存在一些局限性:

  • Claude可能知道当前日期,但不知道确切的时间
  • Claude在处理基于时间的加法运算时表现不佳,尤其是在展望未来多天的情况下
  • Claude不知道如何设置提醒

用户询问"为我的医生预约设置一个提醒。是下周四。",AI回复"好的,我会提醒您"。

您需要的工具

为了解决这些问题,您将创建三个专用工具:

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

上文列出的提醒系统所需的三个工具及每个工具存在的原因。

工具函数的工作原理

工具系统在您的服务器和Claude之间遵循特定的流程。您编写Claude在需要额外信息时可以调用的函数,Claude接收结果以帮助形成其响应。

标注了每个步骤代码的工具使用流程,依次为:JSON schema、ToolUse部分、工具函数、ToolResult部分。

这个过程涉及多个步骤:编写工具函数、创建JSON schema规范、使用该schema调用Claude、在Claude请求时运行该工具,以及将结果提供回给Claude。

get_weather工具函数示例:如果location为空,它会引发ValueError,否则以JSON格式返回天气API响应。

编写工具函数

工具函数是普通的Python函数,当Claude判断需要额外信息来帮助用户时,就会执行这些函数。以下是有效编写这些函数的方法:

最佳实践

  • 使用命名良好、描述清晰的参数(这一点在后面会变得很重要)
  • 验证输入,如果验证失败则引发错误
  • 返回有意义的错误信息——如果Claude遇到错误,它会尝试再次调用您的函数

创建bedrock-runtime的boto3客户端,然后定义add_user_message、add_assistant_message和chat的笔记本单元格。

创建您的第一个工具

让我们从最简单的工具开始——获取当前日期和时间。这个函数接受一个日期格式参数,并返回当前时间戳:

python
from datetime import datetime, timedelta

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    return datetime.now().strftime(date_format)

这个函数很简单,但遵循了关键原则:它有一个描述性的名称,接受一个命名良好且具有合理默认值的参数,并返回它所承诺的确切内容。

JSON Schema规范

有了函数之后,您需要编写一个向Claude描述它的JSON Schema。这个schema告诉Claude该函数需要什么参数,并帮助它理解何时以及如何使用该工具。

调用get_current_datetime的笔记本单元格,日期格式为"lkajsflkajsfd",其输出为"lkajsflkajsfd"。

JSON Schema有两个用途:它帮助Claude理解您的函数需要哪些参数,并且它不仅仅是一个LLM概念——JSON Schema在许多编程场景中都被广泛用于数据验证。有许多在线工具可以帮助您生成schema。

Schema最佳实践

  • 说明工具的作用、何时使用它以及它返回什么
  • 描述内容力求控制在3到4句话
  • 为参数提供详细的描述

在编写好工具函数并定义好schema之后,您就可以将其与Claude集成,开始构建能够处理现实世界任务(如设置提醒)的更复杂的AI交互。