把提示、模型與工作流程邏輯視為同一個 AI 發布版本

AI 發布的真正單位，是會共同決定正式環境行為的完整組態，不是單一提示字串或模型端點。若團隊只把模型切回舊版，卻讓新版提示、工具結構描述、權限政策、檢索設定或重試路徑繼續運作，就無法確定測試過什麼、問題請求由哪套組態處理，也無法可靠地把流量送回相容狀態。實務上應先替完整候選建立同一個身分，再讓評估、核准、部署與回復紀錄都指向它。

哪些項目才算同一次 AI 發布？

同一次 AI 發布應涵蓋所有可能改變服務行為、權限、風險、成本、延遲或可觀測性的執行元件。基本盤點包括提示、解析後的模型識別碼與推論參數、工具結構描述及權限、政策或防護措施、檢索與脈絡設定、工作流程程式碼、輸入輸出結構描述、執行期依賴，以及會影響請求處理的環境綁定。元件仍可保有各自版本歷史，但完整候選必須另有一個共同發布身分。

評估資料集、評分器、評分規準與門檻通常不在服務路徑內執行，卻會改變是否准許候選上線的判斷，因此也要版本化並連結到發布紀錄。第三方軟體、資料來源或供應商設定是否納入，則看它們能否實質影響服務或發布決策；邊界不必無限擴張，但不能漏掉可改變權限、脈絡與實際輸出的依賴。

• 提示內容或提示版本改變，就建立新候選。
• 模型快照、溫度、輸出長度或其他有效參數改變，就建立新候選。
• 工具契約、權限政策、防護措施、檢索設定或資料參照改變，就建立新候選。
• 工作流程、結構描述、執行期依賴或行為影響環境綁定改變，也建立新候選。
• 只調整已預先核准的曝光比例，可記為同一候選的部署事件。

如何把行為堆疊綁成發布清單？

做法是凍結一份不可變更的候選清單，讓每個執行元件都以可解析且穩定的參照出現。清單至少要有發布識別碼、建立時間、負責人、目標服務、狀態、停止條件、回復負責人及前一個已知良好版本；元件欄位則保存版本、提交識別碼、產出物摘要、內容雜湊或其他穩定參照，並附上真正生效的設定。latest 或 production 只能當指標，不能充當候選身分。

以內部客服助理為例，support-assistant-r18 可綁定提示 p-42、模型快照 m-2026-07 與參數、CRM 工具結構描述 t-9、權限政策 policy-12、工作流程提交 wf-a71、輸出結構描述 reply-6 及執行期依賴鎖定檔；發布封包另連結 eval-23 與評分器版本。核准連線、功能旗標、路由限制及資料參照也要記錄身分，但清單本身不應存放密鑰。

• 清單本體保持不變；流量配置、部署時間、觀察結果與處置寫入相連的推進紀錄。
• 若推出期間只依原計畫增加曝光，可繼續推進同一個候選。
• 若路由、連線或環境綁定改變每次請求取得的權限、脈絡或行為，就必須建立新候選。
• 把 support-assistant-r17 指定為回復目標前，先確認它能否相容新增的選填到期日與 escalationReason 欄位。

凡是能改變服務行為，或改變授權該行為所依據的證據，都必須在發布紀錄中有解析後的身分。

哪些證據足以讓候選繼續推進？

足以推進的證據，必須來自對同一份完整候選所做的工作流程特定檢查，而不是供應商基準或單一平均分數。發布說明先交代行為意圖、變更依賴、受影響情境與介面、權限或可觀測性變化、已知限制、剩餘風險、推出負責人及相容回復目標；評估再比較候選與現行版本，涵蓋契約、任務品質、安全與權限、工具行為、可靠度、延遲、成本及重要分群。

評估資料集、評分器、規準與門檻都要帶版本，因為關卡改變會讓相同候選得到不同解讀。即使總分改善，只要仍有重大契約錯誤、未授權工具行為、安全問題、高代價邊緣案例或重要分群退步，就不能用平均值掩蓋。每一道關卡最後都要留下推進、暫停或拒絕的處置及具名負責人；較高風險發布可把變更作者與推進核准者分開。

• 發布說明：行為目的、變更元件、受影響情境、限制、剩餘風險與回復目標。
• 建置與介面：清單可解析、結構描述相容、工具與依賴可載入、環境綁定有效。
• 任務與品質：真實案例、缺少脈絡、多語情境、重要分群及高代價邊緣案例。
• 安全與權限：政策規則、資料界線、工具授權、人員核准與禁止動作。
• 服務準備：錯誤、延遲、用量、完成任務成本、追蹤完整度及警示可用性。

