Structured OutputsとJSON Schema
JSON Schemaとは、JSONのデータが持つべき項目、型、選べる値を定める形式です。OpenAIのStructured Outputs(構造化出力)では、このスキーマに合う出力を求められます。たとえば、振り分けの判断にqueueとpriorityを必ず含め、選べる値を限り、余分な項目を拒否するように決められます。JSONモードが「JSONとして読めること」を目指すのに対し、厳密なスキーマは形まで決めます。それでも、中身が正しいことまでは保証しません。
スキーマと意味
形の正しい判断でも、受け入れる前に、渡されたチケットの事実と照らし合わせてください。選ばれた優先度と食い違う事実がないかも確かめます。架空の機器の依頼なら、優先度highの振り分けには、稼働中の停止が起きていることが条件です。停止のフラグがfalseなのにhighを選ぶJSONは、形が正しくても拒否します。この業務のルールは、priorityが許された値の一覧に入っているかの確認とは別に持ちます。
提供元の取り決め
Responsesの構造化出力のガイド(英語、2026年11月14日に確認)では、形式の設定はtext.formatの下に書きます。response_formatを使うChat Completionsの例は、別のリクエストの形です。厳密なスキーマに対応していても、拒否や未完了の出力がなくなるわけではありません。
このノートブックは、簡略にしたモックの取り決めで練習します。結果を受け入れる前に、拒否と不完全なレスポンスとスキーマと業務の検証を練習してください。実際のスキーマのリクエストは送りません。