Files
wecom_it_smart_desk/docs/03-技术架构/sequence-triage-flow.mermaid
T
Simon 449c6d4875 feat: 2026-07-12~13 全量更新 - AI对话链路改造+H5 v4/v5+坐席端v5+上下文感知诊断+知识库迭代3
## H5 员工端 v4 (2026-07-13 00:48 已部署)
- 人工按钮三态文案统一为"人工坐席"
- 按钮位置移至发送键和语音按钮上方(垂直堆叠)
- 点按钮直接调 store.shakeAgent(),删除 CallAgentModal 弹窗动画
- 截图快捷键提示改为"截图->粘贴:Alt+Shift+A-Ctrl+V ---> Ctrl+V"
- 移动端隐藏截图提示(CSS 媒体查询)
- AI转人工提示改为"已为您呼叫人工坐席,请稍等!"
- 坐席接入提示改为"坐席正在查看您的信息,请等待处理回复!"
- 删除"摇铃呼叫坐席"入口和文案
- 删除孤儿组件 MessageList.vue + shake 动画 CSS

## H5 员工端 v5 (2026-07-13 02:08 已部署)
- RightPanel v2.1:删除"软件安装"和"资源权限"标签页
- 移除标签栏,智能推荐(DynamicRecommend)直接展示
- 删除 SoftwareDownloads/ApprovalLinks 引用和相关 CSS

## AI 对话链路全栈改造 Phase 1-6 (已部署)
- Phase 1: Dify JSON输出 + 后端blocking解析 + 双WS推送 + 错误降级
- Phase 2: 关键词收窄(~25强意图词) + 两级分类Prompt + 删除前端checkApprovalIntent
- Phase 3: WS扩展(ai_thinking+dynamic_recommend) + ai_structured气泡 + RightPanel v2 + 选项回传
- Phase 4: VisionService接入 + 图片消息融合(5秒窗口) + 降级策略
- Phase 5: 坐席端ai_thinking指示器 + ai_structured/byod_card渲染 + handleNewMessage修复
- Phase 6: diagnosis_stage(6值) + response_time_ms计时 + 慢响应告警(>10s)

## 坐席端 v5 (2026-07-13 01:38 已部署)
- ai_structured/byod_card 只读渲染
- AI思考指示器 UI
- handleNewMessage 透传 msg_type/extra_data 修复
- 布局优化v2.0: QuickReplyBar L1+L2悬浮 + ReplyBox左右分区 + 右栏260/560px切换
- 键盘快捷键v2.3: 纯数字路由 + ESC分层撤销 + Shift+Space用event.code

## 上下文感知智能诊断闭环 (2026-07-12 已部署)
- 三层诊断(API→Script→AI) + 三段排队(VIP→info_locked→not locked)
- 答题插队 + 五场景关闭
- 迁移052(6表+6列) + queue_service + quiz_service + closing_service
- H5前端: QueueWaiting + RightPanel双Tab + InputBar三态 + ResolveConfirmCard
- 坐席前端: pending_close结单流程 + 信息锁定(Dify步骤完成+有效回答率≥70%)

## 知识库迭代3 (2026-07-12 已部署)
- 分诊交互(H5+坐席+Dify独立应用)
- 拓扑预览(ECharts只读)
- 代答排除(4种匹配器: keyword/regex/intent/category)
- 迁移051 + 44文件43测试通过

## 后端变更
- 6个Python文件改造(h5_ai_task.py/h5.py/ai_service.py/closing_service.py等)
- funny_phrase_service.py: shake/connected/keyword 默认文案更新
- session_service.py: 企微消息文案同步
- 新增: queue.py/quiz.py/triage.py/exclusion_rules.py 等API端点
- 新增: diagnostic.py/quiz.py/triage_session.py 等模型
- 新增: closing_service/queue_service/quiz_service/triage_service 等服务

