内容
# 客户支持代理
> 独资企业操作系统代理 #9 — 分类用户消息（注册失败 / 卡住 / 账单 / 好评 / 垃圾信息 / 其他）→ 自动草拟回复 → 人机协作队列。
[](LICENSE)
[](#)
由 [Alex Ji](https://github.com/alex-jb) 构建 — 完成独资企业标准栈的第 5 层（客户支持）。
## 功能
在产品发布日或发布后，您的 inbox/PH-comments/X-DMs 会涌入用户查询。此代理：
1. 读取传入的消息（JSONL inbox 文件）
2. 将每个消息分类为 6 个模板之一，通过 Claude Haiku（或关键词 fallback）
3. 为每个非垃圾信息分类草拟回复
4. 将草稿写入 `~/.customer-support-agent/queue/pending/` 以供人机协作审查
```
$ customer-support-agent triage --inbox messages.jsonl
# 客户支持分类 — 2026-05-02T13:24:00Z
处理的消息：14
按标签分类：{'signup_broken': 4, 'love': 5, 'billing': 2, 'forge_stuck': 1, 'spam': 1, 'novel': 1}
草拟的回复队列：13
跳过的垃圾信息：1
其他（需要人工回复）：1
```
## 安装
```bash
pip install customer-support-agent
# 或
git clone https://github.com/alex-jb/customer-support-agent
cd customer-support-agent && pip install -e .
```
## 使用
### 分类一批消息
inbox JSONL 格式（每行一个消息）：
```jsonl
{"source":"email","source_id":"abc123","sender":"alice@x.com","subject":"signup not working","body":"Verification email never arrived..."}
{"source":"producthunt","source_id":"ph_456","sender":"@bob","subject":"","body":"Love this!"}
```
```bash
customer-support-agent triage --inbox inbox.jsonl
```
### 单次分类
```bash
customer-support-agent classify "I never got the verification email"
# label=signup_broken confidence=0.55
# reasoning: keyword match: signup, verification, email
```
### 查看队列
```bash
customer-support-agent queue-status
# # 待定草稿（3）
# - 2026-05-02-signup_broken-alice-x-com.md
# - 2026-05-02-billing-bob-x-com.md
# - 2026-05-02-novel-carol-x-com.md
```
## 六个默认标签
| 标签 | 触发条件 | 操作 |
|---|---|---|
| `signup_broken` | 注册/登录问题 | 同情 + 2-3 个故障排除步骤 |
| `forge_stuck` | 卡住/故障 | "我会处理" |
| `billing` | 支付/退款/订阅 | 确认 + 24 小时回复承诺 |
| `love` | 好评 | 简短感谢 |
| `spam` | 垃圾信息 | 跳过 |
| `novel` | 其他 | "我会考虑" + 人工标记 |
## 为什么所有草稿都进入人机协作队列
自动发送回复给真实用户是快速被封禁、嘲笑或发送不当信息的途径。此代理 **从不发送**。它草拟回复；您在 Obsidian 中审查；您发送（或粘贴到 Gmail / PH / X）。
## MCP 服务器
```bash
pip install 'customer-support-agent[mcp]'
```
```json
{
"mcpServers": {
"customer-support": {
"command": "customer-support-mcp",
"env": { "ANTHROPIC_API_KEY": "..." }
}
}
}
```
工具：`classify_message(text, subject?, sender?)` · `draft_support_reply(text, subject?, sender?, label?)`
## 路线图
- [x] **v0.1** — 启发式 + Claude 分类器 · 6 个标签 · 人机协作队列 · MCP 服务器 · 25 个测试
- [ ] **v0.2** — IMAP + PH GraphQL 导入（自动拉取而不是 JSONL）
- [ ] **v0.3** — 自动发送“好评”回复（前 100 次仍需人机协作，然后自动）
- [ ] **v0.4** — 反思学习：分类器从拒绝的草稿中改进
## 许可证
MIT.
---
## 🧩 [独资企业操作系统](https://github.com/alex-jb/solo-founder-os) 栈的一部分
一个不断增长的 MIT 许可代理集合，它们共享 `solo-founder-os` 作为基础库 — cron, eval, reflexion, AnthropicClient, 人机协作队列, 通知器。每个代理都独立有用；它们一起覆盖了整个独资企业工作流程。
🌐 整个栈在 [vibexforge.com](https://vibexforge.com) 上已投入生产。
| 代理 | 功能 |
|---|---|
| [solo-founder-os](https://github.com/alex-jb/solo-founder-os) | 共享基础库（cron · eval · reflexion · 技能库 · DGM-lite）。其他代理都依赖它。 |
| [build-quality-agent](https://github.com/alex-jb/build-quality-agent) | 预推送 Claude 差异审查器 + 本地构建运行器 — 在部署前捕获 CI 杀伤性更改。 |
| [customer-discovery-agent](https://github.com/alex-jb/customer-discovery-agent) | Reddit 痛点爬虫 + Claude 聚类用于产品验证。 |
| [funnel-analytics-agent](https://github.com/alex-jb/funnel-analytics-agent) | 每日创始人简报 + 9 个来源的实时 PH-day 警报。 |
| [orallexa-marketing-agent](https://github.com/alex-jb/orallexa-marketing-agent) | AI 营销代理 — 提交项目一次，获取 X / Reddit / HN / Dev.to / 小红书 + 7 个平台的原生帖子。支持 [vibexforge.com](https://vibexforge.com)。 |
| [vc-outreach-agent](https://github.com/alex-jb/vc-outreach-agent) | 冷邮件草拟器 — 投资者（vc 模式）或付费客户（客户模式，从 v0.9.0 合并）。人机协作队列 + SMTP 发送器。 |
| [cost-audit-agent](https://github.com/alex-jb/cost-audit-agent) | 6 个提供商（Vercel / Anthropic / OpenPanel / HyperDX / Supabase / GitHub Actions）的月度账单审计，带有美元标记的浪费发现。 |
| [bilingual-content-sync-agent](https://github.com/alex-jb/bilingual-content-sync-agent) | EN ⇄ 中文 i18n 差异 + Claude 翻译 + 人工应用。批量 API 路径 @ 50% 折扣。 |
| [payments-agent](https://github.com/alex-jb/payments-agent) | 过期发票提醒草拟器。Stripe 形状的类型 + MockProvider fallback + 硬货币安全提示规则。 |
*每个代理的行都被省略在它的 README 中。安装您需要的代理 — `pip install <agent-name>`。*
