FA 一键诊断 — Best Case Mock 数据（BIZ20260722092728UDCTTH）
用途：产品宣发展示，模拟「语音建单 + 一键诊断」全链路效果。
场景：用户语音建单「一楼大厅空调不制冷」→ 自动生成报修单 → 一键诊断 → 诊断报告（E07 执行器失步）。
工单：
BIZ20260722092728UDCTTH设备：空调机组 AHU-012（组合式空气处理机组，基于真实物模型 26 点位，含 FaultCode 故障码信号）
一、场景总览
1.1 链路全景
用户语音："一楼大厅空调不制冷，有点热"
↓ ASR 语音转写
"一楼大厅空调不制冷"
↓ 空间解析（空间-设备绑定）
空间：金螳螂西环路/总部大楼/1F/大厅 → 设备：AHU-012
↓ 自动建单
报修单 BIZ20260722092728UDCTTH（报修对象 AHU-012 / 位置 1F大厅 / 描述 不制冷）
↓ 一键诊断
诊断报告：执行器失步(E07) + 排查步骤1.2 建单方式说明
- 多模态建单：基础形态为 ASR 语音建单；若用户能提供图片，可进阶为图片建单。
- 本场景放弃图片建单：AHU 是集中式空气处理机组，房间内只有被动出风口、没有内机面板可供拍摄，故无法通过图片识别建单，降级为语音建单。
- 一键诊断范围：只到诊断报告输出。诊断之后是否再传图（维修照片）属于工单闭环，一键诊断产品不关注。
二、工单信息
工单编号: BIZ20260722092728UDCTTH
建单方式: ASR 语音建单（用户语音 → 自动生成）
报修对象: 空调机组AHU-012
报修位置: 金螳螂西环路/总部大楼 1F 大厅
故障描述: 1F大厅空调不制冷,室温异常偏高。明天早上有重要会议,今晚必须处理好。
等级: 紧急
状态: 待处理
创建人: 王经理（行政部）
创建时间: 2026-07-28 17:30
资产ID: AST-2024-AHU012
device_id: DEV-AHU-012三、一键诊断 — 数据输入
3.1 报修单解析
解析报修单得到：repair_case=device、asset=AST-2024-AHU012、device=DEV-AHU-012、故障描述=「1F大厅空调不制冷」。
3.2 资产上下文（核心数据源）
按设备/资产查询资产上下文，返回：资产档案 + IOT 实时信号（26 点）+ 告警历史 + 维保/巡检/工单历史。
资产档案
| 项目 | 值 |
|---|---|
| 资产名称 | 空调机组AHU-012 |
| 资产编码 | ntkt2024011500012 |
| 资产类型 | 组合式空气处理机组 |
| 品牌 / 型号 | 天加 (TICA) / TAC0815CHW |
| 物理位置 | 金螳螂西环路/总部大楼 > 1F > AHU 机房 |
| 服务区域 | 1F 大厅 |
| 关联设备 | AHU-012 控制柜（DEV-AHU-012） |
IOT 实时信号（26 点）
| 信号 | 标识符 | 当前值 | 参考范围 |
|---|---|---|---|
| 回风温度 | ReturnAirTemperature | 30.8°C | — |
| 回风温度设定 | ReturnAirTemperatureSet | 24.0°C | — |
| 送风温度 | SupplyAirTemperature | 26.5°C | 14~18°C |
| 送风温度设定 | SupplyAirTemperatureSet | 18.0°C | — |
| 回风湿度 | ReturnAirHumidity | 65.0% | 40~60% |
| 回风湿度设定 | ReturnAirHumiditySet | 55.0% | — |
| 运行模式 | OperationMode | 制冷 | — |
| 季节模式 | SeasonMode | 夏季 | — |
| 风机运行状态 | FanRunningStatus | 停机 | — |
| 风机故障状态 | FanFaultStatus | 故障 | — |
| 风机变频器频率反馈 | FanFrequencyFeedback | 0.0Hz | 20~50Hz |
| 风机压差 | FanDifferentialPressure | 停机 | — |
| 风机启停控制 | FanStopStartControl | 关 | — |
| 风机手/自动转换 | FanManualAutomatic | 自动 | — |
| 冷水阀阀位反馈 | ColdWaterValveFeedback | 85.0% | 60~80%（夏季） |
| 热水阀阀位反馈 | HotWaterValveFeedback | 0.0% | 夏季 0% |
| 新风温度 | FreshAirTemperature | 37.5°C | — |
| 新风阀阀位反馈 | FreshAirValveFeedback | 30.0% | 最小新风 |
| 回风阀阀位反馈 | ReturnAirValveFeedback | 70.0% | — |
| 初效滤网报警 | PrimaryFilterAlarm | 正常 | — |
| 中效滤网报警 | MediumFilterAlarm | 正常 | — |
| 防冻开关报警 | AntifreezeAlarm | 正常 | — |
| 烟雾报警 | SmokeAlarm | 正常 | — |
| BA/平台模式 | BA_Nimbus | BA模式 | — |
| 累计运行时间 | RunTime | 8500h | — |
| 故障码 | FaultCode | E07 | 0=正常 / E01~E99=故障码 |
关键信号标注：
- 回风温度 30.8°C / 设定 24°C（偏差 +6.8°C）→ 制冷严重不足
- 风机停机 / 故障状态；频率 0Hz → 风机未运行
- 冷水阀开度 85%（正常范围 60~80%）→ 水侧无异常
- 故障码 FaultCode=E07 → AHU 控制器上报执行器失步
- 最近巡检（7/25）已有"偶闪 E07"异常记录
- 5 月曾有同设备历史报修：执行器异响卡涩，当时更换过执行器
告警记录（近 30 天）
| 时间 | 等级 | 内容 |
|---|---|---|
| 07-28 17:25 | 紧急 | 执行器失步保护(E07) — 面板显示E07，风机间歇性停机 |
| 07-28 14:10 | 紧急 | 执行器失步保护(E07) — 自动恢复后再次触发 |
| 07-27 09:30 | 一般 | 执行器失步保护(E07) — 首次触发，自动恢复 |
告警由 IOT 信号
FaultCode ≠ "0"经告警规则触发，3 次间隔 24h→3h 递缩。
维保 / 巡检 / 工单历史
- 保养记录 3 条：最近 7/10 含「冷水阀执行器功能测试 正常」
- 巡检记录 3 条：7/25 异常（偶闪 E07）、6/20 正常、5/18 正常
- 历史工单 1 条：2026-05-20 冷水阀执行器异响卡涩，现场润滑复位
- 备件更换 1 条：2026-05-20 更换冷水阀执行器（TAC 原厂）×1
3.3 故障打标（基于用户描述）
打标节点根据用户描述与分类树，选出故障分类：
{
"systemName": "暖通空调",
"componentName": "空调机组",
"faultSymptom": "制冷效果差",
"confidence": "high",
"reasoning": "用户描述 1F 大厅空调不制冷、室温偏高，属于空调机组制冷效果异常，归入暖通空调/空调机组/制冷效果差。"
}说明：打标仅基于用户描述，分到粗分类「制冷效果差」；E07 故障码由诊断阶段结合 IOT 信号与告警记录收敛得出，不出现在打标阶段。
3.4 知识库检索（RAG 元数据过滤）
用粗分类结果作为 RAG 元数据过滤条件检索知识库——即 systemName=暖通空调、componentName=空调机组、faultSymptom=制冷效果差 命中相关文档，query 为「空调不制冷、室温偏高」等用户现象。命中 4 篇文档：
| # | 文档 | 关键内容 | 文档ID |
|---|---|---|---|
| 1 | 故障码速查表 - AHU 天加TAC系列 | E07=失步保护；断电复位重新校准，反复触发需更换执行器 | AHU-FAULT-CODE-001 |
| 2 | 天加TAC系列AHU安装维护手册 §2.4 | 电动阀手动驱动测试步骤 | TAC-AHU-MAINT-0024 |
| 3 | 空调机组常见故障诊断手册-通用篇 §3.3 | 风机异常停机：执行器失步连锁停机 → 面板报E07 | AHU-DIAG-GEN-0033 |
| 4 | 楼宇自控冷水阀执行器调试手册 §3.4 | 执行器失步(E07)原因与标准处理流程 | BAS-VALVE-DEBUG-0034 |
四、一键诊断 — 诊断结论
4.1 多源收敛
诊断 LLM 综合 打标结果（制冷效果差）+ IOT 信号（FaultCode=E07、风机停机、温度偏高）+ 告警记录（3 条 E07）+ 历史工单（5 月执行器更换），收敛出具体故障：
- 故障分类：暖通空调 / 空调机组 / 执行器失步停机(E07)
- 主因判断：冷水阀执行器齿轮磨损导致反复失步（可能性：高）
4.2 诊断报告
安全提示：排查前须断开 AHU 控制柜电源并执行 LOTO（上锁挂牌），接触执行器前确认阀体温度（冷水管路可能结露），佩戴绝缘手套。
故障概述
1F 大厅空调不制冷，室温异常偏高；IOT 告警发现 AHU-012 近期触发 3 次 E07 失步保护。回风温度 30.8°C 较设定 24°C 偏差 +6.8°C，制冷效果严重下降。E07 告警近期已触发 3 次，间隔从 24h 加速缩短至 3h，属快速复发的间歇性故障 [C:4]。
工况与指标
| 指标 | 当前值 | 期望值 | 状态 |
|---|---|---|---|
| 回风温度 | 30.8°C | 24.0°C（设定） | 偏差 +6.8°C |
| 送风温度 | 26.5°C | ≤18.0°C（设定） | 偏高 |
| 风机运行状态 | 停机 | 运行 | 异常 |
| 风机故障状态 | 故障 | 正常 | 异常 |
| 风机频率反馈 | 0.0Hz | 20~50Hz | 异常 |
| 冷水阀开度 | 85.0% | 60~80% | 正常 |
| 热水阀开度 | 0.0% | 0%（夏季） | 正常 |
| 新风温度 | 37.5°C | — | 室外高温 |
| 初/中效滤网 | 正常 | — | 正常 |
告警
近 30 天共 3 条 E07 失步保护告警，告警间隔从 24h 急剧缩短至 3h，说明执行器失步问题正在加速恶化。
可能原因
冷水阀执行器齿轮磨损导致反复失步（可能性：高）
- E07 故障码明确指向「失步保护」[C:1]
- 同设备 5 月份曾因执行器异响卡涩报修，当时执行器已更换（来源：资产上下文-历史工单）
- 更换后仅 2 个月再次出现 E07，可能存在齿轮箱批次质量缺陷或安装校准不到位
- 告警间隔加速缩短（24h→3h），符合齿轮磨损逐渐加剧的特征
供电电压瞬时波动导致执行器丢步（可能性：中）
- 电压波动是执行器失步的常见诱因 [C:1]
- 需确认同一回路上其他设备是否同步出现异常
阀芯轻微卡涩触发执行器过力矩保护（可能性：中低）
- 上次维保（7/10）测试结论为「正常」，阀芯卡涩可能性较低
- 但不排除水质问题导致阀芯结垢，增加转动阻力
DDC 控制信号异常导致执行器反复定位（可能性：低）
- 冷水阀当前开度 85%（正常），说明控制信号链路基本正常
- 仅在风机停机期间信号才异常，可能性较低
排查步骤
断电复位（第一优先级）
- 断开 AHU 控制柜电源 30 秒，重新上电
- 观察面板 E07 是否消除，空调能否正常启动
- 若一次性解决且不再复发 → 偶发性电压波动导致
执行器校准测试
- 长按执行器面板「MODE」键 5 秒进入校准模式 [C:1]
- 观察阀门是否全程动作（全关→全开），LED 是否变为绿色
- 若校准过程中阀门卡涩或报错 → 执行器内部机械故障
观察复发间隔
- 复位/校准后记录 E07 再次触发的时间间隔
- 若 < 4 小时复发 → 执行器齿轮已严重磨损，需更换
检查电源稳定性
- 测量执行器供电端子电压，确认是否在额定范围内（如 24VAC ±10%）
- 检查同回路其他设备运行状态
更换执行器
- 若以上步骤均无效或复发间隔短 → 更换冷水阀执行器（TAC 原厂）
- 上次更换记录：2026-05-20；建议检查新执行器生产批次
需现场核实
- 断电复位后 E07 是否清除
- 执行器手轮盘动是否顺畅，有无卡涩感
- 控制柜电源指示灯及电压表读数
本建议仅供参考，如有疑难请升级处理。
4.3 引用来源（4 条）
[C:1] 故障码速查表 | [C:2] 天加TAC系列AHU维护手册 | [C:3] 空调机组常见故障诊断手册 | [C:4] 冷水阀执行器调试手册
五、系统数据准备
5.1 需要在系统中建立的内容
| 内容 | 说明 |
|---|---|
| 空间 | 建立「金螳螂西环路/总部大楼/1F/大厅」空间 |
| 空间-设备绑定 | 1F大厅 → AHU-012 |
| 设备资产 | AHU-012（AST-2024-AHU012 / DEV-AHU-012），26 点物模型含 FaultCode |
| 知识库 | 上传故障码速查表（含 E07）等 4 篇文档 |
5.2 数据准备清单
| 系统 | 改造内容 |
|---|---|
| IOT 平台 | mock 新点位 FaultCode（故障码），设置参考范围 |
| 告警规则 | FaultCode ≠ "0" 时触发告警 |
| 巡检系统 | 7/25 写入"偶闪 E07"异常记录 |
| 保养记录 | 录入 7/10、4/8、1/10 三次保养记录 |
| 报修历史 | 录入 5/20 执行器异响报修工单，关联备件更换 |
| 空间绑定 | 录入「1F大厅 → AHU-012」 |
5.3 关键注意点
注意点 1：为什么用户输入是「不制冷」而非「E07」、为什么特意选 1F 大厅
（一）用户看不到 E07：用户（在 1F 大厅）看不到 AHU 的 E07 错误码——E07 显示在机房 AHU 控制柜面板上，房间内只有被动出风口、没有内机面板。最初的 mock 例子设定"用户看到面板显示 E07 后报修"，逻辑不闭环，因此改为：用户只报现象（不制冷）→ 系统通过 IOT 数据关联自动发现 E07。这是整个场景设计的起点，决定了后续打标与诊断逻辑。
（二）为什么特意选 1F 大厅：一般 AHU 是一对多——一台 AHU 通过风管服务多个房间。若选一个小会议室，会遇到"多个房间共享一台 AHU"的绑定难题：系统只有空间→设备单层绑定，没有"房间→父级区域→服务设备"的多级关联能力，无法把小会议室报修路由到正确的 AHU。而 1F 大厅是独立大空间，通常有独立/专用的 AHU 直接服务，空间→设备是一对一清晰绑定，正好匹配现有系统的单层绑定模型，让"大厅报修 → 关联 AHU-012 → 诊断"的逻辑成立。
注意点 2：IOT 故障码点位需要 Mock 当前物联平台上缺乏 FaultCode（故障码）这个点位，本场景需要在 Mock 环境中新增它，作为 AHU-012 物模型的第 26 个信号点，当前值设为
E07。这是整个数据链路的源头——告警由它触发、诊断由它收敛，没有这个点位，E07 无从谈起。
注意点 3：Dify 一键诊断逻辑需要调整（粗分类 → RAG 过滤 → 重分类） 现有 Dify 逻辑是基于用户描述直接打标。本场景用户描述只有「不制冷」，无法直接命中具体故障码，因此 Dify 流程需改为：
- 先粗分类：基于用户描述打标到粗分类（暖通空调/空调机组/制冷效果差）
- RAG 元数据过滤检索：用粗分类（systemName/componentName/faultSymptom）作为知识库元数据过滤条件检索
- 诊断后重分类：LLM 综合 IOT 信号 + 告警记录 + 检索结果，重分类为具体故障（执行器失步停机 E07）
- 前端展示最终重分类结果：给用户/工单看到的是重分类后的具体故障分类（E07），而非粗分类
文档版本：v3.0创建日期：2026-07-31主要变更：语音建单链路、打标粗分类→诊断收敛E07、过程节点精简为数据摘要、设备定为 AHU-012 / 空间 1F 大厅、补充三个关键注意点（用户看不到E07的根因、IOT mock点位、Dify粗分类→RAG过滤→重分类）基础工单：BIZ20260722092728UDCTTH设备：空调机组 AHU-012（DEV-AHU-012 / AST-2024-AHU012）