
構造化出力とは、モデルの回答を開発者が指定したJSONスキーマどおりに固定する機能です。JSONモードとの違い、OpenAI公式が公表した評価値、使う場面を整理します。
読み方:こうぞうかしゅつりょく。構造化出力(Structured Output)とは、大規模言語モデル(LLM)の回答を、開発者が指定したJSONスキーマどおりに固定する機能です。このページでは、定義、JSONモードとの違い、公式に公表された評価値、実務での使いどころを整理します。
OpenAIは2024年8月、APIにStructured Outputsを導入したと発表しました。これは「モデルの出力が、開発者が渡したJSONスキーマに確実に従う」ことを目的とした機能です。発表記事は、開発者がシステム間の連携のために出力形式をそろえようと、プロンプトの工夫やリトライで対処してきた経緯を踏まえ、スキーマへの制約でこの問題を解く方針を説明しています。
JSONモードは、出力を「文法的に正しいJSON」にする機能でした。発表記事は、JSONモードは正しいJSONの生成には役立つものの、出力が特定のスキーマに従うことを保証しないと説明しています。構造化出力はそこから一歩進み、「必須の項目がそろっている」「型が指定どおりである」というレベルまで制約します。
| 方式 | 保証されること | 保証されないこと |
|---|---|---|
| 通常の生成 | 自然な文章が返ること | 形式そのもの |
| JSONモード | 出力が正しいJSONになること | 指定スキーマへの一致 |
| 構造化出力 | 指定スキーマへの一致 | 項目の内容が正しいこと |
注意すべきは、構造化出力が保証するのは「形」であって「中身の正しさ」ではない点です。値自体が誤っている場合は、ハルシネーション対策として別の検証が必要です。
発表記事によれば、複雑なJSONスキーマへの追従を測るOpenAI自身の評価で、Structured Outputsを有効にした新モデルは100%を達成し、比較対象の旧モデルは40%未満にとどまったとされています。これは開発者が指定したスキーマへの一致率を測った値であり、回答内容の正確さを測った値ではありません。
発表記事は、フォームへの入力用に自由文から項目を抜き出す処理や、最終回答と補足説明を分けて返す処理、ユーザーの意図に合わせて画面を動的に組み立てる処理を例として挙げています。社内ツールでモデルの出力をスプレッドシートやデータベースに流し込む場合も、項目の抜け落ちが減るため取り回しが良くなります。
実装上は2つの入り口が用意されています。1つは道具を呼び出す定義に厳密モードを設定する方法、もう1つは応答形式のパラメータにスキーマを渡す方法です。前者は道具の利用と組み合わせる場合に使います。道具を呼ぶ仕組みそのものは、ツール利用(Tool Use)とファンクションコーリングのページで解説しています。
スキーマを複雑にしすぎると、モデルの追従率や応答速度に影響が出ることがあります。必須項目は必要最小限にし、入れ子の深さを抑えた設計から始めるのが安全です。また、スキーマどおりの形が返ってきても、項目の値が目的に合っているかは別の検証で確認してください。出力の検証工程の設計は、出力ガードレールを扱ったガイドも参考になります。
APIで出力形式を固定する機能は、開発者向けの提供が中心です。料金と提供条件は各サービスの公式情報で確認してください。
出典:OpenAI「APIにStructured Outputsを導入」(2024年8月6日)。JSONモードとの違い、2つの実装方式、評価での100%と40%未満という数値、挙げられた利用例は同記事の記載に基づきます。
本記事にはアフィリエイトリンクを含む場合があります。経由での申し込み時に当サイトが報酬を受け取ることがありますが、掲載内容・評価は報酬の有無に左右されません。記載情報は公開時点のものであり、最新情報は各公式サイトをご確認ください。
編集部の評価方法論を見る →