エージェントの作成は反復的なプロセスです。 エージェントの動作を理解し、変更を加え、結果を確認することで、より優れたエージェントを構築できます。 Copilot Studio のアクティビティ追跡機能は、セッション内のエージェントの入力、決定、出力の順序を視覚的にマッピングするため、問題や改善の機会を特定できます。
アクティビティ マップ は、エージェントが会話を開始したとき、または外部イベントによってトリガーされたときに開始されるセッションごとに生成されます。 マップは、ノードを持つ各アクティビティを表 します。
アクティビティ追跡には 2 つの形式があります:
- テスト中のエージェントのパフォーマンスのリアルタイム活動マップ
- 過去のセッションの活動履歴マップと議事録
Note
この機能は、生成オーケストレーションが有効になっているエージェントでのみ使用できます。
エージェントとの独自の操作と、エージェントが認証に資格情報を使用した場所のみが表示されます。 エージェントは 、統合された Microsoft 認証 を使用して対話を識別する必要があります。
テスト中のリアルタイム アクティビティ マップ
テスト ペインでエージェントに質問をすると、アクティビティ マップに生成されたプランが視覚的に表示されます。 マップでは、アクションの入力パラメーターまたは出力パラメーターが不足しているか無効であるなどのエラーが強調表示され、各ステップの実行にかかる時間が示されます。 また、エージェントが送受信している情報が正しいかどうかを確認することもできます。
アクティビティ マップを開くには、テストペインの上部にあるマップ アイコン
を選択します。
テスト ウィンドウでエージェントに問い合わせを送信した際にアクティビティ マップを自動的に表示するには、下矢印をクリックしてオンを選択します。
ここでは、ユーザーが "現在の気象条件は何ですか?応答するために選択されたアクションと、入力と出力を確認できます。
イベント トリガーのテスト
イベント トリガーのテスト時に、トリガー ペイロードがテスト チャットにメッセージとして表示されます。 このメッセージは、テスト目的で Copilot Studio 内でのみ表示されます。 エージェントのユーザーには表示されません。 ペイロード メッセージを使用して、トリガがいつ、どのような情報や指示をエージェントに送信するかを理解できます。
トピック間の追跡
アクティビティ マップを使用すると、アクティビティ マップの上部に、トピック間を追跡するオプションが表示されます。 トラッキングが有効になっている場合、計画の一部としてトピックがトリガーされると、トピック内のノードがアクティビティ マップ上に実行されるように表示され、会話の流れを監視することができます。
Note
トピック内の生成オーケストレーション アクティビティは、アクティビティ マップに表示されません。
活動の履歴
エージェントがセッションを開始するたびに、Copilot Studio で開始したテストセッションも含め、その活動は活動ページにリアルタイムで記録されます。 アクティビティ ページに移動して確認します:
- セッション中にエージェントが行ったインタラクションと決定を確認します
- エージェントの行動が目標に合わない箇所を見つける
- エージェントが各アクティビティを完了するまでにかかる時間を確認する
- エラーの詳細を検索する
履歴エージェント アクティビティは、次の目的で使用できます。
- Copilot Studio のテスト チャットでの対話
- Microsoft Teams チャネルに公開されるエージェント
- 自律トリガーで開始されたセッション
Note
作成者は、過去のエージェントの活動を表示するため、Microsoft Exchange のライセンスと受信トレイを持っている必要があります。 この機能は、Microsoft 365 サービスを利用しています。 データは、Azure コンプライアンス境界の外側にある、メーカーの Exchange メールボックスの地理的リージョンの場所に格納されます。 Microsoft 365 の用語とデータ所在地のコミットメントは、 履歴アクティビティ データを管理します。
管理者は 、Power Platform 管理センター を使用して、Microsoft 365 によって格納されているデータをオフにする必要があります。
詳細については、Microsoft 365 のサービスを利用して活動データを管理する を参照してください。
活動 ページに移動して確認します:
- セッションの一覧とその詳細
- セッション内で発生したステップバイステップのアクティビティ
セッションの一覧
セッションは、ユーザーとの会話、イベントの登録と応答、またはこれらアクティビティの組み合わせを含む、エージェントのインタラクションの単位です。
セッション リストには次の内容が表示されます:
- ユーザー: エージェントと対話するユーザーの名前です。 セッションにユーザーが関与しなかった場合 (エージェントがユーザーにプロンプトを表示せずにアクションを実行した場合など)、ユーザーは [自動] と表示されます。
- チャネル: 対話が行われたチャネル。 エージェントのテスト ペインで発生したセッションには、Copilot Studio アイコンが表示されます。
- 日付: セッションの最初のやり取りが開始された日付です。
- 完了したステップ: エージェントがセッション中に完了したステップの数。
- 最後の手順: セッションで完了した最後の手順。
セッションの活動を表示する
活動 タブでは、セッション内の活動を視覚的な活動マップまたは会話のトランスクリプトとして表示できます。 活動マップまたはトランスクリプトを選択して、これらのビューを切り替えます。
セッションのアクティビティを表示するには、セッションを選択します。 セッション リストに戻るには、戻るアイコン を選択します。
トランスクリプト ビューには、セッション中にエージェントと行われた会話が表示されます。 トランスクリプトには、ユーザー入力、トリガーペイロード、エージェント応答が記録されます。
トランスクリプトを使用して、エージェントがユーザーとの会話にどのように対応するかを確認できます。 また、エージェントがイベント トリガーから受け取るトリガー ペイロード メッセージを表示することもできます。
活動マップでエージェントのすべてのアクティビティを表示
活動マップ は、セッション中に発生した入力、決定、反応のフローを視覚的に表現したものです。 エージェント、ユーザー、またはトリガーが ノードで実行する各アクティビティ。 アクティビティ マップを表示しているときに、ノードを選択すると、そのアクティビティの入力、決定、出力の詳細が表示されます。
次の図は、ナレッジ ノードを選択したときに表示される内容の例です。 それが表示されます。
- ナレッジ ソースを検索するためにエージェントによって使用されるクエリ。 ユーザーが書き込むクエリや、トリガーによって提供される入力とは異なる場合があります。
- ナレッジ ソースに基づいてエージェントが作成した応答。
- エージェントが参照するソース。
- 他のソースは検索しますが、応答の作成には使用されません。 エージェントはこれらのソースを検索しましたが、クエリに関連する情報が見つかりませんでした。
この例では、明日の予測を取得するためのアクション ノードの詳細 を 確認し、入力と出力を示します。
選択したアクティビティに関連付けられている構成を表示および変更するには、[ 編集] を 選択します。
Rationale
論理的根拠 は、エージェントが特定のツールを呼び出すことにした方法の説明を提供します。 AI は、エージェントのメタデータとアクティビティに基づいて、オンデマンドで根拠を生成します。 完了した状態のナレッジソースまたはコネクタには、[根拠]が表示されます。 [ 根拠の表示 ] を選択して、根拠を表示します。
エージェントのアクティビティを確認するときに、 Rationale を使用して、エージェントが特定のツールの呼び出しまたはパラメーターの入力を選択した理由をより深く理解できます。 エージェントの動作のトラブルシューティングに役立ちます。 ただし、この根拠は AI で生成されるため、正確ではない可能性があるため、提供された根拠を確認する際には、最善の判断を使用する必要があります。
エージェントの状態
次の表は、エージェントの操作中に発生する可能性があるさまざまな状態に関する情報を示しています。
状態 | 条件 | 対象 |
---|---|---|
完成 | エラーなし。 最後のメッセージは、[接続の 管理 ] ダイアログではありません。 チャットは、会話イニシエーターの定義済みのステップ計画が完了状態になると完了します。 会話が完全な状態に移行したり、 完全 な状態から移動したりすることがあります。 | アクションを含む自律エージェントまたは会話エージェント |
Incomplete (不完全) | 問題が発生した場合 (いずれかの手順が失敗した場合)、またはすべてのステップが終了状態にあり、それらのすべてが 完了していない場合は、 不完全です。 | アクションを含む自律エージェントまたは会話エージェント |
失敗しました | すべてのアクティビティが失敗した場合は、 失敗します。 | アクションを含む自律エージェントまたは会話エージェント |
進行中 | 定義された手順の少なくとも 1 つが完了せず、まだ進行中です。 | アクションを含む自律エージェントまたは会話エージェント |
ユーザーを待機中 | エージェントが応答し、ユーザーが会話を続けるかどうかを待機しています。 最後の手順では、人間による入力が必要です。 | アクションを含む自律エージェントまたは会話エージェント |
Created | 会話が始まったばかりです。 | アクションを含む自律エージェントまたは会話エージェント |
キャンセル | 残りの動的プランを取り消し、ダイアログ スタックを空にします。 |