用企业微信 API + Dify 快速搭建一个支持知识库检索的企微 AI 智能客服机器人
Dify 是一个低代码 AI 应用平台，自带知识库、工作流、工具调用。用它接企微，可以少写很多代码，但也有一些坑要避开。
整体架构
客户消息 → 企微 Webhook → 你的服务 → Dify API → 知识库检索 → LLM 生成 → 你的服务 → 企微发送你的服务只做两件事：接收企微回调、调用 Dify API。知识库、Prompt、模型都在 Dify 侧管理。
Dify 侧配置
创建应用：选"聊天助手"类型，绑定模型（DeepSeek / GPT / Claude 都可以）。
上传知识库：把产品文档、FAQ、操作手册传上去，Dify 自动做向量化和索引。
配置检索策略：相似度阈值 0.7，返回 top 3，别贪多，多了反而干扰生成。
发布 API：Dify 会生成一个 API Key 和 endpoint，你的服务用这个调。
你的服务：桥接企微和 Dify
import requests DIFY_API_KEY = "app-xxxx" DIFY_ENDPOINT = "https://api.dify.ai/v1/chat-messages" def handle_wecom_message(data): text = data["content"] conv_id = data["conversationId"] # 调 Dify resp = requests.post( DIFY_ENDPOINT, headers={"Authorization": f"Bearer {DIFY_API_KEY}"}, json={ "inputs": {}, "query": text, "response_mode": "blocking", # 或 streaming "user": str(data["senderUin"]), } ).json() answer = resp.get("answer", "抱歉，我没听懂") # 发回企微 send_text(conv_id, answer)流式输出的处理
Dify 支持response_mode: streaming，但企微没有消息编辑接口，发出去的消息不能改。所以流式在企微里的实现是"分段发送"：
def handle_stream(data, conv_id): resp = requests.post( DIFY_ENDPOINT, headers={"Authorization": f"Bearer {DIFY_API_KEY}"}, json={ "inputs": {}, "query": data["content"], "response_mode": "streaming", "user": str(data["senderUin"]), }, stream=True ) buffer = "" for line in resp.iter_lines(): if line: chunk = parse_dify_chunk(line) buffer += chunk if len(buffer) > 50 or chunk.endswith(("。", "！", "？", "\n")): send_text(conv_id, buffer) buffer = "" if buffer: send_text(conv_id, buffer)知识库更新的坑
Dify 的知识库更新有延迟，刚上传的文档可能几分钟后才能检索到。如果客户问了一个新文档里的问题，机器人答不上来，别急着调阈值，先确认文档索引完成了。
另外，知识库别塞太多。一个客服机器人放 50 篇高质量 FAQ，比放 500 篇杂七杂八的文档效果好得多。
会话上下文的维持
Dify 的user参数用来做会话隔离，同一个 user 的多次调用会共享上下文。但企微的客户可能会话隔几天再来，Dify 的上下文早就过期了。
做法是把企微的 conversationId 映射成 Dify 的 conversation_id，持久化存储：
def get_dify_conversation(wecom_conv_id): key = f"dify_conv:{wecom_conv_id}" conv_id = redis.get(key) if not conv_id: # 新建会话 conv_id = create_dify_conversation() redis.set(key, conv_id, ex=86400 * 7) # 7 天过期 return conv_id一个真实场景
某 SaaS 公司的客服机器人，用 Dify 接了 80 篇产品文档和 FAQ。客户问"怎么配置 SSO"，机器人 3 秒内返回步骤截图和链接，准确率 85% 以上。剩下的 15% 转人工，人工处理完顺手把答案补进知识库。
Dify 的价值在于让非技术人员也能维护知识库和 Prompt，不用每次都找开发改代码。
企微回调和发送的字段在Eyun 开发文档里能查到，Dify 的 API Key 在 Dify 控制台生成。