定位 RAG 知識庫失敗的原因
用可觀察證據區分來源、匯入、檢索、權限與生成故障。
從失敗請求開始
保留脫敏問題、使用者角色、資料版本、檢索設定和預期結果，單獨記錄檢索文件標識、片段和最終回答。不要把憑證或機密文件放入共享排障工單。
| 現象 | 先檢查的證據 | 優先修復方向 |
|---|---|---|
| 返回舊規則 | 來源版本與最近成功匯入 | 修復來源或更新鏈路 |
| 編號或表格值缺失 | 解析文字、分塊邊界、後設資料 | 修復解析或檢索策略 |
| 出現無權文件 | 呼叫身分與伺服器端過濾 | 先修授權再繼續測試 |
| 片段正確但回答無依據 | 提示詞、生成引數、引用範圍 | 約束或調整生成 |
| 沒有批准來源 | 資料清單與人工複核 | 拒答或補充獲批資料 |
修改真正出問題的層
文件未進入索引，換模型不能解決；正確片段已返回但被誤讀時，應固定檢索結果比較提示詞和模型。把失敗樣本加入迴歸集。
資料更新和刪除需要測量從源變更到可檢索狀態的時間。按約定流程驗證刪除內容從檢索和應用快取中消失，不能只看匯入任務顯示成功。
用反例完成修復驗收
重測原失敗與相鄰的正常請求，加入無權使用者和資料中不存在的資訊請求。輸出原因、修改、前後證據和剩餘限制。模型回答是待驗證結果，不能把它對檢索過程的解釋當作內部執行證據。
官方資料
文件核驗日期：2026 年 10 月 17 日。本文為參考指南，本次未執行真實雲端 API 呼叫。