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