同一個候選應如何逐步進入正式環境？

同一個已解析候選應沿著可量測的階梯逐步推進，並在每一階段保留與現行版本的比較證據。可行時先做影子或不會實際執行動作的重播；所有寫入工具及其他具有後果的副作用都應停用或沙箱化，不能把正式環境動作盲目重播。接著才開放內部使用者、固定分派的正式環境群組、擴大曝光，最後移至全部流量。

每一階段都必須維持相同提示、模型設定、工具、權限、政策、檢索、工作流程、結構描述、依賴與環境綁定。部署事件另記群組規則、流量配置、觀察時間與處置，並以發布識別碼標記遙測。流量比例、最低樣本與觀察期間沒有通用答案，應依服務風險、流量、偵測延遲及營運處理能力決定；影子結果與金絲雀群組也不能代表所有正式條件或罕見失敗。

1. 用代表性近期案例做影子或不執行外部動作的重播，並比較完整追蹤。
2. 先開放內部營運團隊，所有外部動作仍保留原有核准。
3. 把同一候選送往固定分派的正式環境群組，與現行版比較約定訊號。
4. 達到服務自行核定的觀察與樣本要求後擴大曝光，期間不更換候選元件。
5. 移至全部流量後持續以發布版本標記監測，並在既定期間保留回復目標。

何時必須停止發布，回復又要恢復什麼？

安全或政策違反、未授權工具行為、重大契約失敗及嚴重可靠度故障，應在曝光前就列為硬性停止條件；其他退步則使用服務自行核定的限制與觀察窗口。證據若仍模糊，可先暫停並調查，不必一律自動回復，但處置與負責人仍要明確。真正執行回復時，應把流量送回經相容性確認的完整已知良好發布，而不是只撤換一個模型或提示。

先前版本不一定仍可直接使用，因此平時就要演練復原，並檢查結構描述、狀態變更、資料遷移、供應商可用性、工具契約與路由。更重要的是，設定回復只控制後續請求：它不會刪除已寄出的訊息、撤銷資料寫入、取消核准或逆轉外部系統中已完成的動作。團隊須利用帶發布標記的追蹤找出受影響請求與動作識別碼，再依另行授權的手冊處理圍堵、核對、修正、通知或補償。

• 停止紀錄寫明觸發條件、首次觀察時間、受影響發布與群組。
• 相容性檢查涵蓋結構描述、狀態、遷移、工具契約、供應商與路由。
• 流量復原後立即驗證已知良好版本的契約、工具權限與核心服務訊號。
• 外部動作另列請求、工作流程路徑及動作識別碼，不與設定回復混為一談。
• 最後保存復原時間、補救處置、負責人，以及需要新增的評估或監測項目。

日後要重建一次 AI 發布，至少要留下什麼？

可重建的發布紀錄至少要保留不可變更候選清單、解析後元件與參數、環境綁定、相容性結果、評估資產版本與成績、核准、部署事件、流量配置、追蹤、發現事項、回復事件及最終處置。把發布識別碼附在追蹤上，才能將生成、工具呼叫、交接、防護措施、時間與結果歸因到實際處理請求的組態；可取得時，也應同時保存供應商請求識別碼與應用追蹤識別碼。

這種紀錄追求的是組態可重建與決策可重建，不是逐位元重播相同輸出。固定模型快照、參數及內容摘要仍無法排除隨機取樣、託管服務與基礎設施變化；發布紀錄也不必為了完整而永久保存每一份提示、工具輸入、模型輸出或客戶資料。敏感承載內容應依組織政策選擇性擷取與保留。若發布改變敏感資料處理、重大權限、受規範流程或外部動作補救方式，應另請合格的資安、隱私、法務、紀錄、風險或領域人員判定要求。

• 候選：發布身分、元件版本或摘要、有效參數及環境綁定。
• 證據：評估資料、評分器、規準、門檻、結果、限制與核准。
• 部署：群組規則、流量配置、觀察時段、訊號與每階段處置。
• 運作：發布標記追蹤、供應商請求識別碼、應用追蹤識別碼及發現事項。
• 復原：停止觸發、相容目標、流量恢復、外部動作補救與最終結論。