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

完全なツール仕様には、3つの主要な部分があります。
- 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のような一貫した命名パターンを使用してください。
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型をインポートして使用してください。
from anthropic.types import ToolParam
get_current_datetime_schema = ToolParam({
# ここにスキーマ辞書を記述
})これは機能面で厳密に必要というわけではありませんが、後でコード内でスキーマを使用する際の型エラーを防ぐことができます。
適切に書かれたツール関数と詳細なJSONスキーマを組み合わせることで、Claudeが会話内でツールを理解し、正しく使用するために必要なすべてが揃います。