07-client-total-interaction-flow.md 9.4 KB
07｜P0 客户端总交互流程
产品：医梦患者智能服务门户（内部代号 Adjutant）
范围：单医院、固定 Mock 患者、三个智能体、语音优先。
本图目的：让产品、设计、FastGPT、MCP 与测试人员对“患者从哪里进入、如何完成任务、结果回到哪里”形成同一理解。
1. 一张图看懂完整闭环
flowchart LR
subgraph ENTRY["① 发现与唤起"]
E1["首页统一语音入口<br/>不知道用什么服务"]
E2["首页 / 服务中心卡片<br/>明确选择某项服务"]
E3["患者状态与待办<br/>继续未完成任务"]
E4["健康记录 / 业务内嵌<br/>查看结果或再次办理"]
end
subgraph START["② 路由与任务启动"]
G["统一助手 / 任务启动器<br/>识别意图 · 加载医院和患者上下文<br/>医疗安全前置判断"]
D{"如何进入任务？"}
D1["明确能力<br/>直接创建任务"]
D2["自然语言诉求<br/>确认目标服务后创建任务"]
D3["已有 taskId<br/>恢复原任务状态"]
end
subgraph SHELL["③ 统一对话式任务界面"]
S1["最近 1–2 轮对话<br/>患者原话 + 助手理解"]
S2["已收集信息<br/>显示完整度、缺失项和修改入口"]
S3["当前唯一任务<br/>一次只追问或处理一件事"]
S4["语音主输入<br/>文字备选 + 快捷选项"]
S5["完整性与安全检查<br/>通过后才查询或执行"]
S6["操作记录<br/>可展开查看转写、规则和工具调用"]
end
subgraph AGENTS["④ 三个 P0 智能体"]
R["智能分诊挂号<br/>急诊门禁 → 挂号补槽<br/>号源选择 → 独立确认<br/>Mock 锁号 / 挂号 / 支付"]
P["报告智能解读<br/>选择或上传 → 归属确认<br/>质量 / 风险检查<br/>结构化解读"]
T["中医舌诊<br/>体质症候问答 → 舌象采集<br/>调用现有舌诊 MCP<br/>融合评估结果"]
end
X["共同异常与恢复<br/>信息不足继续追问 · 图片重传 · 工具重试<br/>医疗风险中止普通流程 · 必要时转人工"]
subgraph RETURN["⑤ 结果与患者状态回流"]
U["统一结果组件<br/>成功、风险、失败和行动建议"]
H["健康记录<br/>保存完成结果与未完成任务"]
W["首页状态与待办<br/>预约、新报告、继续舌诊、失败重试"]
end
E1 --> G
E2 --> G
E3 --> G
E4 --> G
G --> D
D --> D1
D --> D2
D --> D3
D1 --> S1
D2 --> S1
D3 --> S1
S1 --> S2 --> S3 --> S4 --> S5
S6 -.过程留痕.-> S5
S5 --> R
S5 --> P
S5 --> T
R --> U
P --> U
T --> U
R -.异常.-> X
P -.异常.-> X
T -.异常.-> X
X -.恢复任务.-> S3
U --> H --> W
W -.继续或发起新任务.-> G
2. 五段交互分别解决什么问题
| 阶段 | 患者看到什么 | 产品需要保证什么 |
|---|---|---|
| 发现与唤起 | 语音入口、服务卡、待办、健康记录 | 三项服务可发现，但患者不需要理解“智能体” |
| 路由与启动 | 系统确认准备办理的事情 | 多个入口调用同一能力；风险信号优先于普通业务 |
| 对话式任务界面 | 最近对话、已收集信息、当前追问 | 语音负责表达和补槽，卡片负责检查、修改与确认 |
| 三智能体任务 | 挂号、报告、舌诊各自的专业流程 | 共享任务壳，但不把三种业务混在一个大对话线程里 |
| 结果与回流 | 结果详情、健康记录、首页待办 | 完成结果可回看，未完成或失败任务可继续 |
3. 三类入口如何进入同一任务
3.1 统一语音入口
适合患者不知道该选择什么服务。
患者说出诉求
→ 语音转文字并回显
→ 识别挂号 / 报告 / 舌诊意图
→ 医疗风险前置判断
→ 告知准备进入的服务
→ 患者确认
→ 创建具体任务并带入已识别信息
例如：
“我头疼，帮我挂神经内科明天早上九点的专家号。”
系统进入挂号任务，并直接展示已得到的科室、日期、时间、号别；只追问缺失的医生信息。
3.2 服务卡片入口
适合患者已经知道要使用哪项服务。
点击服务卡
→ capabilityCode 已确定
→ 进入该智能体的语音任务起点
→ 患者用一句话表达完整或部分诉求
服务卡不会跳过对话式任务壳，也不会直接进入一组静态表单。
3.3 状态、待办与健康记录入口
适合恢复任务或查看结果。
| 记录状态 | 点击后的动作 |
|---|---|
WAITING_USER |
恢复最近对话、已收集信息和当前缺失项 |
PROCESSING |
回到分析或执行进度页 |
COMPLETED |
打开业务结果详情 |
FAILED |
展示失败原因，允许保留上下文重试 |
TRANSFERRED |
展示急诊、人工或线下处理指引 |
4. 统一对话式任务界面
三个智能体共用六个区域：
- 任务标题：明确当前正在办理挂号、报告解读或舌诊；
- 最近对话：保留最近 1–2 轮患者原话和助手理解；
- 已收集信息：持续显示业务字段、完整度和缺失项；
- 当前任务：一次只追问一个问题，或要求患者完成一个动作；
- 输入与操作：语音为主，文字、快捷选项、上传和标准卡片为辅；
操作记录：默认折叠，患者可查看转写、规则判断和工具步骤。
语音表达 → 回显患者原话 → 展示助手理解 → 更新已收集信息 → 高亮当前缺失项 → 语音 / 文字 / 选项补充 → 完整性与安全检查 → 进入查询、分析或确认
关键原则：
- 不做只有聊天气泡的无限对话；
- 不隐藏患者已经说过什么；
- 已收集信息在补槽过程中持续可见；
- 患者可以修改识别错误的字段；
- 具有副作用的操作必须使用独立确认卡；
- 完成后保存业务记录，不建立“机器人会话列表”。
5. 三个智能体的主路径
5.1 智能分诊挂号
语音描述挂号需求
→ 急诊安全门禁
→ 显示已收集的挂号条件
→ 逐项补齐缺失信息
→ 查询医生和号源
→ 选择具体号源
→ 独立确认挂号信息
→ Mock 锁号、挂号和支付
→ 挂号结果
必须演示：
- 一句话提供多个条件，只追问医生；
- 修改科室、日期、时间或号别；
- 胸痛和呼吸困难中止普通挂号；
- 无号源或锁号失败后保留已收集信息重新选择。
5.2 检验检查报告解读
语音说明解读诉求
→ 展示患者和目标报告类型
→ 选择院内报告或上传文件
→ 确认归属、来源和报告状态
→ 文件质量、OCR 和风险检查
→ 生成结构化解读
→ 保存报告解读记录
必须演示：
- 从首页待办直接进入指定报告；
- 从语音入口进入后再选择报告；
- 图片模糊时重传；
- 风险提示优先于普通指标解释。
5.3 中医舌诊
语音说明健康诉求
→ 展示已识别诉求
→ 完成体质与症候问答
→ 保存阶段进度
→ 舌象拍摄和图片质控
→ 调用现有舌诊 MCP
→ 融合问答与舌象结果
→ 保存中医评估记录
必须演示：
- 问答中断后继续；
- 图片模糊后重新拍摄；
- MCP 失败后保留问答和图片重试；
- 输出辅助评估和健康建议，不输出确诊或处方。
6. 结果如何回到门户
任务完成后不能只停留在对话页面：
任务结果
→ 保存到健康记录
→ 首页生成或更新状态卡
→ 患者从待办、最近记录或健康记录再次进入
典型回流：
| 任务结果 | 健康记录 | 首页变化 |
|---|---|---|
| 挂号成功 | 新增挂号记录 | 展示明日预约和就诊提醒 |
| 报告解读完成 | 新增报告解读记录 | “待解读”变为“解读已完成” |
| 舌诊问答未完成 | 保存进行中评估 | 展示“继续完成舌诊” |
| 工具调用失败 | 保存失败原因与上下文 | 展示“任务未完成，可重试” |
| 急诊风险 | 保存分流结果和依据 | 不生成普通预约，保留急诊提示 |
7. P0 固定边界
- 单家指定医院；
- 固定 Mock 患者本人，不提供登录和家庭成员切换；
- 三个能力固定开通；
- 语音使用演示转写；
- 挂号与报告使用 Mock MCP；
- 舌诊调用现有 MCP；
- 不接真实 HIS、LIS、支付和消息系统；
- 所有结果和风险规则明确标记为演示数据；
- 客户端使用稳定能力编码，不直接绑定 FastGPT App ID。
能力编码：
SMART_REGISTRATIONREPORT_INTERPRETATIONTCM_TONGUE_ASSESSMENT
8. 原型评审顺序
评审时按以下顺序完整演示：
- 首页统一语音入口识别挂号诉求；
- 挂号任务展示 5/6 已收集信息并补齐医生；
- 查询号源、独立确认并完成 Mock 挂号；
- 返回首页查看预约状态，再进入健康记录；
- 从首页新报告待办进入报告解读；
- 从服务卡进入中医舌诊并演示任务中断与恢复；
- 演示急诊打断、报告模糊和舌诊分析失败三个异常场景。
可编辑视觉源：
医梦患者智能服务门户_P0客户端总交互流程.excalidraw