Claude Fable 5.2 構造化出力:強制的なツール使用なしで信頼性の高いJSONを生成
Claude Fable 5.2を使用して、JSON出力、厳密なツール使用、ローカルセマンティック検証により、スキーマに準拠したJSONと信頼性の高いツールパラメータを生成します

Claude Fable 5.2は、tool_choiceをanyまたは名前付きtoolに設定した強制ツール選択をサポートしておらず、そのような設定では400エラーが返されます。これは信頼性の高い自動化を妨げるものではありません。必要な契約に適した機能を使用してください。
- JSON出力はモデルの最終応答を制約します。
- 厳格なツール使用は、Claudeが選択して行うツール呼び出しの名前と入力を検証します。
- エージェントが信頼性の高い関数パラメータと構造化された最終結果の両方を必要とする場合に使用します。
スキーマの妥当性は、事実やビジネス上の妥当性を意味しません。アプリケーションは、権限、識別子、日付、合計、およびアクションが許可されているかどうかを引き続き確認する必要があります。
オプション1: JSON出力
レスポンス自体がJSONスキーマに従う必要がある場合は、output_config.formatを使用してください。
from anthropic import Anthropic
client = Anthropic()
schema = {
"type": "object",
"properties": {
"リスクレベル": {
"type": "string",
"enum": ["低い", "中", "高い"]
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"claim": {"type": "string"},
"source": {"type": "string"}
},
"必須": ["請求", "ソース"],
"additionalProperties": False
}
}
},
"required": ["risk_level", "所見"],
"additionalProperties": False
}
= client.messages.create(
model="claude-fable-5-2",
max_tokens=4096,
messages=[{
"role": "ユーザー",
"content": "提供された変更ログを評価し、各所見の根拠を引用してください。"
}],
output_config={
"format": {
"type": "json_schema",
"schema": スキーマ
}
}
)
現在の本番フィールドは output_config.format です。古いベータ版の例では output_format を使用している場合があります。移行コードをコピーするのではなく、SDKとリクエストの形状を更新してください。
オプション2: 厳格なツール使用
ツール定義に strict: true を設定すると、Claude がツールを呼び出す際にツールの入力がそのスキーマと一致することを保証します。tool_choice は auto のままにしてください。
tools = [{
"name": "create_review_ticket",
"description": "ユーザーが承認した後にのみレビューチケットを作成します。",
"strict": True,
"input_schema": {
"type": "object",
"properties": {
"title": {"type": "string"},
"severity": {
"type": "string",
"enum": ["低い", "中", "高い"]
},
"evidence_ids": {
"type": "配列",
"items": {"type": "string"}
}
},
"required": ["タイトル", "重大度", "evidence_ids"],
"additionalProperties": False
}
}]
厳格性は形状を保証するものであり、認可を保証するものではありません。サーバーは、ユーザーがアクションを承認したことと、各証拠IDが存在することを依然として確認する必要があります。
強制的なツール使用を軽率にシミュレートしないでください
現在のターンで特定のツールが必要な場合は、モデルに明確に指示し、利用可能な場合はサポートされている会話中のシステムガイダンスを使用してください。その後、オーケストレーションレイヤーで期待される呼び出しが行われたことを確認する必要があります。フォールバックとして自由形式のテキストを実行しないでください。
もし本当の要件が「有効なJSONを返すこと」なら、偽のツールを発明する代わりにJSON出力を使用してください。
モデルとアプリケーションの信頼性のための設計スキーマ
スキーマを狭く保つ
意味のある列挙型、必須フィールド、および additionalProperties: false を使用してください。任意のコンテンツを隠すことができる汎用的な「メタデータ」オブジェクトは避けてください。
証拠と結論を分離する
発見内容とともに、情報源の識別子または抜粋を要求します。証拠が伴わない場合、有効な high 値であってもサポートされません。
不確実性を明示的に表現する
status: confirmed | inferred | unresolved のようなフィールドを使用し、不確かな証拠を強制的に確定論理値に変換しないでください。
解析後にセマンティクスを検証する
アプリケーションコードで範囲、データベースの存在、権限、通貨の一貫性、およびクロスフィールドルールを確認してください。現在のStructured OutputsサポートにはJSON Schemaの制限があり、再帰スキーマの非対応や数値、文字列、配列、正規表現の制約が制限されています。
キャッシュとトークンの考慮事項
Structured Outputsは、システムプロンプトにフォーマットガイダンスを注入するため、入力トークンがわずかに増加します。output_config.formatを変更すると、その会話のプロンプトキャッシュが無効になります。スキーマのバージョン管理を行い、リクエストごとにわずかに異なるスキーマが生成されるのを避けてください。
暗号化キーの制限
Anthropicは、顧客管理の暗号化キーを使用する組織は、Claude Fable 5.2またはMythos 5.2でStructured Outputsを使用できないことを文書化しています。これにはJSON出力と厳格なツール使用が含まれます。その構成では、自動ツール選択を使用し、strictを省略し、入力をローカルで検証し、安全な再試行または修復パスを設計してください。
エラーハンドリング戦略
- スキーマを送信する前に検証してください。
- サポートされていないスキーマ機能は、一時的な障害ではなく、開発エラーとして扱います。
- APIの結果を確認した後にのみ、レスポンスを解析してください。
- ビジネスルールをローカルで検証する。
- JSONがパースされたという理由だけでツールを実行してはいけません。
- ログスキーマのバージョンとリクエストID。
よくある質問
なぜ tool_choice: {"type":"ツール"} Fable 5.2 で失敗する?
強制された tool および any の選択肢はサポートされていません。厳格なツール使用、JSON出力、またはサポートされているオーケストレーション指示とともにautoを使用してください。
有効なJSONは回答が正しいことを意味しますか?
いいえ。それは形式を保証するものであり、真実性、証拠、承認、または安全なビジネス行動を保証するものではありません。
JSON出力と厳格なツールは併用できますか?
はい、アカウント設定が構造化出力をサポートしている場合です。これらはインタラクションの異なる部分を制御します。


















































































































