diff --git a/2 - Projects/Smart Support.md b/2 - Projects/Smart Support.md index 8bb3f53..a02e002 100644 --- a/2 - Projects/Smart Support.md +++ b/2 - Projects/Smart Support.md @@ -49,6 +49,58 @@ AI 客服行动层框架。粘贴你的 API,获得一个能执行真实操作 | Phase 3 | 第 4-6 周 | OpenAPI 自动发现 + MCP 服务器生成 + SSRF 防护 | 未开始 | | Phase 4 | 第 6-7 周 | 对话回放 + 数据分析仪表盘 | 未开始 | +### Phase 1:核心框架(第 1-3 周) + +- [ ] FastAPI 后端 + WebSocket 聊天端点 +- [ ] Docker Compose 配置(PostgreSQL 16 + 应用) +- [ ] PostgresSaver 检查点持久化(`.setup()` 初始化) +- [ ] LangGraph Supervisor 配置(2-3 个演示 Agent:订单查询、FAQ、升级) +- [ ] YAML Agent 注册表加载器(含验证,无效 YAML 报明确错误) +- [ ] Agent 人设配置(YAML 中 tone/greeting 字段) +- [ ] React 聊天 UI + WebSocket 连接 + 逐 token 流式渲染 +- [ ] 基础 `interrupt()` 流程(写操作触发确认提示) +- [ ] Fallback Agent(路由错误时兜底) +- [ ] Token 用量统计回调(LangChain callback,写入 PostgreSQL) +- [ ] DB 连接错误处理(try/except,返回用户友好错误) +- [ ] **集成检查点:** 第 3 周末,完整聊天闭环端到端可用 + +### Phase 2:多 Agent + 安全(第 3-4 周) + +- [ ] 完整 Supervisor 路由 + 意图分类 +- [ ] Webhook 升级通知(HTTP POST 到配置 URL,含完整对话上下文) +- [ ] Webhook 失败重试(指数退避) +- [ ] 垂直行业模板(电商、SaaS YAML 配置文件) +- [ ] 过期中断处理(30 分钟 TTL 自动取消 + 重试提示) +- [ ] **集成检查点:** 第 4 周末,多 Agent 路由 + 中断流程可用 + +### Phase 3:OpenAPI 自动发现(第 4-6 周) + +- [ ] SSRF 防护模块(屏蔽内网 IP、localhost、169.254.x,DNS 重绑定防护) +- [ ] OpenAPI 3.0 规范解析器(用 `openapi-spec-validator` 验证) +- [ ] 无效/格式错误规范 → 明确错误信息 +- [ ] 从规范生成完整 MCP 服务器(每个端点一个工具) +- [ ] LLM 辅助端点分类(读/写、客户参数识别、Agent 分组建议) +- [ ] 运维审核/修正 UI(确认 LLM 分类结果) +- [ ] 从分类结果自动生成 Agent YAML 配置 +- [ ] 异步导入 + WebSocket 进度更新(「解析规范...」「生成工具 3/50...」「完成!」) +- [ ] **集成检查点:** 第 6 周末,粘贴真实 API 规范 → 工具在聊天中可用 + +### Phase 4:分析 + 回放(第 6-7 周) + +- [ ] 自定义分页回放 API 端点(`/api/replay/{thread_id}`) +- [ ] 回放 UI(React 时间线组件,逐步展示 Agent 决策、工具调用、返回结果) +- [ ] 分析查询(解决率、Agent 使用率、升级率、每次对话成本) +- [ ] 解决率计算:成功工具调用 + 未触发升级 +- [ ] 分析仪表盘 UI + 零数据状态处理 +- [ ] **集成检查点:** 第 7 周末,完整产品演示就绪 + +### Phase 5:打磨 + 演示准备(缓冲) + +- [ ] 错误处理加固 +- [ ] 演示脚本 + 示例数据 +- [ ] Docker Compose 全栈部署配置 +- [ ] 90 秒屏幕录制 + ## 目标用户 中型电商公司(日均 500-5000 订单,5-20 名客服)的客户体验负责人。