> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# プラグイントリガー

## はじめに

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

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

例えば、GitHub トリガープラグインをインストールしたとします。これは、`Pull Request`、`Push`、`Issue` を含む、サブスクライブできる GitHub イベントのリストを提供します。`Pull Request` イベントをサブスクライブし、`Pull Request` プラグイントリガーをワークフローに追加すると、指定されたリポジトリで誰かがプルリクエストを開くたびに自動的に実行されます。

## プラグイントリガーの追加と設定

1. ワークフローキャンバスで右クリックし、**ブロックを追加** > **始める** を選択します。次に、ワークフローを開始するプラグイントリガーイベントを選択します。その他のトリガープラグインは [Marketplace](https://marketplace.dify.ai/?language=ja-JP\&category=trigger) で検索できます。

   <Tip>
     * 対象の外部システムに対応するトリガープラグインがない場合は、[コミュニティにリクエスト](https://github.com/langgenius/dify-plugins/issues/new?template=plugin_request.yaml)するか、[自分で開発](https://docs.dify.ai/ja/develop-plugin/dev-guides-and-walkthroughs/trigger-plugin)するか、代わりに [Webhook トリガー](/ja/3.9.x/use/nodes/trigger/webhook-trigger) を使用してください。
     * 1 つのワークフローに複数のプラグイントリガーを含めることができます。トリガーブランチが下流ノードを共有する場合、[変数集約器](/ja/3.9.x/use/nodes/variable-aggregator) を追加して集約してください。
   </Tip>

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

   <Tip>
     **プラグイン** 配下のプラグイン詳細パネルから、特定のサブスクリプションを使用しているワークフローの数を確認できます。
   </Tip>

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

<Info>
  プラグイントリガーの出力変数は、そのトリガープラグインによって定義されており、変更できません。
</Info>

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

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

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

<Note>
  **前提条件：コールバック URL のベースを設定する**

  Dify は `TRIGGER_URL` 環境変数とトリガープラグイン固有のパスを組み合わせて、各サブスクリプションのコールバック URL を生成します。デフォルトの `http://localhost:5001` は外部システムから到達できないため、`TRIGGER_URL` を公開ドメインまたは IP アドレスに設定し、Dify を再起動してからサブスクリプションを作成してください。
</Note>

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

* **自動作成**：サブスクライブするイベントを選択すると、Dify が外部システムで Webhook を自動的に作成します。Dify が代行するため、OAuth または API キーによる事前の認証が必要です。
* **手動作成**：Dify が提供するコールバック URL を使用して、外部システムで Webhook を自分で作成します。認証は不要です。

<Tabs>
  <Tab title="OAuth（自動）">
    1. **OAuth 経由** > **カスタム** を選択します。
    2. 外部システムで、Dify が提供するコールバック URL を使用して OAuth アプリケーションを作成します。
    3. Dify に戻り、アプリケーションのクライアント ID とクライアントシークレットを入力してから、**保存と承認** をクリックします。
       <Info>保存後、同じ認証情報を今後のサブスクリプションで再利用できます。</Info>
    4. サブスクリプション名を指定し、サブスクライブするイベントを選択し、その他の必要な設定を行います。
           <Tip>
             利用可能なすべてのイベントをサブスクライブすることをお勧めします。トリガーはサブスクリプションでカバーされたイベントに対してのみ発火するため、幅広くサブスクライブしておけば、後から追加するトリガーで同じサブスクリプションを再利用できます。
           </Tip>
    5. **作成** をクリックします。
  </Tab>

  <Tab title="API キー（自動）">
    1. **API キーで作成** を選択します。
    2. 必要な認証情報を入力してから、**検証** をクリックします。
    3. サブスクリプション名を指定し、サブスクライブするイベントを選択し、その他の必要な設定を行います。
           <Tip>
             利用可能なすべてのイベントをサブスクライブすることをお勧めします。トリガーはサブスクリプションでカバーされたイベントに対してのみ発火するため、幅広くサブスクライブしておけば、後から追加するトリガーで同じサブスクリプションを再利用できます。
           </Tip>
    4. **作成** をクリックします。
  </Tab>

  <Tab title="URL を貼り付けて新しいサブスクリプションを作成（手動）">
    1. **URL を貼り付けて新しいサブスクリプションを作成** を選択します。
    2. サブスクリプション名を指定し、Dify が提供するコールバック URL を使用して外部システムで Webhook を作成します。
    3. （オプション）テストします。サブスクライブしたイベントをトリガーして、**手動設定** ページ下部の **リクエストログ** で受信リクエストと Dify のレスポンスを確認します。
           <Frame>
             <img src="https://mintcdn.com/dify-enterprise-docs/zvhvyUvEpyoIONBf/images/use-dify/workflow/plugin-trigger-manual-setup-request-logs.png?fit=max&auto=format&n=zvhvyUvEpyoIONBf&q=85&s=821aa98304f8b29365f1281cfef19118" alt="リクエストログ" width="1218" height="518" data-path="images/use-dify/workflow/plugin-trigger-manual-setup-request-logs.png" />
           </Frame>
    4. **作成** をクリックします。
  </Tab>
</Tabs>

## プラグイントリガーをテストする

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