英語で読む

次の方法で共有


イベント トリガー 概要 (トリガー)

イベント トリガー を使用して、何かが発生したときに 応答 でアクションを実行したりトピックを呼び出したりするようにカスタム エージェントを構成できます。ユーザーからの入力を必要とする トピック トリガーとは異なり、イベント トリガーを使用すると、定義されたイベントの発生に対して エージェント が 応答 内で自律的に動作できます。

重要

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

注意

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

イベントトリガーの仕組み

イベント トリガーには、 トリガー ペイロード を生成し、コネクタを介して エージェント に送信する選択されたイベントが必要です。 ペイロードには、特定の種類のデータの変数など、イベントに関する情報が含まれます。 エージェント はペイロードを受信すると、エージェント の命令内の エージェント 著者 によって提供された指示と、トリガー ペイロードを介して送信された命令を実行します。

エージェントは、著者 の設計と指示に基づいてのみ行動します。 たとえば、 新しいチーム メンバーが追加されたときに トリガー を追加し、 新しい従業員にオンボーディング リソースを含む歓迎メッセージを送信するアクションとして 応答 を指定できます。

イベント トリガーは、エージェント 外部のイベントに基づいてアクティブになります。 これらは、ユーザーが入力した トピック フレーズに基づいてトピックやアクションをアクティブ化するために使用される トピック トリガー とは異なります。

この記事では、イベント トリガーの仕組み、制限、およびトラブルシューティング戦略について説明します。 イベント トリガー の追加の詳細については、「 イベント トリガー の追加」を参照してください。

イベント トリガーの他の例としては、次のようなものがあります。

  • アイテムが作成されると SharePoint
  • ファイルが作成されると OneDrive
  • Plannerでタスクが完了すると
  • Outlookに新しいメールが届いたとき
  • 一定時間が経過した (a 繰り返し トリガー)

重要

利用できるトリガーは、管理者 によって 設定された組織のデータ損失防止ポリシー Power Automate によって異なります。

トリガー ワークフロー

トリガー は、複数の部分を含むワークフローの一部です。

  1. イベント トリガー は、特定の イベント が発生したことを登録します。
  2. トリガー は、イベントと指示に関する情報を含む ペイロード を送信します。
  3. エージェント には、ペイロードに基づいて1つ以上のアクションを選択するための 指示 があります。

あなたのイベントにぴったりのトリガーを見つけましょう

Copilot Studio Microsoftおよびパートナー サービスで発生する可能性のあるさまざまなイベントのトリガーのライブラリがあります。 トリガー 構成は、トリガー を開始するイベントのパラメータを決定します。 また、トリガー ペイロードの内容も決定します。

イベント トリガー ライブラリのスクリーンショット。

ほとんどのトリガーでは、トリガー をアクティブにするイベントに関するパラメータを指定できます。 たとえば、Outlookの 新しい電子メールが届いたとき トリガー では、すべての受信電子メールではなく、件名に文字列 プロジェクトの詳細 が含まれる電子メールのみに トリガー をアクティブにするように指定できます。

トリガー ペイロードを定義する

トリガー ペイロードは、イベントに関する情報が含まれるJSONまたはプレーン テキスト メッセージです。 ペイロードは メッセージとして エージェント に送信されます。 トリガー を追加する 場合、その トリガー のデフォルトのペイロード コンテンツを保持するか、独自の指示を追加することができます。 後で、 で変数や文字列演算子の追加など、ペイロードの内容を変更 Power Automateできます。

たとえば、 新しいメールが届いたとき トリガー のデフォルト メッセージは、 次のコンテンツを使用する Bodyです。 エージェント がペイロードを受信すると、電子メールの本文のコンテンツと、そのコンテンツを使用するための手順が取得されます。

トリガー を定義するためのフィールドのスクリーンショット。

ペイロード内に エージェント に送信する指示を追加して、トリガー によってアクティブ化されたときに エージェント がどのように動作するかを指示することができます。 トリガーが複数ある場合は、トリガー ペイロードごとに具体的で詳細な指示を含めることができます。エージェント の一般的な指示に長くて複雑なガイダンスを記述したり、どの指示がどの トリガー に適用されるかについて エージェント を混乱させたりする必要はありません。

