加载中
加载中

在使用Claude构建AI应用程序时,您经常需要让它能够访问实时信息或执行操作的能力。这正是工具函数发挥作用的地方——它们是Python函数,当Claude需要额外数据来帮助用户时,可以调用这些函数。

Claude需要知道当前的日期和时间,它在日期时间加法运算上并不完美,我们需要一种方法来设置提醒。

上图展示了我们将要实现的三个基本工具:获取当前日期/时间、为日期添加时长,以及设置提醒。让我们从第一个开始。

什么是工具函数?

工具函数是一个普通的Python函数,当Claude判断它需要额外信息来帮助用户时,该函数会被自动执行。例如,如果有人问"现在几点了?",Claude会调用您的日期/时间工具来获取当前时间。

get_weather函数:如果location为空,它会抛出ValueError,然后调用天气API并返回JSON。

这是一个天气工具函数的示例。请注意它是如何验证输入并提供清晰的错误消息的——这些都是重要的最佳实践。

工具函数的最佳实践

在编写工具函数时,请遵循以下准则:

  • 使用描述性名称: 您的函数名和参数名都应该清楚地表明其用途
  • 验证输入: 检查必需的参数是否为空或无效,如果是,则抛出错误
  • 提供有意义的错误消息: Claude可以看到错误消息,并可能会使用修正后的参数重试函数调用

验证之所以特别重要,是因为Claude会从错误中学习。如果您抛出一个清晰的错误,比如"位置不能为空",Claude可能会尝试使用有效的位置值再次调用该函数。

构建您的第一个工具函数

让我们创建一个获取当前日期和时间的函数。这个函数将接受一个日期格式参数,以便Claude可以请求不同格式的时间:

python
from datetime import datetime

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    if not date_format:
        raise ValueError("date_format cannot be empty")
    return datetime.now().strftime(date_format)

此函数使用Python的datetime模块来获取当前时间,并根据提供的格式字符串对其进行格式化。默认格式为年-月-日 时:分:秒。

您可以使用不同的格式来测试它:

python
# 默认格式:“2024-01-15 14:30:25”
get_current_datetime()

# 仅小时和分钟:“14:30”
get_current_datetime("%H:%M")

这个验证检查确保Claude不能为日期格式传递空字符串。虽然这个特定的错误不太可能发生,但它展示了验证输入和提供有用错误消息的模式,供Claude从中学习。

后续步骤

创建函数只是第一步。接下来,您需要编写一个JSON schema来向Claude描述该函数,然后将其集成到您的聊天系统中。这种工具函数方法赋予了Claude强大的能力,同时保持您的代码井然有序、易于维护。