设施运营 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 证据在项目负责人批准前保持内部审阅状态。
- 动作草稿与已批准工单保持分离。