たとえば、 新しいメールが届いたとき トリガー ペイロードに、 受信者のアクション項目を探す Bodyを追加できます。 エージェント はペイロードを受信すると、電子メールの本文内でアクション項目を探す指示を受信します。

ただし、エージェント の一般的な指示と競合するペイロード指示を記述することは避けてください。 命令の競合によりエラーや予期しない結果が発生する可能性があります。 必ず イベントトリガーに関連するすべての変更をテストする

トリガー を作成した後、 トリガー ペイロードで変数または文字列演算子を追加または変更 したり、 を使用して既存のペイロード命令を変更したりできます Power Automate

エージェント 命令とペイロード命令

ペイロード命令は、1つのイベントにどのように反応するかに特化しています。 また、エージェント 命令を使用して、エージェント に、トリガー からの情報の処理方法や、トリガー ペイロードを受信したときの動作方法を指示したり、エージェント の一般的な動作を決定したりすることもできます。 たとえば、受信メールに基づいてMicrosoft To Doタスクを作成する エージェント の場合、手順は次のようになります: 新しいメールからアクション アイテムを受信したら、タスク リストにTo Doタスク を作成します。

エージェント 指示フィールドのスクリーンショット。

ただし、エージェント の手順がすべての状況で最適に機能するとは限りません。 エージェント に複数のトリガーまたは複数の複雑な目標がある場合は、代わりに トリガー ペイロード の指示を使用する必要があります。

最後の例を続けると、トリガー ペイロードに、 受信者のアクション項目を検索する Bodyという指示を追加できます。 エージェント はペイロードを受信すると、アクション項目を探すように指示されます。 次に、エージェント の一般的な指示により、見つかったアクション項目ごとにTo Doタスクを作成するように指示されます。

トリガー を作成するときに、トリガー ペイロード指示を追加するためのフィールドのスクリーンショット。

エージェント向けの指示書を作成するには練習が必要です。 その他のヒントについては、 ライティング ガイダンス にアクセスし、エージェント に加えたすべての変更を必ずテストしてください。

アクションを呼び出すか、トピック

エージェント が トリガー ペイロードを受信すると、指定した指示によって、応答 で呼び出されるアクションまたは トピック が決まります。 あなたの指示により、エージェント は利用可能な情報に基づいてアクションを 選択 したり、トピック したりできるようになります。

エージェント では、その場で新しいアクションや トピック は作成されません。 エージェント 著者, として、選択 できるアクションまたはトピックを定義する必要があります。 エージェント がどのアクションまたは トピック を呼び出すかを決定する方法については、 生成モードの仕組みを参照してください。

エージェント が期待どおりに反応しない場合は、 アクティビティ マップ を使用して、重要な入力情報が不足していないかどうかを確認できます。

入力が欠落しているアクションを示す アクティビティ マップ のスクリーンショット。

手順を改善できる点としては、次のようなものがあります。

  • トリガー ペイロードまたは エージェント 手順に、より詳細な手順を追加します。 エージェント には、アクションの特定の入力フィールドで使用する情報など、さらに詳しい指示が必要な場合があります。
  • トリガー ペイロードに指示を含めます。
  • エージェント に特定のアクションまたは トピック を呼び出すように指示します。
  • トリガー ペイロードと エージェント 命令間の競合する命令をチェックしています。
  • アクションの説明を追加して、エージェント がいつ呼び出すかを判断するための情報をより多く持つようにします。
  • アクション入力フィールドに説明を追加して、エージェント がパラメータを正しく入力できるようにします。 アクションの入力が毎回同じ場合は、値を自分で設定できます。
  • 15個未満のアクションまたはトピックを連続して呼び出します。 多くのアクションまたはトピックを単一のシーケンスとして実行する複雑なエージェントでは、それらの実行を確実に管理することが困難な場合があります。

エージェント が期待されるアクションをまだ呼び出すことができない場合は、エージェント のアクションとして目標を達成する Power Automate フロー を追加することを検討してください。

