触发器

​

简介

触发器仅适用于 Workflow 应用。

触发器是一种开始节点，能够使 Workflow 定时运行或当外部系统（例如 GitHub、Gmail 或你自己的内部系统）的特定事件发生时自动运行，而不是只能通过用户交互或 API 调用才能启动。

基于以上特性，触发器可用于自动执行重复任务，或将 Workflow 与第三方系统集成以实现自动化数据同步与处理。

一个 Workflow 可同时拥有多个并行的触发器。你也可以在同一画布上构建多个独立的、以不同触发器作为起点的 Workflow。

对于 Sandbox 套餐，每个 Workflow 最多可添加 2 个触发器。升级 以添加更多。

每次 Workflow 运行的触发源将显示在 日志 中。

在 Dify Cloud 上，触发器事件（由触发器启动的 Workflow 运行）受套餐配额限制。详见 套餐对比。 工作区所有者和管理员可在 设置 > 账单 页面查看剩余配额。

​

触发器类型

• 定时触发器

  • 在指定的时间点自动运行 Workflow。

  • 示例：每天早上 9 点自动生成销售报告，并通过电子邮件发送给团队成员。

• 插件触发器

  • 通过触发器插件订阅外部系统的特定事件，当订阅事件发生时自动运行 Workflow。

  • 示例：通过订阅 Slack 触发器插件中的频道中的新消息事件，自动分析并归档特定频道中的新消息。

• Webhook 触发器

  • 通过自定义 webhook 订阅外部系统的特定事件，当订阅事件发生时自动运行 Workflow。

  • 示例：当电商平台通过 HTTP 请求发送包含订单详情的新订单时，自动处理该订单。

插件触发器和 Webhook 触发器均可让 Workflow 具备 事件驱动（基于事件运行）的特性。选择时，可参考以下思路：

1. 当你的目标外部系统有可用的触发器插件时，使用 插件触发器。你只需订阅该插件中支持的事件即可。

2. 当没有合适的插件或需要订阅现有插件不支持的事件时，使用 Webhook 触发器。此时，你需要在外部系统中自行配置 webhook。

​

启用或禁用触发器

在右侧调出的 快捷设置 菜单中，你可以启用或禁用 已发布 的触发器。被禁用的触发器不会触发 Workflow。

只有已发布的触发器才会出现在 快捷设置 中。若未看到某个已添加的触发器，请先确保它已被发布。

​

测试多个触发器

当一个 Workflow 有多个触发器时，可点击 测试运行 > 运行所有触发器 以测试所有触发器。第一个运行的触发器将启动 Workflow，其余触发器将被忽略。

点击 运行所有触发器 后：

• 定时触发器将在下一个计划时间运行。

• 插件触发器将开始监听已订阅的事件。

• Webhook 触发器将开始监听外部 HTTP 请求。