← 返回學習路線
案例 · 已發布

實戰:RAG 索引藍綠切換與回滾

建立新索引並執行抽樣檢查,再用版本指標完成無損切換。

來源: knowledge/p24-b/collection_6e8fbe1e8b1ea569a539e8a5/cases/rag-index-blue-green-release.mdRAG 知識庫工程
本章閱讀進度 0%學習路線進度 0% · 0/10 已完成章節繼續學習路線 →

問題與邊界

知識庫每天更新,直接覆蓋索引可能產生半成品結果。需要在隔離目錄建立新版本,驗證通過後再切換,失敗時回到舊版本。

方案

每個索引目錄包含 manifest.json、chunks.jsonl 和健康檢查結果;current.json 只保存目前版本指標。切換是一次原子檔案替換。

最小實作

import json
from pathlib import Path

def promote(root: Path, version: str) -> None:
    manifest = json.loads((root / version / 'manifest.json').read_text())
    if manifest.get('status') != 'healthy':
        raise ValueError('index is not healthy')
    tmp = root / 'current.json.tmp'
    tmp.write_text(json.dumps({'version': version}))
    tmp.replace(root / 'current.json')

重現步驟

  1. 將輸入文件快照和建立參數寫入新版本目錄。
  2. 檢查文件數、區塊數、抽樣檢索和權限過濾結果。
  3. 將狀態標為 healthy 後,原子替換 current.json。
  4. 觀察錯誤率和零結果搜尋,異常時把 current.json 指回舊版本。

驗證清單

驗證建立中斷不會改變 current.json、損壞的 manifest 不可提升、回滾後舊版本可讀,以及快取鍵包含索引版本。

常見問題

為何不用資料庫交易切換? 生產實作可以使用資料庫指標;本案例用檔案指標展示原子切換概念。

回滾會刪除新索引嗎? 不會立即刪除,保留到回滾窗口結束並完成備份。

官方參考

OpenAI Production best practices;OpenAI Embeddings。

最後核對日期:2026-11-16。介面和安全邊界以連結中的官方資料為準;本文不虛構效能或費用結論。

前置知識與教學

知識RAG 生產管線:更新、快取與回滾

延伸閱讀

知識RAG 企業知識庫:架構與落地實踐知識AI Agent:從基礎概念到實際應用知識AI 自動化工作流程設計與實踐
產品中心 Demo · V0.3