生成オーケストレーションを使用するエージェントの場合、既定のトピック トリガーは エージェント別 です。 トリガー ノードで指定されたトピックの名前と説明が、ユーザーからの着信メッセージと一致するとエージェントが判断したときにアクティブになります。
クラシック オーケストレーションを使用するエージェントの場合、既定のトピック トリガーはフレーズです。 指定されたトリガー フレーズの 1 つ以上がユーザーからの着信メッセージと密接に一致した場合に起動します。 トピックをいつ実行するかを決定する使用可能なトリガー タイプは他にもあります。
前提条件
トピックの作成と編集に慣れている。
トリガーの種類
トリガーを使用すると、エージェントはさまざまなイベントやさまざまなタイプの受信アクティビティをインターセプトして処理できます。 次のトリガー タイプにより、トピックをいつトリガーするかを判断します。
チップ
ユーザーがエージェントにメッセージを送信するとき、ペイロードはアクティビティ タイプのメッセージです。 エージェントは、チャットや他のイベントで発生する内容に応じて、他のタイプのアクティビティを受信できます。
たとえば、Microsoft Teams は 呼び出す タイプの非表示アクティビティを送信します。これは、Message Extension との対話など、ユーザーのアクションを意味します。
| タイプ | プロパティ |
|---|---|
| エージェント別 | 生成オーケストレーションを使用するエージェントで使用できます。 トリガー ノードで指定されたトピックの名前と説明が、ユーザーからの着信メッセージと一致するとエージェントが判断したタイミングで発動します。 |
| フレーズ | クラシック オーケストレーションを使用するエージェントで使用できます。 1 つ以上のトリガー フレーズがユーザーからの受信メッセージと一致する場合に発動します。 |
| メッセージを受信 | メッセージ タイプのアクティビティ (最も一般的なタイプのアクティビティ) を受信したときに発動します。 ユーザーがエージェントに何かを入力または発言したときに受信されます。 |
| イベントを受信 | イベント タイプのアクティビティを受信したときに発動します。 既定では、すべてのイベント アクティビティに応答します。 トリガー プロパティ内の イベント名 プロパティを使用して、特定のイベントをフィルターします。 |
| 活動を受信 | 任意のタイプのアクティビティを受信したときに発動します。 トリガーのプロパティで アクティビティの種類 プロパティを設定して、特定のアクティビティの種類をフィルターで絞り込むこともできます。 |
| 会話の更新を受信 | conversationUpdate タイプのアクティビティを受信したときに発動します。 たとえば、Teams は、ユーザーが会話に参加すると、このタイプの活動を送信します。 |
| 呼び出しを受信 | 呼び出す タイプのアクティビティを受信したときに発動します。 最も一般的には、ユーザーが Teams のメッセージまたは検索拡張機能を操作するときなど、Teams チャネルから受信されます。 |
| リダイレクト発生時 | トピックが別のトピックによって明示的に呼び出されたときに発生します。 トリガーのプロパティの非アクティブ期間プロパティを使用して、目的の非アクティブ時間を設定します。 |
| 非アクティブ | 設定された期間が経過してもユーザーがエージェントと対話しなかった場合に発生します。 |
| 計画の完了 | 生成オーケストレーションを使用するエージェントで使用できます。 エージェントが、ユーザー問合せまたは自律型トリガーに応答するために計画されたすべてのステップの実行を終了したときに起動します。 |
| AI の応答が生成されました | 生成オーケストレーションを使用するエージェントで使用できます。 エージェントが 1 つ以上のトピック、アクション、またはナレッジ ソースを呼び出した後にユーザーの応答を生成したときに起動します。 生成された応答を表示するには、システム変数 Response.FormattedText を使用します。 オーケストレーションの応答が送信されないようにする場合は、ContinueResponse 変数を false に設定してください (たとえば、メッセージを変更して、メッセージ ノードを使用して独自のメッセージを送信する場合など)。 |
トピックのトリガーの変更
エージェントのトピック ページに移動し、目的のトピックを開きます。
トリガー ノードのボックスにカーソルを合わせ、トリガーの変更アイコンを選択します。
トピックに適したトリガーの種類を選択してください。
- エージェント別 トリガーには、エージェントがこのトピックを使用するタイミングを説明します。
- フレーズ トリガーに、目的のトリガー フレーズを入力します。
トリガー ボックスで、編集を選択します。 指定したトリガーの種類のプロパティ パネルが表示されます。
トリガーに適用可能なプロパティを設定します。
トリガー条件
トリガーを起動するために満たす必要がある条件を指定します。 たとえば、従業員が使用するチャネルが Microsoft Teams の場合にのみトリガーを起動したい場合などです。
より複雑な条件が必要な場合は、Power Fx 式エディタに切り替えることができます。ビルダーを選択し、式を選択します。
トリガーの優先度
メッセージなどの単一の受信活動に対して複数のトリガーを起動できます。 トリガー タイプによって、トリガーが起動する順序が決まります。
実行順序:
- 活動を受信
- メッセージ / イベント / 会話の更新 / 呼び出しの受信
- エージェント別 / フレーズ別
条件を満たす同じタイプのトリガーが複数ある場合、トリガーは作成順 (古いものから順) に実行されます。
Priority のプロパティを設定して、実行順序を明示的に決定できます。