Skip to main content

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

Info

トリガーは Workflow アプリケーションでのみ利用可能です。

インテグレーショントリガーは、外部システムで特定のイベントが発生したときにワークフローを自動的に開始します。トリガー統合を通じてイベントをサブスクライブし、対応するトリガーをワークフローに追加します。

例えば、GitHub トリガー統合をインストールすると、Pull Request、Push、Issue などのイベントをサブスクライブできます。Pull Request をサブスクライブしてトリガーを追加すると、指定リポジトリでプルリクエストが作成されるたびにワークフローが実行されます。

インテグレーショントリガーの追加と設定#

  1. ワークフローキャンバスで右クリックし、ブロックを追加 > 始める を選択してから、ワークフローを開始するインテグレーショントリガーイベントを選択します。その他のトリガー統合は Marketplace で検索できます。

    Tip
    • 対象の外部システムに対応するトリガー統合がない場合は、コミュニティにリクエストするか、自分で開発するか、代わりに Webhook トリガー を使用してください。
    • 1 つのワークフローに複数のインテグレーショントリガーを含めることができます。トリガーブランチが下流ノードを共有する場合、変数集約器 を追加して集約してください。

  2. 既存のサブスクリプションを選択するか、新しいサブスクリプションを作成します。トリガーがイベントを受信するにはサブスクリプションが必要です。

  3. その他の必要な設定を行います。

Info

インテグレーショントリガーの出力変数はトリガー統合によって定義されており、変更できません。

サブスクリプションの作成#

サブスクリプションは、外部システムからのイベントをリッスンする Webhook です。各トリガー統合はワークスペースごとに最大 10 個のサブスクリプションをサポートします。

Webhook とは？

Webhook を使用すると、あるシステムが別のシステムにリアルタイムでデータを送信できます。イベントが発生すると、ソースシステムはイベントの詳細を HTTP リクエストにパッケージ化し、宛先システムが提供する URL に送信します。

Dify はサブスクリプションの作成方法を 2 つサポートしています。利用可能な方法はトリガー統合の設計によって異なります。

  • 自動作成：サブスクライブするイベントを選択すると、Dify が外部システムで Webhook を自動的に作成します。Dify が代行するため、OAuth または API キーによる事前の認証が必要です。
  • 手動作成：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. 作成 をクリックします。

サブスクリプションの管理#

トリガー統合のサブスクリプションは 統合 > トリガー から管理できます。統合を開くと、各サブスクリプションの使用状況（利用中のワークフロー数）を確認でき、編集や削除が行えます。

インテグレーショントリガーのテスト#

未公開のトリガーをテストするには、まず このステップ実行 をクリックするか、ワークフロー全体をテスト実行してください。これによりトリガーがリスニング状態になり、サブスクライブしたイベントをキャプチャできるようになります。リスニング状態にしないと、イベントが発生しても無視されます。