訓練與管理設備模型
設備模型採用受控制的生命週期。訓練只會建立待審查的候選版本，不會自動取代目前保護設備的生產判定。
先分清兩種模型產物
| 模型軌道 | 用途 | 目前訓練入口 | 生產控制方式 |
|---|---|---|---|
設備基線分布 (PDM_BASELINE_DISTRIBUTION) | 描述設備已觀察到的運轉分布，供基線比較使用。 | 預測性維護 > 模型控制台 | 模型控制台的基線晉升門檻 |
可執行異常模型 (PDM_ANOMALY_MODEL) | 對指定設備與 target 執行異常評分 artifact。 | 管理員 API | 指向已驗證不可變 artifact 的 ACTIVE assignment |
設備基線分布不是可執行異常模型。基線計算成功，不代表異常模型已實際執行；異常分數也不是故障機率。
入口與權限
| 任務 | 入口 | 權限 |
|---|---|---|
| 查看模型控制台 | /pdm/model-console | mlops.model.read 或 system.config |
| 查看模型使用詳情 | /ai-models/registry/:registryId | mlops.model.read 或 system.config |
| 訓練或晉升設備基線 | 模型控制台 | pdm:write |
| 訓練可執行異常候選模型 | 管理員 API | pdm:write |
| 晉升或回復可執行 assignment | 管理員 API | pdm:write |
| 查看設備 Finding | /pdm/anomalies 與 Finding 詳情 | pdm:read |
標準「模型使用詳情」頁面是唯讀頁面。目前不提供 assignment 晉升或回復按鈕。
生命週期
SHADOW 只執行旁路比較，不會改變 alert、健康分數、advisory 或 Finding。ACTIVE 表示 assignment 具有生產選擇權，但仍要等到新鮮且成功的 runtime evidence，才能確認生產環境真的使用了該模型。
訓練統計設備基線
- 開啟 預測性維護 > 模型控制台。
- 找到目標設備並確認租戶、設備、target 與單位。
- 查看 readiness 結果與所有未滿足條件。
- 確認運轉狀態歷史和訓練時間窗正確。
- 在條件符合且具備
pdm:write時啟動訓練。 - 等待頁面更新，確認新版本和訓練時間。
| Readiness 結果 | 含義 | 下一步 |
|---|---|---|
| Eligible | 必要資料條件目前已滿足。 | 訓練後審查 SHADOW 候選版本。 |
| Missing criteria | 一項或多項可量測條件未滿足。 | 補齊有效運轉歷史或修復必要信號。 |
| Cannot determine | 服務無法作出判斷。 | 依頁面原因修復身份、資料或服務問題；不要誤報為歷史不足。 |
| Caveat | 可以訓練，但時間窗有已知限制。 | 記錄限制並納入發布審查。 |
訓練基線只會建立比較用候選版本，既有生產判定仍然有效。
訓練可執行異常候選模型
這目前是管理員 API 流程，標準模型控制台沒有對應的自助按鈕。
| Method | Endpoint | 結果 |
|---|---|---|
POST | /api/v1/pdm/model-console/{equipmentId}/train-anomaly-model | 建立不可變的可執行候選版本，不改變統計基線或現有 ACTIVE 路徑。 |
API 成功後，請在模型註冊表確認：
- 綁定的是正確設備與 target；
- artifact 已註冊並完成驗證；
- assignment 為
SHADOW； - 已有可供發布決策使用的 SHADOW 執行証跡。
請在目標租戶中執行 API，不可複用其他租戶或環境的 registry/assignment ID。
審查 SHADOW 行為
在模型使用詳情確認綁定、artifact 類型與驗證狀態、訓練時間窗、執行結果數量，以及 SHADOW disagreement。
Disagreement 只表示候選路徑與現行路徑在某個比較窗內結果不同，不代表任一方較準確。告警較少也可能表示漏掉重要狀況。發布決策必須搭配現場 Finding、維護結果、運轉情境和資料品質。
有意識地晉升
在 UI 晉升設備基線
符合條件的 SHADOW 基線可在模型控制台向具備 pdm:write 的使用者顯示晉升動作。後端會檢查候選版本是否可與目前判定比較，但不宣稱它比較準確。
透過 API 晉升可執行 assignment
| Method | Endpoint |
|---|---|
POST | /api/v1/pdm/model-console/assignments/{assignmentId}/promote |
晉升成功後，確認目標 assignment 為 ACTIVE、registry 版本為 PRODUCTION、舊的設備級生產 assignment 已退出、artifact 仍通過驗證，並等待新鮮的 ACTIVE runtime evidence。
頁面顯示 ACTIVE_AWAITING_EVIDENCE、STALE、FALLBACK、CONFLICT 或 ARTIFACT_UNAVAILABLE 時，不可宣稱模型已在生產中執行。
回復可執行 assignment
回復目前是管理員 API 流程：
| Method | Endpoint |
|---|---|
POST | /api/v1/pdm/model-console/assignments/{assignmentId}/rollback |
使用租戶範圍模型 API 回傳的 assignmentId，不要從 URL、模型名稱或另一個環境推測。回復後確認替代 assignment 已 ACTIVE、歷史狀態正確、新鮮執行証跡已出現，且被回復的 artifact 不再由 live assignment 引用。
回復不會刪除歷史 assignment、生命週期事件、執行証跡、Finding 或 feedback。
主要狀態
| 狀態 | 可以證明 | 不能證明 |
|---|---|---|
STAGING | Registry 版本是候選版本。 | 可以影響使用者結果。 |
SHADOW | Assignment 可進行非寫入比較。 | 它是生產模型。 |
ACTIVE | Assignment 具有生產選擇權。 | 最近一次執行成功。 |
PRODUCTION | Registry 版本在受治理範圍內是生產版本。 | 每次設備評估都使用了它。 |
RETIRED 或 ROLLED_BACK | 版本或 assignment 已成為歷史。 | 歷史稽核證據已刪除。 |
排解與驗證
| 現象 | 檢查項目 |
|---|---|
| 看不到訓練動作 | pdm:write、readiness、assignment 狀態，以及是否為 API-only 異常模型流程。 |
| 訓練被拒絕 | 設備身份、target、運轉歷史、時間窗覆蓋與回傳原因。 |
| 候選版本停留在 SHADOW | 這是發布決策前的預期安全狀態。 |
| 晉升成功但未顯示生產使用 | 檢查新鮮執行証跡、fallback 與 artifact 驗證。 |
| 找不到回復按鈕 | Assignment 回復目前由管理員 API 執行。 |
完成前請確認設備和 target 正確、兩種模型產物未混淆、訓練未暗中改變生產路徑、SHADOW 未影響使用者結果，且晉升或回復後已有新鮮 ACTIVE 執行証跡。