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