企业微信机器人安装指南

# 企业微信机器人 - 快速安装指南 ## 安装步骤 ### 1. 创建数据库表 执行SQL文件创建必要的数据库表： ```bash # 方法1：使用MySQL命令行 mysql -u用户名 -p密码 数据库名 < app/Database/wework_bot.sql # 方法2：使用phpMyAdmin # 1. 登录phpMyAdmin # 2. 选择数据库 # 3. 点击"导入" # 4. 选择 app/Database/wework_bot.sql 文件 # 5. 点击"执行" # 方法3：直接执行SQL # 打开 app/Database/wework_bot.sql 文件 # 复制所有SQL语句 # 在数据库管理工具中执行 ``` SQL文件会创建以下表： - `wework_bot` - 机器人配置表 - `wework_conversation` - 对话记录表 ### 2. 验证安装 访问后台管理系统，检查左侧菜单是否出现「企业微信机器人」选项： ``` 系统配置 ├─ 模板管理 ├─ API管理 ├─ 企业微信机器人 ← 新增菜单 ├─ AI配置 ├─ RAG管理 └─ 系统设置 ``` ### 3. 配置企业微信 参考《企业微信机器人使用说明.md》完成企业微信应用的创建和配置。 ## 文件清单 安装完成后，系统包含以下文件： ### 后端控制器 - `app/Controllers/Admin/Wework.php` - 后台管理控制器 - `app/Controllers/Wework.php` - 企业微信回调处理控制器 ### 视图文件 - `app/Views/admin/wework/index.php` - 机器人列表页 - `app/Views/admin/wework/edit.php` - 机器人编辑页 - `app/Views/admin/wework/logs.php` - 对话日志页 - `app/Views/admin/wework/stats.php` - 统计分析页 ### 数据库 - `app/Database/wework_bot.sql` - 数据库表结构 ### 路由配置 已在 `app/Config/Routes.php` 中添加以下路由： ```php // 后台管理路由 admin/wework - 机器人列表 admin/wework/add - 添加机器人 admin/wework/edit/:id - 编辑机器人 admin/wework/save - 保存机器人 admin/wework/delete - 删除机器人 admin/wework/toggle - 启用/禁用 admin/wework/test - 测试连接 admin/wework/logs - 对话日志 admin/wework/stats - 统计分析 // 企业微信回调路由 wework/callback/:token - 接收企业微信消息 ``` ## 功能特性 ✅ **多机器人管理** - 支持创建多个机器人，对接不同应用 ✅ **智能路由** - 根据置信度自动决定是否转人工 ✅ **工作模式** - 智能路由/全自动/混合三种模式 ✅ **对话日志** - 完整记录所有对话历史 ✅ **数据统计** - 对话量、置信度、高频问题等分析 ✅ **可视化配置** - 后台界面化配置，无需修改代码 ## 系统要求 - PHP 7.4+ - MySQL 5.7+ / MariaDB 10.2+ - CodeIgniter 4 - 已配置AI模型（用于智能问答） - 已创建知识空间和文档 - HTTPS域名（企业微信要求） ## 快速测试 ### 1. 创建测试机器人 ``` 机器人名称：测试机器人 机器人标识：test-bot CorpId：你的企业ID AgentId：你的应用ID Secret：你的应用密钥 Token：随机生成的Token EncodingAESKey：随机生成的密钥 知识空间：选择一个已有空间 AI模型：选择已配置的模型 工作模式：全自动 ``` ### 2. 配置企业微信回调 ``` URL：https://你的域名/wework/callback/test-bot Token：与机器人配置中的Token一致 EncodingAESKey：与机器人配置中的密钥一致 ``` ### 3. 发送测试消息 在企业微信应用中发送"你好"，机器人应该会自动回复。 ## 故障排查 ### 问题1：菜单不显示 - 清除浏览器缓存 - 检查路由配置是否正确 - 确认已更新 `app/Views/admin/layout/header.php` ### 问题2：数据库表不存在 - 确认已执行 `app/Database/wework_bot.sql` - 检查数据库连接配置 - 查看数据库是否有权限创建表 ### 问题3：回调验证失败 - 确认URL可以从外网访问 - 检查Token和EncodingAESKey是否一致 - 查看服务器错误日志 ### 问题4：机器人不回复 - 检查机器人是否已启用 - 确认AI配置正常 - 查看对话日志是否有记录 - 检查知识空间是否有内容 ## 下一步 安装完成后，请阅读《企业微信机器人使用说明.md》了解详细的配置和使用方法。 ## 技术支持 如遇到问题，请检查： 1. 系统日志：`writable/logs/` 2. 对话日志：后台 → 企业微信机器人 → 对话日志 3. 数据库表：`wework_bot` 和 `wework_conversation` --- **版本**：v1.0.0 **更新时间**：2024-01-20