AI 成长教练(AI管家)应用场景
角色标签:butler;场景编号:SC-B-01~12(空号 03、08,实编 10);关联用例:TC-B-01~12(空号 03、08,实编 10;见 ../test-cases/butler.md,三流共 30 条)。
角色定位:AI 成长教练(AI 管家,AI growth-coach)是面向家庭的主动式 AI 智能体。以家长为触达入口、孩子成长数据为底座、成长规划师为专业出口。其核心职责收敛为两大支柱:
- 问题解答:随时回答家长关于孩子成长/健康的疑问(通用咨询、报告通俗解读、报告细节追问)。
- 任务跟踪:把成长方案落到可执行——主动提醒、个性化任务/饮食推荐与采纳、方案同步后的跟进打卡、家庭成长看板聚合。
边界澄清:AI 管家 ≠ 孩子端 AI 对话(SC-C-13,孩子视角)。AI 管家不以孩子视角登录,仅在家长端触达,底层消费 POST /api/ai/health-coach/send。AI 管家无法处理或需专业干预时,转接真人管家(09-human-butler.md)或成长规划师(04-teacher.md)。
家长端入口:见 02-parent.md 的 SC-P-49(已收敛为管家入口引用,保留编号与 P0)。本文是 AI 管家角色完整能力谱系。
业务域 A:问题解答
场景 B-01:成长咨询对话(SC-B-01)
用户故事:作为家长,我想随时问 AI 成长教练「孩子便秘吃什么/怎么调理」「这个阶段该关注什么」,以便获得基于知识库的回答。
- 角色:家长(AI 管家主入口)
- 前置条件:已登录;AI 服务可用(LangGraph 或 Fallback)。
- 主流程
- 进入 AI 对话(成长教练)→
POST /api/ai/health-coach/send。
- 返回基于知识库的回答,可含产品/任务推荐。
- 多轮上下文连续(会话级记忆)。
- 异常/边界:LangGraph 不可用时
AiGateway Fallback 兜底;敏感问题不泄露隐私。
- 关联需求/设计:
AIChatController /api/ai/*;LangGraph RAG/对话。家长端入口见 02-parent.md SC-P-49。
- 关联用例:TC-B-01
场景 B-04:成长报告智能解读(SC-B-04)
用户故事:作为家长,我希望 AI 教练把专业报告翻译成人话,并关联五维给出行动建议,便于理解孩子成长状况。
- 角色:家长
- 前置条件:孩子已有成长/健康报告(已入库,见 SC-P-23/SC-P-91)。
- 主流程
- 家长选择报告 → 发起解读。
- 教练输出通俗语言解读 + 五维关联 + 行动建议。
- 可追问(见 SC-B-11)或一键采纳建议为任务(见 SC-B-07)。
- 异常/边界:无报告不解读(提示先上传);解读不超出报告范围(不杜撰指标);敏感数据脱敏展示;报告类型不一致时提示。
- 关联需求/设计:报告解析中台 /
HealthReportController 🟡(关联 SC-P-20~23)。
- 关联用例:TC-B-04
场景 B-11:报告细节追问(SC-B-11)
用户故事:作为家长,我希望就报告中的具体细节(某菌种、某风险项)继续追问,教练基于该报告上下文回答。
- 角色:家长
- 前置条件:已对该报告发起过解读(SC-B-04);报告上下文在会话内可追溯。
- 主流程
- 家长针对报告细节提问。
- 教练基于该报告结构化数据 + 知识库给出定向回答。
- 多轮深入到具体指标。
- 异常/边界:追问超出报告范围时明确提示「报告未涵盖」;脱离报告上下文的泛问回退到通用咨询(SC-B-01);不泄露其他成员报告。
- 关联需求/设计:
AIChatController 报告上下文注入 🟡。
- 关联用例:TC-B-11
业务域 B:任务跟踪
场景 B-02:主动成长提醒(SC-B-02)
用户故事:作为家长,我希望 AI 教练按用药/饮水/作息/测评到期/打卡等节点主动提醒,以免遗漏关键事项。
- 角色:家长(触达)/ 孩子(数据对象)
- 前置条件:已配置提醒项(手动或方案派生);消息推送通道可用。
- 主流程
- 提醒项到期/到点 → 教练触发提醒生成。
- 推送至家长(必要时孩子端只读可见)。
- 家长点击可跳转对应任务/预约/报告。
- 异常/边界:免打扰时段不推送(关键安全提醒除外);重复提醒去重;仅本家庭成员可见,越权家庭不可触达。
- 关联需求/设计:消息服务 / 提醒调度 🟡(
/api/notify/*)。关联 SC-P-65 通知设置。
- 关联用例:TC-B-02
场景 B-07:个性化任务/饮食推荐与采纳(SC-B-07)
用户故事:作为家长,我希望 AI 教练根据孩子五维短板或报告,自动推荐任务、心愿、饮食,并支持一键采纳为正式任务,减少我自己规划的负担。
- 角色:家长
- 前置条件:已有五维能量/成长报告作为推荐依据。
- 主流程
- 分析孩子五维短板 / 报告风险。
- 生成任务/心愿/饮食推荐清单。
- 推送家长;家长可一键采纳为正式任务或心愿。
- 异常/边界:无报告时降级为通用推荐(提示依据不足);推荐可一键采纳(采纳后落
TaskController/WishController);重复推荐幂等;过敏/忌口自动排除(关联 SC-P-28)。
- 关联需求/设计:任务/心愿/饮食推荐系统 🟡(关联 SC-P-10/SC-P-13/SC-P-26)。
- 关联用例:TC-B-07
场景 B-09:教练转接成长规划师(SC-B-09)
用户故事:作为家长,当 AI 教练识别到需专业干预的信号时,我希望它引导我转接成长规划师,而不是给不了专业结论。
- 角色:家长
- 前置条件:已绑定成长规划师(关联 SC-T-02);或提示先绑定。
- 主流程
- 教练识别专业信号(如持续异常、方案分歧、报告高风险)。
- 引导家长预约/发消息给绑定规划师。
- 生成预约(关联 SC-P-36)或消息(关联 SC-X-11),转接留痕。
- 异常/边界:未绑定规划师时提示先绑定(关联 SC-P-32);转接动作留审计;不代规划师给出诊断结论。
- 关联需求/设计:预约/消息服务 🟡(关联
AssessmentAppointmentController / 消息服务)。
- 关联用例:TC-B-09
场景 B-10:家庭成长看板(教练聚合视图)(SC-B-10)
用户故事:作为家长,我希望 AI 教练一屏聚合全家五维、任务、报告、方案,快速掌握整体成长状态与待办。
- 角色:家长
- 前置条件:家庭成员已有能量/报告/任务/方案数据。
- 主流程
- 打开家庭成长看板。
- 教练聚合展示成员五维能量、近期报告、进行中任务/方案、预警项。
- 点击任意卡片下钻。
- 异常/边界:仅本家庭成员可见;数据缺失降级展示(不报错);越权家庭 403。
- 关联需求/设计:家庭天盘/仪表板 🟡(关联 SC-P-68 家庭天盘 / SC-T-16 客户总览)。
- 关联用例:TC-B-10
场景 B-12:同步规划师建议主动跟进(SC-B-12)
用户故事:作为家长,当规划师方案生效后,我希望 AI 教练据此主动跟进(打卡提醒、进度提示),而不是我手动盯。
- 角色:家长
- 前置条件:规划师方案已激活(关联 SC-P-46/SC-T-05);教练可读取方案任务。
- 主流程
- 方案激活后,教练同步方案任务与节奏。
- 按节奏主动推送打卡提醒/进度提示。
- 异常停滞时提示家长关注。
- 异常/边界:方案未激活不触发;方案变更后教练重同步;家长可暂停教练跟进;仅本家庭任务可见。
- 关联需求/设计:成长计划/任务服务 🟡(关联
GrowthPlanController/GrowthTaskService)。
- 关联用例:TC-B-12
业务域 C:安全与韧性(横切)
场景 B-05:敏感问题拦截与隐私保护(SC-B-05)
用户故事:作为平台,我需要保证 AI 教练对违规/敏感问题拒答、且不泄露家庭成员隐私。
- 角色:系统(横切)
- 前置条件:内容安全策略/敏感词库已配置。
- 主流程
- 用户提问命中敏感词/违规类别 → 教练拒答并给出合规提示。
- 越权询问(查询非本家庭成员数据)→ 拒答。
- 异常/边界:敏感词命中即拦截(关联 SC-A-13/SC-T-28 内容安全);不泄露内部错误详情;不返回 500。
- 关联需求/设计:内容安全 /
AIChatController。
- 关联用例:TC-B-05
场景 B-06:LangGraph 不可用 Fallback(SC-B-06)
用户故事:作为用户,当 AI 底层(LangGraph)故障时,我仍能用 AI 教练的基础能力,而不是白屏或报错。
- 角色:系统(横切)
- 前置条件:
AiGateway 熔断/超时机制就绪。
- 主流程
- LangGraph 不可达/超时 →
AiGateway 触发 Fallback。
- 教练降级到规则/模板/FAQ 兜底回答。
- 明确提示「AI 服务降级中」。
- 异常/边界:降级提示明确;超时熔断不阻塞主流程;不返回 500;恢复后自动切回 LangGraph。
- 关联需求/设计:
AiGateway(熔断+超时+Fallback);关联 SC-P-40/SC-P-49 的 Fallback 口径。
- 关联用例:TC-B-06
空号说明:SC-B-03(异常指标预警)、SC-B-08(每日/每周简报)本轮移出 AI 管家核心范畴——前者属监控/运营侧能力、后者属运营侧汇总,不再作为 AI 成长教练的职责;其能力如确需保留,建议下沉至运营(05-admin.md)或跨角色(07-five-dimension.md)。
派生用例:test-cases/butler.md TC-B-01~12(空号 03、08,实编 10;正常流 10 + 异常流 10 + 权限流 10 = 30 条,已补齐)。