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

デフォルトでは、トピックはフレーズ トリガーを使用します。つまり、1 つ以上のトリガー フレーズがユーザーからの受信メッセージと厳密に一致する場合にトピックがトリガーされます。 ただし、トピックをいつ実行する必要があるかを指定するために、複数の追加のトリガー タイプを使用できます。

前提条件

重要

このトピックは Power Virtual Agents プレビューのドキュメントを含み、今後変更される可能性があります。

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

運用に対応したボットを構築する場合は、Power Virtual Agents の概要 を参照してください。

トリガーの種類

トピックを起動するタイミングを指定するために、次のトリガー タイプが存在します。

チップ

ユーザーからボットへのメッセージが受信されると、メッセージが到着するペイロードは活動と見なされ、活動のタイプはメッセージになります。 ボットは、他の種類の活動を受信することもできます。通常は、何かが発生または変更されたことをボットに知らせるために使用されるチャネルによって送信されます。 たとえば、Microsoft Teams は、タイプが invoke の隠し活動を送信します。これにより、ボットは、Teams ユーザーがメッセージ拡張機能との対話などの何かを行ったことを認識できます。 ここで説明する使用可能なトリガーの多くを使用すると、さまざまな種類の活動を傍受して処理できます。

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

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

  1. トリガー ノードにカーソルを合わせ、トリガーの変更ボタンをクリックします。 これにより、選択できるトリガーのリストが表示されます。

    トリガーの選択肢のスクリーンショット。

  2. トピックに関連付けるトリガーのタイプを選択します。 トリガー フレーズのリストなど、現在のトリガーに関連付けられている構成がある場合は、トリガー タイプが変更されるとこの内容が失われるため、続行する前に確認を求められます。

  3. トリガーの編集ボタンをクリックすると、トリガーのプロパティが開きます。

トリガー条件

条件プロパティで、トリガーを起動するために満たす必要のある条件を指定できます。 次の例では、トリガーおよびその関連付けられているトピックは、エンド ユーザーが使用しているチャネルが Microsoft Teams の場合のみ起動します。

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

オプションでフル Power Fx エディタに切り替えて、より複雑な条件を作成するには、ビルダー ドロップダウンをに切り替えます。

トリガーの優先度

1 つの受信活動 (メッセージなど) に対して複数のトリガーを起動できます。 受信活動に応答するトリガーが起動する順序は、最初にトリガーの種類によって決まります。 以下は、トリガー タイプが実行される順序です。

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

同じタイプの適格なトリガーが複数ある場合、デフォルトでは、トリガーは関連するトピックの作成順に実行されます (古い順)。 優先度プロパティを使用して、実行順序を明示的に指定できます。

追加のトリガー プロパティ

個々のトリガー タイプの一部には、条件優先度以外にも追加のプロパティがあります。

活動を受信

活動を受信 - デフォルトでは、このプロパティは空です。 入力されている場合、受信活動のタイプ プロパティがここで選択された値と一致する場合にのみ、トリガーが起動します。

イベントを受信

イベント名 - デフォルトでは、このプロパティは空です。 入力されている場合、受信イベント活動の名前プロパティがここで入力された値と一致する場合にのみ、トリガーが起動します。

非アクティブ

期間 - これには、このトリガーおよびその関連付けられているトピックが起動される前に、ユーザーが非アクティブであるべき期間を指定します。 デフォルトは 30 分です。 ドロップダウン内の利用可能なオプションから選択するか、式エディターに切り替えて、Power Fx 式を提供して値を指定することができます。

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