## 文档更新
- CHANGELOG.md: 新增 [未发布] 区全部变更记录
- 项目管理主文档 v2.5: 新增v0.7.3版本 + 已完成看板 + 最近搞定
- 版本记录: 新增v0.7.3条目
- AI对话链路实施计划: Phase 1-6 全部标记已实施
- 新增架构图/时序图/类图(mermaid)

## 部署路径修正
- 服务器项目根路径: /opt/wecom-it-desk/
- 所有前端dist均为ro bind mount,只能在宿主机源路径操作
- 服务器nginx /h5/ 是静态文件服务(非proxy_pass)
- elFinder上传二进制不可靠(MD5不匹配),改用base64分块上传
2026-07-13 02:17:03 +08:00

75 lines
3.3 KiB
Plaintext

%% 分诊主流程时序图
%% 来源:增量设计-知识库迭代-开发任务分解-20260712.md §2.5
sequenceDiagram
participant H5 as H5 员工端
participant API as FastAPI 后端
participant TriSvc as TriageService
participant DifyTri as Dify 分诊应用
participant DB as PostgreSQL
participant AG as 坐席端看板
participant WS as WebSocket
rect rgb(255, 243, 224)
Note over H5,DB: 阶段1:发起分诊
H5->>API: POST /api/h5/triage/start {conversation_id, question}
API->>TriSvc: start_triage(conversation_id, question)
TriSvc->>DB: INSERT triage_sessions (status=triaging)
TriSvc->>DifyTri: 调用分诊 prompt(拆分问题为分步选择题)
alt Dify 5秒内响应
DifyTri-->>TriSvc: {steps[], confidence, urgency, suggested_route, problem_type}
TriSvc->>DB: UPDATE triage_sessions SET triage_steps, confidence, urgency, suggested_route
TriSvc-->>API: {triage_id, steps, total, confidence, urgency, suggested_route}
API-->>H5: {triage_id, steps, total, ...}
else Dify 超时(>5s)
TriSvc->>DB: UPDATE triage_sessions SET status=timeout
TriSvc-->>API: 超时,自动转人工
API-->>H5: 分诊超时,已转人工
end
end
rect rgb(227, 242, 253)
Note over H5,DB: 阶段2:分步选择 + 坐席协同
loop 每一步
H5->>API: POST /api/h5/triage/step {triage_id, step_index, selected_label}
API->>TriSvc: submit_step(triage_id, step_index, selected_label)
TriSvc->>DB: 记录 collected_context
TriSvc->>DifyTri: 根据选择动态调整后续步骤
DifyTri-->>TriSvc: next_step
TriSvc-->>API: {next_step, collected_context}
API-->>H5: {next_step, collected_context}
end
Note over AG: 坐席看板实时查看分诊进度
AG->>API: GET /api/agent/triage/pending
API-->>AG: 待分诊列表
AG->>API: GET /api/agent/triage/{triage_id}
API-->>AG: 分诊详情
opt 坐席排除选项
AG->>API: POST /api/agent/triage/{triage_id}/exclude-options {excluded_labels}
API->>WS: WS 推送 excluded_labels 到 H5
WS-->>H5: {type: "triage_exclude", excluded_labels}
H5->>H5: TriageCard.setExcludedOptions(labels)
end
end
rect rgb(232, 245, 233)
Note over H5,DB: 阶段3:分诊完成 / 转人工
alt 所有步骤完成
H5->>API: POST /api/h5/triage/complete {triage_id, context}
API->>TriSvc: complete_triage(triage_id, context)
TriSvc->>DifyTri: 根据收集的上下文生成最终回复
DifyTri-->>TriSvc: {reply, confidence}
TriSvc->>DB: UPDATE triage_sessions SET status=routed, route_action=ai_self
TriSvc-->>API: {reply, confidence}
API-->>H5: AI 回复
else 转人工
H5->>API: POST /api/h5/triage/transfer {triage_id, context}
API->>TriSvc: transfer_to_human(triage_id, context)
TriSvc->>DB: UPDATE triage_sessions SET status=routed, route_action=human
TriSvc-->>API: 转人工成功
API-->>H5: 已转人工
end
end