主题
M6 AI 能效顾问（Demo 场景 PRD）
| 项 | 内容 |
|---|---|
| 文档定位 | 08_移动端AI场景设计.md §10 中反引号标记的 demo 模块的场景 PRD。本文是 M6；模板见 公共规范.md §8 |
| 通用规范 | 前端形态、系统提示词边界、定时任务方式、数据与输出规范见 公共规范.md；本文只写 M6 场景本身 |
| 能力来源 | 01_能源类AI能力-现状与自有发挥.md §4 示例 5（规则诊断解释）、§1 定位收口 |
| 版本 | v0.1 |
1. 场景定义
1.1 一句话
管理者问「3 楼空调能耗为什么高？有什么建议」，Agent 查规则诊断命中项和知识库，给出基于现有规则的诊断解释和可核实的排查建议——不生成优化策略，不通过对话控制设备。
1.2 用户与价值
| 项 | 内容 |
|---|---|
| 用户 | 管理者（demo 固定账号 M1001，数据范围全院） |
| 价值 | 不用自己拼规则命中、制度文件和历史案例；一句话拿到「可能是哪几类问题、先核实什么」 |
| 频次 | 按需，无定时推送 |
| 层级 | L2 数据查询 + L1 知识问答 |
1.3 触发方式
- 被动问答，没有定时任务。
- 典型 query：
- 「3 楼空调能耗为什么高？有什么办法？」
- 「这个能耗水平正常吗？」
- 「设备该开没开、该关没关，怎么判断？」
- 「节能改造有什么要求？」（知识库问答）
- 问题同时涉及数据和制度时，先答数据诊断，再引知识库；一轮只给一个主结论。
1.4 边界
| 不做 | 原因 |
|---|---|
| 不生成节能优化策略 | 参数调整、策略重设、运行方式改变需结合现场、可能含人工措施，暂不作为 Agent 自动建议（01 已确认） |
| 不通过对话下发控制 | 冷机、空调、照明由自控系统按策略执行；Agent 只查询和解释 |
| 不承诺节能量/回收期 | 没有经过验证的优化模型，不编造收益 |
| 不重复异常清单 | 逐条异常、证据、转工单归 M4 |
| 不做用能画像 | 总量、分项、同类对比归 M3 |
| 不做碳核算/月报 | 归 M5 |
| 不把知识库当项目事实 | 制度、标准、案例只作解释依据；项目数据以 MCP 返回为准 |
2. Demo 形态
通用形态见 公共规范.md（小程序悬浮球打开 DeerFlow 聊天区、单会话、Markdown + Mermaid）。
本场景只约定：
- 管理者在常驻会话里直接提问，回答落在聊天区，不写首页洞察卡片（M6 不是 L4 主动服务）。
- 追问沿用上下文：先问「3 楼为什么高」，再问「那我先查什么」，Agent 沿用同一空间和诊断结果。
- 回答末尾固定加一句边界说明：「以上为规则诊断解释，不含优化策略，也不通过对话控制设备。」
注：演示方式——登录管理者账号，点悬浮球，输入「3 楼空调能耗为什么高？有什么办法？」。
3. Agent 输出设计
3.1 输出元素
| 元素 | 用途 |
|---|---|
| Markdown 文字 | 结论、诊断解释、排查建议、边界说明 |
| Markdown 表格 | 规则诊断命中项 |
| Markdown 列表 | 知识库依据（制度/标准/案例） |
默认不画图；用户明确要趋势时最多 1 张 xychart-beta。
3.2 诊断解释（主场景）
用户
3 楼空调能耗为什么高？有什么办法？
Agent
目前能给的是基于现有规则诊断的解释，不是优化策略：3F 有 2 台设备在非计划时段运行，另有 1 台温度低于目标值；3F 单位面积能耗高于同类空间约 8%，但具体原因需要结合现场运行、设备状态和使用安排做专项分析。
类型 设备 命中规则 时段/数值 时段类 EF_B1_16中餐后厨排风机计划外运行 21:30 后仍运行 47 分钟 时段类 FAU_B1_4西塔客房新风应关未关 10:00–14:00 运行 1 小时 12 分 阈值类 FAU_B1_7东塔客房新风低于目标温度 最低 23.8℃，目标 25℃ 知识库依据：
- 《设备运行时段管理规范》：非计划时段运行需有加班/检修工单或现场确认；
- 《新风机组温度控制说明》：目标温度偏离需先核对传感器，再检查阀门开度；
- 同类项目案例：时段类异常多由手动覆盖或计划未更新导致，阈值类多由传感器偏差导致。
可以先核实这几件事：
- 核实这 3 台设备当天是否有加班、检修或临时使用安排；
- 核对
FAU_B1_7的温度传感器读数与现场温度计是否一致；- 确认设备运行计划是否随课表/预约更新。
以上为规则诊断解释，不含优化策略，也不通过对话控制设备。真正的节能优化（参数调整、策略重设、运行方式改变）需要结合项目实际，可能包含人工措施。
系统没有能耗定额/标准，本例的「高 8%」只与同类空间均值比较；没有同类或历史基线时，只给绝对值，不判断「正常/不正常」。
3.3 知识库问答
用户问「节能改造有什么要求」「设备该开没开怎么判断」时：
- 只答知识库中有的内容，给出来源文件/章节；
- 知识库没有时写「知识库暂无相关内容」，不凭常识编造；
- 涉及本项目具体数据时，另调工具取数，不拿通用标准当项目结论。
3.4 无诊断命中
规则诊断没有命中时：
Agent
近 {N} 天该范围未命中规则诊断，未发现时段类或阈值类异常。单位面积能耗高于同类约 {x}%，但原因需要结合现场运行、设备状态和使用安排做专项分析；当前不生成优化策略。
注：不为了「给建议」而编造原因。
3.5 异常与降级
| 情况 | 输出 |
|---|---|
| 规则未配置 | 说明「该范围未配置诊断规则」，只做知识库问答 |
| 诊断工具失败 | 说明取数失败，不给原因推测 |
| 知识库无结果 | 写「知识库暂无相关内容」，保留数据结论 |
| 用户要求优化策略 | 明确说明本期不生成优化策略；可给规则诊断解释和排查方向 |
| 用户要求直接控制设备 | 拒绝，说明控制由自控系统按策略执行 |
| 问题超出能源范围 | 说明不在本场景范围，引导到对应模块 |
| 越权空间 | 拒绝并说明授权范围 |
3.6 输出模板（开发参考）
本节给 Skill 组装输出用，业务评审可跳过。
诊断解释：
结构固定：结论 → 规则诊断命中 → 知识库解释 → 可核实的排查建议 → 边界说明。
4. MCP 设计
空间范围解析复用 M3 §4.1 的 query_space_tree：先把「3 楼」「A 楼」解析成空间树节点，再把 node_id 传给诊断与指标查询。M6 不重复定义空间树工具。
4.1 规则诊断 MCP
Tool：query_rule_diagnosis
| 项 | 内容 |
|---|---|
| 作用 | 查某范围/设备命中的行为诊断与异常诊断 |
| 入参 | scope_node_id（空间树节点，默认根节点）、start_date、end_date、device_id（可选）、types（可选） |
返回：
| 字段 | 类型 | 说明 |
|---|---|---|
| hits | array | 命中项：rule_id、rule_name、category（time_window/threshold）、device_id、device_name、space_name、time_range、observed_value、target_value、excess_kwh、severity |
| total_count | int | 命中总数 |
| rules_configured | bool | 该范围是否已配置规则 |
| data_quality | object | missing_days[]、note |
注：规则底座与 M4 相同，但 M6 只取「解释所需」的摘要，不返回逐条证据曲线；证据归 M4。
4.2 能耗指标 MCP
Tool：query_energy_metrics
| 项 | 内容 |
|---|---|
| 作用 | 查能耗总量与指标（绝对值），不提供定额/标准判定 |
| 入参 | start_date、end_date、dimension（space_node/system）、node_level（可选）、scope_node_id（空间树节点，默认根节点） |
| 返回 | total（energy_kwh、intensity、area_m2）、compare（peer_avg、peer_group、diff_pct、mom_pct、basis（peer/historical））、data_quality；无同类/历史基线时 compare 为 null |
注：系统没有能耗定额或标准，compare 只表示与同类均值或自身历史基线的差异；没有基线时只给绝对值，不说「高/低/正常」。画像结构归 M3，不在这里展开分项饼图。
4.3 知识库 MCP
Tool：search_energy_knowledge
| 项 | 内容 |
|---|---|
| 作用 | 检索能源制度、设备说明、标准与历史案例 |
| 入参 | query（string）、top_k（默认 5）、doc_types（可选：policy/manual/standard/case） |
| 返回 | chunks[]：content、source（文件名）、section、score |
注：只返回检索片段，不返回整篇文档；Agent 必须标注来源，不把片段改写成项目事实。
5. Skill 设计
5.1 职责
Skill 把「判断问题类型 → 取诊断/取知识 → 按骨架回答 → 加边界说明」写死，保证每次回答都不越界、不生成优化策略。
5.2 流程
5.3 Skill 提示词草稿
你是上海交通大学新院区 IBMS 的管理者助手，负责能源能效问答。
输入：
- 管理者 ID：demo 固定 M1001
- 数据范围：全院（demo）
步骤：
1. 先用 query_space_tree 解析空间范围，得到 scope_node_id。
2. 判断问题类型：项目数据/原因 → 查规则诊断；制度/标准/案例 → 查知识库；两者都有 → 先数据后知识。
3. 项目数据问题：调 query_rule_diagnosis(scope_node_id=…)；需要指标背景时再调 query_energy_metrics。系统没有能耗定额/标准，只与同类均值或自身历史基线比；没有基线时只给绝对值。
4. 知识问题：调 search_energy_knowledge，只答检索到的内容。
5. 按骨架回答：结论 → 诊断命中表 → 知识库依据 → 可核实的排查建议 → 边界说明。
输出要求：
- 只用 Markdown，不输出 JSON、不用 HTML；默认不画图。
- 只做规则诊断解释，不生成优化策略、不承诺节能量和回收期、不通过对话控制设备。
- 建议只写「核实/核对/确认」类排查动作，不写参数调整值、不写运行策略。
- 知识库内容必须标来源；知识库没有就写「暂无」，不凭常识编造。
- 规则未配置时说明未配置，不推断。
- 不重复 M4 的逐条异常证据、不做 M3 的画像、不做 M5 的碳核算。
- 末尾固定加：「以上为规则诊断解释，不含优化策略，也不通过对话控制设备。」5.4 工具调用顺序与失败策略
| 步骤 | 调用 | 失败时 |
|---|---|---|
| 1 | query_rule_diagnosis | 说明取数失败，不给原因推测；可退化为纯知识库问答 |
| 2 | query_energy_metrics | 省略「高多少」的对比，只给诊断命中 |
| 3 | search_energy_knowledge | 保留数据结论，标注「知识库暂无相关内容」 |
注：诊断是主数据，失败就不做原因解释；知识库是辅助，失败不影响诊断结论。
6. 定时任务配置
无。
M6 是被动问答。能源类主动推送归 M10 月度报告；异常主动处置归 O5。
7. 权限与数据范围
- 管理者账号
M1001，demo 数据范围「全院」；生产按授权空间树节点裁剪。 - 数据裁剪在 MCP 层按
scope_node_id校验，不靠提示词约束。 - 知识库按角色过滤：只检索管理者有权查看的制度/案例，不返回内部工单原文。
- 只返回聚合与诊断摘要，不返回设备原始运行全表、个人数据。
- 越权查询直接拒绝并说明当前范围。
8. 验收要点
| # | 验收项 | 标准 |
|---|---|---|
| 1 | 回答结构 | 结论 → 诊断命中 → 知识依据 → 排查建议 → 边界说明 |
| 2 | 边界 | 不出现优化策略、参数调整值、节能量承诺 |
| 3 | 控制 | 用户要求控制设备时明确拒绝并说明由自控执行 |
| 4 | 无命中 | 明确说「未命中规则」，不编原因 |
| 5 | 知识库 | 只答检索到的内容并标来源；无结果写「暂无」 |
| 6 | 规则未配置 | 说明未配置，只做知识库问答 |
| 7 | 模块边界 | 不重复 M4 证据、不做 M3 画像、不做 M5 碳核算 |
| 8 | 数据范围 | 只出现授权范围内的空间与设备 |
9. 已确认与待确认
9.1 已确认
| # | 事项 | 结论 |
|---|---|---|
| 1 | 定位 | 问答型顾问：查询、解释、汇总规则诊断 |
| 2 | 优化策略 | 本期不生成；参数调整、策略重设不作为 Agent 建议 |
| 3 | 控制 | 不通过对话下发控制，由自控系统按策略执行 |
| 4 | 知识库 | 只作解释依据，必须标来源 |
| 5 | 交互形态 | 被动问答，无定时任务 |
| 6 | 指标口径 | 没有能耗定额/标准，只与同类均值或自身历史基线比较 |
9.2 待确认
- 知识库范围：能源制度、设备手册、标准、历史案例由谁提供；是否包含内部工单与项目文档。
- 规则诊断覆盖：新院区行为/异常诊断规则是否已配置；未配置时 M6 只能做知识库问答。
- 诊断与地点的关联：规则是否都绑定空间/设备，能否落到空间树节点；无法落地的规则只能按设备维度回答。
- 「为什么高」的归因深度：只到规则命中 + 同类对比，还是要接负荷预测/机理模型；后者不在本期。
- 负荷预测是否纳入：
01提到供冷侧预测可查询/解释，但 08 的 M6 未列；若要纳入，需新增工具与边界说明。 - 建议话术边界：哪些排查动作可以写（核实、核对、确认），哪些算优化策略（调参数、改策略），需要甲方认可。
- 知识库更新机制：谁维护、多久更新、失效文档如何下线。
- 同类基线来源：同类均值按什么标签/范围算；没有同类数据时是否允许用自身历史基线。
10. 关联文档
| 文档 | 关联内容 |
|---|---|
01_能源类AI能力-现状与自有发挥.md §1、§4 示例 5/6/7 | 问答型顾问定位、规则诊断解释、优化/控制边界 |
08_移动端AI场景设计.md §7、§10 | 管理者时间线、M6 模块定义 |
00_总览-方案与主线.md §4 | Skill/MCP 分层、权限装配 |
公共规范.md | 前端形态、常驻会话、智能体边界、输出规范、场景 PRD 模板 |
注：上述文档与本文保持一致。如有差异，以本文为准，回写更新对应文档。