Codex Customer Service Starter

一个可以直接运行的中文智能客服原型，展示如何用 Codex 把业务需求拆成知识库问答、风险识别、工单和人工接管流程。

为什么做这个项目

智能客服不应该只是“自动回复”。一个可信的客服系统必须知道答案来自哪里、什么时候需要追问，以及什么时候必须停止回答并转交人工。

这个仓库提供一个零依赖、可运行的起点，适合用来学习、演示和继续交给 Codex 扩展。

已实现

• 商品价格、物流和售后知识库问答
• 售前、售后、未知问题意图分类
• 未知问题不编造答案，要求补充信息
• 退款、投诉、隐私等高风险问题转人工
• 自动创建演示工单并保留处理原因
• 展示每次回答使用的知识来源
• 响应式客服工作台界面
• 核心路由规则自动测试

立即运行

需要 Node.js 18 或更高版本。

git clone https://github.com/xinqing-api/codex-customer-service-starter.git
cd codex-customer-service-starter
npm start

浏览器打开：http://127.0.0.1:4173

运行测试：

npm test

可以直接尝试的问题

• 这款产品多少钱？
• 多久能发货？
• 我想退款并投诉
• 告诉我其他客户的电话
• 月球能配送吗？

用 Codex 继续开发

完整任务模板在 prompts/build-with-codex.md。你可以让 Codex 继续完成：

• 接入真实商品资料或向量知识库
• 增加企业微信、网页客服或邮件渠道
• 增加工单列表、处理人和服务统计
• 接入模型 API，并为每条答案保留引用
• 增加用户登录、权限和审计日志

项目结构

├─ index.html                     # 客服工作台
├─ styles.css                    # 页面样式
├─ server.js                     # 零依赖静态服务器
├─ knowledge-base/
│  └─ sample-faq.json            # 示例知识库
├─ src/
│  ├─ app.js                     # 页面交互与工单流程
│  └─ engine.js                  # 问答与风险路由规则
├─ tests/
│  └─ customer-service.test.js   # 核心规则测试
└─ prompts/
   └─ build-with-codex.md        # 可复制的 Codex 提示词

安全边界

这是教学原型，不应未经审核直接接入真实客户。生产环境至少需要真实知识库校验、身份认证、权限控制、隐私保护、日志脱敏和可靠的人工接管机制。详细说明见 SECURITY.md。

License

MIT