企业微信机器人使用说明

# 企业微信机器人使用说明 ## 功能概述 企业微信机器人功能允许您将知识库系统与企业微信深度集成，实现智能客服、自动问答等功能。用户在企业微信中发送消息，机器人会自动检索知识库并返回答案。 ## 核心特性 ### 1. 智能路由模式 - **智能路由**：根据AI回答的置信度自动决定是否转人工 - **全自动模式**：7×24小时自动回复，无需人工介入 - **混合模式**：工作时间人工优先，非工作时间自动回复 ### 2. 多机器人管理 - 支持创建多个机器人，对接不同的企业微信应用 - 每个机器人可独立配置知识空间、AI模型、回复策略 - 灵活的启用/禁用控制 ### 3. 完整的对话日志 - 记录所有对话历史，包括用户问题和AI回答 - 支持按机器人、时间、关键词筛选 - 查看置信度、响应时间等详细信息 ### 4. 数据统计分析 - 对话量趋势图表 - 平均置信度分析 - 高频问题统计 - 转人工率分析 ## 使用步骤 ### 第一步：创建企业微信应用 1. 登录企业微信管理后台：https://work.weixin.qq.com/ 2. 进入「应用管理」→「自建」→「创建应用」 3. 填写应用信息（名称、Logo等） 4. 创建成功后，记录以下信息： - **AgentId**：应用的唯一标识 - **Secret**：应用的密钥 - **CorpId**：企业ID（在「我的企业」中查看） ### 第二步：配置接收消息 1. 在企业微信应用详情页，找到「接收消息」配置 2. 点击「设置API接收」 3. 填写以下信息： - **URL**：`https://你的域名/wework/callback/机器人标识` - **Token**：自定义的验证令牌（建议随机生成） - **EncodingAESKey**：消息加密密钥（点击「随机获取」） 4. 保存配置（此时会验证URL，需要先完成第三步） ### 第三步：在后台创建机器人 1. 登录知识库后台管理系统 2. 进入「系统配置」→「企业微信机器人」 3. 点击「添加机器人」 4. 填写配置信息： #### 基本信息 - **机器人名称**：便于识别的名称，如"技术支持机器人" - **机器人标识**：英文标识，用于生成回调URL，如"tech-support" - **描述**：机器人的用途说明 #### 企业微信配置 - **CorpId**：企业ID - **AgentId**：应用ID - **Secret**：应用密钥 - **Token**：接收消息的验证令牌 - **EncodingAESKey**：消息加密密钥 #### 知识库配置 - **知识空间**：选择机器人可以检索的知识空间（可多选） - **AI模型**：选择用于回答问题的AI模型 - **系统提示词**：自定义AI的回答风格和规则 #### 回复策略 - **工作模式**： - 智能路由：置信度高于阈值时自动回复，否则提示转人工 - 全自动：始终自动回复 - 混合模式：工作时间转人工，非工作时间自动回复 - **置信度阈值**：0-1之间，建议0.7-0.8 - **工作时间**：设置人工客服的工作时间段 - **最大历史消息数**：保留的对话上下文数量 - **欢迎语**：用户首次对话时的欢迎消息 - **转人工提示**：置信度不足时的提示语 - **无答案回复**：未找到相关知识时的回复 5. 点击「保存」创建机器人 ### 第四步：验证配置 1. 在机器人列表中，点击「测试连接」按钮 2. 系统会验证企业微信配置是否正确 3. 如果测试失败，请检查： - CorpId、AgentId、Secret是否正确 - 网络是否可以访问企业微信API - 服务器时间是否准确 ### 第五步：完成企业微信回调配置 1. 返回企业微信管理后台 2. 在「接收消息」配置中，使用机器人详情页显示的回调URL 3. 点击「保存」，系统会自动验证URL 4. 验证成功后，机器人即可开始工作 ### 第六步：测试机器人 1. 在企业微信中打开创建的应用 2. 发送一条测试消息，如"你好" 3. 机器人应该会自动回复 4. 在后台「对话日志」中可以查看对话记录 ## 配置说明 ### 系统提示词示例 ``` 你是一个专业的技术支持助手，负责回答用户关于产品的技术问题。 请遵循以下规则： 1. 回答要准确、简洁、专业 2. 如果不确定答案，请明确告知用户 3. 对于复杂问题，可以分步骤说明 4. 保持友好、耐心的态度 5. 必要时引导用户查看详细文档 ``` ### 工作模式选择建议 | 场景 | 推荐模式 | 说明 | |------|---------|------| | 技术文档查询 | 智能路由 | 简单问题自动回复，复杂问题转人工 | | 常见问题解答 | 全自动 | 知识库完善，可全自动处理 | | 客户服务 | 混合模式 | 工作时间人工服务，其他时间自动回复 | | 内部知识查询 | 全自动 | 员工自助查询，无需人工介入 | ### 置信度阈值设置 - **0.8-1.0**：非常严格，只有高度匹配才自动回复（适合对准确性要求极高的场景） - **0.7-0.8**：平衡模式，推荐设置（大部分场景适用） - **0.5-0.7**：宽松模式，更多自动回复（知识库完善的情况下） - **0.0-0.5**：不推荐（可能产生不准确的回复） ## 对话日志 ### 查看日志 1. 进入「企业微信机器人」→「对话日志」 2. 可以按以下条件筛选： - 机器人 - 时间范围 - 关键词搜索 - 是否转人工 ### 日志信息 每条日志包含： - 用户问题 - AI回答 - 置信度分数 - 响应时间 - 是否转人工 - 对话时间 ## 统计分析 ### 查看统计 进入「企业微信机器人」→「统计分析」 ### 统计指标 1. **对话量趋势**：近7天/30天的对话量变化 2. **平均置信度**：AI回答的平均准确度 3. **转人工率**：需要人工介入的对话比例 4. **高频问题**：用户最常问的问题TOP10 5. **响应时间**：平均响应时间统计 ### 优化建议 - 如果转人工率过高，考虑： - 降低置信度阈值 - 完善知识库内容 - 优化系统提示词 - 如果用户反馈不准确，考虑： - 提高置信度阈值 - 检查高频问题的答案质量 - 调整AI模型选择 ## 常见问题 ### Q1: 回调URL验证失败？ **A:** 检查以下几点： 1. URL是否可以从外网访问 2. Token和EncodingAESKey是否与后台配置一致 3. 服务器是否正常运行 4. 防火墙是否允许企业微信服务器访问 ### Q2: 机器人不回复消息？ **A:** 排查步骤： 1. 检查机器人是否已启用 2. 查看对话日志是否有记录（判断是否收到消息） 3. 测试AI配置是否正常 4. 检查知识空间是否有内容 5. 查看服务器日志是否有错误 ### Q3: 回复速度慢？ **A:** 可能原因： 1. AI模型响应慢（考虑更换更快的模型） 2. 知识库内容过多（优化检索范围） 3. 服务器性能不足（升级配置） 4. 网络延迟（检查与AI服务的连接） ### Q4: 如何提高回答准确度？ **A:** 优化方法： 1. 完善知识库内容，确保信息准确、完整 2. 使用更强大的AI模型 3. 优化系统提示词，明确回答规则 4. 提高置信度阈值，不确定时转人工 5. 定期查看对话日志，针对性补充知识 ### Q5: 可以同时对接多个企业微信吗？ **A:** 可以。每个企业微信应用创建一个机器人即可，它们相互独立，互不影响。 ### Q6: 如何备份对话记录？ **A:** 对话记录存储在数据库的`wework_conversation`表中，可以： 1. 使用数据库备份工具定期备份 2. 在后台「系统设置」→「数据备份」中备份整个数据库 3. 导出对话日志为CSV格式（功能开发中） ## 技术架构 ### 消息流程 ``` 用户发送消息 ↓ 企业微信服务器 ↓ 回调URL（验证签名） ↓ 解密消息内容 ↓ 调用知识库API检索 ↓ AI生成回答 ↓ 判断置信度 ↓ 发送回复到企业微信 ↓ 记录对话日志 ``` ### 数据库表 #### wework_bot（机器人配置表） 存储机器人的基本信息和配置参数 #### wework_conversation（对话记录表） 存储所有对话历史，用于日志查询和统计分析 ### API接口 机器人使用系统现有的`/openapi/chat`接口进行知识检索和AI问答，无需额外开发。 ## 安全建议 1. **保护密钥**：Secret、Token、EncodingAESKey等敏感信息不要泄露 2. **验证签名**：系统会自动验证企业微信的消息签名，防止伪造 3. **HTTPS**：生产环境必须使用HTTPS协议 4. **权限控制**：限制机器人可访问的知识空间范围 5. **日志审计**：定期检查对话日志，发现异常及时处理 ## 更新日志 ### v1.0.0 (2024-01-20) - ✅ 支持企业微信应用接入 - ✅ 多机器人管理 - ✅ 智能路由、全自动、混合三种工作模式 - ✅ 完整的对话日志记录 - ✅ 数据统计分析 - ✅ 后台可视化配置 ## 技术支持 如有问题，请联系技术支持或查看系统文档。