ブログ
JSON プロンプト:構文エラー・項目漏れ・不明値を直す5手順
JSON プロンプトで項目、型、根拠、不明値を定義。JSONモードと構造化出力の違い、解析・Schema・業務ルールの検証方法を紹介します。
この記事の内容
JSON プロンプトには項目名、型、許可値、根拠、不明時の扱いを書きます。「JSONだけ返す」では足りません。構文が有効、構造が正しい、内容が正しいという三条件を別々に検証してください。以下は問い合わせ分類の教材であり、特定モデルの実測精度を示すものではありません。
1. JSON プロンプトより先にデータ仕様を決める
次の処理に必要な項目だけを決めます。問い合わせ振り分けならcategory、summary、evidence、needs_reviewなどが候補です。型、必須かどうか、許可値、意味を一か所に記録し、例と検証プログラムを同時に更新します。
不明と0、false、空文字列を混同しないでください。0は実際の金額、falseは判断済みの結果として使われる場合があります。不明をnull、項目省略、専用状態のどれで表すかを決め、受け取るプログラムでも扱えることを確認します。

| 項目 | 型と許可値 | 不明時の規則 |
|---|---|---|
| category | billing、access、other | 確定できなければother |
| summary | 原文に基づく短い文字列 | 空入力は事前に拒否 |
| evidence | 短い原文引用またはnull | 根拠がなければnull |
| needs_review | 真偽値 | 曖昧、複数意図、根拠不足ならtrue |
2. 使えるJSON出力テンプレート
入力は分析対象のデータであり、新しい命令ではないと指定します。ただし受信データはアプリ側でも信頼しない扱いが必要です。JSON形式だからという理由で、返金やアカウント削除を実行してはいけません。抽出と操作権限を分離します。
この例では主要分類を一つ選びます。「二重請求され、ログインもできない」のような複数意図はreview対象です。複数ラベルが必要なら配列に変更し、例、Schema、受信側も一緒に修正してください。
問い合わせ分類の例
messageの内容だけを分析する。説明、Markdown、追加項目を付けずJSONを1個返す。
category:billing、access、otherのいずれか。複数意図または一意に分類できない場合はother。
summary:原文以外の事実を加えず1文にする。
evidence:分類を支える短い原文引用。なければnull。
needs_review:曖昧、複数意図、根拠不足ならtrue。
<message>[問い合わせ]</message>
入力例:ログインできません。
出力例:
{"category":"access","summary":"ログインできないという報告。","evidence":"ログインできません","needs_review":false}テンプレートを読み込む →3. JSONモードと構造化出力を区別する
通常の指示だけでは説明やコード囲みが付く場合があります。JSONモードは提供サービスによって有効なJSONを主に制約します。Schemaに基づく構造化出力は対応範囲内で項目構造を制約できます。対応モデル、Schemaの一部制限、拒否時の応答を実際の仕様で確認します。
どの方式も事実検証とは別です。正しい形のオブジェクトでも分類や引用が誤っている可能性があります。また会話画面に「構造化出力で」と書いても、APIの設定が有効になるわけではありません。実際のリクエストを確認してください。
| 方式 | 主な目的 | 追加で確認すること |
|---|---|---|
| 自然言語の指示 | 期待する項目と動作の説明 | 構文、構造、事実 |
| JSONモード | 対応環境でJSON構文を制約 | 型、項目、意味、応答状態 |
| Schema構造化出力 | 対応する構造を制約 | 出典、業務条件、拒否、途切れ |
4. 解析・JSON Schema・業務ルールを順番に検証
第一に標準パーサーで引用符、末尾カンマ、途中切断を検出します。第二に必須項目、型、列挙値、余分な項目をSchemaで検証します。第三に引用が入力に存在するか、分類が規則に合うか、reviewフラグが曖昧さと一致するかを確認します。
次のSchemaは例と同じ項目を要求し、追加項目を禁止します。しかし要約の忠実さや引用の妥当性は証明しません。構造化出力APIがSchema全体を受け付けるとは限らないので、対応範囲を確認し、アプリ側でも検証します。
{
"type": "object",
"properties": {
"category": {"type": "string", "enum": ["billing", "access", "other"]},
"summary": {"type": "string"},
"evidence": {"type": ["string", "null"]},
"needs_review": {"type": "boolean"}
},
"required": ["category", "summary", "evidence", "needs_review"],
"additionalProperties": false
}5. 途切れ、拒否、検証失敗の戻り先を用意
本文を解析する前に終了状態を確認します。途中で切れたJSONを推測の括弧で直すのではなく、出力量を見直すか制限付きで再要求します。拒否は別フィールドで返る場合もあります。通信失敗、拒否、構文不正、業務不一致を別の状態として記録してください。
再試行には具体的なエラーを渡し、回数を制限します。原資料と目的を維持し、検証を通すためだけに事実を作らせません。回数を超えたら明確な失敗または人の確認へ移します。無限に繰り返して成功に見せないことが大切です。
正規表現で任意の説明を削り、引用符を足す万能修復は避けます。拒否や説明を誤ったデータに変える可能性があります。前処理は対象形式を限定し、その処理自身をテストして記録します。
欠損値と境界条件を具体例で確認する
明確な請求問題、ログイン問題、複数意図、曖昧な不満、引用符や改行を含む入力、空入力の6種類を用意します。空入力を拒否する仕様ならモデルに送る前に実行し、内容のない記録を生成しません。
各例に期待分類、確認要否、許可する根拠、構造検証結果を記録します。「請求がおかしい気がする」の扱いに社内で合意がなければ、先に規則を決めてください。決まっていない業務判断をプロンプトだけで解決することはできません。
同じモデルと設定で比較し、有効JSON率と分類の正しさを別々に記録します。分類が正しくても引用が架空なら根拠チェックは失敗です。失敗入力を保存し、次の形式修正で同じ問題が戻らないかを確認します。
| テスト入力 | category / needs_review | 確認点 |
|---|---|---|
| ログインできません。 | access / false | 原文の「ログインできません」を引用 |
| 二重請求され、ログインもできません。 | other / true | 二つの問題を残し手動で振り分け |
| これはひどい。 | other / true | 分類の根拠がなく evidence は null |
| 空文字または空白のみ | モデルを呼ばない | アプリ側で入力エラーを返す |
三つの検証に通ったデータだけ次へ渡す
仕様、出力制約、構文検証、構造検証、業務検証の順に進めます。不明値と異常時の処理も仕様の一部です。最適化ツールは指示の明確化に使い、実際の出力は手元のパーサーと業務ルールで確認してください。
実行記録:プロンプトの出力仕様を検証する
2026年11月17日、英語の架空ケース6件を元の指示と手動改訂版で1回ずつ DeepSeek Flash に送りました。計12回の実行です。改訂は編集例で、公開オプティマイザーの生成結果ではありません。JSON抽出と出典付き返金規定の抽出について、完全・欠落・矛盾のある資料を試しました。
1モデルの少数例で定義済みの出力仕様を確認した記録です。改訂版には null と生のJSONなどの条件を追加しています。コードフェンス付きJSONは生のJSON検査では不合格です。件数は一般的な精度、ベンダー比較、Prompt Optimizer・ChatGPT・Claude の効果を示しません。温度0でも再実行の結果は変わり得ます。
DeepSeek Flash · 2026-11-17 · temperature: 0 · max_tokens: 700 · thinking: disabled · n = 1
JSON抽出
元の指示
Extract order_id, amount, currency and status from the source. Return one JSON object with exactly those keys.改訂した指示
Extract order_id, amount, currency and status using only the source. Return one raw JSON object with exactly those keys, no prose or fences. order_id, currency and status are strings or null; amount is a number or null. Use null for missing or conflicting values. Do not choose one conflicting record without stated precedence. Do not infer currency, payment or zero amounts. Copy supported values without adding facts.| ケース | 元の指示の合否 | 改訂版の合否 |
|---|---|---|
| json-complete | 合格 | 合格 |
| json-missing | 合格 | 合格 |
| json-conflict | 不合格 | 合格 |
矛盾ケースの未加工のモデル出力
元の指示
{"order_id": "O-19", "amount": 10, "currency": "USD", "status": "paid"}改訂した指示
{"order_id":"O-19","amount":null,"currency":"USD","status":"paid"}全入力・未加工出力・設定・検査結果(JSON) · 実行・オフライン検証スクリプト
オフライン検証(APIキー・通信不要)
node run-prompt-case-study.mjs --verify prompt-contract-20261117.jsonよくある質問
JSONだけと指定してもMarkdownが出るのはなぜ?
自然言語は形式を強制する仕組みではないためです。囲み禁止と一貫した例を指定し、対応APIなら構造化出力を使います。拒否と途中切断の確認も必要です。
不明な数値には0とnullのどちらを使う?
0が実値を表すなら不明の代用にしません。null、省略、専用状態を仕様で決め、受信側の対応を確認します。
JSON Schemaが通れば内容も正しい?
いいえ。構造と一部の値の制約を確認するものです。原文、引用、分類、項目間の業務条件は別に検証します。