跳至主要内容

智慧供熱 AI 工具

智慧供熱透過產品 API 提供營運工作流程，並透過 AI Engine 介面執行分析計算。實際可用路由取決於模組授權、部署版本、租戶設定與專案整合。

前提條件​

  • 目標租戶已啟用智慧供熱模組。
  • 產品 API 與 AI Engine 驗證符合預期的讀取或計算工作流程。
  • 管網、站點、資產與來源 ID 已通過驗證。
  • 可以記錄輸入單位、時間戳記、品質標記與模型版本。
  • 已指定營運或工程負責人審閱輸出。

工具層級​

層級主要用途範例命名空間
產品 API總覽、站點、拓撲、歷史、異常、建議、營運日誌、報表與工單/api/v1/heatops/*
AI Engine狀態估計、異常評分、預測、管網數位孿生計算、策略準備與安全檢查/ai/heatops/*、/ai/mpc/*
DFS來源連接、對應、品質審閱、資料集準備與受治理歷史DFS API 與工作流程
Inspector 或 CMMS巡檢、工單執行、附件、關閉與回饋專案設定的工單 API

面向使用者的文字使用智慧供熱。heatops 只用於路徑、設定鍵、scope 與權限字串。

產品 API 地圖​

工作流程範例路由審閱用途
總覽與站點/api/v1/heatops/overview、/api/v1/heatops/stations、/api/v1/heatops/stations/{stationId}、/api/v1/heatops/stations/{stationId}/history確認站點範圍、狀態、新鮮度與歷史。
管網/api/v1/heatops/network/topology、/api/v1/heatops/network/leaks、/api/v1/heatops/network/hydraulic-analysis、/api/v1/heatops/network/pipeline/{pipelineId}/history審閱拓撲、疑似洩漏、水力脈絡與管線歷史。
預測/api/v1/heatops/forecast、/api/v1/heatops/forecast/weather、/api/v1/heatops/ai/forecast/load、/api/v1/heatops/ai/forecast/supply-temp結合天氣準備負載與供水溫度審閱。
異常與診斷/api/v1/heatops/anomalies、/api/v1/heatops/anomalies/patterns、/api/v1/heatops/rca/faults、/api/v1/heatops/rca/diagnose/{stationId}分流發現並查看診斷證據。
建議與日誌/api/v1/heatops/suggestions、/api/v1/heatops/suggestions/{suggestionId}/accept、/api/v1/heatops/suggestions/{suggestionId}/reject記錄營運審閱，並將接受的任務連結到營運日誌。

AI Engine 地圖​

介面輸入輸出與審閱
POST /ai/heatops/state節點讀值、先驗值、分區與濾波設定節點與分區狀態、信賴度、修正項、阻擋項與證據。
POST /ai/heatops/anomaly/detect站點特徵、室外溫度、嚴寒標記異常評分、門檻、影響特徵與候選故障類型。
POST /ai/heatops/forecast/load歷史負載、天氣、選用建築係數與預測時長負載預測、區間、模型版本與可用誤差脈絡。
POST /ai/heatops/forecast/supply-temp歷史供水溫度、天氣、選用建築係數與預測時長供水溫度趨勢、區間與模型版本。
POST /ai/heatops/twin/simulate模式、節點、管段、站點、分區與實測值水力、熱力、站點、分區四層結果及殘差報告。
POST /ai/mpc/strategy站點、目前狀態、天氣預測、供水溫度與熱慣性供水目標、變化速率、閥門調整、預測溫度、信賴度與安全報告。
POST /ai/heatops/safety/check建議操作與核准約束通過狀態、警告、阻止值、檢查約束與最高嚴重級別。
POST /ai/heatops/safety/batch多項操作與核准約束一組決策中每項操作的安全結果。

建議呼叫順序​

日常營運​

系統總覽與站點摘要
  -> 站點與拓撲新鮮度
  -> 負載與供水溫度預測
  -> 異常佇列與診斷脈絡
  -> 經過審閱的建議
  -> 營運日誌或工單
  -> 實測結果

工程情境​

版本化拓撲與輸入包
  -> /ai/heatops/state
  -> 完成校準的水力熱力分析
  -> 殘差審閱
  -> 備選情境
  -> 安全與負責人審閱
  -> 受監控的執行計畫

驗證清單​

  • 在目標環境中發現實際可用路由。
  • 每次請求前確認租戶、管網、站點與資產 ID。
  • 記錄時間戳記、單位、品質、輸入版本與模型版本。
  • 將狀態、異常、預測、策略與模擬輸出視為審閱證據。
  • 寫入整合前完成專案約束、授權、稽核、回復與人工接管驗收。

問題處理​

問題處理方式
路由不可用確認模組啟用、部署版本、租戶設定與整合合約。
狀態信賴度低用於後續流程前檢查缺失讀值、先驗值、拓撲與來源品質。
預測歷史不足使用通過審閱的替代方法、顯示限制，並累積更長的代表性時段。
模擬殘差未通過驗收重新檢查拓撲、單位、實測值與校準參數。
安全檢查阻止操作維持阻止狀態，修改操作或交由工程負責人處理。