厳密なツール使用

ツール定義に strict: true を設定すると、モデルのトークンサンプリングをスキーマに適合する出力に制約する手法（「grammar-constrained sampling」（文法制約サンプリング）と呼ばれる技術）により、Claudeのツールインプットが指定したJSON Schemaに一致することが保証されます。このページでは、厳密モードがエージェントにとって重要な理由、有効化の方法、一般的なユースケースについて説明します。サポートされているJSON Schemaのサブセットについては、JSON Schemaの制限事項を参照してください。非厳密なスキーマのガイダンスについては、ツールの定義を参照してください。

厳密なツール使用はツールパラメータを検証し、Claudeが正しく型付けされた引数で関数を呼び出すことを保証します。以下が必要な場合に厳密なツール使用を使用してください。

• ツールパラメータの検証
• エージェント型ワークフローの構築
• 型安全な関数呼び出しの保証
• ネストされたプロパティを持つ複雑なツールの処理



厳密なツール使用がエージェントにとって重要な理由

信頼性の高いエージェントシステムを構築するには、スキーマ準拠の保証が必要です。厳密モードがない場合、Claudeは互換性のない型（2 の代わりに "2"）を返したり、必須フィールドを省略したりして、関数が壊れ、ランタイムエラーが発生する可能性があります。

厳密なツール使用は型安全なパラメータを保証します。

• 関数は毎回正しく型付けされた引数を受け取ります
• ツール呼び出しの検証と再試行が不要です
• 大規模でも一貫して動作する本番環境対応のエージェント

たとえば、予約システムが passengers: int を必要とするとします。厳密モードがない場合、Claudeは passengers: "two" や passengers: "2" を提供する可能性があります。strict: true を使用すると、レスポンスには常に passengers: 2 が含まれます。



クイックスタート

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "strict": True,  # Enable strict mode
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA",
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either 'celsius' or 'fahrenheit'",
                    },
                },
                "required": ["location"],
                "additionalProperties": False,
            },
        }
    ],
)
print(response.content)

レスポンス形式: response.content[x].input に検証済みのインプットを含むツール使用ブロック

{
  "type": "tool_use",
  "name": "get_weather",
  "input": {
    "location": "San Francisco, CA"
  }
}

保証:

• ツールの input は input_schema に厳密に従います
• ツールの name は常に有効です（提供されたツールまたはサーバーツールから）



仕組み



一般的なユースケース



データ保持

厳密なツール使用は、構造化出力と同じパイプラインを使用して、ツールの input_schema 定義を文法にコンパイルします。ツールスキーマは最後の使用から最大24時間、一時的にキャッシュされます。プロンプトとレスポンスはAPIレスポンスを超えて保持されません。

厳密なツール使用はHIPAA対象ですが、PHIをツールスキーマ定義に含めてはいけません。APIはコンパイルされたスキーマをメッセージコンテンツとは別にキャッシュし、これらのキャッシュされたスキーマはプロンプトやレスポンスと同じPHI保護を受けません。input_schema のプロパティ名、enum 値、const 値、pattern 正規表現にPHIを含めないでください。PHIはメッセージコンテンツ（プロンプトとレスポンス）にのみ含めるべきであり、そこではHIPAAの保護措置の下で保護されます。

すべての機能におけるZDRおよびHIPAAの適格性については、APIとデータ保持を参照してください。



次のステップ