Dify 推出全新插件 Lark Trigger(飞书触发器),打通 IM 与 AI 的集成。无论是智能群聊助手、文档自动审查,还是票据自动录入,都能通过飞书事件实时触发 Dify 工作流。
什么是 Lark Trigger?
Lark Trigger 是连接 Dify 强大 AI 能力与飞书办公生态的组件。它时刻监听着飞书工作台中的事件——无论是收到一条新消息、新建了一个文档,还是上传了一份文件。一旦捕捉到这些事件,它就会立即触发你预先设定好的 Dify 工作流,让 AI 自动介入处理。
核心应用场景
场景一:智能群聊助手
传统的群机器人往往不够智能,只能回复死板的关键词。通过 Lark Trigger,你可以将 Dify 的 LLM 能力接入飞书群聊。
- 触发机制:监听群聊或私聊中的特定消息(如 @机器人)。
- AI 动作:Dify 接收消息内容,结合企业知识库进行语义分析,生成专业回复。
- 价值:打造懂业务、会思考的智能客服或内部 IT 运维助手,释放人力成本。
场景二:文档自动审查
产品经理写完 PRD,运营写完活动方案,往往需要经过多轮人工评审。现在,AI 可以作为初审官。
- 触发机制:监听飞书云文档的创建或更新事件。
- AI 动作:Dify 自动读取文档内容,根据预设的评分标准进行分析,并将修改建议回写到文档评论区。
- 价值:大幅提升文档质量,减少低级错误,让团队评审更聚焦于核心创意。
场景三:票据智能录入
报销、合同归档等场景中,大量的数据录入工作让人头疼。
- 触发机制:监听飞书多维表格或文件夹的文件上传事件。
- AI 动作:Dify 调用 OCR 工具识别图片/PDF 中的关键信息(如金额、日期、发票号),并自动写入飞书多维表格。
- 价值:实现数据从采集到录入的全流程自动化,准确率高,速度快。
配置教程
第一步:飞书开放平台配置
-
创建应用:登录飞书开放平台,点击创建企业自建应用,填写应用名称和描述。

-
获取凭证:在左侧菜单栏点击凭证与基础信息,复制并保存 App ID 和 App Secret。

-
开启机器人能力:点击左侧添加应用能力,选择机器人并点击添加。这是为了让应用具备接收和发送消息的能力。

-
申请权限:点击权限管理,根据你的需求开通权限。
- 如果是群聊助手,搜索并开通
im:message.p2p_msg:readonly(获取用户发给机器人的单聊消息)和im:message.group_at_msg:readonly(获取群聊中用户@机器人的消息)。
- 记得点击批量开通并发布版本,权限才会生效哦!

第二步:Dify 插件配置
-
安装插件:登录 Dify,点击右上角头像 -> 插件 -> Dify Marketplace,搜索 Lark Trigger 并安装。

-
填写凭证:在插件设置页面,填入第一步获取的 App ID 和 App Secret。
加密 Key 和验证 Token,获取如下:

-
获取回调地址:配置完成后,Dify 会生成一个 Callback URL(回调地址),点击复制。这个地址是飞书向 Dify 发送消息的邮筒。

第三步:飞书事件订阅
- 配置请求网址:回到飞书开放平台,点击左侧事件与回调。
- 填入 URL:点击编辑,将 Dify 生成的 Callback URL 粘贴到请求网址中,并点击保存。
注意:保存时飞书会发送一个测试请求,如果 Dify 配置正确,这里会直接保存成功。 - 添加事件:在下方事件配置区域,点击添加事件。
- 搜索并添加 接收消息 v2.0 (im.message.receive_v1)。这是最常用的事件,用于监听所有消息。

第四步:编排工作流
- 创建应用:在 Dify 中创建一个 Workflow(工作流)。
- 添加触发器:删除默认的 开始 节点,点击节点添加按钮,选择 Lark Trigger。

- 测试运行:
- 发布你的 Dify 应用。
- 在飞书中找到你创建的机器人应用,把通过审核的机器人拉入一个群组。
- 在群里@机器人说一句话'测试飞书 Trigger',你会发现 Dify 的运行日志里已经收到了这条消息!

接下来,你可以连接 LLM 节点让 AI 回复消息,或者连接 HTTP 请求节点去操作其他系统。
常见问题排坑
Q: 为什么生成的 Callback URL 是 http://localhost 开头、并且订阅错误? A: 这是因为 Dify 的环境变量未正确配置公网地址。
- 解决方法:
- 找到 Dify 部署目录下的
.env文件。 - 修改 SERVICE_API_URL、APP_API_URL、APP_WEB_URL、TRIGGER_URL 变量,将其值改为你的服务器公网 IP 或域名(例如
http://1.2.3.4或https://dify.example.com)。
- 重启 Dify 容器:
docker compose down && docker compose up -d。 - 注意:飞书需要通过公网访问该地址。如果是本地测试,请使用内网穿透工具(如 ngrok)生成公网 URL。
结语
Lark Trigger 的出现,标志着 Dify 在企业级就绪的道路上迈出了重要一步。它不仅打破了应用间的数据孤岛,更让 AI 真正融入到了企业的日常业务流中。


