Skip to main content

本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。

Info

触发器仅适用于 Workflow 应用。

集成触发器可在外部系统发生特定事件时自动运行工作流。你通过触发器集成订阅这些事件，再将对应的触发器添加到工作流中即可。

例如，安装 GitHub 触发器集成后，你可以订阅 Pull Request、Push、Issue 等事件。订阅 Pull Request 并添加对应的触发器后，每当有人在指定仓库中创建 pull request，工作流就会自动运行。

添加和配置集成触发器#

  1. 在工作流画布上，单击右键并选择 添加节点 > 开始，然后选择要启动工作流的集成触发器事件。如需更多集成，可在 市场 中搜索。

    Tip

  2. 选择一个现有订阅或 创建新订阅。触发器需要订阅才能接收事件。

  3. 配置其他必需设置。

Info

集成触发器的输出变量由触发器集成定义，无法修改。

创建订阅#

订阅是一个用于监听外部系统事件的 webhook。每个触发器集成在每个工作空间中最多支持 10 个订阅。

什么是 webhook？

Webhook 允许一个系统自动向另一个系统发送实时数据。当某个事件发生时，源系统将事件详情打包为 HTTP 请求，发送至目标系统提供的 URL。

Dify 支持两种创建订阅的方式，具体取决于触发器集成支持的选项。

  • 自动：你选择要订阅的事件，Dify 在外部系统中自动创建 webhook。这需要先通过 OAuth 或 API key 授权，以便 Dify 代表你完成配置。
  • 手动：你使用 Dify 提供的回调 URL 自行在外部系统中创建 webhook，无需授权。

在 Dify Cloud 上，许多主流触发器集成都预配置了默认 OAuth 客户端，你无需注册自己的 OAuth 应用即可一键授权。如需改用自己的 OAuth 应用，则选择 自定义。

默认

  1. 选择 通过 OAuth 创建 > 默认，然后点击 保存并授权。
  2. 在弹出的授权页面上，授予 Dify 访问权限。
  3. 填写订阅名称，选择要订阅的事件，并配置其他必需设置。
    Tip

    建议订阅所有可用事件。触发器只会响应订阅中涵盖的事件，因此一个涵盖广泛的订阅可被后续添加的触发器复用，无需再创建新订阅。

  4. 点击 创建。

自定义

  1. 选择 通过 OAuth 创建 > 自定义。
  2. 在外部系统中，使用 Dify 提供的回调 URL 创建一个 OAuth 应用。
  3. 返回 Dify，输入应用的客户端 ID 和客户端密钥，然后点击 保存并授权。
    Info
    保存后，同一凭据可在后续订阅中复用。
  4. 填写订阅名称，选择要订阅的事件，并配置其他必需设置。
    Tip

    建议订阅所有可用事件。触发器只会响应订阅中涵盖的事件，因此一个涵盖广泛的订阅可被后续添加的触发器复用，无需再创建新订阅。

  5. 点击 创建。

管理订阅#

在 集成 > 触发器 中管理触发器集成的订阅。打开某个触发器集成后，可查看其所有订阅（包括每个订阅被多少个工作流使用），并进行编辑或删除。

测试集成触发器#

如需测试未发布的触发器，先点击 运行此步骤 或测试运行整个工作流，使触发器进入监听状态。否则，即使订阅的事件发生，也不会被捕获。