メインコンテンツへスキップ
見出し画像

AIに「空欄」を推測させない――不明・未確認・非開示・該当なしを分ける欠損理由契約

    設計書の「タイムアウト」欄が空白だったとします。

    AIはこれを、0秒、製品の既定値、未設定、未確認、該当なしのどれとして扱うべきでしょうか。

    人なら周辺の文章や経験から保留できても、RAGやAIエージェントは空欄を都合よく補い、もっともらしい回答へ変えてしまうことがあります。逆に、すべてを「不明」として止めれば、使える既定値まで活用できません。

    必要なのは「空欄を埋めない」という注意書きだけではありません。なぜ値がないのか、その理由ならAIは何をしてよいのかを、値とは別のデータとして持つことです。

    この記事では、大企業の設計文書、構成情報、ナレッジグラフをAIで扱う社内SE、設計管理、データ/AI基盤担当者向けに、欠損理由を契約化する「Missingness Contract」を整理します。

    空欄は、一つの状態ではない

    「値がない」は、少なくとも次の七つに分かれます。

    • unknown:本来は値があるが、現時点で分からない。AIは推測せず、根拠不足として返す。

    • not-asked:まだ確認していない。確認タスクを起票する。

    • asked-unknown:確認したが、確認先も分からない。上位の責任者や別資料へエスカレーションする。

    • temp-unknown:後で確定する見込みがある。期限まで保留し、再取得する。

    • declined-or-masked:回答拒否、権限、プライバシー等で見せられない。迂回推測せず、非開示として扱う。

    • not-applicable:その対象には値自体が存在しない。エラーにせず、集計対象から除外する。

    • unsupported-or-error:元システムが保持できない、または取得処理に失敗した。連携またはデータ品質の障害として扱う。

    この区別がないと、同じ空欄が正反対の動作を引き起こします。

    例えば「暗号化方式」がnot-applicableなら、その機能には暗号化対象がないのかもしれません。unknownなら、設計確認が終わるまでリリース判定を止めるべきです。maskedなら、一般利用者へは見せず、権限のあるレビュアーだけが確認します。

    見た目が同じでも、判断は同じではありません。

    値と欠損理由を、別の事実として持つ

    JSON Schemaの公式解説でも、必須プロパティが存在しないことと、プロパティの値がnullであることは同じではありません。型がstringなら、nullを入れても有効な文字列にはなりません。

    設計情報でも、次のように分けます。

    • 値が存在するか

    • 値が存在しないなら、理由は何か

    • その理由は、どの根拠から判断したか

    • AIは推論、既定値適用、質問、停止のどれを行えるか

    「値」の列へunknownやN/Aという文字列を混ぜると、検索、型検証、集計が崩れます。値と状態は別の項目にします。

    Missingness Contractの7項目

    既存の設計書や台帳へ、最初から大規模なオントロジーを導入する必要はありません。影響の大きい項目から、次の七つを定義します。

    1. Expectedness

    その値が必須、任意、条件付き必須のどれかを決めます。

    条件付き必須なら、「外部通信がある場合だけ接続先が必須」のように条件を機械判定できる形へ落とします。単にoptionalとすると、未記入と該当なしが混ざります。

    2. Absence Reason

    値がない場合に選べる理由コードを定義します。自由記述だけにせず、unknown、not-asked、not-applicableなどを列挙します。

    3. Evidence

    理由を判断した根拠を残します。文書名だけでなく、版、ページ、見出し、レコードID、取得クエリなど、後から再確認できる位置が必要です。

    4. Observed At / Valid At

    いつ観測した状態かと、いつの業務状態に有効かを分けます。

    今日確認してunknownだった値が、来月もunknownとは限りません。temp-unknownには再確認期限が必要です。

    5. Inference Policy

    AIが既定値を入れてよいか、明示的に決めます。

    • forbidden:推論禁止

    • allowed-with-marker:派生値だと表示し、規則と版を残す場合だけ許可

    • default-only:承認済み既定値だけ許可

    • human-confirmation-required:候補提示まで。確定は人が行う

    6. Downstream Treatment

    欠損理由ごとに、検索回答、集計、承認、実行での扱いを決めます。

    unknownを0として集計しない。not-applicableを品質エラー件数へ含めない。maskedを「存在しない」と回答しない。業務によって変わるため、理由コードだけでなく処理規則まで必要です。

    7. Resolution Owner / Due

    誰が、いつまでに状態を解消するかを持ちます。

    not-askedやtemp-unknownは、担当者と期限がなければ永久に残ります。一方、not-applicableは解消対象ではありません。理由によってワークフローも分けます。

    記入例:タイムアウト欄が空白だった場合

    API設計書の「応答タイムアウト」が空白だったとします。空欄のままRAGへ入れると、AIは一般的な30秒を答えるかもしれません。

    Missingness Contractでは、次のように記録します。

    • field:api.response_timeout_seconds

    • expectedness:本番利用時は必須

    • value:値なし

    • absence_reason:not-asked

    • evidence:API設計書 v3.2「通信制御」節に記載なし

    • observed_at:2026-10-14

    • inference_policy:human-confirmation-required

    • downstream_treatment:本番承認を保留。AIは候補値を確定回答しない

    • owner / due:API設計責任者/次回レビュー前

    ここで大切なのは、30秒という候補を出すことと、30秒が設計上の事実であることを分けることです。

    候補を提示するなら、「一般的な値からの推測」であること、採用根拠、承認者、適用した規則の版を残します。承認前の派生値を、元設計書に書かれていた値として扱ってはいけません。

    既定値を使うなら、派生した事実として残す

    W3Cが2026年10月13日に公開したSHACL 1.2 Core Working Draftには、構造制約に加え、値がない場合のsh:defaultValueなどが含まれます。2026年9月17日公開のSHACL 1.2 Inference Rules First Public Working Draftは、既定値や計算値を暗黙のトリプルとして導出する扱いを説明しています。

    ただし、これは草案です。また、技術的に既定値を導出できることと、元データにその値が記録されていたことは別です。

    既定値を使う場合は、少なくとも次を残します。

    • asserted_or_derived:原文の値か、派生値か

    • derivation_rule:どの規則で導出したか

    • rule_version:規則の版

    • derived_at:導出時刻

    • evidence:元データと適用条件

    • approval_state:業務上の利用が承認済みか

    例えば「再試行回数が未設定なら3回」という規則があっても、すべてのAPIへ無条件に適用できるとは限りません。外部決済、非同期処理、冪等性の有無など、条件を形状やルールに含める必要があります。

    JSON SchemaとSHACLへ落とすときの考え方

    JSONで管理するなら、値と欠損理由を兄弟項目にします。概念的には次の形です。

    {
    	"field": "api.response_timeout_seconds",
    	"value": null,
    	"absenceReason": "not-asked",
    	"inferencePolicy": "human-confirmation-required",
    	"evidence": "API design v3.2 / communication control",
    	"observedAt": "2026-10-14"
    }
    

    検証ルールは、少なくとも次の五つです。

    1. valueがあるとき、absenceReasonを同時に持たせない

    2. 必須項目でvalueがないとき、許可されたabsenceReasonを必須にする

    3. not-applicableには、適用対象外と判断した条件を求める

    4. derived valueには、規則IDと規則版を必須にする

    5. maskedには、AIが追加取得や迂回推測をしないポリシーを結び付ける

    RDFやKnowledge Graphなら、SHACLのsh:minCount、sh:or、sh:in、sh:closedなどで形状を表せます。ただし、Open Worldを前提とするグラフでは、トリプルがないことが「偽」や「該当なし」を意味するとは限りません。必要な場面だけClosedな検証境界を設け、値または欠損理由のどちらかが必要だと明示します。

    欠損理由は、集計の分母も変える

    欠損理由の設計は、AIの回答品質だけの話ではありません。

    例えば、設計レビュー100項目のうち20項目が空欄だったとします。

    • not-applicableが10件

    • not-askedが5件

    • temp-unknownが3件

    • maskedが2件

    これを「未記入20件」と集計すると、品質の判断を誤ります。

    not-applicableは分母から除外するのか。maskedは品質上完了だが一般画面では非表示なのか。temp-unknownは期限内なら許容するのか。not-askedはレビュー未実施として扱うのか。

    同じ理由コードでも、指標の目的によって分母や警告レベルは変わります。だからMissingness ContractにはDownstream Treatmentが必要です。

    30分で始めるなら、影響の大きい5項目だけ選ぶ

    全設計項目を一度に整理しようとすると止まります。最初は、AIが誤推測すると判断や実行へ影響する五項目を選びます。

    例えば、接続先、タイムアウト、データ分類、承認者、適用開始日です。

    1. 既存文書で空欄、null、N/A、ハイフンになっている箇所を集める

    2. 七つの欠損理由へ分類する

    3. 理由ごとにAIの動作を「回答可/候補のみ/停止/確認へ」に分ける

    4. 必須なのに理由がないレコードを検証エラーにする

    5. 一週間後、unknownとnot-askedの残件、誤推論、確認工数を見直す

    最初の成功条件は、空欄をゼロにすることではありません。AIが分からないことを、分からないまま正しく扱えることです。

    「空欄を埋める」から「欠け方を設計する」へ

    AIに設計情報を読ませるとき、値だけを整備しても十分ではありません。

    値がない理由、推論してよい条件、止めるべき処理、再確認する責任者まで設計して初めて、空欄は判断可能な状態になります。

    要点は三つです。

    • 値と欠損理由を別の事実として持つ

    • 既定値や推論値は、元の事実と混ぜず規則・版・証拠を残す

    • 欠損理由ごとに、AIの許可動作と下流処理を決める

    空欄を消すことが目的ではありません。値がなくても、次の正しい行動を選べる状態を作ることが目的です。


    設計書へ用途・正解例・禁止事項・定義・証跡を添える全体像は、AIに設計書の意味を推測させない――用途・正解例・禁止事項を添えるSemantic Contractで整理しています。

    RAGが「最新版」ではなく、実際に有効な設計書を選ぶためのメタデータは、設計書RAGに「最新版」を聞いてはいけない――AIが有効な文書を選ぶ6つのメタデータをご覧ください。

    このアカウントでは、大企業の生成AI活用で曖昧になりやすい権限、承認、証跡、変更影響、設計情報の意味を、実務で再利用できる判断表やテンプレートへ変えて発信しています。同じ課題に向き合っている方は、次の記事も追えるようフォローしていただけるとうれしいです。

    参考資料

    (情報確認日:2026年10月14日)

     
     
    ユーザー企業の立場から、生成AI活用、社内SE、システム企画・設計を考えます。AIエージェントの権限・検証・運用や設計情報の活かし方を、実務で使える判断基準として整理します。

    あなたへのおすすめ