團隊的 AI 工程規範:從程式碼審查到事故處理
把散落的最佳實務寫成團隊規範,新人才不用重踩一遍。
AI 功能與一般後端服務有幾個本質差異:非決定性、成本與呼叫量直接掛鉤、行為會因為外部模型改版而改變。團隊規範需要針對這些差異調整。
一、程式碼審查的額外檢查項
- 提示改動有沒有附評測結果。
- 有沒有新的使用者輸入插入點(注入面)。
- 有沒有設定逾時、重試上限與成本上限。
- 模型與提示版本是否寫進日誌。
- 失敗路徑:模型不可用時的行為是什麼。
- 新增的資料落地點有沒有登記進資料盤點表。
二、發布規範
- 提示與模型的變更一律走灰度,不直接全量。
- 發布前跑完整評測並附上報告。
- 回滾必須能在數分鐘內完成,且不需重新部署。
- 重大變更要在低流量時段進行。
三、事故分級
P1 輸出錯誤資訊造成實際損害 / 個資外洩 / 服務完全不可用
P2 品質明顯下降但仍可用 / 成本異常暴增 / 部分功能失效
P3 單一案例錯誤 / 延遲上升但在可接受範圍
P1 立即回滾,先止血再查原因。
四、AI 特有的事故類型
- 上游模型改版:輸出格式或行為突然改變。預防:鎖定模型版本。
- 成本失控:迴圈或濫用導致費用暴增。預防:三層用量上限。
- 提示注入成功:系統被誘導執行非預期操作。預防:紅隊測試、最小權限。
- 資料洩漏:快取或日誌把 A 的內容給了 B。預防:快取鍵含權限指紋。
- 評測失效:分數很好但線上很差。預防:影子模式、線上指標。
五、事後檢討的三個問題
- 為什麼監控沒有先發現?——多數 AI 事故的根因是缺乏對應指標。
- 回滾花了多久?——超過十分鐘就該改善回滾機制。
- 這個失敗模式有沒有進評測集?——沒有的話,它會再發生一次。
六、知識沉澱
把每次事故的「症狀 → 根因 → 修法」寫成一頁文件並索引。半年後同樣的症狀再出現時,新人能自己查到。這比要求所有人讀完整份規範更實際。
規範要短。超過三頁就沒人會讀完。把細節放進檢查清單與工具的預設行為裡,讓正確做法成為最省力的做法。
訂閱後繼續閱讀全文
本篇為訂閱者專屬內容。訂閱後可取得下列權限:
- 解鎖全部內容權限
- 閱讀不限篇數
- 全站移除廣告
月卡
NT$240
開通 30 天
一次付清,開通 30 天
季卡
NT$620
開通 90 天
一次付清,開通 90 天,每天約 NT$7
年卡
NT$2,160
開通 365 天
一次付清,開通 365 天,每天約 NT$6
一次性付款,付款成功後立即開通,到期自動結束,不會再次扣款,也不需要取消訂閱。
立即訂閱
金額均為新臺幣(TWD),即實際扣款金額,不另收手續費
支援信用卡 · Apple Pay · Google Pay · WebATM · ATM 轉帳
購買須知與退款政策