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

项目名称：企业微信智能客服系统 交付日期：2026年1月22日 版本号：v1.0 客户：[客户公司名称]

一、项目概述

本系统是一套基于企业微信的智能客服解决方案，员工或客户通过企业微信与机器人对话，系统自动从知识库中检索相关内容并生成回答。管理员通过后台管理知识库、查看对话记录、分析统计数据。

核心功能：

企业微信机器人（支持私聊和群聊）
知识库管理（文档管理、批量导入）
智能问答（RAG技术，语义检索+AI生成）
后台管理（机器人配置、对话记录、统计分析）
定时推送（定时发送通知消息）

二、系统功能清单

2.1 企业微信机器人

| 功能 | 说明 | 状态 | |------|------|------| | 机器人管理 | 创建、编辑、删除机器人，支持多个机器人 | ✅ 已完成 | | 私聊支持 | 用户私聊机器人，自动回复 | ✅ 已完成 | | 群聊支持 | 群聊中@机器人，自动回复 | ✅ 已完成 | | 消息接收 | 接收企业微信推送的消息 | ✅ 已完成 | | 消息发送 | 向企业微信发送回复消息 | ✅ 已完成 | | 上下文记忆 | 记住用户最近的对话，实现连续对话 | ✅ 已完成 | | 回调URL | 自动生成企业微信回调地址 | ✅ 已完成 |

使用场景：

员工在企业微信中向机器人提问，机器人自动回答
群聊中@机器人，机器人回复问题
支持创建多个机器人，服务不同部门

2.2 知识库管理

| 功能 | 说明 | 状态 | |------|------|------| | 文档管理 | 创建、编辑、删除文档 | ✅ 已完成 | | 分类管理 | 文档分类，便于管理 | ✅ 已完成 | | 批量导入 | 支持批量导入txt、md、html文件 | ✅ 已完成 | | 文档搜索 | 搜索文档标题和内容 | ✅ 已完成 | | 向量索引 | 自动建立向量索引，提高检索准确度 | ✅ 已完成 |

使用场景：

整理公司的产品手册、FAQ、操作指南等文档
批量导入现有文档
按分类管理不同类型的知识

2.3 智能问答（RAG）

| 功能 | 说明 | 状态 | |------|------|------| | 语义检索 | 根据问题检索相关文档 | ✅ 已完成 | | AI生成回答 | 基于检索到的文档生成回答 | ✅ 已完成 | | 多AI支持 | 支持火山方舟、腾讯云混元 | ✅ 已完成 | | Embedding切换 | 支持火山方舟、腾讯云、关键词匹配 | ✅ 已完成 | | 上下文管理 | 结合历史对话生成回答 | ✅ 已完成 |

工作原理：

用户提问

系统在知识库中检索相关文档（Top 5）

将文档内容和问题发送给AI

AI生成回答

返回给用户

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张核心表：

wework_bot - 机器人配置

wework_conversation - 对话记录

wework_user_history - 用户对话历史

wework_user_profile - 用户画像

wework_schedule_task - 定时任务

wework_global_config - 全局配置

kb_document - 知识库文档

kb_category - 文档分类

kb_embedding - 向量索引

cms_admin - 管理员

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. 上传代码

# 上传代码到服务器
cd /www/wwwroot/
unzip project.zip

2. 配置数据库

# 创建数据库
mysql -uroot -p
CREATE DATABASE wework_kb DEFAULT CHARSET utf8mb4;
导入数据库
mysql -uroot -p wework_kb < app/Database/install.sql

3. 配置系统

# 复制配置文件
cp env .env
编辑配置
vi .env

修改以下配置：

database.default.hostname = localhost
database.default.database = wework_kb
database.default.username = root
database.default.password = 你的密码

4. 配置权限

chmod -R 755 /www/wwwroot/project
chmod -R 777 /www/wwwroot/project/writable

5. 配置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. 配置定时任务

crontab -e
添加：
    * cd /www/wwwroot/project && php spark wework:schedule

7. 访问系统

后台地址：https://yourdomain.com/admin
默认账号：admin
默认密码：admin123

详细安装步骤见：docs/企业微信机器人安装指南.md

五、使用说明

5.1 配置AI服务

系统支持两种AI服务，至少配置一种：

