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