Structured output(構造化出力)
Structured output(構造化出力)とは、言語モデルの応答を、通常はJSONスキーマなど自分で定義した形式に従わせるAPIの機能です。自由なテキストから抜き出す代わりに、コードで確実に解析できます。
別名: JSON mode, JSON schema output, structured outputs
執筆 Divya Sharma · 2026年11月15日確認 · レビューの方法
モデルの回答をコードに渡す場合、自由なテキストは壊れやすいものです。括弧の欠落、余計な一文、フィールド名の変更でパーサーは壊れます。Structured outputは、モデルにスキーマを与え、APIがそれに一致する応答だけを返すようにすることでこれを解決します。
仕組み
リクエストとともに、フィールド、その型、必須のものを列挙したJSONスキーマを送ります。厳格なstructured outputに対応するプロバイダーは、制約付きデコーディングを使います。各ステップで、モデルは応答がスキーマに対して有効なままになるトークンしか生成できません。Anthropicのドキュメントは、これによりスキーマに準拠した応答が保証され、JSONの解析エラーがなく、必須フィールドが常に存在すると述べています。
JSONモードとスキーマによる出力の違い
単なる「JSONモード」は、構文的に有効なJSONを求めるだけです。応答は解析できますが、フィールドが欠けていたり型が違っていたりすることはありえます。スキーマに基づくstructured outputは、形も確認します。どちらもなければ、プロンプトエンジニアリング、検証、再試行に頼ることになります。
例
請求書の抽出ツールなら、取引先、日付、合計、通貨のフィール ドを定義するでしょう。モデルはちょうどそのキーを持つオブジェクトを返し、検証の後そのままデータベースに入れられます。
function callingとの違い
Function callingは、モデルにツールを選ばせ、その引数を埋めさせます。Structured outputは最終的な回答そのものの形を整えます。どちらもスキーマを使い、ツールの引数に厳格モードを用意しているプロバイダーもあります。
限界
形が有効でも、答えが正しいとは限りません。モデルは整った形のフィールドに誤った値やハルシネーションを入れることがあるため、形式だけでなく内容も確認してください。プロバイダーによって対応するJSON Schemaの範囲が異なるため、お使いのプロバイダーがどのキーワードを受け付けるかを確認してください。
関連用語
- ツール呼び出し
- ツール呼び出し(tool calling)は関数呼び出し(function calling)とも呼ばれ、モデル API の機能の 1 つです。スキーマで関数を記述すると、モデルはその 1 つを呼び出す構造化されたリクエストを返し、コードがそれを実行して結果を返します。
- プロンプトエンジニアリング
- プロンプトエンジニアリング(prompt engineering)とは、モデルの重みを変えずに、アプリケーションが必要とする出力を言語モデルが生成するよう、与える指示と例を書き、構成し、テストすることです。
- ハルシネーション(AI)
- ハルシネーション(hallucination)とは、流暢で自信ありげに聞こえるものの、誤っている、情報源に裏付けられていない、あるいは作り話である AI モデルの出力です。架空の引用文献、発言、統計、API の関数などがその例です。
- ガードレール(AI)
- ガードレール(guardrails)とは、言語モデルの周りに置く実行時のチェックです。入力と出力を調べ、ブロックしたり、書き換えたり、別の経路に回したりします。これにより、アプリケーションが話題から外れず、有害なコンテンツを避け、モデルだけでは確実に守れないルールに従うようにします。