实战
用 Dify 接入企业微信，做个内部知识问答机器人
企业内部最常见的问题是：「制度、报销、IT 流程」天天被问爆，HR 和行政分身乏术。Dify 是开源的 LLMOps 平台，配合企业微信自建应用，可以做一个「内部知识问答机器人」：员工在企微里 @ 它，它基于公司文档秒回。本教程带你把 Dify 应用接到企业微信。
💬 本教程适合：企业 IT / 数字化负责人，想用自有文档搭一个内网问答助手。需要企业微信管理员权限。
Step 1：准备 Dify（云版或私有部署）
1 准备 Dify（云版或私有部署）
直接用 Dify 云端（dify.ai）最快；数据敏感可选私有化部署（Docker Compose 一条命令起）。登录后进入工作室。
# 私有化部署（可选）
git clone https://github.com/langgenius/dify.git
cd dify/docker && docker compose up -dStep 2：创建知识库并导入公司文档
2 创建知识库并导入公司文档
在「知识库」上传制度手册、FAQ、操作 SOP（支持 pdf / word / 网页）。Dify 会自动切分、向量化。建议开启「父子分段」提升长文档召回。
权限红线：只导入允许全员查阅的文档。涉密文件务必先脱敏，或限定可见部门后再接机器人。
Step 3：编排一个对话型应用
3 编排一个对话型应用
新建「聊天助手」或「Agent 编排」，绑定刚建的知识库作为上下文，写好人设（如「你是公司 IT 助手，只依据知识库回答」）。在「预览」里先聊通。
Step 4：获取企业微信自建应用凭证
4 获取企业微信自建应用凭证
用管理员账号进「企业微信管理后台 → 应用管理 → 自建」，创建一个应用，记下 CorpID、AgentId、Secret。同时配置「可信域名」与「接收消息」回调 URL。
Step 5：打通 Dify 与企业微信（回调 / 插件）
5 打通 Dify 与企业微信（回调 / 插件）
Dify 社区版可用「企业微信」集成或自己写个转发服务：企微把用户消息 POST 到你的回调地址，你再调用 Dify 的 API 拿到回答回传企微。
# 调用 Dify 聊天 API（示意）
curl -X POST https://api.dify.ai/v1/chat-messages \
-H "Authorization: Bearer $DIFY_KEY" \
-H "Content-Type: application/json" \
-d '{"inputs":{},"query":"怎么报销差旅费?","user":"emp_001"}'Step 6：配置通讯录权限与安全
6 配置通讯录权限与安全
在企微应用里设置「可见范围」（哪些部门能用）、「接收消息」开关；在 Dify 侧用环境变量藏好密钥，别写死在前端。
🔐 安全建议：用企业微信的「成员敏感度」做分级，敏感问题（工资、合同）直接转人工，不让模型回答。
Step 7：上线与持续运营
7 上线与持续运营
发布后先在小范围（IT 部门）灰度一周，收集「答错 / 答不出」的问题反哺知识库。Dify 有「日志与标注」功能，可把 bad case 标成训练数据。
常见问题速查
| 你遇到的现象 | 大概率原因 & 解决 |
|---|---|
| 企微收不到回复 | 回调 URL 未公网可达 / 未配可信域名 |
| 回答不基于文档 | 知识库未绑定或检索阈值过低，调高 top_k 相关性 |
| 泄密风险 | 收紧可见范围 + 敏感词转人工 |
| 冷启动答不出 | 先导入 Top 20 高频 FAQ 再扩大 |