企业微信客服自动化系统是一个完整的企业微信客服 AI 助手解决方案，用于自动处理好友添加、智能问答和人工转接等客服场景。
一、用途 该方案面向企业微信客服场景，目标是用 AI 助手承接外部客户的常见咨询，减少人工客服的重复性工作，并在 AI 无法处理时将问题及时转交人工客服。
二、主要能力
- 自动同意好友添加：实时监听好友添加事件，自动通过好友请求，发送欢迎消息，并标注用户来源和标签。
- 基于知识库的智能问答：使用向量知识库存储企业知识，通过语义搜索匹配问题，由 LLM 生成专业回复，并支持多轮对话上下文。
- 未知问题人工介入：通过置信度阈值判断，自动提醒人工客服，转接对话给人工，并记录未解决问题用于优化。
三、技术架构 系统由企业微信 Webhook、回调服务器（Go/Python）、向量知识库（PostgreSQL + pgvector）、LLM API（如 Kimi、GPT-4）和人工提醒通道（如 Telegram）组成。完整消息处理流程为：接收消息后判断是否为文本，是则搜索知识库，比较相似度与阈值，命中则生成回答并发送，否则转人工并通知人工客服。
四、使用方式
- 配置企业微信应用：登录企业微信管理后台，创建应用并选择“微信客服”，记录 corp_id、agent_id、secret；配置回调地址（URL、Token、EncodingAESKey）；订阅联系人变更事件、消息事件、外部联系人免验证添加事件。
- 设置知识库：安装 PostgreSQL 与 pgvector，创建数据库并初始化表结构。
- 导入知识库数据：准备 Markdown 格式的知识文档，通过脚本切片并向量化导入，并验证导入结果。
- 启动回调服务：配置环境变量（企业微信配置、数据库 URL、LLM API 密钥与地址、通知渠道等），使用 uvicorn 启动 FastAPI 服务或使用 Go 运行服务。
- 验证服务：通过健康检查接口和知识库搜索测试接口验证。
五、典型场景
- 自动欢迎新好友：用户添加客服为好友时，自动通过请求、添加“新客户”标签并发送包含可服务范围的欢迎消息。
- 知识库问答：用户提问时检索知识库，构建提示词调用 LLM 生成回答，若无法回答则转人工。
- 人工介入提醒：发送转接提示给用户，通过 Telegram 通知人工客服用户信息与问题内容，并记录未解决问题。
六、知识库管理 支持从 Markdown 导入知识、直接向数据库插入知识、重新导入更新知识（自动去重），并提供搜索测试脚本。
七、监控与维护 提供日志查看、基于 Prometheus 的性能监控示例以及未解决问题分布的统计查询。
八、安全与故障排查 建议使用 pass 存储密钥、环境变量引用而非硬编码，客户信息加密存储，定期清理敏感日志，Webhook 验证签名、IP 白名单限制，记录并审查审计日志。常见故障包括回调接收不到消息、知识库搜索无结果、人工提醒未发送，文档提供了对应的排查命令。
九、扩展方向 文档提及可扩展多轮对话记忆（Redis 存储会话上下文）、情感分析、主动营销等能力。
十、限制与未提供信息 该方案的具体收费方式、价格、平台支持范围、性能指标和实际效果暂未提供；使用需自行准备企业微信应用、PostgreSQL 数据库、LLM API 密钥及可选的通知渠道。