毎回全文を読めない量になったら、質問に必要な根拠を取得します。原文 → 解析・分割 → 候補検索 → 選択 → コンテキスト → 回答を辿ります。設定が見つかっても例外条件まで取得したとは限らず、検索スコアと回答の根拠を別々に検証します。
外部証拠を生成に取り込む
RAG(Retrieval-Augmented Generation:検索拡張生成)は、生成の前または生成の過程で外部資料を取得し、モデルがそれらを利用して回答できるようにします。古典的な研究では、パラメータモデルと検索可能な非パラメータ知識を組み合わせました。エンジニアリングにおけるRAGでは、キーワード検索、SQL、ドキュメント読み取り、またはマルチターンツールクエリを使用することもでき、ベクトルデータベースに限定されるものではありません。Retrieval-Augmented Generation
これにより、資料の更新とモデルの重み更新が部分的に分離されましたが、生成モデルが重要でなくなるわけではありません。資料が存在しない場合、検索が重要な条件を見逃す場合、アセンブリが切り捨ててしまう場合、モデルが誤読する場合もあります。これらの各段階を個別に検証する必要があり、「答えの問題は必ず検索の問題だ」と事前に想定してはいけません。
少量の完全なドキュメントの場合、全文を直接提供した方が簡単であることが多く、特に章をまたいだ全体の判断が必要な場合に有効です。大規模で頻繁に更新される、または権限が細分化されたナレッジベースでは、必要に応じて資料を取得する方が制御が容易です。ファインチューニングは、動作、スタイル、またはドメインの処理方法を改善するために使用でき、検索と組み合わせても問題ありません。選択の基準はタスクと証拠の要件であり、「全文提供かファインチューニングか」という二者択一ではありません。
ドキュメントから検索可能な証拠へ
パースの品質がインデックスの内容を決定する
まず、本文、見出しの階層、テーブル、コード、および引用の位置を特定します。PDFの2段組での順序の乱れ、見出しの欠落、スキャン文字のOCRエラーは、ベクトル化の前に意味を損なう可能性があります。検索エンジンは、誤ってパースされた結果から、存在しない原文を復元できません。
各証拠ユニットには、ドキュメントID、バージョンまたはコンテンツハッシュ、セクションパス、原文の位置、アクセス範囲、および更新時間が保存されます。原文への位置特定は、チャンク分割の変更によって変化する「何番目のチャンク」に依存するだけでなく、当時のドキュメント内の具体的な内容に戻れるものでなければなりません。
チャンク分割は、完全性と選択精度の間の妥協点です
短いチャンクは正確なマッチングには優れていますが、指示語、定義、制限事項を見落とす可能性があります。長いチャンクは関係性を保持しますが、複数のトピックが混入したり、多くのコンテキストウィンドウを消費したりする可能性があります。セクション、段落、またはコード構造に基づいて分割するのが一般的な出発点ですが、固定長やオーバーラップの比率は、資料とタスクに応じて検証する必要があり、すべてのナレッジベースが200〜500トークンに適しているとは限りません。
実行可能な設計として、小さなチャンクで検索し、親セクションや近傍の段落で回答の証拠を提供する方法があります。例えば、設定項目にヒットした場合は、そのタイトル、テーブルヘッダー、および適用制限を補完します。オーバーラップは境界の分断を緩和しますが、重複ヒットを引き起こす可能性があります。コンテキストに取り込む前に重複を除去し、異なるバージョンが誤って1つの断片に合成されていないかを確認する必要があります。
「それにより10%増加した」といった、原文の文脈なしには理解しにくい断片に対しては、ドキュメントとセクションの背景を付記します。Contextual Retrieval のエンジニアリング事例では、断片にコンテキストを補完する方法で検索を改善しています。生成された背景も検証する必要があり、モデルが補足した説明を原文の事実として扱ってはなりません。Contextual Retrieval
embedding は表現を提供するが、意味の正確な理解を保証するものではない
密な検索(Dense Retrieval)は、クエリとドキュメントをベクトルにエンコードし、内積やコサイン類似度などの尺度に基づいてソートします。トレーニングの目標は、関連するクエリと証拠を対応する空間でより近くにすることですが、これは「意味が同じであること」を保証するものではありません。否定、正確な番号、バージョンの違いは依然として区別が難しい場合があります。
クエリとドキュメントは互いに互換性のあるエンコーディングスキームを使用する必要があります。必ずしも同じエンコーダーである必要はありません。双方向エンコーダーの設計では、問題と段落を別々にエンコードできますが、トレーニングと使用法が一致していることが前提です。Dense Passage Retrieval のモデルバージョン、ベクトル次元、正規化、およびクエリプロンプトの形式は記録する必要があります。エンコーディングスキームを変更する場合は、対応するインデックスを再生成する必要があります。同じ次元だからといって、同じ空間を意味するわけではありません。
全件走査と近似最近傍(ANN)インデックスの選択は、データ量、次元、フィルタリング、ハードウェア、およびレイテンシの目標によって異なります。「数万件なら必ず全件走査、百万件ならANN」という統一された閾値はありません。近似インデックスは候補の漏れも引き起こすため、インデックスのリコールとモデルの表現能力を分離して確認する必要があります。
リコール、融合、および証拠の選択
キーワードとベクトルは補完し合える
エラーコード、商品番号、関数名は、文字通りの一致を保持するのが適しています。ユーザーが言い換えを行った場合、意味的な表現がキーワードの漏れを補う可能性があります。BM25などの手法とベクトル検索のスコアは異なるスケールにあるため、キャリブレーションなしに直接加算することはできません。ランキングベースの融合を使用するか、検証セット上で重み付け方法をキャリブレーションする必要があります。
RRF(Reciprocal Rank Fusion)は、候補 d が各結果リストでランク r にある場合、1/(c+r) を累積します。リストに出現しない場合は貢献しません。c は平滑化定数であり、最終的に何件の結果を返すかとは異なるパラメータです。RRF 原始論文
キーワード結果が A, B, C、ベクトル結果が B, D, A で、c=60 と仮定します。B のスコアは 1/62 + 1/61 ≈ 0.03252、A は 1/61 + 1/63 ≈ 0.03227 となるため、B が A より上位になります。融合は、両方のパスが特定の項目をサポートしているというシグナルを利用しますが、B の内容が必ずしも正しいことを証明するものではありません。
from collections import defaultdict
from fractions import Fraction
lists = [["A", "B", "C"], ["B", "D", "A"]]
scores = defaultdict(Fraction)
for ranking in lists:
assert len(ranking) == len(set(ranking))
for rank, doc in enumerate(ranking, 1):
scores[doc] += Fraction(1, 60 + rank)
order = sorted(scores, key=lambda doc: (-scores[doc], doc))
assert order == ["B", "A", "D", "C"]
print([(doc, round(float(scores[doc]), 5)) for doc in order])
リランキングは、リコールされなかった材料を回復できない
cross-encoder によるリランキングは、クエリと候補コンテンツを結合して処理するため、通常は単一のベクトル類似度比較よりもコストが高くなります。そのため、候補数が少ない場合に頻繁に使用されます。これにより、リコールされたがランクが低かった正しい断片を最終的なコンテキストに含めることができますが、候補セット外のドキュメントを自動的に(何もないところから)追加することはできません。
候補数、リランキング後の数、およびコンテキストのトークン予算を個別に設定します。候補セットを拡大するとカバー率が向上する一方で、レイテンシも増加します。最終的な証拠を減らすとノイズが減少しますが、マルチホップ問題に必要な2番目の事実を見落とす可能性もあります。証拠のカバー率を中心に調整すべきであり、「50件投入、5件出力」といった固定の実行に依存すべきではありません。タスク横断的な検索評価でも、異なる検索手法のパフォーマンスはドメインやタスクに応じて変化することが示されています。BEIR
例えば、「部門AはインターフェースXを使用できるか」と問われた場合、権限ルール、Aのロールマッピング、およびXのバージョン制限のすべてが必要になる可能性があります。単一の断片の類似度が高くても不十分であり、システムは問題を分解するか、重要な関係に証拠があるまで検索を続ける必要があります。資料を取得できない場合は、欠落を明確にします。
2 つの順位をどう統合するか
元の順位を残すことでスコアを再計算できます。c が小さいと上位差が強まり、大きいと各ヒットの寄与が近づきます。統合後も版・権限・根拠の検証が必要です。 RRF (Cormack et al., 2009)
RRF(d)=ℓ:d∈ℓ∑c+rℓ(d)1
図を準備しています
2 つの順位をどう統合するかRRF は順位の逆数項を合計し、未登場の一覧からの寄与は0です。異なる尺度の生スコアは加算しません。
{"id":"ai-rrf-ranking","title":"2 つの順位をどう統合するか","summary":"RRF は順位の逆数項を合計し、未登場の一覧からの寄与は0です。異なる尺度の生スコアは加算しません。","height":1000,"html":"<h2 data-i18n=\"heading\"></h2><p class=\"intro\" data-i18n=\"intro\"></p><div class=\"presets\" role=\"group\" data-i18n-label=\"mode\"><button data-mode=\"one\" data-i18n=\"one\"></button><button data-mode=\"two\" data-i18n=\"two\"></button><button data-mode=\"three\" data-i18n=\"three\"></button></div><div class=\"control\"><label for=\"c\" data-i18n=\"c\"></label><output for=\"c\" id=\"c-value\"></output><input id=\"c\" type=\"range\" min=\"0\" max=\"100\" value=\"60\" step=\"1\"></div><section class=\"panel\"><h3 data-i18n=\"scores\"></h3><div id=\"scores\"></div></section><section class=\"panel\"><h3 data-i18n=\"order\"></h3><div id=\"order\"></div></section><div class=\"copy\"><p id=\"explanation\" role=\"status\"></p><p class=\"reserve\" aria-hidden=\"true\" data-i18n=\"explain\"></p></div><details class=\"scope\"><summary data-i18n=\"scopeLabel\"></summary><p data-i18n=\"scope\"></p></details>","css":".intro{margin:8px 0 18px;color:var(--muted);font-size:14px}.control{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:6px 12px;align-items:center;margin:14px 0;font-size:13px}.control output{color:var(--accent);text-align:right;font-variant-numeric:tabular-nums;min-width:4em}.control input{grid-column:1/-1;width:100%;margin:0}.presets{display:flex;gap:4px;align-items:stretch}.presets button{flex:1;min-width:0;overflow-wrap:anywhere;font-size:13px;min-height:44px}.actions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin:16px 0}.actions button{min-width:0;min-height:44px;font-size:13px;overflow-wrap:anywhere}.copy{display:grid;font-size:14px;margin:16px 0}.copy>*{grid-area:1/1;margin:0;overflow-wrap:anywhere}.reserve{visibility:hidden}.scope{margin-top:14px;color:var(--muted);font-size:12px}.scope summary{padding:8px 0;cursor:pointer}.scope p{margin-top:10px;overflow-wrap:anywhere}.metrics{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:14px;margin:18px 0}.metrics>div{border-left:2px solid var(--accent);padding:0 6px 0 10px;min-width:0}.metrics span{display:block;min-height:3.6em;color:var(--muted);font-size:12px;overflow-wrap:anywhere}.metrics strong{font-size:21px;display:block;min-height:2em;font-weight:550;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.check{display:flex;align-items:center;gap:9px;font-size:13px;margin:14px 0}.check input{width:18px;height:18px;flex-shrink:0;accent-color:var(--accent)}select,input[type=text],input[type=number]{background:var(--paper);color:var(--ink);font:inherit;font-size:14px;padding:10px;border:1px solid var(--rule);border-radius:7px;max-width:100%;min-width:0}select{width:100%;min-height:44px}.panel{padding:14px;border:1px solid var(--rule);border-radius:9px;margin:16px 0;min-width:0}.panel>header{font-size:13px;font-weight:600;margin-bottom:12px;color:var(--muted)}.panel>div{overflow-wrap:anywhere}.track-row{margin:16px 0}.track-row>span{display:block;font-size:12px;color:var(--muted);margin-bottom:8px}.track{display:flex;gap:5px;min-width:0}.cell{flex:1;min-width:0;min-height:56px;border:1px solid var(--rule);border-radius:5px;background:var(--surface);display:flex;align-items:center;justify-content:center;text-align:center;padding:6px 3px;font-size:12px;overflow-wrap:anywhere}.cell.on{background:var(--accent-soft);border-color:var(--accent)}.cell.gold{background:var(--second-soft);border-color:var(--second)}.cell.empty{border-style:dashed;color:var(--muted)}.cell.error{border-color:var(--second);text-decoration:line-through}.table{display:grid;gap:5px;font-size:12px}.tr{display:grid;gap:5px}.tr>div{background:var(--surface);border-radius:4px;padding:9px 6px;min-width:0;min-height:5em;overflow-wrap:anywhere;display:flex;align-items:center}.tr>.gold{background:var(--second-soft)}.tr>.on{background:var(--accent-soft)}.formula,.source{font:13px/1.8 ui-monospace,monospace;white-space:pre-wrap;overflow-wrap:anywhere;margin:16px 0}.formula{border-top:1px solid var(--rule);padding-top:12px;min-height:7.2em}.source{min-height:8em;background:var(--surface);padding:12px;border-radius:8px}.intervals{margin:16px 0}.interval{position:relative;height:38px;background:var(--surface);margin:6px 0;border-radius:4px;overflow:hidden}.interval i{position:absolute;height:100%;background:var(--accent-soft);border-left:2px solid var(--accent)}.interval i.gold{background:var(--second-soft);border-color:var(--second)}.interval span{position:relative;z-index:1;font:12px/38px ui-monospace,monospace;padding-left:7px}.bars{display:grid;gap:10px;margin:16px 0}.bar-row{display:grid;grid-template-columns:44px minmax(0,1fr) 62px;gap:8px;align-items:center;font:12px ui-monospace,monospace}.bar-track{height:24px;background:var(--surface);border-radius:4px;overflow:hidden}.bar-track i{display:block;height:100%;background:var(--accent);transition:width .2s}.bar-track i.gold{background:var(--second)}.bar-track i.empty{opacity:.2}.bar-row output{text-align:right}.diagram{display:block;width:100%;height:auto;margin:18px 0}.diagram text{font:13px ui-monospace,monospace;fill:var(--ink)}.node{fill:var(--surface);stroke:var(--rule)}.node.on{fill:var(--accent-soft);stroke:var(--accent)}.node.gold{fill:var(--second-soft);stroke:var(--second)}.edge{stroke:var(--rule);stroke-width:2;fill:none}.edge.on{stroke:var(--accent)}.matrix{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:6px;margin:16px 0}.matrix button{min-width:0;min-height:44px;font:13px ui-monospace,monospace}.matrix button[aria-pressed=true]{background:var(--accent-soft);border-color:var(--accent)}.matrix button.masked{opacity:.35}.legend{font-size:12px;color:var(--muted);min-height:3.6em;overflow-wrap:anywhere}.numeric{font-variant-numeric:tabular-nums}.scope p{line-break:strict}@media(max-width:480px){.presets button,.actions button{font-size:12px}.panel{padding:12px}.metrics{gap:10px}.metrics strong{font-size:19px}.bar-row{grid-template-columns:34px minmax(0,1fr) 58px;gap:6px}}@media(prefers-reduced-motion:reduce){*,*::before,*::after{transition:none!important;animation:none!important}}\n\n.panel>h3{font-size:13px;font-weight:600;margin:0 0 12px;color:var(--muted)}\n\n.bar-row{grid-template-columns:44px minmax(0,1fr) 82px}.bar-row output{white-space:nowrap}@media(max-width:480px){.bar-row{grid-template-columns:34px minmax(0,1fr) 76px}}\n\n#order{min-height:2em;font:15px ui-monospace,monospace}.table .tr>div{min-height:3em;padding:8px 4px}","js":"const $=s=>document.querySelector(s);const set=(id,v)=>$('#'+id).textContent=v;const t=k=>viz.t(k);function cells(id,values){$('#'+id).replaceChildren(...values.map(v=>{const e=document.createElement('div');e.className='cell '+(v.cls||'');e.textContent=v.text;e.title=v.title||v.text;return e;}));}function pressed(mode){document.querySelectorAll('[data-mode]').forEach(e=>e.setAttribute('aria-pressed',String(e.dataset.mode===mode)));}const esc=s=>String(s).replace(/[&<>\"']/g,c=>({'&':'&','<':'<','>':'>','\"':'"',\"'\":'''}[c]));const fmt=s=>'{'+[...s].sort().join(', ')+'}';function graph(id,nodes,edges){const el=$('#'+id);el.setAttribute('viewBox','0 0 360 200');el.innerHTML='<defs><marker id=\"arrow-'+id+'\" viewBox=\"0 0 10 10\" refX=\"8\" refY=\"5\" markerWidth=\"5\" markerHeight=\"5\" orient=\"auto-start-reverse\"><path d=\"M 0 0 L 10 5 L 0 10 z\" fill=\"var(--muted)\"/></marker></defs>'+edges.map(e=>{const a=nodes[e[0]],b=nodes[e[1]],dx=b.x-a.x,dy=b.y-a.y,d=Math.hypot(dx,dy)||1;if(edges.some(r=>r[0]===e[1]&&r[1]===e[0])){const nx=-dy/d,ny=dx/d;return '<path class=\"edge '+(e[2]?'on':'')+'\" d=\"M '+(a.x+dx/d*22+nx*12)+' '+(a.y+dy/d*22+ny*12)+' Q '+((a.x+b.x)/2+nx*38)+' '+((a.y+b.y)/2+ny*38)+' '+(b.x-dx/d*25+nx*12)+' '+(b.y-dy/d*25+ny*12)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}return '<line class=\"edge '+(e[2]?'on':'')+'\" x1=\"'+(a.x+dx/d*25)+'\" y1=\"'+(a.y+dy/d*25)+'\" x2=\"'+(b.x-dx/d*28)+'\" y2=\"'+(b.y-dy/d*28)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}).join('')+nodes.map(n=>'<g><circle class=\"node '+(n.cls||'')+'\" cx=\"'+n.x+'\" cy=\"'+n.y+'\" r=\"25\"/><text x=\"'+n.x+'\" y=\"'+(n.y+4)+'\" text-anchor=\"middle\">'+esc(n.name)+'</text>'+(n.sub?'<text x=\"'+n.x+'\" y=\"'+(n.y+43)+'\" text-anchor=\"middle\">'+esc(n.sub)+'</text>':'')+'</g>').join('');}function table(id,rows){$('#'+id).classList.add('table');$('#'+id).replaceChildren(...rows.map(r=>{const row=document.createElement('div');row.className='tr';row.style.gridTemplateColumns='repeat('+r.length+',minmax(0,1fr))';r.forEach(x=>{const c=document.createElement('div');if(typeof x==='object'){c.textContent=x.text;c.className=x.cls||'';}else c.textContent=x;row.append(c)});return row;}));}function band(id,parts,total){$('#'+id).replaceChildren(...parts.map((p,i)=>{const e=document.createElement('i');e.style.width=(100*p.value/total)+'%';e.className=i%2?'gold':'on';e.title=p.name+': '+p.value;return e}));}function intervals(id,items,total){$('#'+id).replaceChildren(...items.map(p=>{const row=document.createElement('div');row.className='interval';const bar=document.createElement('i');bar.style.left=(100*p.start/total)+'%';bar.style.width=(100*(p.end-p.start)/total)+'%';bar.className=p.cls||'';const label=document.createElement('span');label.textContent=p.label;row.append(bar,label);return row;}));}function plot(id,series,xr,yr,opts={}){const e=$('#'+id),X=x=>42+(x-xr[0])/(xr[1]-xr[0])*298,Y=y=>175-(y-yr[0])/(yr[1]-yr[0])*148;let out='<defs><clipPath id=\"clip-'+id+'\"><rect x=\"42\" y=\"27\" width=\"298\" height=\"148\"/></clipPath></defs>';for(let i=0;i<3;i++){let x=xr[0]+i*(xr[1]-xr[0])/2,y=yr[0]+i*(yr[1]-yr[0])/2;out+='<path class=\"gridline\" d=\"M '+X(x)+' 27V175M42 '+Y(y)+'H340\"/><text x=\"'+X(x)+'\" y=\"194\" text-anchor=\"middle\">'+esc(opts.xfmt?opts.xfmt(x):Number(x.toFixed(2)))+'</text><text x=\"36\" y=\"'+(Y(y)+4)+'\" text-anchor=\"end\">'+esc(opts.yfmt?opts.yfmt(y):Number(y.toFixed(2)))+'</text>';}out+='<g clip-path=\"url(#clip-'+id+')\">';for(const s of series){out+='<path fill=\"none\" stroke=\"'+(s.color||'var(--accent)')+'\" stroke-width=\"2.5\" '+(s.dash?'stroke-dasharray=\"5 4\"':'')+' d=\"'+s.pts.map((p,i)=>(i?'L':'M')+X(p[0]).toFixed(2)+','+Y(p[1]).toFixed(2)).join(' ')+'\"/>';}for(const p of opts.points||[])out+='<circle cx=\"'+X(p[0])+'\" cy=\"'+Y(p[1])+'\" r=\"4\" fill=\"var(--second)\" stroke=\"var(--paper)\" stroke-width=\"1.5\"/>';if(opts.cursor!==undefined)out+='<path d=\"M'+X(opts.cursor)+' 27V175\" stroke=\"var(--muted)\" stroke-dasharray=\"3 3\"/>';e.innerHTML=out+'</g>';e.dataset.curves=JSON.stringify(series.map(s=>s.pts));}const curve=(fn,lo,hi,n=120)=>Array.from({length:n+1},(_,i)=>{const x=lo+(hi-lo)*i/n;return[x,fn(x)]});function inputs(draw){document.querySelectorAll('input,select').forEach(e=>{e.addEventListener('input',draw);e.addEventListener('change',draw)});draw()}const n=id=>+$('#'+id).value;const show=(id,v,d=3)=>set(id,Number(v.toFixed(d)));function bars(id,values,max=1){$('#'+id).className='bars';$('#'+id).innerHTML=values.map(v=>'<div class=\"bar-row\"><span>'+esc(v.label)+'</span><div class=\"bar-track\"><i class=\"'+(v.cls||'')+'\" style=\"width:'+Math.max(0,Math.min(100,v.value/max*100))+'%\"></i></div><output>'+esc(v.text??(v.value*100).toFixed(1)+'%')+'</output></div>').join('')}function softmax(z,T=1){let max=Math.max(...z),w=z.map(x=>Math.exp((x-max)/T)),sum=w.reduce((a,b)=>a+b,0);return w.map(x=>x/sum)}let mode='one';function draw(){pressed(mode);let a=['A','B','C'],b={one:['B','D','A'],two:['D','C','B'],three:['A','B','C']}[mode],c=n('c'),s={};let rows=['A','B','C','D'].map(x=>{let i=a.indexOf(x)+1,j=b.indexOf(x)+1;s[x]=(i?1/(c+i):0)+(j?1/(c+j):0);return [x,i||'—',j||'—',s[x].toFixed(5)]});let order=Object.keys(s).filter(x=>s[x]>0).sort((a,b)=>s[b]-s[a]||a.localeCompare(b));set('c-value',c);table('scores',[['d','KW','Vec','RRF'],...rows]);set('order',order.join(' → '));set('explanation',t('explain'));document.body.dataset.scores=JSON.stringify(s);document.body.dataset.order=order.join('');}document.querySelectorAll('[data-mode]').forEach(e=>e.onclick=()=>{mode=e.dataset.mode;draw()});inputs(draw);","audio":false,"strings":{"c":"平滑化定数 c","explain":"B は2位と1位、A は1位と3位なので、既定では B がわずかに上です。高スコアは内容の真実性を証明しません。","heading":"2 つの順位をどう統合するか","intro":"ベクトル検索の順位と RRF 定数を変え、各スコアを確認します。","mode":"ベクトル検索順位","one":"B / D / A","order":"統合後の順序","reset":"リセット","scope":"キーワード順位は A/B/C、ベクトル一覧は3種類。順位は1から、同点は文字順。関連性モデルは再現しません。","scopeLabel":"モデルの範囲と前提","scores":"順位とスコア","three":"A / B / C","two":"D / C / B"}}
インデックスは継続的に保守されるデータ製品
インデックスの構築は一度きりの作業ではありません。新規追加、変更、削除、権限の取り消しはすべて、更新パイプラインに入る必要があります。古い断片がベクトルデータベースやキーワードデータベースに残ったままになると、モデルが廃止されたルールを引用する原因となります。2つのインデックスの更新が同期していないと、ハイブリッド検索が互いに矛盾するバージョンを返す可能性があります。
| 変更 | 処理すべき内容 | 無視した場合の結果 |
| 本文の変更 | 影響を受ける内容を再パースし、インデックスとバージョンを更新 | 古いルールを引用 |
| ドキュメントの削除 | 断片、派生インデックス、およびキャッシュを取り消し | 削除された内容が再出現 |
| 権限の取り消し | 検索範囲を更新し、読み取り時に再検証 | 権限外の資料がモデルのコンテキストに入る |
| embedding の変更 | 対応するベクトルを新規作成し、検証後に切り替え | 新旧の空間が混在して検索される |
| チャンク戦略の変更 | ドキュメントのバージョンと原文位置のマッピングを保持 | 古い引用が追跡不能になる |
権限制約は検索と結果の読み取りに参加させる必要があり、まず全テナントの資料をモデルに渡してから、モデルが自ら無視することを期待してはいけません。検索キャッシュも、認可範囲、ドキュメントバージョン、およびクエリ条件にバインドする必要があります。ユーザーAのヒット結果を、アクセス権限のないユーザーBにそのまま再利用することはできません。
インデックスをアップグレードする際は、まず新版を構築し、カバー率、レイテンシ、権限、および引用位置を検証してから、読み取りエントリを切り替えます。必要なロールバック情報を保持しますが、削除や権限の取り消しはロールバックによって復活させてはいけません。ベクトルデータベースに保存されているエントリは派生データであり、権威あるソースと更新記録は引き続き保持する必要があります。
コンテキストのアセンブリと引用の検証
証拠と指示を区別し、ドキュメントのID、位置、バージョン、および切り捨て状況を注釈付けします。動的な証拠は、プレフィックスの再利用を容易にするため、安定した指示の後に配置するのが適しています。具体的な配置位置の効果は測定する必要があり、「最後に配置すれば」モデルが正しく使用してくれるとは限りません。外部ドキュメントに記載されている操作指示は、自動的にアプリケーションの認可にはなりません。
引用は検証に役立ちますが、「回答にリンクが含まれているからといって」結論が支持されるわけではありません。引用が存在するか、バージョンが適用可能か、断片がその主張を本当に支持しているかを項目ごとに確認する必要があります。例えば、引用が「テスト環境でサポート」と述べているのに、回答が「本番環境でサポート」と書かれている場合、位置特定は正確ですが推論が権限外です。
証拠が不十分な場合は、親セクションの読み取り、クエリの拡張、または情報の欠如を明確に説明します。資料が十分かどうかに関わらず、モデルに確定した回答を強要しないでください。RAG は 長期記憶 も検索できます。これらには「RAG は客観的のみ、記憶は主観的のみ」といった自然的な境界線はありません。
設定だけでなく制限も取得したか
B を検索から、次にコンテキストから外して再順位付けを試します。失われる段階が異なり、未取得の条件は並べ替えでは追加できません。必要な根拠の組合せを測り、関連資料1件の命中とは区別します。
図を準備しています
設定だけでなく制限も取得したか再順位付けは取得済み候補だけを扱います。回答には再試行設定と冪等性条件の両方が必要です。
{"id":"ai-evidence-coverage","title":"設定だけでなく制限も取得したか","summary":"再順位付けは取得済み候補だけを扱います。回答には再試行設定と冪等性条件の両方が必要です。","height":1000,"html":"<h2 data-i18n=\"heading\"></h2><p class=\"intro\" data-i18n=\"intro\"></p><label class=\"check\"><input type=\"checkbox\" id=\"recall\" checked><span data-i18n=\"recall\"></span></label><label class=\"check\"><input type=\"checkbox\" id=\"keep\" checked><span data-i18n=\"keep\"></span></label><label class=\"check\"><input type=\"checkbox\" id=\"rerank\"><span data-i18n=\"rerank\"></span></label><div class=\"track-row\"><span data-i18n=\"candidates\"></span><div id=\"candidates\" class=\"track\"></div></div><div class=\"track-row\"><span data-i18n=\"context\"></span><div id=\"context\" class=\"track\"></div></div><div class=\"metrics\"><div><span data-i18n=\"coverage\"></span><strong id=\"coverage\"></strong></div><div><span data-i18n=\"result\"></span><strong id=\"result\"></strong></div></div><div class=\"copy\"><p id=\"explanation\" role=\"status\"></p><p class=\"reserve\" aria-hidden=\"true\" data-i18n=\"explain\"></p></div><details class=\"scope\"><summary data-i18n=\"scopeLabel\"></summary><p data-i18n=\"scope\"></p></details>","css":".intro{margin:8px 0 18px;color:var(--muted);font-size:14px}.control{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:6px 12px;align-items:center;margin:14px 0;font-size:13px}.control output{color:var(--accent);text-align:right;font-variant-numeric:tabular-nums;min-width:4em}.control input{grid-column:1/-1;width:100%;margin:0}.presets{display:flex;gap:4px;align-items:stretch}.presets button{flex:1;min-width:0;overflow-wrap:anywhere;font-size:13px;min-height:44px}.actions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin:16px 0}.actions button{min-width:0;min-height:44px;font-size:13px;overflow-wrap:anywhere}.copy{display:grid;font-size:14px;margin:16px 0}.copy>*{grid-area:1/1;margin:0;overflow-wrap:anywhere}.reserve{visibility:hidden}.scope{margin-top:14px;color:var(--muted);font-size:12px}.scope summary{padding:8px 0;cursor:pointer}.scope p{margin-top:10px;overflow-wrap:anywhere}.metrics{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:14px;margin:18px 0}.metrics>div{border-left:2px solid var(--accent);padding:0 6px 0 10px;min-width:0}.metrics span{display:block;min-height:3.6em;color:var(--muted);font-size:12px;overflow-wrap:anywhere}.metrics strong{font-size:21px;display:block;min-height:2em;font-weight:550;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.check{display:flex;align-items:center;gap:9px;font-size:13px;margin:14px 0}.check input{width:18px;height:18px;flex-shrink:0;accent-color:var(--accent)}select,input[type=text],input[type=number]{background:var(--paper);color:var(--ink);font:inherit;font-size:14px;padding:10px;border:1px solid var(--rule);border-radius:7px;max-width:100%;min-width:0}select{width:100%;min-height:44px}.panel{padding:14px;border:1px solid var(--rule);border-radius:9px;margin:16px 0;min-width:0}.panel>header{font-size:13px;font-weight:600;margin-bottom:12px;color:var(--muted)}.panel>div{overflow-wrap:anywhere}.track-row{margin:16px 0}.track-row>span{display:block;font-size:12px;color:var(--muted);margin-bottom:8px}.track{display:flex;gap:5px;min-width:0}.cell{flex:1;min-width:0;min-height:56px;border:1px solid var(--rule);border-radius:5px;background:var(--surface);display:flex;align-items:center;justify-content:center;text-align:center;padding:6px 3px;font-size:12px;overflow-wrap:anywhere}.cell.on{background:var(--accent-soft);border-color:var(--accent)}.cell.gold{background:var(--second-soft);border-color:var(--second)}.cell.empty{border-style:dashed;color:var(--muted)}.cell.error{border-color:var(--second);text-decoration:line-through}.table{display:grid;gap:5px;font-size:12px}.tr{display:grid;gap:5px}.tr>div{background:var(--surface);border-radius:4px;padding:9px 6px;min-width:0;min-height:5em;overflow-wrap:anywhere;display:flex;align-items:center}.tr>.gold{background:var(--second-soft)}.tr>.on{background:var(--accent-soft)}.formula,.source{font:13px/1.8 ui-monospace,monospace;white-space:pre-wrap;overflow-wrap:anywhere;margin:16px 0}.formula{border-top:1px solid var(--rule);padding-top:12px;min-height:7.2em}.source{min-height:8em;background:var(--surface);padding:12px;border-radius:8px}.intervals{margin:16px 0}.interval{position:relative;height:38px;background:var(--surface);margin:6px 0;border-radius:4px;overflow:hidden}.interval i{position:absolute;height:100%;background:var(--accent-soft);border-left:2px solid var(--accent)}.interval i.gold{background:var(--second-soft);border-color:var(--second)}.interval span{position:relative;z-index:1;font:12px/38px ui-monospace,monospace;padding-left:7px}.bars{display:grid;gap:10px;margin:16px 0}.bar-row{display:grid;grid-template-columns:44px minmax(0,1fr) 62px;gap:8px;align-items:center;font:12px ui-monospace,monospace}.bar-track{height:24px;background:var(--surface);border-radius:4px;overflow:hidden}.bar-track i{display:block;height:100%;background:var(--accent);transition:width .2s}.bar-track i.gold{background:var(--second)}.bar-track i.empty{opacity:.2}.bar-row output{text-align:right}.diagram{display:block;width:100%;height:auto;margin:18px 0}.diagram text{font:13px ui-monospace,monospace;fill:var(--ink)}.node{fill:var(--surface);stroke:var(--rule)}.node.on{fill:var(--accent-soft);stroke:var(--accent)}.node.gold{fill:var(--second-soft);stroke:var(--second)}.edge{stroke:var(--rule);stroke-width:2;fill:none}.edge.on{stroke:var(--accent)}.matrix{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:6px;margin:16px 0}.matrix button{min-width:0;min-height:44px;font:13px ui-monospace,monospace}.matrix button[aria-pressed=true]{background:var(--accent-soft);border-color:var(--accent)}.matrix button.masked{opacity:.35}.legend{font-size:12px;color:var(--muted);min-height:3.6em;overflow-wrap:anywhere}.numeric{font-variant-numeric:tabular-nums}.scope p{line-break:strict}@media(max-width:480px){.presets button,.actions button{font-size:12px}.panel{padding:12px}.metrics{gap:10px}.metrics strong{font-size:19px}.bar-row{grid-template-columns:34px minmax(0,1fr) 58px;gap:6px}}@media(prefers-reduced-motion:reduce){*,*::before,*::after{transition:none!important;animation:none!important}}\n\n.panel>h3{font-size:13px;font-weight:600;margin:0 0 12px;color:var(--muted)}\n\n.bar-row{grid-template-columns:44px minmax(0,1fr) 82px}.bar-row output{white-space:nowrap}@media(max-width:480px){.bar-row{grid-template-columns:34px minmax(0,1fr) 76px}}\n\n.metrics strong{font-size:16px;min-height:4em}","js":"const $=s=>document.querySelector(s);const set=(id,v)=>$('#'+id).textContent=v;const t=k=>viz.t(k);function cells(id,values){$('#'+id).replaceChildren(...values.map(v=>{const e=document.createElement('div');e.className='cell '+(v.cls||'');e.textContent=v.text;e.title=v.title||v.text;return e;}));}function pressed(mode){document.querySelectorAll('[data-mode]').forEach(e=>e.setAttribute('aria-pressed',String(e.dataset.mode===mode)));}const esc=s=>String(s).replace(/[&<>\"']/g,c=>({'&':'&','<':'<','>':'>','\"':'"',\"'\":'''}[c]));const fmt=s=>'{'+[...s].sort().join(', ')+'}';function graph(id,nodes,edges){const el=$('#'+id);el.setAttribute('viewBox','0 0 360 200');el.innerHTML='<defs><marker id=\"arrow-'+id+'\" viewBox=\"0 0 10 10\" refX=\"8\" refY=\"5\" markerWidth=\"5\" markerHeight=\"5\" orient=\"auto-start-reverse\"><path d=\"M 0 0 L 10 5 L 0 10 z\" fill=\"var(--muted)\"/></marker></defs>'+edges.map(e=>{const a=nodes[e[0]],b=nodes[e[1]],dx=b.x-a.x,dy=b.y-a.y,d=Math.hypot(dx,dy)||1;if(edges.some(r=>r[0]===e[1]&&r[1]===e[0])){const nx=-dy/d,ny=dx/d;return '<path class=\"edge '+(e[2]?'on':'')+'\" d=\"M '+(a.x+dx/d*22+nx*12)+' '+(a.y+dy/d*22+ny*12)+' Q '+((a.x+b.x)/2+nx*38)+' '+((a.y+b.y)/2+ny*38)+' '+(b.x-dx/d*25+nx*12)+' '+(b.y-dy/d*25+ny*12)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}return '<line class=\"edge '+(e[2]?'on':'')+'\" x1=\"'+(a.x+dx/d*25)+'\" y1=\"'+(a.y+dy/d*25)+'\" x2=\"'+(b.x-dx/d*28)+'\" y2=\"'+(b.y-dy/d*28)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}).join('')+nodes.map(n=>'<g><circle class=\"node '+(n.cls||'')+'\" cx=\"'+n.x+'\" cy=\"'+n.y+'\" r=\"25\"/><text x=\"'+n.x+'\" y=\"'+(n.y+4)+'\" text-anchor=\"middle\">'+esc(n.name)+'</text>'+(n.sub?'<text x=\"'+n.x+'\" y=\"'+(n.y+43)+'\" text-anchor=\"middle\">'+esc(n.sub)+'</text>':'')+'</g>').join('');}function table(id,rows){$('#'+id).classList.add('table');$('#'+id).replaceChildren(...rows.map(r=>{const row=document.createElement('div');row.className='tr';row.style.gridTemplateColumns='repeat('+r.length+',minmax(0,1fr))';r.forEach(x=>{const c=document.createElement('div');if(typeof x==='object'){c.textContent=x.text;c.className=x.cls||'';}else c.textContent=x;row.append(c)});return row;}));}function band(id,parts,total){$('#'+id).replaceChildren(...parts.map((p,i)=>{const e=document.createElement('i');e.style.width=(100*p.value/total)+'%';e.className=i%2?'gold':'on';e.title=p.name+': '+p.value;return e}));}function intervals(id,items,total){$('#'+id).replaceChildren(...items.map(p=>{const row=document.createElement('div');row.className='interval';const bar=document.createElement('i');bar.style.left=(100*p.start/total)+'%';bar.style.width=(100*(p.end-p.start)/total)+'%';bar.className=p.cls||'';const label=document.createElement('span');label.textContent=p.label;row.append(bar,label);return row;}));}function plot(id,series,xr,yr,opts={}){const e=$('#'+id),X=x=>42+(x-xr[0])/(xr[1]-xr[0])*298,Y=y=>175-(y-yr[0])/(yr[1]-yr[0])*148;let out='<defs><clipPath id=\"clip-'+id+'\"><rect x=\"42\" y=\"27\" width=\"298\" height=\"148\"/></clipPath></defs>';for(let i=0;i<3;i++){let x=xr[0]+i*(xr[1]-xr[0])/2,y=yr[0]+i*(yr[1]-yr[0])/2;out+='<path class=\"gridline\" d=\"M '+X(x)+' 27V175M42 '+Y(y)+'H340\"/><text x=\"'+X(x)+'\" y=\"194\" text-anchor=\"middle\">'+esc(opts.xfmt?opts.xfmt(x):Number(x.toFixed(2)))+'</text><text x=\"36\" y=\"'+(Y(y)+4)+'\" text-anchor=\"end\">'+esc(opts.yfmt?opts.yfmt(y):Number(y.toFixed(2)))+'</text>';}out+='<g clip-path=\"url(#clip-'+id+')\">';for(const s of series){out+='<path fill=\"none\" stroke=\"'+(s.color||'var(--accent)')+'\" stroke-width=\"2.5\" '+(s.dash?'stroke-dasharray=\"5 4\"':'')+' d=\"'+s.pts.map((p,i)=>(i?'L':'M')+X(p[0]).toFixed(2)+','+Y(p[1]).toFixed(2)).join(' ')+'\"/>';}for(const p of opts.points||[])out+='<circle cx=\"'+X(p[0])+'\" cy=\"'+Y(p[1])+'\" r=\"4\" fill=\"var(--second)\" stroke=\"var(--paper)\" stroke-width=\"1.5\"/>';if(opts.cursor!==undefined)out+='<path d=\"M'+X(opts.cursor)+' 27V175\" stroke=\"var(--muted)\" stroke-dasharray=\"3 3\"/>';e.innerHTML=out+'</g>';e.dataset.curves=JSON.stringify(series.map(s=>s.pts));}const curve=(fn,lo,hi,n=120)=>Array.from({length:n+1},(_,i)=>{const x=lo+(hi-lo)*i/n;return[x,fn(x)]});function inputs(draw){document.querySelectorAll('input,select').forEach(e=>{e.addEventListener('input',draw);e.addEventListener('change',draw)});draw()}const n=id=>+$('#'+id).value;const show=(id,v,d=3)=>set(id,Number(v.toFixed(d)));function bars(id,values,max=1){$('#'+id).className='bars';$('#'+id).innerHTML=values.map(v=>'<div class=\"bar-row\"><span>'+esc(v.label)+'</span><div class=\"bar-track\"><i class=\"'+(v.cls||'')+'\" style=\"width:'+Math.max(0,Math.min(100,v.value/max*100))+'%\"></i></div><output>'+esc(v.text??(v.value*100).toFixed(1)+'%')+'</output></div>').join('')}function softmax(z,T=1){let max=Math.max(...z),w=z.map(x=>Math.exp((x-max)/T)),sum=w.reduce((a,b)=>a+b,0);return w.map(x=>x/sum)}function draw(){let r=$('#recall').checked,k=$('#keep').checked,order=$('#rerank').checked?['B','A','C']:['A','C','B'],cand=order.filter(x=>x!=='B'||r),ctx=cand.filter(x=>x!=='B'||k),full=ctx.includes('B');for(const [id,a]of[['candidates',cand],['context',ctx]])cells(id,Array.from({length:3},(_,i)=>({text:a[i]||'—',cls:a[i]==='B'?'gold':a[i]?'on':'empty'})));set('coverage',full?'2 / 2':'1 / 2');set('result',t(full?'full':'missing'));set('explanation',t('explain'));document.body.dataset.coverage=full?2:1;}inputs(draw);","audio":false,"strings":{"candidates":"候補集合","context":"最終コンテキスト","coverage":"必要な根拠の網羅","explain":"A: retry=true、B: 自動再試行は冪等な操作のみ。B なしでは任意の書き込みを再試行できるとは言えません。","full":"条件が揃う","heading":"設定だけでなく制限も取得したか","intro":"検索とコンテキストの切り詰めを変え、必要条件の消失箇所を追います。","keep":"コンテキストに B を保持","missing":"根拠不足","recall":"条件 B を取得","rerank":"B を最上位にする","reset":"リセット","result":"回答可能性","scope":"固定資料 A=設定、B=冪等性条件、C=背景。実際の検索や書き込みは実行しません。","scopeLabel":"モデルの範囲と前提"}}
階層型評価と失敗の帰属
関連性の注釈単位を明確にする
クエリに対して関連するドキュメントまたは証拠ユニットを注釈付けし、マルチホップ問題にどのような組み合わせが必要かを説明します。クエリ Q に対して、関連集合を R、返された上位 k 件の集合を S とします。
| 指標 | 定義 | 盲点 |
| precision@k | 上位 k 件中、関連する項目の数 / k | どの程度の証拠が漏れているかを説明しない |
| recall@k | 命中した関連項目の数 / 全注釈済み関連項目数 | 注釈の完全性に影響される |
| reciprocal rank | 最初の関連結果のランクの逆数、命中しない場合は0 | 後続の必要な証拠を測定しない |
| MRR | 複数クエリの reciprocal rank の平均 | 依然として最初の命中に偏る |
| 証拠組み合わせのカバー | 回答に必要なすべての重要条件を取得しているか | タスクレベルの注釈が必要 |
例えば、R={A,C} で、返された結果が [B,A,D] の場合、precision@3=1/3、recall@3=1/2、reciprocal rank=1/2 となります。recall を「正しい断片が1つでもあれば」と簡略化すると、C が漏れます。関連項目がちょうど1つの場合に限り、recall はその項目が含まれているかどうかを示す値になります。
指標の計算はプログラム化できますが、関連性ラベルと証拠の要件は依然として不完全であったり、意見が分かれたりする可能性があります。拒否回答の妥当性、引用の支持、最終的な正答率、レイテンシ、およびコストも測定する必要があります。検索が関連しているからといって、回答が導出可能であるとは限りません。断片が候補セットに入ったからといって、最終的に生成ウィンドウに入るわけではありません。
失敗チェーンに沿って階層ごとに特定する
| 失敗の位置 | 確認方法 | 調整方向 |
| 元データに答えがない | 権威あるソースを再確認 | 資料の補完、または不明であることを明示 |
| パースで条件が欠落 | 原文と登録済み断片を比較 | パース、テーブル、チャンク分割の修正 |
| 候補セットでリコールされていない | フィルタリング、エンコーディング、マルチパス検索を確認 | リコールの修正、リランキングだけでなく |
| 候補はあるが最終証拠がない | リランキング、重複除去、予算切り捨てを確認 | 必要な条件とマルチホップ関係を保持 |
| 証拠は完全だが回答が誤り | プロンプト、モデル、引用推論を確認 | 生成と検証の修正 |
| 結果は正しいが権限外または古い | 認可とバージョンを確認 | データガバナンスとキャッシュ境界の修正 |
次に読む:Agent ループと実行器。