Tool functions

📚 学习笔记：工具函数 (Tool Functions) 基础

一、 工具函数定义

• 工具函数 (Tool Function)： 一种 Python 函数，当 Claude 决定需要检索额外信息来帮助用户时，系统会自动执行该函数。
• 目的： 允许 AI 调用外部功能（如获取当前日期/时间、查询天气等）。

二、 工具函数的最佳实践 (Best Practices)

• 参数命名 (Argument Naming)： 必须使用描述性强、易于理解的参数名称。
• 输入验证 (Input Validation)： 必须验证输入参数。如果输入不符合要求（如缺失或为空），应立即抛出错误。
• 错误信息 (Error Messages)： 抛出的错误信息必须具有意义。
• 作用： 当 Claude 调用工具失败时，它会看到错误信息，并可能据此尝试以不同的方式重新调用工具来修正错误。

三、 实现获取当前日期/时间工具

• 函数目标： 获取当前的日期和时间。
• 函数签名示例： get_current_date_time(date_format)
• date_format：用于指定输出格式的参数。
• 默认值： 建议设置一个复杂的默认格式（如：%Y-%m-%d %H:%M:%S）。
• 核心逻辑： 使用 datetime. now(). strftime(date_format) 来获取并格式化当前时间。
• 输入验证示例：
• 检查 date_format 是否为空 (if not date_format)。
• 如果为空，则抛出明确的错误（例如：“date format cannot be empty”）。
• 目的： 即使是极小概率的错误，也能为 Claude 提供修复错误的信号。

Takeaways

• 工具函数是Python函数，当Claude需要检索外部信息（如日期、天气）时，系统会自动执行它。
• 工具函数必须对输入参数进行验证，若输入缺失或不符合要求，应立即抛出明确的错误。
• 抛出的错误信息必须具有意义，这能帮助Claude识别调用失败的原因并尝试修正错误。
• 实现工具时，应使用描述性强的参数命名，并利用datetime模块获取和格式化当前时间。