読み込み中
読み込み中

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

JSON Schemaを理解する

JSON SchemaはAIやツール呼び出しに特化したものではなく、長年にわたって広く使われてきたデータ検証の仕様です。AIコミュニティがこれを採用したのは、関数の引数を記述し、データを検証するための便利な方法だからです。

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

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

  • name - ツールの明確でわかりやすい名前(「get_weather」のような)
  • description - そのツールが何をするか、いつ使うべきか、そして何を返すか
  • input_schema - 関数の引数を記述する実際のJSONスキーマ

効果的な説明文を書く

ツールの説明文は、Claudeがその関数をいつ使うべきかを理解するうえで極めて重要です。ベストプラクティスには以下が含まれます。

  • ツールが何をするかを説明するのに3〜4文を目安にする
  • Claudeがいつそれを使うべきかを記述する
  • どのような種類のデータを返すかを説明する
  • 各引数について詳細な説明を提供する

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

スキーマを生成する簡単な方法

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

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

プロンプトは次のようなものにするとよいでしょう。「この関数についてツール呼び出し用の有効なJSONスキーマ仕様を書いてください。添付のドキュメントに記載されているベストプラクティスに従ってください。」

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

コードにスキーマを実装する

Claudeがスキーマを生成したら、それをコードファイルにコピーします。以下の命名パターンに従うとよいでしょう。

python
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型をインポートして使用します。

python
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でスキーマを使用する際の型エラーを防ぎ、コードの堅牢性を高めることができます。