次の方法で共有

イベント トリガーを追加する (プレビュー)

  • [アーティクル]

イベントトリガーを使用すると、他のシステムでイベントが発生したときにエージェントが自動的に反応できます。 次に、エージェントが応答して実行する特定のアクション フローを定義したり、実行する最適なアクションを決定する方法について エージェント に指示を与えたりできます。

重要

イベント トリガーの使用は、パブリック プレビュー機能です。 プレビュー参加者はイベント トリガーを無料で使用できますが、使用量 クォータにカウントされるメッセージが必要です。 プレビュー機能は運用環境での使用を想定しておらず、機能が制限される可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が事前にアクセスし、そこからフィードバックを得ることができます。

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

ヒント

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

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

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

  2. トリガーの追加を選択します。 [概要] ページの [トリガー] パネルのスクリーンショット。

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

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

  5. 次へを選択します。

    ヒント

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

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

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

トリガーをテストする

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

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

  1. トリガー イベントを 1 回実行して、ペイロードを生成します。 たとえば、Microsoft Planner トリガーを使用している場合 新しいタスクが自分に割り当てられたとき Microsoft Planner の場合は、Microsoft Planner でテスト タスクを自分に割り当ててトリガーをアクティブ化します。
  2. エージェントの概要ページで、トリガーの横にあるテストのトリガー アイコン を選択します。 リストには、イベントの最近のすべてのインスタンスが含まれます。
  3. テストするインスタンスを選択し、テストを開始をクリックします。 選択するテスト ペイロードを示すスクリーンショット。

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

トリガーの編集

トリガーを作成した後、次の方法でイベント パラメーターとペイロードを変更できます Power Automate。 Copilot Studio からトリガーを開く方法:

  1. 概要 ページで、トリガーを探します。
  2. その他アイコン (…) で、Power Automate で開く を選択します。 トリガーを開いて編集する方法のスクリーンショット Power Automate 。
  3. トリガーを選択し、 パラメーター および コード タブに移動して変更を行います。 追加できる変数と文字列演算子については、情報 タブを参照してください。
  4. 変更を保存します。 Power Automateの変更の詳細については、 トリガーの使用を開始する Power Automateを参照してください。

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

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

イベント トリガーでは、認証に エージェント 作成者の資格情報 (つまり、接続の 承認に使用した資格情報) のみを使用できます。 これにより、エージェントのユーザーは、自分の許可を得ずに、アクセスすべきでないデータやシステムにアクセスできるようになります。 詳細については、トラブルシューティングと制限事項を参照してください。