01 / DECIDE
架構決策
適合應用要根據上傳 manual、policy、case 或 project artifact 回答時。
即使是 hosted retrieval tool,仍需治理 corpus:ingestion status、metadata、access filter、citation、refresh 與 deletion。 先把 input、output、state 與 side effect 畫成一條可觀察路徑,再決定 用 ownership 與 freshness 建立 file search 要放在哪一層。
02 / BUILD
三步實作
- 01
框定合約
先寫下 caller、資料分類、成功條件、timeout、取消與 ownership。適合應用要根據上傳 manual、policy、case 或 project artifact 回答時。
- 02
建立單一路徑
只實作一條 end-to-end path,保留 request correlation、typed state 與可逆 failure handling。即使是 hosted retrieval tool,仍需治理 corpus:ingestion status、metadata、access filter、citation、refresh 與 deletion。
- 03
證明結果
把驗收寫成可重跑的 fixture、contract test 或 browser test。Tenant-isolation suite 證明跨 user query 無法取得 title、snippet、identifier 或 content。
03 / BOUND
Production 邊界
Retrieval 前必須評估 authorization,刪除文件也必須停止影響回答與 citation。
04 / PROVE
驗收證據
Tenant-isolation suite 證明跨 user query 無法取得 title、snippet、identifier 或 content。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://developers.openai.com/api/docs/guides/tools' | sed -n '1,5p'