方案1：火山方舟（推荐）

登录后台 → 火山方舟

填写API Key和Endpoint ID

点击"测试连接"

添加文本模型

方案2：腾讯云混元

登录后台 → 腾讯云AI

填写Secret ID和Secret Key

选择模型

点击"测试连接"

5.2 配置Embedding（可选）

Embedding用于提高检索准确度，可选配置：

登录后台 → Embedding配置

选择服务商：

- 火山方舟Embedding（推荐） - 腾讯云混元Embedding - 关键词匹配（免费，但准确度较低）

填写配置信息

点击"测试"

5.3 创建机器人

登录后台 → 企业微信 → 机器人管理

点击"添加机器人"

填写基本信息：

- 机器人名称 - 机器人标识（英文，如：customer-service）

填写企业微信配置：

- 企业ID（在企业微信后台"我的企业"中查看） - 应用ID（在应用详情页查看） - 应用Secret（在应用详情页查看） - Token（自定义，如：abc123） - EncodingAESKey（在企业微信后台生成）

配置知识库：

- 选择知识空间 - 选择AI模型 - 填写系统提示词

保存后，复制回调URL

5.4 配置企业微信

登录企业微信管理后台

进入应用详情页

找到"接收消息"设置

填入：

- URL：系统生成的回调URL - Token：机器人配置中的Token - EncodingAESKey：机器人配置中的EncodingAESKey

保存

5.5 导入知识库

方法1：手动创建

登录后台 → 知识库 → 文档管理

点击"添加文档"

填写标题、分类、内容

保存

方法2：批量导入

登录后台 → 知识库 → 批量导入

上传文件（支持txt、md、html）

系统自动导入并建立索引

详细使用说明见：docs/企业微信机器人使用说明.md

六、功能演示

6.1 对话效果

用户在企业微信中提问：

用户：你们的产品怎么收费？机器人：我们的产品采用按需付费模式：基础版：免费 - 支持100个文档 - 1个机器人标准版：¥299/月 - 支持1000个文档 - 3个机器人企业版：¥999/月 - 无限文档 - 无限机器人

详情请查看产品价格说明。

6.2 后台界面

主要页面：

首页仪表盘：显示今日对话数、总对话数、活跃机器人等
机器人管理：列表显示所有机器人，可编辑配置
知识库管理：文档列表，支持搜索、编辑、删除
对话记录：查看所有对话，可按机器人、用户、时间筛选
统计分析：对话趋势图、热门问题排行

七、常见问题

Q1：机器人不回复消息？

检查：

机器人状态是否启用

企业微信回调URL是否配置正确

Token和EncodingAESKey是否匹配

查看系统日志：writable/logs/

Q2：回答不准确？

优化方法：

补充相关知识库文档

优化文档内容质量

启用Embedding提高检索准确度

调整系统提示词

Q3：如何查看日志？

日志位置：

系统日志：writable/logs/log-{date}.log
对话记录：后台 → 企业微信 → 对话记录

Q4：如何备份数据？

登录后台 → 系统配置 → 系统设置

点击"立即备份"

下载备份文件

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小时内响应
紧急问题：随时响应

文档结束

本文档作为系统交付的依据，请客户验收确认。如有问题，请及时联系技术支持。

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

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

一、项目概述

二、系统功能清单

2.1 企业微信机器人

2.2 知识库管理

2.3 智能问答（RAG）

2.4 后台管理

2.5 定时推送

三、技术架构

3.1 技术栈

3.2 数据库表

3.3 目录结构

四、部署说明

4.1 服务器要求

4.2 安装步骤

导入数据库

编辑配置

添加：

五、使用说明

5.1 配置AI服务

5.2 配置Embedding（可选）

5.3 创建机器人

5.4 配置企业微信

5.5 导入知识库

六、功能演示

6.1 对话效果

6.2 后台界面

七、常见问题

Q1：机器人不回复消息？

Q2：回答不准确？

Q3：如何查看日志？

Q4：如何备份数据？

Q5：支持多少并发用户？

八、交付清单

8.1 源码文件

8.2 文档资料

8.3 技术支持

九、验收标准

9.1 功能验收

9.2 性能验收

9.3 安全验收

十、联系方式