加载中
编写好工具函数后,下一步是创建一个 JSON 模式(schema),告诉 Claude 您的函数需要哪些参数以及如何使用它。这个模式充当文档,供 Claude 阅读以理解何时以及如何调用您的工具。
理解 JSON Schema
JSON Schema 并非 AI 或工具调用所专有——它是一种已经存在多年、被广泛使用的数据验证规范。AI 社区采用它,是因为它是一种描述函数参数和验证数据的便捷方式。

完整的工具规范有三个主要部分:
- name - 函数名称(如"get_weather")
- description - 该工具的作用以及何时使用它
- input_schema - 描述参数的实际 JSON 模式
编写有效的描述

description 字段对于帮助 Claude 理解您的工具至关重要。请遵循以下最佳实践:
- 解释该工具的作用、何时使用它,以及它返回什么
- 力求控制在 3-4 句话
- 同样为每个参数提供详细的描述
input_schema 部分使用标准 JSON Schema 格式描述函数的参数,包括类型信息以及每个参数的详细描述。
简便方法:让 Claude 为您编写模式
您无需从零开始编写 JSON 模式,而是可以使用 Claude 本身来生成它们。具体流程如下:
- 复制您的工具函数
- 前往 Claude,让它为工具调用编写一个 JSON 模式
- 将 Anthropic 关于工具使用的文档作为上下文一并提供
- 让 Claude 按照最佳实践生成一个格式正确的模式

提示词大致应为:"请为这个函数编写一个用于工具调用的有效 JSON 模式规范。遵循所附文档中列出的最佳实践。"
在代码中实现该模式
一旦 Claude 生成了您的模式,将其复制到您的代码文件中。使用一致的命名模式,如 function_name_schema,以保持条理清晰:
python
get_current_datetime_schema = {
"name": "get_current_datetime",
"description": "Returns the current date and time formatted according to the specified format",
"input_schema": {
"type": "object",
"properties": {
"date_format": {
"type": "string",
"description": "A string specifying the format of the returned datetime. Uses Python's strftime format codes.",
"default": "%Y-%m-%d %H:%M:%S"
}
},
"required": []
}
}增加类型安全
为了更好地进行类型检查,从 Anthropic 库中导入并使用 ToolParam 类型:
python
from anthropic.types import ToolParam
get_current_datetime_schema = ToolParam({
# 您的架构字典放在这里
})这对功能而言并非严格必需,但它可以在您之后在代码中使用该模式时防止类型错误。
精心编写的工具函数与详细的 JSON 模式相结合,为 Claude 在对话中理解并正确使用您的工具提供了所需的一切。