營運與維護 · 實作指南
記錄決策過程,不要複製客戶整份資料
用較少敏感內容,建立足以解釋 AI 工作流程故障的診斷事件。

文字更多,未必更容易診斷
假設支援團隊為了解發票錯誤,把所有提示和回應寫進日誌。結果裡面充滿銀行資料、姓名與重複文件,卻仍看不出哪條規則拒絕請求。建議先列出診斷問題:哪個步驟失敗、涉及哪筆紀錄、負責人下一步可以做什麼。再收集能回答問題的欄位,而不是默認保存整段對話。日誌本身也是需要管理的資料產品,不是免費而無風險的暫存區。
建立共同事件詞彙
可定義擷取被拒、批准到期、連接器不可用、外部寫入已確認等事件,附請求編號、公司參考、階段、耗時、模型設定版本與安全原因碼。事件結構保持穩定,換提供方時就不必重寫整份維運報告。OWASP 日誌指引提供背景,這套詞彙則是本文建議。錯誤原因要能引導處理,例如缺必要欄位,而不是只寫模型失敗,令一線人員無從判斷。
流程一覽
把例外內容檢查分開管理
有時診斷確實需要樣本,但應是另行授權的程序,具遮蔽處理、有限存取、到期日與使用理由。一般事件不放權杖、簽署下載連結或密碼。也要測試錯誤處理器是否意外印出請求標頭或原文件。多人可看的維運儀表板,不能悄悄變成另一個客戶文件庫。資料保留期限應與目的相符,當例外調查結束後,也要有人負責處理留下的副本。
同時衡量可用性與暴露量
試點時讓未參與開發的人,僅憑事件軌跡處理幾宗虛構故障,記錄判斷耗時和需要原始內容的次數。資料不足時,先改善原因碼,再考慮擴大擷取。保留與存取仍須按客戶情況決定。少記錄不是把責任證據全刪掉;應減少不必要內容,同時保留操作、批准和結果之間的關係。能解釋又不過量收集,才是較可靠的診斷安排。
演練誰可查看日誌
請一般支援使用者診斷一宗虛構擷取失敗,確認不能閱讀密鑰或其他公司的事件;再讓獲授權調查者取得有限期樣本。這能測試維運便利是否意外造出大範圍資料視窗。也要檢查匯出日誌後的保存方式,因為平台內權限正確,不代表下載到桌面的副本仍受控。交付訓練需要說明哪些情況可匯出、誰批准以及何時清理。
來源與延伸閱讀
- Logging Cheat SheetLogging Cheat SheetOWASP · 官方文件 ·
編輯原則
本系列以 AI 輔助原創撰寫,並對照連結的公開來源。實作建議與假設情境屬編輯分析,並非客戶實績。來源發布日期及產品細節可能與本系列整理日期不同。