AI Agent 營運指南
當 AI Agent 工作流程從早期驗證進入受控試點或正式營運時,應使用這些指南。這裡關注存取權限、資料、運行記錄、審核、問題排查和輸出範例。
前置條件
使用這些營運指南前,團隊應先確認:
- 已選擇設定好的 Agent 或整合入口;
- 已確定工作流程負責人和複核人;
- 已識別租戶、站點、資產、設備、場景或工作記錄邊界;
- 已列出所需來源系統和文件;
- 已選擇首個 MCP endpoint 和 scope 包;
- 首次驗證運行會以唯讀方式開始。
指南地圖
| 指南 | 何時使用 | 主要輸出 |
|---|---|---|
| Agent 生命週期與設定 | 租戶 Agent 需要申請、設定、變更、暫停或停用 | Agent 目的、負責人、邊界、啟用工具、驗證狀態和變更記錄 |
| 風險治理與安全 | 工作流程可能使用計算工具、草稿動作或較高風險的營運輸出 | 風險級別、複核關口、證據要求和審批規則 |
| 存取與 Scope 規劃 | 客戶端、工作流程或整合需要 endpoint 和 API key | Endpoint 選擇、scope 清單、key 負責人和審批邊界 |
| 執行時工具發現 | 設定好的客戶端需要在實施前證明哪些工具可見 | 執行時工具清單、缺失工具診斷和 scope/模組確認 |
| 工具執行治理 | 工具呼叫需要統一處理為證據、建議、草稿或已核准記錄 | 執行結果規則、複核說明、草稿動作邊界和稽核證據 |
| 資料就緒 | 工作流程需要可靠的資產、訊號、文件、場景或工單上下文 | 資料缺口清單、來源映射和品質檢查 |
| 工作流程運行記錄 | 工作流程執行結果需要後續複盤或稽核 | 輸入邊界、工具呼叫、來源引用、審核記錄和最終結果 |
| 驗證與交接 | 試點需要交給營運、維護或工程團隊接收 | 驗收檢查、負責人交接、支援邊界和改善閉環 |
| 問題排查 | 客戶端、scope、資料、工具或輸出問題阻塞工作流程 | 排查路徑和交給責任團隊的證據 |
| 範例 | 團隊在實施前需要請求和回應樣例 | 範例 prompt、工具上下文、輸出格式和審核說明 |
營運順序
- 確認 Agent 目的、負責人、使用者入口和生命週期狀態。
- 明確工作流程邊界、endpoint、scope 和 key 負責人。
- 列出執行時工具,並與預期 endpoint 和 scope 包對照。
- 檢查所需資產、訊號、文件、場景和工作記錄是否就緒。
- 先以唯讀方式運行工作流程,並記錄工具輸出與來源引用。
- 只有在假設和複核負責人可見後,再加入計算工具。
- 寫入動作必須作為草稿進入審批、稽核和回復流程。
- 複盤已完成運行,把確認過的修正回饋到資料層和知識層。
審核關口
| 關口 | 必須檢查 |
|---|---|
| 存取關口 | 客戶端只能看到 endpoint 和 scope 允許的工具。 |
| 資料關口 | 來源記錄能穩定對應到資產、位置、場景或工單標識。 |
| 輸出關口 | 回答包含來源引用、假設和未解決缺口。 |
| 動作關口 | 任何寫入動作在負責人批准前保持草稿狀態。 |
| 交接關口 | 營運團隊清楚 key、工作流程、異常和支援由誰負責。 |
預期輸出
| 輸出 | 來源 |
|---|---|
| Agent 設定摘要 | Agent 生命週期與設定。 |
| 存取計畫 | 存取與 Scope 規劃。 |
| 執行時工具發現快照 | 執行時工具發現。 |
| 風險與審批說明 | 風險治理與安全。 |
| 資料就緒說明 | 資料就緒和 DFS 頁面。 |
| 工具執行策略 | 工具執行治理。 |
| 唯讀驗證結果 | 工作流程指南和範例。 |
| 運行記錄 | 工作流程運行記錄。 |
| 驗收包 | 驗證與交接。 |
| 問題證據 | 故障排查和 MCP 錯誤與稽核。 |
失敗處理
| 問題 | 下一頁 |
|---|---|
| 客戶端無法連接或列出工具 | 故障排查 和 MCP 錯誤與稽核 |
| Agent 設定變化或應停用 | Agent 生命週期與設定 |
| Scope 包過寬或過窄 | 存取與 Scope 規劃 |
| 預期工具缺失或出現了不應暴露的工具 | 執行時工具發現 |
| 工具結果需要成為草稿動作或已核准記錄 | 工具執行治理 |
| 來源資料過期或不完整 | 資料就緒 和 DFS |
| 輸出無法被接受 | 工作流程運行記錄 和 驗證與交接 |
選擇下一頁
- 客戶端或權限模型仍在設計時,從 存取與 Scope 規劃 開始。
- 需要建立、變更、暫停或停用設定好的 Agent 時,從 Agent 生命週期與設定 開始。
- 客戶端已連接但需要驗證可見工具集時,從 執行時工具發現 開始。
- 工作流程依賴外部系統、DFS 管道或客戶文件時,從 資料就緒 開始。
- 團隊已有可運行試點並需要穩定複盤證據時,從 工作流程運行記錄 開始。