本指南用于搭建面向设施、园区、工厂和公辅区域的 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、来源时间戳和工作记录引用。
- 证据不完整时，工作流仍能清楚说明限制。
- 动作草稿与已批准动作明确分开。
- 已完成工作结果被记录下来，用于后续工作流改进。