本指南用於搭建面向設施、園區、工廠和公用工程區域的 AI Agent 工作流程。該工作流程幫助團隊基於 DataMesh Inspector 使用的同一套數位孿生和運營記錄，查看資產狀態、理解告警、準備巡檢並生成工單草稿。
前置條件
| 要求 | 說明 |
|---|
| 資產上下文 | FactVerse Platform 中的資產層級、站點、樓層、區域、設備 ID、責任團隊和權限邊界。 |
| 運營記錄 | Inspector 告警、巡檢備註、工單、檢查表、計量讀數和現場回饋。 |
| 資料管線 | DFS 或客戶側連接器提供的訊號時間戳、品質標記和來源系統引用。 |
| 空間上下文 | Designer 場景或 Inspector 視覺化，用於定位資產並查看周邊系統。 |
| 存取控制 | 按工作流程最小權限簽發的 API key、endpoint 和 scope。 |
Endpoint 與 scope
從 /mcp/base/ 開始。
| Scope | 用途 |
|---|
base.read | 讀取資產上下文、文件、狀態、歷史記錄和相關證據。 |
base.compute.run | 運行已批准的分析，例如能耗計算、規則評估或運營摘要生成。 |
base.action.write | 在操作員批准後建立或更新動作草稿。 |
第一版應保持唯讀。只有客戶已經定義審批路徑和審計記錄後，才加入寫入 scope。
工作流程步驟
- 設定運營邊界：確認租戶、站點、區域、資產組、時間範圍和操作員角色。
- 解析資產：把使用者請求映射到 Platform 資產 ID，並核對對應的 Inspector 記錄。
- 收集證據：取得目前狀態、近期告警、巡檢、工單、文件和來源系統時間戳。
- 使用空間上下文：在 Designer 或 Inspector 場景中定位資產，並檢查可能受影響的周邊設備。
- 形成摘要：區分已確認事實、可能原因、缺失證據和建議的下一步檢查。
- 生成動作草稿：只有具備寫入 scope 且獲得人工批准時，才建立巡檢或工單草稿。
- 記錄結果：保存已批准動作、操作員備註和修正資訊，讓後續運行能夠利用已完成工作。
建議輸出結構
| 區塊 | 內容 |
|---|
| 運營摘要 | 站點、資產、目前狀態、嚴重程度、未關閉告警和來源新鮮度。 |
| 證據 | 回答中使用的訊號、巡檢記錄、工單、文件和場景引用。 |
| 缺失資料 | 預期存在但暫時不可用的訊號、文件或記錄。 |
| 建議檢查 | 現場檢查、安全檢查、周邊設備檢查或文件複核項。 |
| 動作草稿 | 包含負責人、位置、受影響資產和原因的工單或巡檢草稿。 |
常見失敗模式
| 現象 | 可能原因 | 處理方式 |
|---|
| 無法解析資產 | Platform、Inspector 或來源系統中的名稱不一致 | 要求補充站點、位置或設備 ID，確認後更新映射表。 |
| 摘要缺少近期活動 | 來源管線過期或時間戳不可見 | 顯示目前可用的最新時間戳，並發起資料新鮮度檢查。 |
| 告警上下文過寬 | 查詢邊界包含過多資產或時間範圍 | 按站點、系統、嚴重程度和時間視窗收窄範圍。 |
| 工單草稿被阻止 | 缺少寫入 scope 或審批策略 | 只返回草稿內容供操作員審核，不寫入運營系統。 |
驗證清單
- 執行時工具發現能看到預期的
/mcp/base/ 工具。
- 回答包含資產 ID、來源時間戳和工作記錄引用。
- 證據不完整時，工作流程仍能清楚說明限制。
- 動作草稿與已批准動作明確分開。
- 已完成工作結果被記錄下來，用於後續工作流程改進。