設施營運 AI 工具
設施營運使用共享 AI 工具面，協助 Agent 和產品工作流程審閱資產、告警、工單、現場巡檢、能源記錄、設施分析和證據包。
當 Agent 工作流程或後端整合需要了解可用工具和審閱路徑時，使用本頁。
工具層
| 層 | 主要使用者 | 訪問邊界 | 輸出類型 |
|---|---|---|---|
/mcp/base/ MCP 工具 | Agent 客戶端、copilot、工作流程編排器 | base.read、base.compute.run 和選擇性的 base.action.write scope | 資產上下文、文件、狀態摘要、資料品質、分析輸出、動作草稿 |
/api/v1/ai/* 後端代理 | 設施營運 UI 和後端服務 | 產品服務認證和租戶權限 | 能源分析、設備知識、知識圖譜審閱、根因和影響摘要 |
/ai/* AI Engine endpoint | 設施、SmartFM、能源和 FMS 工作流程 | 產品服務認證和工作流程權限 | 能源畫像、基準、Advisor chat、VAV 診斷、冷機效率、工單文本抽取、模擬結果 |
/api/v1/* 模組 API | 設施營運 UI 和後端整合 | 產品 RBAC scope | 工單、worker 任務、巡檢、營運讀模型、資產中心、模型資產、能源、FMS、ESG、Green Mark 證據 |
Agent 需要跨營運記錄的受治理訪問時使用 MCP 工具。產品工作流程執行受控分析、診斷、文本結構化或模擬任務時使用 AI Engine endpoint。
MCP endpoint 和 scope
| Endpoint | Scope | 用途 |
|---|---|---|
/mcp/base/ | base.read | 讀取資產上下文、設備狀態、文件、連接器狀態、合規檔案、工作流程任務和 action plan 歷史。 |
/mcp/base/ | base.compute.run | 執行已核准的能源、空間、預測、異常、模擬、最佳化和報告生成任務。 |
/mcp/base/ | base.action.write | 在負責人核准後建立工單草稿。 |
早期 Agent 工作流程應保持唯讀。客戶定義負責人審批、稽核捕獲和回滾處理後，再增加寫入 scope。
MCP 工具地圖
營運上下文和證據
| 工具 | 主要用途 | 典型問題 |
|---|---|---|
get_equipment_status | 讀取設備狀態、最新感測器讀值、活動告警和近期工單。 | “這台泵現在發生了什么？” |
get_equipment_documents | 檢索手冊、SOP、圖紙、維護記錄和相關文件。 | “技術員應該查看哪份 SOP？” |
search_documents | 按關鍵詞、類型或關聯實體搜尋 ECM 文件。 | “尋找這個房間最新的巡檢流程。” |
query_knowledge | 查詢設備類型、故障模式、維修動作、診斷規則和維護計畫。 | “這個告警常見原因是什么？” |
get_action_plan_history | 審閱歷史 action plan、審批狀態、執行結果和關聯文件。 | “以前試過這個處理方式嗎？” |
get_pending_tasks | 讀取工作流程中的審批、審閱或簽核任務。 | “哪些維護報告還在等待審批？” |
get_compliance_documents | 按標準或主題檢索證书、稽核報告和證據包。 | “顯示這個條款相關證據。” |
資料和連接器就緒度
| 工具 | 主要用途 | 典型問題 |
|---|---|---|
list_connectors | 列出連接器狀態、來源和最後同步時間。 | “哪些 BMS 或 CMMS 連接器在線？” |
check_data_quality | 審閱完整性、準確性、一致性、及時性和主要違規項。 | “這個資料集能用於營運摘要嗎？” |
troubleshoot_connector | 診斷連接器錯誤和近期同步日志。 | “為什么表計讀值沒有更新？” |
import_data | 匯入並處理外部 REST 或 CSV 記錄。 | “匯入這份維護歷史用於審閱。” |
設施分析
| 工具 | 主要用途 |
|---|---|
calculate_emissions | 按 scope 和區域默認因子計算溫室氣體排放。 |
analyze_spare_parts | 審閱備件使用、慢動庫存、缺貨風險和補貨建議。 |
forecast_timeseries | 對時間序列進行預測。 |
detect_anomaly | 對資料點進行異常評分。 |
generate_report | 生成狀態、告警、設備或模擬報告。 |
analyze_spatial_anomaly | 檢測空間熱力圖感測器異常。 |
compare_zones | 比較區域或樓層統計。 |
recommend_sensor_placement | 根據涵蓋缺口建議感測器位置。 |
find_path | 在建築中尋找跨樓層和可達性路徑。 |
create_work_order | 從已核准建議建立工單草稿。 |
create_work_order 只應在工作流程具備寫入 scope 且操作員已核准動作文本、負責人、位置、資產、優先級和證據引用後調用。
AI Engine 與後端代理
| Endpoint | 目的 | 需要準備的輸入 | 需要審閱的輸出 |
|---|---|---|---|
/api/v1/ai/energy/analyze, /ai/energy/analyze | 分析設施或設備能耗讀值。 | 表計對應、時間窗口、資產上下文、執行規劃、天氣或負載上下文。 | 異常說明、建議、碳估算和證據引用。 |
/api/v1/ai/energy/profile, /ai/energy/profile | 構建設備能耗畫像。 | 設備 ID、近期讀值、基線窗口、設備類型、執行模式。 | 畫像摘要、典型範圍、異常指標和建議檢查項。 |
/api/v1/ai/energy/benchmarks, /ai/energy/benchmarks | 與基準參考比較能源表現。 | 建築或設施類型、區域、時間窗口、歸一化能耗輸入。 | 基準類別、偏差和審閱說明。 |
/ai/advisor/chat | 執行設施管理助手對話。 | 使用者問題、租戶上下文、資產或告警上下文、證據片段。 | 回答草稿、工具調用軌跡、缺少證據和下一步檢查。 |
/api/v1/ai/graph/root-cause | 用知識圖譜審閱可能根因。 | 告警、資產、相關系統、巡檢發現、工作記錄。 | 根因候選和支撐路徑。 |
/ai/hvacops/vav/diagnostics/summary | 匯总 VAV 診斷狀態。 | VAV 讀值、設定點、風量、溫度、時間窗口。 | 診斷摘要、影響區域和工程檢查建議。 |
/ai/hvacops/chiller/efficiency | 審閱冷機效率。 | 冷機負載、COP、環境條件、執行狀態、設備元資料。 | 效率摘要、比較說明和執行審閱輸入。 |
/ai/sim/extract-kpis, /ai/sim/build-idf, /ai/sim/run | 準備並執行 EnergyPlus 方向的建築模擬。 | 建築幾何、分區、材料、時程、天氣、表計資料、執行假設。 | KPI 列表、IDF payload、執行狀態、模擬輸出和假設。 |
推薦工具序列
| 場景 | 推薦路徑 |
|---|---|
| 日常營運分診 | list_connectors -> check_data_quality -> get_equipment_status -> 文件檢索 -> generate_report |
| 告警到工單 | get_equipment_status -> query_knowledge -> get_action_plan_history -> 根因審閱或 Advisor -> 審批後建立工單 |
| 能源與可持續審閱 | list_connectors -> check_data_quality -> /ai/energy/profile 或 /ai/energy/analyze -> calculate_emissions -> 報告 |
| Green Mark 證據準備 | 合規文件 -> 到期文件 -> 文件搜尋 -> 資料品質檢查 -> 證據包組裝 |
| FMS 診斷審閱 | 設備狀態 -> 設備文件 -> 知識查詢 -> VAV 或冷機診斷 -> 維護摘要 |
資料要求
- 穩定的租戶、站點、樓層、區域、空間和設備 ID；
- BMS、CMMS、巡檢、表計、ESG 和證據系統的來源系統 ID；
- 带時間戳的感測器讀值、表計讀值、告警、巡檢記錄和工單更新；
- 來源新鮮度和 DFS 品質說明；
- 設備手冊、SOP、圖紙、維護記錄和合規證據；
- 表計單位、碳因子、費率假設、天氣上下文和執行規劃；
- 需要空間上下文時的模型資產和 twin-model 綁定 ID；
- 工單草稿、證據包和外部報告的審批負責人。
輸出審閱清單
- 租戶、站點、資產、表計和來源系統 ID 可見。
- 使用來源資料時包含連接器狀態和資料新鮮度。
- 工單和巡檢記錄包含負責人、狀態、時間戳和稽核引用。
- 能源和碳輸出顯示假設、時間窗口、單位和來源對應。
- 診斷輸出連接到支撐讀值、文件和執行上下文。
- Green Mark 或 ESG 證據在專案負責人核准前保持內部審閱狀態。
- 動作草稿與已核准工單保持分離。