英語で読む

次の方法で共有

トピック トリガーを使用する

  • [アーティクル]

デフォルトでは、トピックは フレーズ トリガーを使用し、1 つ以上のトリガー フレーズがユーザーからの受信メッセージと密接に一致するとアクティブになります。 トピックをいつ実行するかを決定する使用可能なトリガー タイプは他にもあります。

前提条件

  • トピック トリガーを理解する前に、トピックの作成と編集に慣れておくことをお勧めします。 詳細情報は、トピックを作成および編集するを参照してください。

重要

この記事には Microsoft Copilot Studio プレビュー ドキュメントが含まれ、変更される可能性があります。

プレビュー機能は運用環境での使用を想定しておらず、機能が制限される可能性があります。 これらの機能は公式リリースの前に使用できるため、一足先にアクセスして フィードバックを送る ことができます。

本番環境に対応した エージェント を構築する場合は、 Microsoft Copilot Studio 概要を参照してください。

トリガーの種類

トリガーを使用すると、さまざまなタイプのアクティビティを中断して処理できます。 次のトリガー タイプにより、トピックをいつトリガーするかを判断します。

ヒント

ユーザーが エージェント にメッセージを送信すると、ペイロードはアクティビティの メッセージ タイプ になります。 エージェントは、チャットで新しい変更が加えられた他のタイプの活動を受信できます。

例えば、Microsoft Teams は、メッセージ拡張機能との対話などのユーザー アクションを示す、タイプが invoke の非表示活動を送信します。

タイプ 説明
フレーズ 1 つ以上のトリガー フレーズがユーザーからの受信メッセージと一致する場合
活動を受信 任意のタイプの活動を受信した場合
メッセージを受信 タイプが message の活動を受信した場合
最も一般的な活動のタイプ。
ユーザーがエージェントに何かを入力または発言したときに受信されます。
イベントを受信 タイプが event の活動を受信した場合
会話の更新を受信 タイプが conversationUpdate の活動を受信した場合
たとえば、Teams は、ユーザーが会話に参加すると、このタイプの活動を送信します。
呼び出しを受信 タイプが invoke の活動を受信した場合
最も一般的には、Teams チャネルから受信します。 たとえば、ユーザーが Teams アプリでメッセージまたは検索の拡張機能を操作する場合。
非アクティブ ユーザーが長期間にわたってエージェントと対話しなかった場合。 期間は設定できます。

トピックのトリガーを変更する

  1. Copilot Studio でエージェント を開き、 トピック ページに移動します。

  2. 任意のトピックを開きます。

  3. トリガー ノードの フレーズ にカーソルを合わせ、トリガーの変更 アイコンを選択します。 選択できるトリガーのリストが表示されます。

    トリガーの変更の選択内容のスクリーンショット。

  4. トピックのトリガーのタイプを選択します。

    重要

    現在のトリガー タイプのコンテンツがある場合、トリガー タイプが変更されると削除されます。 タイプを変更する前に確認を求められます。

    トリガー タイプを変更するとトリガー フレーズが失われるという警告のスクリーンショット。

  5. トリガーの 編集 を選択して、そのトリガー タイプのプロパティを開きます。

トリガー条件

条件 ノードを使用すると、トリガーを起動するために満たす必要がある条件を指定できます。 たとえば、条件は従業員が使用するチャネルが Microsoft Teams である場合にのみ発生します。

トリガー条件のプロパティのスクリーンショット。

必要に応じて、...ノード メニュー を選択し、計算式に変更する を選択することで、完全な Power Fx エディターに切り替えて、より複雑な条件を作成できます。

詳細については、条件とトピックの追加 を参照してください。

トリガーの優先度

メッセージなど、1 つの受信活動に対して複数のトリガーを起動できます。 トリガー タイプによって、トリガーが起動する順序が決まります。

実行順序:

  1. 活動を受信
  2. メッセージ / イベント / 会話の更新 / 起動の受信
  3. フレーズ

同じタイプの適格なトリガーが複数ある場合、トリガーは作成順 (古い順) で実行されます。

ノードの プロパティ ペインの 優先順位 プロパティを使用して、実行順序を明示的に指定できます。

ノードのプロパティ ペインの優先順位プロパティのスクリーンショット。

その他のトリガー プロパティ

一部のトリガー タイプには、条件 と 優先順位 以外にも多くのプロパティがあります。 たとえば、非アクティブ トリガー タイプを使用すると、非アクティブ期間を設定できます。

非アクティブ トリガーの期間プロパティのスクリーンショット。

デフォルトのトリガー タイプ

既定ではこれらのプロパティは空です。

ただし、活動またはイベント タイプを選択した場合は、一致する受信タイプのみが起動されます。 たとえば、会話をエージェントにエスカレーションする必要がある場合に、引き継ぎ 活動タイプを選択すると、引き継ぎ をトリガーする受信メッセージのみが起動します。

活動を受信 イベントを受信
アクティビティの種類 イベントの種類

詳細については、イベント活動の送信 を参照してください。