3.6 KiB
3.6 KiB
created, type, status, deadline
| created | type | status | deadline |
|---|---|---|---|
| 2026-03-29 | project | active |
Smart Support
AI 客服行动层框架。粘贴你的 API，获得一个能执行真实操作的智能客服。
目标
解决现有客服工具（Zendesk、Intercom）自动化率卡在 20-30% 的问题。这些工具能回答 FAQ，但无法执行内部系统操作。Smart Support 作为「行动层」补充，让 AI 直接调用客户的内部系统完成查订单、取消订单、发优惠券等操作。
架构
客户 → React Chat UI → FastAPI WebSocket → LangGraph Supervisor → Agent → MCP Tools → 客户内部系统
核心组件：
- langgraph-supervisor v1.1 - 多 Agent 编排
- langchain-mcp-adapters - MCP 工具集成
- PostgresSaver - 会话状态持久化
- interrupt() - 写操作人工确认
技术栈
- Python 3.11+, FastAPI, LangGraph v1.1
- React（前端）, PostgreSQL（Docker Compose）
- Claude Sonnet 4.6（可切换 LLM）
核心特性
- 多 Agent 协作，YAML 驱动配置
- OpenAPI 规范自动生成 MCP 服务器 + Agent 配置（LLM 辅助分类 + 人工审核）
- 写操作人工确认（30 分钟超时自动取消）
- 对话回放 + 数据分析仪表盘
- Webhook 升级通知
- 垂直行业模板（电商、SaaS、金融科技）
开发阶段
| 阶段 | 周期 | 内容 | 状态 | 详情 |
|---|---|---|---|---|
| Phase 1 | 第 1-3 周 | 核心框架 | COMPLETED (2026-03-30) | Smart Support/Phase 1 - 核心框架 |
| Phase 2 | 第 3-4 周 | 多 Agent + 安全 | 未开始 | Smart Support/Phase 2 - 多 Agent + 安全 |
| Phase 3 | 第 4-6 周 | OpenAPI 自动发现 | 未开始 | Smart Support/Phase 3 - OpenAPI 自动发现 |
| Phase 4 | 第 6-7 周 | 分析 + 回放 | 未开始 | Smart Support/Phase 4 - 分析 + 回放 |
| Phase 5 | 缓冲周 | 打磨 + 演示 | 未开始 | Smart Support/Phase 5 - 打磨 + 演示 |
目标用户
中型电商公司（日均 500-5000 订单，5-20 名客服）的客户体验负责人。
仓库
- 代码：
ssh://git@git.colacoder.com:2200/kai/smart-support.git - 分支：
main - 本地路径：
/Users/yiukai/Documents/git/smart-support
完整文档（已同步）
- Smart Support/Architecture - 系统架构文档（12 章，含 ADR、数据库设计、API 协议）
- Smart Support/Development Plan - 详细开发计划（6 Phase，任务清单 + 检查点 + 风险）
- Smart Support/Phase 1 Dev Log - Phase 1 开发日志（88% 覆盖率，82 个单元测试）
计划文档
项目根目录下：
design-doc.md- 设计文档（问题定义、约束、方案选择）ceo-plan.md- CEO 计划（产品愿景、范围决策）eng-review-plan.md- 工程评审（架构决策、测试策略、失败模式）eng-review-test-plan.md- 测试计划（测试路径、边界情况、E2E 流程）TODOS.md- 待办事项
关键决策
- 用 LangGraph 内置能力（supervisor、checkpointer、interrupt），不自己造轮子
- PostgresSaver 从第一天起使用，为后期分析和回放打基础
- OpenAPI 导入生成完整 MCP 服务器（非简单 @tool 函数），LLM 辅助端点分类
- 路由错误时有 fallback agent 兜底
- 解决率定义：成功工具调用 + 未升级
- Token 用量从第一天起记录
待解决
- 认证/授权系统（生产部署前）
- 多租户架构（第一个付费客户后）
- CI/CD 流水线（原型阶段手动部署）
- 路由准确率评估数据集
- 过期中断处理（Phase 2 实现）
- SSRF 防护模块（Phase 3 前构建）
Related
- Billo Release Agent - 另一个 AI Agent 项目