次の方法で共有


イベント トリガーを追加する

イベント トリガーを使用すると、他のシステムでイベントが発生したときにエージェントが自動的に応答できます。 その後、エージェントが応答するアクションの特定のフローを定義したり、エージェントが取るべき最適なアクションを決定する方法を指示することができます。

重要

イベント トリガーを有効にすると、課金の計算方法に影響を与える可能性があります。 詳しくは、生成モードの課金についてをご参照ください。

イベント トリガーがどのように動作し、エージェントの他のコンポーネントに関連するかについての詳細なガイダンスについては、イベント トリガーの概要を参照してください。

ヒント

この機能は、生成オーケストレーションが有効になっているエージェントでのみ使用できます。

エージェントにイベント トリガーを追加する方法:

  1. エージェントの概要ページで、トリガー セクションに移動します。

  2. [トリガーの追加] を選択します。

  3. 必要なトリガーを選択します。

  4. 必要に応じて、認証の詳細を入力します。

  5. 次へを選択します。

    ヒント

    トリガー コネクタは、エージェント作成者のアカウント (エージェント作成者認証) を使用してのみ認証できます。 エージェント作成者は、エージェント作成者としてアクセスする権限があるシステムのイベントに基づいてのみ、エージェントのトリガーを設定できます。 詳細については、イベント トリガーの制限事項 を参照してください。

  6. 必要に応じてトリガーを構成し、トリガーを起動するイベントパラメーターとトリガーのペイロードを定義します。 トリガーは既定のペイロード コンテンツを提供しますが、独自のコンテンツや指示を追加することもできます。 詳細については、トリガーペイロードを定義するを参照してください。

エージェントがイベント トリガーに応答するためには、エージェントが応答で呼び出すアクションやトピック、どれを呼び出すかの指示が必要です。 詳細については、アクションまたはトピックを呼び出すを参照してください。

トリガーをテストする

公開する前に、必ずトリガーとその応答をテストしてください。 エージェントのチャットをテスト するを使用して、定義したトリガーに エージェント がどのように反応するかをテストできます。

新しいトリガーで エージェント を公開するまで、エージェント はトリガーに自動的に反応しません。 代わりに、エージェントに送信するトリガー ペイロードを選択して、エージェントを手動でアクティブ化する必要があります。

  1. トリガー イベントを 1 回実行して、ペイロードを生成します。 たとえば、Microsoft Planner トリガー Microsoft Plannerの新しいタスクが自分に割り当てられた場合は、Microsoft Plannerでテスト タスクを自分に割り当ててトリガーをアクティブ化します。

  2. エージェントの概要ページで、トリガーの横にあるテストのトリガー アイコン を選択します。 リストには、イベントの最近のすべてのインスタンスが含まれます。

  3. テストするインスタンスを選択し、テストを開始をクリックします。

アクティビティ マップ を使用して、テスト中にエージェントがトリガー ペイロードにどのように応答するかを確認できます。 アクティビティ マップを開くには、テストペインの上部にあるマップ アイコン を選択します。

トリガーの編集

トリガーを作成したら、Power Automateを使用してイベント パラメーターとペイロードを変更できます。 Copilot Studio からトリガーを開くには:

  1. 概要 ページで、トリガーを探します。

  2. 3 点リーダー () を選択し、次に Power Automate で編集 を選択します。

  3. トリガーを選択し、パラメーターコード タブに移動して変更を行います。 追加できる変数と文字列演算子については、情報 タブを参照してください。

  4. 変更を保存します。 Power Automate における変更の詳細については、「Power Automate のトリガーの開始方法」を参照してください。

トリガー付きの エージェントを公開する

イベントトリガーを使用してエージェントを公開する前に、作成者の認証情報を使用しているエージェントに関する警告が表示されます。 イベント トリガーは、エージェント作成者の認証情報 (接続を承認するために使用した認証情報) のみを使用することができます。 これにより、エージェントのユーザーが独自の許可を得ずに、アクセスすべきでないデータやシステムにアクセスできる可能性があります。 詳細については、トリガーに関するデータ保護のベストプラクティスをご覧ください。

トリガーを使用してエージェントを公開する前の作成者の資格情報に関する警告を示すスクリーンショット。

イベント トリガー付きのエージェントを公開すると、エージェント トリガーがアクティブ化されるたびに自動的に反応します。 エージェントのトリガーとリアクションの詳細な記録は、[ アクティビティ] ページで確認できます。