ツール関数を書いたら、次のステップは、Claudeに対してその関数がどのような引数を期待し、どのように使用すればよいかを伝えるJSONスキーマを作成することです。このスキーマは、Claudeがいつ、どのようにツールを呼び出せばよいかを理解するために読み込むドキュメントとして機能します。
JSON Schemaを理解する
JSON SchemaはAIやツール呼び出しに特化したものではなく、長年にわたって広く使われてきたデータ検証の仕様です。AIコミュニティがこれを採用したのは、関数の引数を記述し、データを検証するための便利な方法だからです。

完全なツール仕様には、3つの主要な部分があります。
- name - ツールの明確でわかりやすい名前(「get_weather」のような)
- description - そのツールが何をするか、いつ使うべきか、そして何を返すか
- input_schema - 関数の引数を記述する実際のJSONスキーマ
効果的な説明文を書く
ツールの説明文は、Claudeがその関数をいつ使うべきかを理解するうえで極めて重要です。ベストプラクティスには以下が含まれます。
- ツールが何をするかを説明するのに3〜4文を目安にする
- Claudeがいつそれを使うべきかを記述する
- どのような種類のデータを返すかを説明する
- 各引数について詳細な説明を提供する

スキーマを生成する簡単な方法
JSONスキーマをゼロから書く代わりに、Claude自身を使ってスキーマを生成することができます。手順は次の通りです。
- ツール関数のコードをコピーする
- Claudeに行き、ツール呼び出し用のJSONスキーマを書くように依頼する
- コンテキストとしてツール使用に関するAnthropicのドキュメントを含める
- Claudeにベストプラクティスに従った適切な形式のスキーマを生成させる
プロンプトは次のようなものにするとよいでしょう。「この関数についてツール呼び出し用の有効なJSONスキーマ仕様を書いてください。添付のドキュメントに記載されているベストプラクティスに従ってください。」

コードにスキーマを実装する
Claudeがスキーマを生成したら、それをコードファイルにコピーします。以下の命名パターンに従うとよいでしょう。
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)
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": []
}
}function_nameの後にfunction_name_schemaを続けるパターンを使うことで、スキーマを整理しやすく、対応する関数と対応付けやすくなります。
型安全性を追加する
より優れた型チェックのために、AnthropicライブラリからToolParam型をインポートして使用します。
from anthropic.types import ToolParam
get_current_datetime_schema = ToolParam({
"name": "get_current_datetime",
"description": "Returns the current date and time formatted according to the specified format",
# ... 残りのスキーマ
})機能面で厳密に必要というわけではありませんが、これによりClaudeのAPIでスキーマを使用する際の型エラーを防ぎ、コードの堅牢性を高めることができます。