イベントトリガーを使用したエージェントの公開

新しいイベント トリガー で エージェント を公開するまでは、エージェント はその トリガー に自動的に反応しません。 公開前に エージェント を徹底的にテストしてください。新しい トリガー を使用して エージェント を公開 すると、トリガーがアクティブになるたびに エージェント が自動的に反応するようになります。 アクティビティ ページで、エージェント のトリガーと反応の詳細な記録を確認できます。

テスト中にトリガーをアクティブ化する方法の詳細については、「 トリガー のテスト」を参照してください。

イベント トリガーは、トリガー の認証に エージェント 著者's資格情報 (つまり、 接続を承認するために使用した資格情報) のみを使用できます。 これにより、エージェント のユーザーは、エージェント を使用して、同じ認証を使用してデータやシステムにアクセスできるようになります。 詳細については、 トラブルシューティングと制限事項 をご覧ください。

公開後のアクションの認証

エージェント にアクションを実行するための認証がない場合、またはユーザー認証を要求するように構成されている場合は、ユーザーに資格情報を要求するメッセージが送信されます。 エージェント のフローが、情報を受信できないかアクションが失敗したために中断された場合、セッションを続行できません。 エージェント を自律的に実行したい場合は、各アクションを、ユーザー入力を必要としない機能する認証で構成する必要があります。 エージェント に、ユーザーに資格情報を要求しないように指示することもできます。

エージェントはすべてのコネクタを正常に実行できない可能性があります。 エージェントが繰り返しコネクタの呼び出しに失敗する場合は、 Power Automate フローアクション 問題のあるコネクタを使用してアクションを完了します。

トラブルシューティングと制限事項

クォータ制限

トリガーが頻繁にアクティブになると、エージェント が予想よりも多くのリソースを使用することになる可能性があります。 エージェント はサービス負荷を超える可能性があります 割り当て制限、サービスが制限される可能性があります。

管理者は リソースの使用状況を監視する Power Platform。 また、 イベント トリガーをブロック して、環境 での使用を禁止することもできます。

クォータ制限を超えないようにするには:

  • 非常に頻繁に発生するトリガーや、無期限に繰り返されるトリガーを追加する場合は注意してください。 たとえば、繰り返し トリガー は、設定された時間が経過するたびにアクティブになります。 もっと小さく のアクティベーション間の時間が長いほど、トリガー が使用するリソースが多くなります。
  • 環境 でアクティブなトリガーの数を追跡します。

トリガーはメーカーの資格情報のみを使用できます

現在、イベント トリガーは認証に エージェント 著者's資格情報のみを使用できます。 認証されたイベント トリガーを使用して エージェント を公開または 共有 すると、ユーザーが情報にアクセスしたり、著者 の資格情報を使用して エージェント にアクションの実行を要求したりできるようになる可能性があります。

保護されたデータやシステムにユーザーがアクセスしたり変更したりすることを防ぐために、認証を必要とするデータやシステムがイベント トリガーを持つエージェントによって使用されるかどうか、またどのように使用されるかを慎重に検討してください。 作成者は、イベント トリガーを含むエージェントを共有または公開する際には注意する必要があります。

管理者は、ユーザーがエージェントでイベント トリガーを使用することをブロックすることもできます。 Copilot Studio 詳細については、 「ブロック イベント トリガー」を参照してください

イベントトリガーを使用した知識ソースの使用に関する制限

エージェントは、応答 内の一部のナレッジ ソースをイベント トリガー に参照できません。 一部のナレッジ ソースでは、アクセスするための認証を提供するために エージェント が必要ですが、エージェントはその認証を自律的に提供することはできません。

応答 でイベント トリガー を参照する場合、これらの知識ソースは避けてください。

  • SharePoint
  • Dataverse
  • グラフ コネクタ
  • AI Builder プロンプト

代わりに、応答 のこれらの知識ソースをイベント トリガー に参照してください。

  • 公開 Web サイト
  • アップロードされたファイル
  • コネクタを使用したエンタープライズデータ