From d7a51684ad1942bb78a9d6df7b568eb732f74785 Mon Sep 17 00:00:00 2001
From: Yaojia Wang <yaojia.wang@colacoder.com>
Date: Sun, 29 Mar 2026 21:15:48 +0200
Subject: [PATCH] vault: add Smart Support project note

---
 2 - Projects/Smart Support.md | 91 +++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 2 - Projects/Smart Support.md

diff --git a/2 - Projects/Smart Support.md b/2 - Projects/Smart Support.md
new file mode 100644
index 0000000..8bb3f53
--- /dev/null
+++ b/2 - Projects/Smart Support.md	
@@ -0,0 +1,91 @@
+---
+created: "2026-03-29"
+type: project
+status: active
+deadline: ""
+---
+
+# 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 周 | 核心框架：Chat UI + Supervisor + Agent 注册表 + 中断流程 | 未开始 |
+| Phase 2 | 第 3-4 周 | 多 Agent 路由 + Webhook 升级 + 垂直模板 | 未开始 |
+| Phase 3 | 第 4-6 周 | OpenAPI 自动发现 + MCP 服务器生成 + SSRF 防护 | 未开始 |
+| Phase 4 | 第 6-7 周 | 对话回放 + 数据分析仪表盘 | 未开始 |
+
+## 目标用户
+
+中型电商公司（日均 500-5000 订单，5-20 名客服）的客户体验负责人。
+
+## 仓库
+
+- 代码：`ssh://git@git.colacoder.com:2200/kai/smart-support.git`
+- 分支：`main`
+- 本地路径：`/Users/yiukai/Documents/git/smart-support`
+
+## 计划文档
+
+项目根目录下：
+- `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 项目