Skip to Content
Docsサンプルコードstructured-output — 構造化出力とバリデーション・リトライ(Python)

structured-output — 構造化出力とバリデーション・リトライ(Python)

LLM に JSON で答えさせ、スキーマ検証 → 失敗ならエラーを添えて作り直しという最小の構造化出力LLM の出力を JSON Schema などの機械可読なスキーマに従わせる技術。後続の処理がコードである出力(分類・抽出・スコア)に使う。パイプラインを示すサンプルです。次のドキュメントの内容を実装しています。

このサンプルの要点

  • 形式はコードで検証できる: 必須キー・型・許容値の検証を関数にし、通らなければリトライします
  • リトライにはエラー内容を添える: 「なぜ不正だったか」を次のプロンプトに入れると、修正されやすくなります
  • LLM 呼び出しを 1 モジュールに隔離: llm_client.py にまとめ、--mock ではダミー応答、実 API では Anthropic SDK と差し替えます

前提

  • Python 3.11 以降(--mock は追加依存なし・標準ライブラリのみで動きます)
  • 実 API 実行時のみ: Anthropic API キー(環境変数 ANTHROPIC_API_KEY)と pip install -r requirements.txt

実行

# モック実行(API キー不要・依存インストール不要)
python structured_output.py --mock
 
# 実 API 実行(要 ANTHROPIC_API_KEY)
python -m venv .venv && source .venv/bin/activate   # Windows は .venv\Scripts\Activate.ps1
pip install -r requirements.txt
python structured_output.py

モック実行では、1 回目にわざと不正な出力(許容外の priority)を返し、検証で弾いて 2 回目で修正される様子が確認できます。

動作確認日

以下は過去の確認記録です。

  • モック実行(--mock): 2026-10-03 に確認(Python 3.12.14、追加依存なし。試行1 NG→試行2 OK、終了コード0)
  • SDK 回帰テスト: 2026-09-10 に確認(anthropic 1.4.0、httpx2 2.12.0 の HTTP モック)。打ち切り・拒否応答を通常の完成出力として返さないことを確認(実行手順)
  • 実 API 実行: 未確認(各自の環境で ANTHROPIC_API_KEY を設定して確認し、この欄に日付を追記してください)

TODO・未確認事項

モデルの選択

既定モデルは claude-opus-5-5 です(モデル仕様確認: 2026-10-03)。環境変数 ANTHROPIC_MODEL で上書きできます。PowerShell では $env:ANTHROPIC_MODEL = "claude-sonnet-5-5"、POSIX シェルでは export ANTHROPIC_MODEL=claude-sonnet-5-5 を実行してから起動します。--mock は API を呼びません。モデル移行時は強制ツール指定・思考履歴・出力上限の互換性を確認してください。実 API の動作確認日は従来の記録を維持し、今回のモック回帰結果は作業記録に分けます。

rag-basics — 依存最小の RAG(Python)tool-use — ツール使用の最小 Agent ループ(Python)