企业微信机器人使用说明

功能概述

企业微信机器人功能允许您将知识库系统与企业微信深度集成，实现智能客服、自动问答等功能。用户在企业微信中发送消息，机器人会自动检索知识库并返回答案。

核心特性

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)

✅ 支持企业微信应用接入
✅ 多机器人管理
✅ 智能路由、全自动、混合三种工作模式
✅ 完整的对话日志记录
✅ 数据统计分析
✅ 后台可视化配置

技术支持

如有问题，请联系技术支持或查看系统文档。