読み込み中

ツールスキーマ

レッスン 247 分
読み込み中

ツール関数を作成したら、次のステップはJSONスキーマを作成することです。このスキーマは、あなたの関数が期待する引数と、その使用方法をClaudeに伝えます。このスキーマはドキュメントとして機能し、Claudeはこれを読んで、いつ、どのようにツールを呼び出すべきかを理解します。

JSON Schemaを理解する

JSON SchemaはAIやツール呼び出しに特化したものではありません。これは何年も前から存在する、広く使われているデータ検証仕様です。AIコミュニティがこれを採用したのは、関数のパラメータを記述し、データを検証するのに便利な方法だからです。

get_weatherツール用のJSONスキーマ: input_schemaは必須の文字列プロパティ「location」を持つオブジェクトです。

完全なツール仕様には、3つの主要な部分があります。

  • name - 関数名(「get_weather」のような)
  • description - ツールが何をするか、いつ使用するか
  • input_schema - 引数を記述する実際のJSONスキーマ

効果的な説明文を書く

name、description、および必須のlocation文字列を記述するinput_schemaを持つ、注釈付きget_weatherツールスキーマ。

description(説明)フィールドは、Claudeにツールを理解させるうえで極めて重要です。以下のベストプラクティスに従ってください。

  • そのツールが何をするか、いつ使うか、何を返すかを説明する
  • 3〜4文を目安にする
  • 各引数についても詳細な説明を提供する

input_schemaセクションでは、標準的なJSON Schemaフォーマットを使って、関数のパラメータを型情報とともに、各引数の詳細な説明とともに記述します。

簡単な方法:Claudeにスキーマを書かせる

JSONスキーマをゼロから書く代わりに、Claude自身を使って生成することができます。手順は以下の通りです。

  1. ツール関数をコピーする
  2. Claudeにアクセスし、ツール呼び出し用のJSONスキーマを書くよう依頼する
  3. コンテキストとして、ツール使用に関するAnthropicのドキュメントを含める
  4. Claudeにベストプラクティスに沿った適切な形式のスキーマを生成させる

メッセージボックスにプロンプトとget_current_datetime関数が入力された、Claude.aiの新しいチャットと、ツール使用ドキュメントのタブ。

プロンプトは次のようなものにすべきです。「この関数のツール呼び出しを目的とした、有効な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が会話内でツールを理解し、正しく使用するために必要なすべてが揃います。