智慧供热 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。
- 记录时间戳、单位、质量、输入版本和模型版本。
- 将状态、异常、预测、策略和仿真输出作为审阅证据。
- 写入集成前完成项目约束、授权、审计、回退和人工接管验收。
问题处理
| 问题 | 处理方式 |
|---|---|
| 路由不可用 | 确认模块启用、部署版本、租户配置和集成合同。 |
| 状态置信度低 | 在用于后续流程前检查缺失读数、先验值、拓扑和源质量。 |
| 预测历史不足 | 使用通过审阅的替代方法，显示限制，并积累更长的代表性时段。 |
| 仿真残差未通过验收 | 重新检查拓扑、单位、实测值和标定参数。 |
| 安全检查阻止操作 | 保持阻止状态，修改操作或交由工程负责人处理。 |