イベント トリガーの概要

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

イベント トリガーのしくみ

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

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

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

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

その他のイベントトリガーの例は次のとおりです:

• SharePoint で項目が作成されたとき
• OneDrive でファイルが作成されたとき
• Planner でタスクが完了したとき
• 一定時間が経過した (繰り返しトリガー)

イベント トリガーの課金と使用状況

イベント トリガー アクティビティは、使用量と課金の消費単位にカウントされます。 メッセージは、エージェントからのアクションや応答をトリガーする、エージェントに送られるリクエストやメッセージとして定義されます。 これには、イベント トリガーからエージェントに送信されるペイロードが含まれます。 たとえば、10 分ごとに起動するように設定された繰り返しトリガーは、10 分ごとにトリガーのペイロードをメッセージとしてエージェントに送信します。

詳細については、「 課金レートと管理」を参照してください。

トリガーのワークフロー

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

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

イベントに合ったトリガーを見つける

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

ほとんどのトリガーでは、トリガーを起動するイベントに関するパラメーターを指定することができます。 たとえば、Dataverse のトリガー 行が追加、変更、削除された場合では、どのテーブルの変更がトリガを起動するかを選択します。

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

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

たとえば、行が追加、変更、削除された場合トリガーの既定メッセージは、Body のコンテンツを使用するです。 エージェント がペイロードを受信すると、行のコンテンツと、そのコンテンツを使用するための指示が含まれます。

ペイロードの中に、トリガーによって起動された際に、エージェントがどのように動作するかを指示する、エージェントに送信する命令を追加することができます。 複数のトリガーがある場合、各トリガー ペイロードには具体的で詳細な指示を含めることができます。 その結果、エージェントの一般的な指示に長くて複雑なガイダンスを書いたり、どの指示がどのトリガーに適用されるかについてエージェントを混乱させすることを回避できます。

たとえば、行が追加、変更、または削除された時には、 チャットで変更の要約を送信するを追加することができます。 エージェントはペイロードを受信すると、エージェント チャットでユーザーの変更を要約します。

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

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

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

ペイロードの指示は、ある事象にどのように対応するかという具体的な命令です。 また、エージェントの一般的な動作を決定するためだけでなく、トリガーからの情報をどのように扱うか、トリガー ペイロードを受信したときにどのように動作するかをエージェントに指示するために、エージェント命令を使用することができます。 たとえば、新しい Dataverse テーブルの行でアカウント名の重複をチェックするエージェントの場合、その指示は次のようになります: 新しい行が追加されたら、重複アカウントかどうかをチェックします。新しい行が追加されたら、重複するアカウントかどうかをチェックします。重複している場合は、To Do タスクを作成して調査し、変更と重複の詳細を記載します。

しかし、エージェントの指示は、すべての状況に最適とは限りません。 エージェントに複数のトリガーや複数の複雑なゴールがある場合、代わりにトリガー ペイロードの指示を使用する必要があります。

最後の例を続けると、トリガー ペイロードに、同じ Dataverse テーブルで重複するアカウント名を検索する命令を追加することができます。エージェントはペイロードを受け取ると、重複するアカウント名を探すように指示されます。 エージェントの一般的な指示には、重複がある場合は、調査する To Do タスクを作成し、変更と重複の詳細を記載してください。

エージェント向けの指示の作成には練習が必要です。 より多くのヒントについては、ライティングのガイダンスを参照してください。そして、エージェントに加えるすべての変更を常にテストしてください。

アクションまたはトピックを呼び出す

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

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

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

手順に対して行うことができる改善点には、次のようなものがあります:

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

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

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

新しいイベント トリガーでエージェントを公開する前に、エージェントは自動的にそのトリガーに反応しません。 新しいトリガーを持つエージェントを公開すると、エージェントはトリガーが起動するたびに自動的に反応します。 エージェントのトリガーとリアクションの詳細な記録は、[ アクティビティ] ページで確認できます。

テスト中のトリガーのアクティブ化については、トリガーのテストを参照してください。

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

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

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

トリガーは作成者認証を使用するため、トリガーを持つ公開エージェントを介して潜在的なユーザーがアクセスできるデータに注意してください。 詳細については、トリガーによるデータ保護セクションを参照してください。

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

クォータ制限

トリガーがあまりにも頻繁に起動すると、エージェントは予想以上にリソースを使用してしまう場合もあります。 エージェントがサービス負荷のクォータ制限を超過し、サービスが整される可能性があります。

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

クォータ制限を超えないようにするには、次のようにします:

• 非常に頻度の高いトリガーや、無期限に繰り返されるトリガーを追加する場合は注意が必要です。 たとえば、繰り返し動作するトリガーは、設定した時間が経過するたびに起動します。 発動までの時間が短いほど、トリガーはより多くのリソースを使用します。
• 環境内でアクティブなトリガーの数を追跡します。

トリガによるエージェントのデータ保護

現在、イベント トリガーは認証のためにエージェント作成者の資格情報のみを使用することができます。 また、エージェントを自律的に実行するには、認証を必要とするすべてのトリガーとアクションで作成者の資格情報を使用する必要があります。

認証されたイベント トリガーを持つエージェントを公開した場合、ユーザは作成者の認証情報を使用して情報にアクセスしたり、エージェントにアクションの実行を促したりできる可能性があります。 作成者が認証されたイベント トリガーでエージェントを構成する場合、エージェントを公開する前にこの制限を思い出させます。

トリガーペイロードには、エージェントがアクションを通じて他の場所に出力できる機密情報が含まれている可能性があります。 たとえば、受信メールの情報を使用して、Dataverse テーブルの新しい行を入力するエージェントを構築したとします。

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

データ保護のベスト プラクティス

ユーザーが機密データにアクセスできないようにするには、次のようにします。

• 認証を必要とするデータやシステムが、イベントトリガーを持つエージェントによって使用されるかどうか、またどのように使用されるかを評価します。
• テストを通じて、トリガーがペイロードにどのような情報を含む可能性があるか、またそのペイロードの入力を使ってどのような情報アクションが出力されるかを理解します。
• トリガー パラメーターを使用してトリガーを起動する範囲を絞り込み、ペイロードデータの処理方法をエージェントに指示します。

ソリューション対応クラウド フロー共有を有効にする必要がある

作成者がエージェントにイベント トリガーを追加できるのは、ソリューション対応クラウド フローの共有がオンになっている環境のみです。

トリガーを追加できない場合、組織の データ ポリシーでトリガーが許可されている場合は、環境でこのオプションがオフになっている可能性があります。 ソリューション対応クラウド共有を有効にするには、環境の管理者にお問い合わせください。

接続の問題に関するトラブルシューティング

エージェントはすべてのコネクターを正常に実行できるとは限りません。 エージェントがコネクタの呼び出しに何度も失敗する場合は、問題のあるコネクタを使用してアクションを完了する Power Automate のフロー アクションを作成することを検討してください。