交付文档-企业微信智能客服系统

# 企业微信智能客服系统 - 交付文档 **项目名称**：企业微信智能客服系统 **交付日期**：2026年1月22日 **版本号**：v1.0 **客户**：[客户公司名称] --- ## 一、项目概述 本系统是一套基于企业微信的智能客服解决方案，员工或客户通过企业微信与机器人对话，系统自动从知识库中检索相关内容并生成回答。管理员通过后台管理知识库、查看对话记录、分析统计数据。 核心功能： - 企业微信机器人（支持私聊和群聊） - 知识库管理（文档管理、批量导入） - 智能问答（RAG技术，语义检索+AI生成） - 后台管理（机器人配置、对话记录、统计分析） - 定时推送（定时发送通知消息） --- ## 二、系统功能清单 ### 2.1 企业微信机器人 | 功能 | 说明 | 状态 | |------|------|------| | 机器人管理 | 创建、编辑、删除机器人，支持多个机器人 | ✅ 已完成 | | 私聊支持 | 用户私聊机器人，自动回复 | ✅ 已完成 | | 群聊支持 | 群聊中@机器人，自动回复 | ✅ 已完成 | | 消息接收 | 接收企业微信推送的消息 | ✅ 已完成 | | 消息发送 | 向企业微信发送回复消息 | ✅ 已完成 | | 上下文记忆 | 记住用户最近的对话，实现连续对话 | ✅ 已完成 | | 回调URL | 自动生成企业微信回调地址 | ✅ 已完成 | **使用场景**： - 员工在企业微信中向机器人提问，机器人自动回答 - 群聊中@机器人，机器人回复问题 - 支持创建多个机器人，服务不同部门 ### 2.2 知识库管理 | 功能 | 说明 | 状态 | |------|------|------| | 文档管理 | 创建、编辑、删除文档 | ✅ 已完成 | | 分类管理 | 文档分类，便于管理 | ✅ 已完成 | | 批量导入 | 支持批量导入txt、md、html文件 | ✅ 已完成 | | 文档搜索 | 搜索文档标题和内容 | ✅ 已完成 | | 向量索引 | 自动建立向量索引，提高检索准确度 | ✅ 已完成 | **使用场景**： - 整理公司的产品手册、FAQ、操作指南等文档 - 批量导入现有文档 - 按分类管理不同类型的知识 ### 2.3 智能问答（RAG） | 功能 | 说明 | 状态 | |------|------|------| | 语义检索 | 根据问题检索相关文档 | ✅ 已完成 | | AI生成回答 | 基于检索到的文档生成回答 | ✅ 已完成 | | 多AI支持 | 支持火山方舟、腾讯云混元 | ✅ 已完成 | | Embedding切换 | 支持火山方舟、腾讯云、关键词匹配 | ✅ 已完成 | | 上下文管理 | 结合历史对话生成回答 | ✅ 已完成 | **工作原理**： 1. 用户提问 2. 系统在知识库中检索相关文档（Top 5） 3. 将文档内容和问题发送给AI 4. AI生成回答 5. 返回给用户 ### 2.4 后台管理 | 功能 | 说明 | 状态 | |------|------|------| | 管理员登录 | 后台登录验证 | ✅ 已完成 | | 机器人管理 | 管理所有机器人 | ✅ 已完成 | | 知识库管理 | 管理文档和分类 | ✅ 已完成 | | 对话记录 | 查看所有对话记录 | ✅ 已完成 | | 统计分析 | 对话量、热门问题等统计 | ✅ 已完成 | | AI配置 | 配置火山方舟、腾讯云混元 | ✅ 已完成 | | Embedding配置 | 配置向量化服务 | ✅ 已完成 | | 全局配置 | 配置默认参数 | ✅ 已完成 | | 系统设置 | 站点信息、数据备份 | ✅ 已完成 | ### 2.5 定时推送 | 功能 | 说明 | 状态 | |------|------|------| | 定时任务管理 | 创建、编辑、删除定时任务 | ✅ 已完成 | | 多种调度 | 支持一次性、每天、每周、每月 | ✅ 已完成 | | 批量发送 | 支持向多个用户发送 | ✅ 已完成 | | 立即执行 | 可以立即执行任务测试 | ✅ 已完成 | **使用场景**： - 每天早上发送日报 - 每周发送周报 - 定期发送通知消息 --- ## 三、技术架构 ### 3.1 技术栈 **后端** - 框架：CodeIgniter 4 - 语言：PHP 7.4+ - 数据库：MySQL 5.7+ **前端** - UI框架：Layui - JavaScript：jQuery - 图表：ECharts **第三方服务** - 企业微信API - 火山方舟AI（可选） - 腾讯云混元AI（可选） ### 3.2 数据库表 系统共11张核心表： 1. **wework_bot** - 机器人配置 2. **wework_conversation** - 对话记录 3. **wework_user_history** - 用户对话历史 4. **wework_user_profile** - 用户画像 5. **wework_schedule_task** - 定时任务 6. **wework_global_config** - 全局配置 7. **kb_document** - 知识库文档 8. **kb_category** - 文档分类 9. **kb_embedding** - 向量索引 10. **cms_admin** - 管理员 11. **cms_config** - 系统配置 详细表结构见：`app/Database/install.sql` ### 3.3 目录结构 ``` project/ ├── app/ # 应用代码 │ ├── Controllers/ # 控制器 │ │ ├── Admin/ # 后台管理 │ │ ├── OpenApi/ # API接口 │ │ └── Wework.php # 企业微信回调 │ ├── Views/ # 视图文件 │ │ └── admin/ # 后台页面 │ ├── Libraries/ # 类库 │ │ ├── EmbeddingService.php │ │ └── ... │ ├── Commands/ # CLI命令 │ │ └── WeworkSchedule.php │ └── Database/ # 数据库文件 │ └── install.sql ├── public/ # 公开目录 │ ├── index.php # 入口文件 │ ├── layui/ # UI框架 │ └── ... ├── writable/ # 可写目录 │ ├── logs/ # 日志 │ └── config/ # 配置文件 └── docs/ # 文档 ``` --- ## 四、部署说明 ### 4.1 服务器要求 **最低配置** - CPU：2核 - 内存：4GB - 硬盘：50GB - 带宽：5Mbps - 系统：Linux（推荐CentOS 7+或Ubuntu 18.04+） **软件环境** - PHP 7.4+（需要扩展：mysqli | mbstring | json | curl） - MySQL 5.7+ - Nginx 或 Apache - SSL证书（HTTPS） ### 4.2 安装步骤 **1. 上传代码** ```bash # 上传代码到服务器 cd /www/wwwroot/ unzip project.zip ``` **2. 配置数据库** ```bash # 创建数据库 mysql -uroot -p CREATE DATABASE wework_kb DEFAULT CHARSET utf8mb4; # 导入数据库 mysql -uroot -p wework_kb < app/Database/install.sql ``` **3. 配置系统** ```bash # 复制配置文件 cp env .env # 编辑配置 vi .env ``` 修改以下配置： ``` database.default.hostname = localhost database.default.database = wework_kb database.default.username = root database.default.password = 你的密码 ``` **4. 配置权限** ```bash chmod -R 755 /www/wwwroot/project chmod -R 777 /www/wwwroot/project/writable ``` **5. 配置Nginx** ```nginx server { listen 80; server_name yourdomain.com; root /www/wwwroot/project/public; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/tmp/php-cgi.sock; fastcgi_index index.php; include fastcgi.conf; } } ``` **6. 配置定时任务** ```bash crontab -e # 添加： * * * * * cd /www/wwwroot/project && php spark wework:schedule ``` **7. 访问系统** - 后台地址：https://yourdomain.com/admin - 默认账号：admin - 默认密码：admin123 详细安装步骤见：`docs/企业微信机器人安装指南.md` --- ## 五、使用说明 ### 5.1 配置AI服务 系统支持两种AI服务，至少配置一种： **方案1：火山方舟（推荐）** 1. 登录后台 → 火山方舟 2. 填写API Key和Endpoint ID 3. 点击"测试连接" 4. 添加文本模型 **方案2：腾讯云混元** 1. 登录后台 → 腾讯云AI 2. 填写Secret ID和Secret Key 3. 选择模型 4. 点击"测试连接" ### 5.2 配置Embedding（可选） Embedding用于提高检索准确度，可选配置： 1. 登录后台 → Embedding配置 2. 选择服务商： - 火山方舟Embedding（推荐） - 腾讯云混元Embedding - 关键词匹配（免费，但准确度较低） 3. 填写配置信息 4. 点击"测试" ### 5.3 创建机器人 1. 登录后台 → 企业微信 → 机器人管理 2. 点击"添加机器人" 3. 填写基本信息： - 机器人名称 - 机器人标识（英文，如：customer-service） 4. 填写企业微信配置： - 企业ID（在企业微信后台"我的企业"中查看） - 应用ID（在应用详情页查看） - 应用Secret（在应用详情页查看） - Token（自定义，如：abc123） - EncodingAESKey（在企业微信后台生成） 5. 配置知识库： - 选择知识空间 - 选择AI模型 - 填写系统提示词 6. 保存后，复制回调URL ### 5.4 配置企业微信 1. 登录企业微信管理后台 2. 进入应用详情页 3. 找到"接收消息"设置 4. 填入： - URL：系统生成的回调URL - Token：机器人配置中的Token - EncodingAESKey：机器人配置中的EncodingAESKey 5. 保存 ### 5.5 导入知识库 **方法1：手动创建** 1. 登录后台 → 知识库 → 文档管理 2. 点击"添加文档" 3. 填写标题、分类、内容 4. 保存 **方法2：批量导入** 1. 登录后台 → 知识库 → 批量导入 2. 上传文件（支持txt、md、html） 3. 系统自动导入并建立索引 详细使用说明见：`docs/企业微信机器人使用说明.md` --- ## 六、功能演示 ### 6.1 对话效果 用户在企业微信中提问： ``` 用户：你们的产品怎么收费？ 机器人： 我们的产品采用按需付费模式： 1. 基础版：免费 - 支持100个文档 - 1个机器人 2. 标准版：¥299/月 - 支持1000个文档 - 3个机器人 3. 企业版：¥999/月 - 无限文档 - 无限机器人 详情请查看产品价格说明。 ``` ### 6.2 后台界面 主要页面： - 首页仪表盘：显示今日对话数、总对话数、活跃机器人等 - 机器人管理：列表显示所有机器人，可编辑配置 - 知识库管理：文档列表，支持搜索、编辑、删除 - 对话记录：查看所有对话，可按机器人、用户、时间筛选 - 统计分析：对话趋势图、热门问题排行 --- ## 七、常见问题 ### Q1：机器人不回复消息？ 检查： 1. 机器人状态是否启用 2. 企业微信回调URL是否配置正确 3. Token和EncodingAESKey是否匹配 4. 查看系统日志：`writable/logs/` ### Q2：回答不准确？ 优化方法： 1. 补充相关知识库文档 2. 优化文档内容质量 3. 启用Embedding提高检索准确度 4. 调整系统提示词 ### Q3：如何查看日志？ 日志位置： - 系统日志：`writable/logs/log-{date}.log` - 对话记录：后台 → 企业微信 → 对话记录 ### Q4：如何备份数据？ 1. 登录后台 → 系统配置 → 系统设置 2. 点击"立即备份" 3. 下载备份文件 ### Q5：支持多少并发用户？ 根据服务器配置： - 2核4G：支持100+并发 - 4核8G：支持500+并发 - 8核16G：支持1000+并发 --- ## 八、交付清单 ### 8.1 源码文件 - ✅ 完整PHP源代码 - ✅ 数据库结构文件（install.sql） - ✅ 配置文件模板（.env.example） ### 8.2 文档资料 - ✅ 安装部署文档 - ✅ 使用说明文档 - ✅ 数据库说明文档 - ✅ 功能开发清单 - ✅ 本交付文档 ### 8.3 技术支持 - ✅ 1个月免费技术支持 - ✅ 微信/邮件响应 - ✅ 远程协助（如需要） --- ## 九、验收标准 ### 9.1 功能验收 - [ ] 能够创建机器人并配置企业微信 - [ ] 能够接收企业微信消息 - [ ] 能够自动回复消息 - [ ] 支持私聊对话 - [ ] 支持群聊@回复 - [ ] 能够创建和管理知识库文档 - [ ] 能够批量导入文档 - [ ] 能够智能回答问题 - [ ] 能够查看对话记录 - [ ] 能够查看统计数据 - [ ] 能够配置AI服务 - [ ] 能够创建定时任务 ### 9.2 性能验收 - [ ] 消息响应时间<3秒 - [ ] 页面加载时间<2秒 - [ ] 支持100+并发用户 ### 9.3 安全验收 - [ ] 后台登录验证正常 - [ ] 企业微信签名验证正常 - [ ] 无明显安全漏洞 --- ## 十、联系方式 **技术支持** - 联系人：[您的名字] - 微信：[您的微信] - 邮箱：[您的邮箱] - 电话：[您的电话] **响应时间** - 工作日：4小时内响应 - 紧急问题：随时响应 --- **文档结束** 本文档作为系统交付的依据，请客户验收确认。如有问题，请及时联系技术支持。