Files
prop-ai-hr/docs/AI陪练功能优化与缺口分析(修订).md
T

91 lines
7.9 KiB
Markdown

# AI 陪练功能优化与缺口分析(修订版 · 2026-07-06)
> 基于归档原件《originals/AI陪练功能优化与缺口分析 补充功能.docx》逐条对照代码库核实修订。
> 修订内容:更正 4 处现状盘点错误、划掉/降级 3 条已实现或半实现的"缺口"、
> 标注 2 处与既定架构决策的冲突、每条缺口标注对应 BACKLOG/规格锚点。
> 原 docx 保留归档;后续排期以本文为准。
## 一、现状盘点(更正版)
| 能力 | 状态 | 更正说明 |
|---|---|---|
| 员工端对练 /start /turn /finish 闭环 | ✅ | 移动端带 Authorization+clientid,mode=mobile 落 `aihr_practice_session` |
| AI 扮演业主(情绪/身份/诉求人设) | ✅ | 真 LLM 生成客户回复(seed 剧本作剧情锚点);**情绪值仍走 seed 锚点,未纳入 LLM 输出** |
| 语音输入 ASR → LLM → TTS 播报 | ✅(部分) | **原文"多语气播报"系夸大**:TTS 单一默认音色,多语气/方言/语速=BACKLOG B2 待办 |
| ASR 转写可编辑后提交 | ✅ | **原文漏计且缺口表误列为缺失**:转写先填入输入框,员工可修改再提交 |
| 每轮 AI 教练提示(coachHint) | ✅ | **原文漏计**:每轮 turn 返回教练提示(卡壳/流程偏差提醒) |
| 训练完成多维评分 | ✅ | 4 维:合规/沟通/情绪/营销 + 导师改写 + 点评;LLM temperature=0 结构化输出,评分仅 /finish 一次 |
| 训练历史与画像聚合 | ✅(部分) | **原文"时长"系错误**:画像只聚合分数均值,无 duration 字段与时长统计(=BACKLOG B5 已记缺口) |
| 主管端复盘列表/详情/导师改写/标记复盘 | ✅ | `GET/POST /api/aihr/mobile/practice/reviews*` |
| 场景管理(后台配置) | ❌ | **原文错误**:场景为代码写死的 2 个 seed(投诉/催费),无管理端 CRUD,`practice_scenario` 表未建(TechSpec P0 表设计在,未实施) |
## 二、24 项缺口逐条修订
图例:🔴 确认缺口 | 🟡 半有(降级表述) | ⛔ 已实现(划掉) | ⚠️ 与既定决策冲突(按决策口径执行)
### (一)训练前侧
| # | 项 | 状态 | 修订说明与锚点 |
|---|---|---|---|
| 1 | 岗位能力模型配置(按岗位设维度权重、按职级设难度) | 🔴 | ≈ BACKLOG B1(数据权限/角色)+ B8(岗位×阶段);`practice_scenario.position` 字段 TechSpec 已设计。前置依赖:岗位身份(H5_REDESIGN §5) |
| 2 | 智能训练计划引擎(每日微训练推送) | 🔴 | = B8 个性化分发引擎;蓝本已定 v1 用规则表不上 AI 排序。"推送"受限 H5 无推送通道,一期做首页「今日安排」拉取式 |
| 3 | 场景分类筛选与搜索 | 🔴 | 前置:先把场景从代码 seed 迁到 `practice_scenario` 表并做管理端 CRUD(即补上"现状盘点"第 9 行缺口),再谈筛选 |
| 4 | 训练前预习卡片 | 🟡 | **素材链路已通**:查SOP 结构化概要+总结卡即现成的"SOP要点+红线话术"卡;缺的只是挂到对练 /start 前的流程串接,前端活 |
### (二)训练中侧
| # | 项 | 状态 | 修订说明与锚点 |
|---|---|---|---|
| 5 | 业主情绪动态系统 + 情绪仪表盘 | 🟡 | 客户回复已随员工话术真实变化;缺口收窄为:①emotion 纳入 LLM 每轮输出(小改)②前端情绪仪表盘 UI(真增量)。勿按"从零建系统"排期 |
| 6 | 环境噪音模拟 | 🔴 | 新增量。实现建议:TTS 播放时前端混音本地噪音音轨(Web Audio),不动后端;音源需授权素材 |
| 7 | 训练中求助按钮 | 🔴 | 新增量。可复用查SOP检索,弹出该场景 SOP 提示;扣分策略进 rubric 配置 |
| 8 | AI 教练主动打断/引导 | 🟡 | **原文定性"无"不实**:每轮已有 coachHint 轻提示;缺的是"红线触发→中断本轮→纠正后重来"机制(COACH_CHECK 规则判定已在 TechSpec 6 章设计内) |
| 9 | 图片/视频情境输入 | 🔴 | 新增量。vision 模型已配(Qwen3-VL),技术就绪;场景素材是瓶颈,可与 B3 文生图联动 |
| 10 | 方言切换 | 🔴 | = BACKLOG B2 既有项(方言 TTS/克隆);ASR 方言识别 SenseVoice 原生支持,评分侧不区分方言 |
### (三)训练后侧
| # | 项 | 状态 | 修订说明与锚点 |
|---|---|---|---|
| 11 | 逐句评分与标注 | ⚠️🔴 | **与 TechSpec §6 既定决策冲突**("每轮不评分,评分仅 /finish 一次",防漂移+G6 成本)。修订口径:**finish 后的复盘阶段对整场 dialogue 一次性逐句标注**(单次 LLM 调用),不做训练中逐句打分 |
| 12 | 标杆对话对比(好/差示例并排) | 🔴 | 依赖案例库积累;"优秀示例"可先用导师改写充当,MVP 成本低 |
| 13 | 薄弱点定向再练(变体场景) | 🔴 | ≈ B8 分发引擎的"错题重练";变体生成可用 chat 模型改写 persona(如愤怒→委屈) |
| 14 | 训练全程录音存储与回放 | 🔴 | **文档独有亮点**。对练音频现用完即弃;存 MinIO 复用 sys_oss 链路即可。⚠️ 录像(摄像头)涉员工隐私,须过 G3/G4,建议一期只做录音 |
| 15 | 画像扩展(成长曲线/雷达/排名/错题集) | 🔴 | = BACKLOG B5 + TechSpec M6(competency_assessment/mistake_book P1 表);排名功能注意 G4 接受度,建议先做"自我对比"不做"同侪排名" |
| 16 | 自动案例沉淀(优秀/典型错误→教学案例) | 🔴 | 与 BRD 4.7 共创机制契合;复用案例审核链(review_task),脱敏走 G3 |
### (四)主管/管理侧
| # | 项 | 状态 | 修订说明与锚点 |
|---|---|---|---|
| 17 | 训练异常预警(连续不合格/超期未训/分数下滑) | 🔴 | ≈ B8 主管监控面板;H5 无推送,一期做主管端首页预警列表 |
| 18 | 主管旁听/陪练模式 | 🔴 | **文档独有亮点**,契合"数字师傅+真师傅"带教叙事;实时旁听需 WebSocket,工程量大,建议先做"事后回放"(依赖 #14)再评估实时 |
| 19 | 批量训练任务派发 | 🔴 | = B8 主管面板"指派专项"(设计基准 key-interactions 图已画);依赖任务表(TechSpec M5 daily_drill/training_camp P1) |
| 20 | 评分校准工具(人工修正回流) | 🔴 | **文档独有亮点**;与 TechSpec"一致率≥70% 校准集+人工评审"(P1)同源,修正数据即校准集来源。挂钩 G1(AI 分仅辅助参考) |
### (五)技术/数据层
| # | 项 | 状态 | 修订说明与锚点 |
|---|---|---|---|
| 21 | 语音识别结果实时纠错 | ⛔ | **已实现**:对练页与查SOP 的 ASR 转写均先入文本框、可编辑后提交。整条划掉 |
| 22 | 评分标准版本控制 | 🔴 | = TechSpec §6 既有设计(固定 prompt_version+评分缓存已实现前半);缺 rubric 后台配置+版本历史(M6 P1) |
| 23 | 训练数据脱敏 | 🔴 | = 生产前闸门 G3 的落地项;对练文本涉业主房号/姓名时自动脱敏再入库 |
| 24 | 离线训练包 | 🔴 | **文档独有亮点**,契合弱网铁律(H5_REDESIGN §1-6);但"离线对练"无 LLM 不可行,修订口径:**离线仅覆盖预习/SOP缓存/题目浏览**,对练必须在线,弱网降级文本 |
## 三、排期建议(按依赖与性价比)
1. **随手做**(依赖已就绪,单点小改):#4 预习卡串接、#5 emotion 入 LLM 输出、#7 求助按钮、#21(无需做)
2. **P2 一并做**(挂 B2/B5 既有排期):#10 方言、#14 录音存储回放、#15 画像扩展、#12 标杆对比
3. **P3 挂 B8**:#1/#2/#3/#13/#17/#19 —— 全部依赖"场景表落库+岗位身份+分发规则表"三块地基
4. **独立评估**:#11 逐句标注(按修订口径)、#20 评分校准、#16 自动沉淀、#6 噪音、#9 图片情境
5. **暂缓**:#18 实时旁听(先回放后实时)、#24 离线包(按修订口径收窄)、录像存储(G3/G4 未过)
## 四、原 docx 的错误清单(留档防再引用)
1. "TTS 多语气播报"——未实现,B2 待办
2. "场景管理(后台配置训练场景)"——不存在,场景是代码 seed
3. "画像聚合含时长"——无时长字段与聚合,B5 已记
4. 漏计:每轮教练提示、ASR 可编辑提交(后者还被误列为缺口 #21)
5. "逐句评分"未注意与 TechSpec §6"评分仅 finish 一次"决策的冲突
6. "业主情绪动态"未反映真 LLM 已上线后的现状