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

設計書RAGに「最新版」を聞いてはいけない――AIが有効な文書を選ぶ6つのメタデータ


    本番障害の原因を調べるため、設計書RAGへ「この機能の最新版の仕様は?」と聞いた。AIは、前日に更新された文書を根拠付きで返してきた。

    ところが、その文書はまだレビュー中だった。本番に適用されているのは、1か月前に承認された別の版だった。

    検索は成功しています。ファイルも新しい。引用元も示されています。それでも、答えは業務上の正解ではありません。

    設計書RAGで本当に選ぶべきなのは、単に新しい文書ではなく、質問された時点・対象システム・環境に対して有効な文書です。

    この記事では、社内SE、IT企画、アーキテクト、RAG基盤担当者向けに、「最新版」を「有効版」へ言い換えるための6つのメタデータと検索前ゲートを整理します。特定のベクトルDBやクラウド製品に依存しない、最小構成です。

    「最新版」には3つの時計がある

    設計書の新しさは、少なくとも3つに分かれます。

    • 更新日時:ファイルを最後に編集した時刻

    • 承認日時:責任者が正式な内容として承認した時刻

    • 適用日時:その内容が業務や本番環境で効き始める時刻

    この3つは一致するとは限りません。

    たとえば、10月7日に更新されたRev.7がレビュー中で、10月1日から本番へ適用されたRev.6が承認済みなら、10月8日の本番仕様を尋ねる質問にはRev.6を返すべきです。

    一方、11月リリースの検討にはRev.7が必要かもしれません。同じ質問文でも、対象時点と用途が変われば、参照すべき版も変わります。

    Microsoft SharePointでも、版履歴とコンテンツ承認は別の仕組みです。ファイルが編集されて新しい版になっても、承認待ちならPendingのままにできます。つまり、文書管理製品の側でも「新しい」と「承認済み」は同じ意味ではありません。

    RAGへ取り込むときに更新日時だけを残すと、この重要な違いが消えます。

    AIが有効版を選ぶための6項目

    最小構成として、文書または文書の版ごとに次の6項目を持たせます。

    • 文書ID・版ID:同じ設計対象のどの版か(例:PAY-IF-01 / Rev.6)

    • ライフサイクル状態:参照してよい状態か(例:Draft / Review / Approved / Retired)

    • 有効期間:いつから、いつまで効くか(例:2026-10-01〜2026-10-31)

    • 適用範囲:どのシステム・環境・リリースに効くか(例:本番 / Release 26.10 / 国内)

    • 置換関係:何を置き換え、何に置き換えられたか(例:Rev.5を置換、Rev.7候補あり)

    • 出典・承認証跡:誰が何を根拠に有効としたか(例:正本URL、承認ロール、承認日時)

    重要なのは、これらをファイル名や本文から毎回AIに推測させないことです。

    vFinal_最終_FIX2.xlsx という名前から正式版かどうかを判断させても、組織の承認事実にはなりません。状態と適用範囲は、人が管理する正本側で確定し、RAGはその値を使います。

    Document Validity Manifestの最小例

    既存の文書管理製品を全面刷新する必要はありません。まずは、検索基盤へ渡す付帯情報をそろえます。

    document_id: PAY-IF-01
    revision_id: rev-6
    title: 支払連携インターフェース設計
    lifecycle_status: approved
    approved_at: 2026-09-30T09:00:00+09:00
    approved_by_role: system_owner
    valid_from: 2026-10-01T00:00:00+09:00
    valid_to: 2026-10-31T23:59:59+09:00
    applies_to:
      system: payment-core
      environment: production
      release: "26.10"
      region: jp
    supersedes: rev-5
    source_uri: https://example.invalid/design/PAY-IF-01/rev-6
    checksum: sha256:...

    ここでは便宜上、これをDocument Validity Manifestと呼びます。製品名ではなく、文書の有効性を機械判定するための契約です。

    approved_at だけでは足りません。承認済みでも、来月から適用される文書なら今日の本番回答には使えないからです。

    applies_to も欠かせません。同じリリース番号でも、国内と海外、検証と本番、旧システムと新システムで仕様が異なることがあります。

    W3C PROV-Oには、情報が生成された時刻と無効になった時刻を分けて表す考え方があります。すべてをPROV-Oで実装する必要はありませんが、作成時刻だけで文書の寿命を表せないことを確認する参考になります。

    意味検索の前に「参照資格」を判定する

    メタデータを保存するだけでは、誤参照は減りません。検索順序を変えます。

    1. 質問から適用条件を取り出す

    質問に含まれる対象時点、システム、環境、リリース、地域を構造化します。

    足りない条件をAIが勝手に補ってはいけません。「本番ですか、検証環境ですか」「いつ時点の仕様ですか」と聞き返す対象です。

    2. 承認状態・有効期間・適用範囲で先に絞る

    lifecycle_status = approved であり、質問時点が valid_from と valid_to の間にあり、applies_to が質問条件と一致する文書だけを検索候補にします。

    Amazon Bedrock Knowledge BasesやGoogle Cloudの検索サービスは、文書メタデータによるフィルタを提供しています。クラウド製品が違っても、考え方は同じです。意味的に近い文書を探す前に、参照資格のない文書を検索空間から外します。

    3. 候補が複数なら衝突として扱う

    同じ対象・同じ期間に、承認済み文書が2つ残っている場合があります。

    ここでベクトル類似度が高い方をAIに選ばせると、文書管理の不整合を検索スコアで隠すことになります。これは回答生成の問題ではなく、正本管理の問題です。

    候補が一意に決まらないときは、回答を止めて管理者へ戻します。

    4. 残った集合に対して意味検索する

    参照資格を通った文書へ、ベクトル検索、キーワード検索、SQL、グラフ探索を適用します。

    この順序なら、意味検索は「どの文書が正式か」を決める責任から解放されます。検索方式は、正式と決まった情報の中で質問に合う箇所を探すことに集中できます。

    5. 回答に選択証跡を返す

    回答には本文の引用だけでなく、少なくとも次を返します。

    • 文書IDと版ID

    • 承認状態

    • 有効期間

    • 適用範囲

    • 正本へのリンク

    • 検索時点

    読者は「それらしい回答」ではなく、「なぜこの版が選ばれたか」を確かめられます。

    3つの文書をどう選ぶか

    次の状態を考えます。

    • Rev.7:更新日 10月7日/Review/11月1日から予定/本番・Release 26.11

    • Rev.6:更新日 9月30日/Approved/10月1日〜10月31日/本番・Release 26.10

    • Rev.5:更新日 8月20日/Retired/9月30日まで/本番・Release 26.09

    10月8日の本番仕様を尋ねられたら、Rev.6です。

    11月リリースのレビュー材料を尋ねられたら、Rev.7も候補になります。ただし、正式仕様として断定せず、Review中であることを明示します。

    9月15日時点の障害を調べるなら、Rev.5を参照します。Retiredだから削除するのではなく、過去時点の説明に必要な履歴として残します。

    「常に最新の1件だけを残す」設計では、この時間移動ができません。

    よくある失敗は、版数を増やすことでは防げない

    更新日時だけで降順に並べる

    レビュー中の文書や、将来適用予定の文書が先頭に来ます。更新日時は候補の鮮度には使えても、正式性の判定には使えません。

    ファイル名へ「最終」「確定」と書く

    命名規則は人間への補助です。承認者、承認日時、適用先を機械的に検証できないままでは、RAGにとって信頼できる状態値ではありません。

    古い文書をすべてインデックスから消す

    現在の質問には有効でも、過去障害、監査、旧リリースの問い合わせに答えられなくなります。削除ではなく、有効期間と検索条件で分けます。

    検索結果の上位1件を正本とみなす

    類似度は内容の近さです。承認や適用の正しさではありません。候補衝突を検知したら、人へ戻す必要があります。

    回答に版と適用範囲を出さない

    正しい文書を選べても、利用者が検証できません。引用箇所だけでなく、選択条件を回答へ含めます。

    導入は6問の棚卸しから始める

    既存の設計書群をRAGへ入れる前に、次を確認します。

    • □ 文書と版を一意に識別できるか

    • □ Draft / Review / Approved / Retiredを区別できるか

    • □ 有効開始日と終了日を持てるか

    • □ システム、環境、リリース、地域などの適用範囲を表せるか

    • □ どの版がどの版を置き換えたか追えるか

    • □ 回答から正本、承認、検索時点へ戻れるか

    すべてを最初から完璧に埋める必要はありません。ただし、値がないことと、AIに推測させることは別です。

    不明な項目は unknown として残し、その条件を必要とする質問では回答を止めます。「分からないので答えない」を設計できることが、企業内RAGの信頼性になります。

    「最新版を答えるAI」から「有効版を説明できるAI」へ

    設計書RAGの品質を上げるとき、チャンキングや埋め込みモデルの調整から始めたくなります。もちろん、それらも必要です。

    しかし、検索対象にDraft、旧版、将来版、別環境向けが混ざっているなら、検索精度だけでは正解を定義できません。

    先に決めるべきなのは、どの文書が、いつ、どこに対して有効なのか。そして、決められないときに止まる条件です。

    更新日時の新しさではなく、承認状態、有効期間、適用範囲、置換関係、証跡を検索前の規則へ変える。そこまで整って初めて、AIは設計書を「探す」だけでなく、参照すべき版を説明できるようになります。

    設計書同士の関係や変更影響をたどる考え方は、「設計書RAGは、なぜ『検索できるだけ』で止まるのか」で整理しています。文書の意味をAIへ推測させないための用途・正解例・禁止事項は、Semantic Contractの記事が次の一歩です。

    このアカウントでは、設計文書AI化、Semantic Design、大企業のAI運用を、概念紹介だけでなく判断基準・テンプレート・停止条件まで落として扱います。設計書をAIに読ませるだけで終わらせず、実務で任せられる状態を作りたい方は、今後の記事も続けて読んでください。

    参考にした一次情報

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

    あなたへのおすすめ