# AI 智能体矩阵（ai-agents）

> 七个智能体运行于多智能体平台 multuex-engine。每个智能体 = **技能**（会什么）+ **工具**（能调什么）+ **记忆**（记得什么）。
> 总原则：**AI 减少填表与巡查，人不减少责任**——查询、提取、草稿、建议、触达归 AI；定级、签批、关闭、降级、锁定永远由人确认执行。时限与闸门（A1–A15）由确定性规则引擎判定，AI 不参与判定、只负责触达与减负。

## 智能体清单

| 智能体 | 技能 | 可调用工具（平台工具代理，按角色裁剪） | 记忆 | 触发 |
|---|---|---|---|---|
| **🛡 跟踪哨兵** | 断点识别、催办文案、升级判断 | **企微应用消息**、创建 HUB 任务、查节点时限、查挂起状态 | 每单跟踪上下文、催办历史（同人 24h 限 1 次）、各角色响应习惯 | 7×24 每 30 分钟巡检 |
| 📝 受理助理 | 语音转写、信息提取、定级建议 | 查客户档案、查设备档案、查知识库 | 客户报修习惯、常见故障措辞映射 | 建单页 AI 受理 |
| 🔧 维修顾问 | 故障检索、备件清单生成、维修步骤生成 | 查工单历史、查知识库、查备件库存 | 每台设备维修史、工程师操作偏好 | 工单执行、AI 助手问答 |
| 🔬 质量分析 | 根因分析（5Why/鱼骨）、纠正措施起草、横展检索 | 查同类问题、查 ECN 库、查 BOM 差异 | 机型共性问题库、历史 4D 范式 | 4D 编制页 |
| ⇄ 变更协调 | 影响面计算、物料清单生成、交期风险预测 | 查设备档案（在役）、查在制计划、查供应商交期 | 供应商交期表现、机型批次切换点 | ECN 页 AI 预清点 |
| ❖ 知识管理员 | 知识抽取、查重合并、过期检测 | 读写知识库（草稿区）、查来源单据 | 知识图谱（现象-根因-方案） | 问题单关闭事件 |
| 📊 运营摘要 | 摘要生成、归因分析、报表文案 | 读 HUB/看板/报表、**企微日报推送** | 管理层关注点、往期摘要基线 | 每日 08:30 / 按需 |

## 跟踪哨兵（专治断点与跟踪不及时）

- **断点定义**：流程「该动而未动」的时刻——节点超时限无动作、客户等待超时未回签、到料后未排产、验证期无跟进记录、工单完成后未回访。
- **处置链**：识别 → 企微催办责任人（同人 24h 限 1 次）→ 建 HUB 任务留痕 → 超时仍无进展自动升级经理 → 重大断点进晨会摘要。
- **与规则引擎分工**：时限判定（何时超时）出自规则引擎 A4/A5/A7；哨兵负责判定之后的**触达、跟到底与升级**——规则管「该不该」，哨兵管「叫得动」。
- **预置跟踪**：对可预见的断点（如 ECN 到料日）提前登记，到点自动提醒责任人排产。

## 界面呈现约定

1. **智能体中心页**（agents.html）：七卡全景（技能/工具/记忆 chips）＋今日运行统计＋工具调用审计日志。
2. **断点雷达**（board.html）：今日断点、哨兵动作、处置状态。
3. **AI 助手抽屉**：每条 AI 回答底部标注 `⚡技能 🔧工具 🧠记忆`；哨兵主动提醒以独立消息插入。
4. **来源可溯**：AI 输出标注依据；推断标「需人确认」；AI 预填字段带标记，人确认后清除。

## KPI 体系（四域八指标，V1.3 起）

| 域 | 指标 | 口径 |
|---|---|---|
| 服务体验 | 首次响应时长 / 跟踪及时率 | T0→首次客户触达；节点移动后 24h 内有跟进的比例 |
| 断点治理 | 断点率 / 重复问题率 | 每百单断点次数（哨兵识别口径）；90 天同设备同现象重复占比 |
| 闭环效率 | 服务闭环周期 / 根治闭环率 | 关闭−T0（净工作日）；ECN/TIP 关闭占比 |
| 平台价值 | AI 建议采纳率 / 企微触达响应时长 | AI 建议被采纳比例；哨兵催办→首次响应时长 |

原规格书 8.2 五项指标为本体系子集（备件一次带齐率并入维修顾问场景统计），规格书 V0.3 同步。

## 数据边界

智能体经平台工具代理访问被授权数据；不持有企微凭据（发消息走工作台消息网关）；不直连业务库写操作（写均经 BFF 接口＋审计）；敏感工具（企微消息）有频控。

## 规划中的扩展智能体（M3+，见 architecture.html）

| 智能体 | 技能 | 工具 | 记忆 | 触发 |
|---|---|---|---|---|
| 📶 **设备洞察** | 时序异常检测、健康度评估、根因佐证报告 | 读时序库、查设备档案、创建预警（联动跟踪哨兵） | 每台设备工况基线模型 | 阈值/模型触发、定时 |

- 数据来源：交付设备远程数采（节点上报，仅出站）——详见 `architecture.md`。
- 同一铁律：分析结果不自动改单，预警给建议、建单候选由人确认。
- 上线前置：设备数采试点（M2，重点机型 10–20 台）+ 时序库。

## 里程碑

- M0：AI 助手抽屉接通引擎（真对话）。
- M2：受理助理、维修顾问、知识管理员、运营摘要、**跟踪哨兵（断点雷达＋企微催办）**上线。
- M3：质量分析、变更协调上线；KPI 四域八指标自动产出。

## 验收要点

- 每个智能体能指出：技能清单、工具白名单、记忆类型、人确认点。
- 造一个断点场景：30 分钟内哨兵识别并发出企微催办，HUB 同步出现任务。
- 全站找不到任何「AI 直接提交/签批/关闭」路径。