エージェントの活動を確認する

エージェントの作成は反復的なプロセスです。 エージェントの動作を理解し、変更を加え、結果を確認する必要があります。 このプロセスは、より優れたエージェントを構築するのに役立ちます。 Copilot Studio のアクティビティ追跡では、エージェントのアクティビティ内の入力、決定、出力のシーケンスを視覚的にマッピングできるため、問題や改善の機会を見つけることができます。

アクティビティ マップは、すべてのアクティビティに対して生成されます。 アクティビティは、エージェントが会話を開始するか、外部イベントによってエージェントがトリガーされたときに開始されます。 マップは、ノード を持つ各活動を表します。

アクティビティ追跡には、次の 2 つの形式があります。

• テスト中のエージェントのパフォーマンスのリアルタイム活動マップ
• 過去のアクティビティ マップと過去のアクティビティのトランスクリプト

Note

この機能は、生成オーケストレーションが有効になっているエージェントでのみ使用できます。

エージェントとの独自の対話と、エージェントが認証に資格情報を使用した場所のみが表示されます。 エージェントは、統合された Microsoft 認証 を使用して対話を識別する必要があります。

テスト中のリアルタイム アクティビティ マップ

テスト ウィンドウでエージェントに質問すると、アクティビティ マップにエージェントによって生成されたプランが視覚的に表示されます。 マップでは、アクションの入力パラメーターまたは出力パラメーターが不足しているか無効であるなどのエラーが強調表示され、各ステップの実行にかかる時間が示されます。 また、エージェントが送受信している情報が正しいかどうかを確認することもできます。

テストペインでエージェントにクエリを送信した際にアクティビティマップを自動的に表示するには、3つの点を選択し、テスト時に「アクティビティマップを表示」をオンにしてください。

ここで、ユーザーは「明日のトロント、カナダの天気はどうですか」と尋ねた。エージェントが応答するように選択したアクションと、入力と出力を確認できます。

イベント トリガーをテストする

イベント トリガーをテストすると、テスト チャットにトリガー ペイロードがメッセージとして表示されます。 テスト目的で Copilot Studio 内でこのメッセージを表示できるのはあなただけです。 エージェントのユーザーには表示されません。 ペイロード メッセージを使用して、トリガーがエージェントに送信するタイミングと指示を把握します。

トピック間の追跡

エージェントをテストするときに、トピック間で追跡できます。 追跡を有効にすると、アクティビティ マップには、トピックがプランの一部としてトリガーされたときに実行されるトピック内のノードが表示されます。 会話フローを監視できます。

Note

トピック内の生成オーケストレーション アクティビティは、アクティビティ マップに表示されません。

変数の表示

[ アクティビティ ] ページでは、テスト中または過去のアクティビティでエージェントによって使用される変数を表示できます。 これらの変数には、エージェントがアクセスできるグローバル変数、環境変数、またはシステム変数を指定できます。

アクティビティ中に使用される変数を表示するには:

1. [アクティビティ] ページに移動します。 活動の一覧が表示されます。
2. テスト中に変数を表示するには、[ テスト ] を選択し、[変数] を選択 します。 [ 変数 ] ウィンドウが開き、テスト中に使用される変数が表示されます。
3. 履歴アクティビティの変数を表示するには、一覧からアクティビティを選択します。 次に、[ 変数] を選択します。 [ 変数 ] ウィンドウが開き、そのアクティビティ中に使用された変数が表示されます。

テスト チャットでエージェントの思考チェーンを表示する

Chain of Thought (CoT) 機能は、テスト中のエージェントの推論プロセスに関する分析情報を提供します。 入力を処理し、出力を生成する際にエージェントによって行われた中間ステップ、考慮事項、および決定が表示されます。 この機能は、複雑な相互作用とデバッグ エージェントの動作を理解するのに役立ちます。

Note

考え方の連鎖機能は、GPT-5 Reasoning、Claude Sonnet、Claude Opus などの一部のモデルでのみ使用できます。

テスト中にエージェントの思考または推論のチェーンを表示するには、次の手順に従います。

1. Copilot Studio でエージェントを開きます。 概要ページが表示されます。
2. [ テスト ] を選択してテスト ウィンドウを開きます。
3. テスト ウィンドウで、クエリまたはプロンプトを入力して、エージェントとの会話を開始します。
4. エージェントが応答する前に、その理由がテスト ウィンドウに表示され、エージェントの応答の思考チェーンが表示されます。

活動の履歴

エージェントがアクティビティを開始するたびに (Copilot Studio で開始したテストを含む)、 アクティビティ ページにアクティビティがリアルタイムで記録されます。 アクティビティ ページに移動して確認します:

• 操作と、アクティビティ中にエージェントが行った決定を確認します。
• エージェントの動作が目標と一致しない場所を見つけます。
• エージェントが各アクティビティを完了するまでにかかる時間を確認します。
• エラーの詳細を検索します。

履歴エージェント アクティビティは、次の目的で使用できます。

• Copilot Studioでのインタラクション テスト チャット
• Microsoft Teams および Microsoft 365 Copilot チャネルに発行されたエージェント
• SharePoint チャネルに公開されたエージェント
• 自律トリガーで開始されたアクティビティ

Note

過去のエージェントの活動を表示するため、Microsoft Exchange のライセンスと受信トレイを持っている必要があります。 データは Microsoft 365 サービスを使用して格納されます。このサービスは、Azure データの使用条件とコミットメントでは管理されません。 代わりに、この機能は Microsoft 365 サービスを利用し、Exchange メールボックスに関連付けられている場所に格納されます。 Microsoft 365 の使用条件とデータ所在地のコミットメント で履歴活動データを管理します。

管理者は、Power Platform 管理センター を使用して、Microsoft 365 にデータを格納できないようにする必要があります。 この設定をオフにすると、Microsoft 365 の将来のデータ ストレージが停止します。 Microsoft 365 に格納されている既存のデータは、Microsoft 365 に設定されているデータ保持ポリシーに従って削除または消去されます。

詳細については、Microsoft 365 のサービスを利用して活動データを管理する を参照してください。

[アクティビティ] ページで次の情報を確認します。

• アクティビティとその詳細の一覧。
• アクティビティ内で発生するステップ バイ ステップの会話。

アクティビティ の一覧

アクティビティは、ユーザーとの会話、イベントの登録と応答、またはこれらのアクティビティの組み合わせを含むエージェントの相互作用の単位です。

アクティビティの一覧には、次の情報が表示されます。

• 名前: エージェントと対話しているユーザーの名前です。 アクティビティにユーザーが関与しない場合 (たとえば、エージェントが人間のプロンプトなしでアクションを実行する場合など)、ユーザーは [自動] と表示されます。
• チャネル: 対話が行われたチャネル。 エージェントのテスト ウィンドウで発生するアクティビティには、Copilot Studio アイコンがあります。
• 日付: アクティビティの最初の対話が開始される日付。
• 完了したステップ: エージェントがアクティビティ中に完了したステップの数。
• 最後のステップ: アクティビティで完了した最後のステップ。
• 状態: アクティビティの状態 (成功、失敗、進行中)。

活動テーブル ビューをカスタマイズする

最も関連性の高い情報に注目できるように、活動テーブル ビューをカスタマイズできます。

活動テーブル ビューをカスタマイズするには:

1. エージェントの 活動 ページに移動します。 活動の一覧が表示されます。
2. 列の編集 を選択します。 列の編集 ウィンドウに、使用可能な列の一覧が表示されます。
3. 列の編集 ウィンドウで以下を行います。
   • 表示する列の名前の横にあるチェック ボックスをオンにします。
   • 非表示にする列の名前の横にあるチェック ボックスをオフにします。
   • 列を任意の順序にドラッグ アンド ドロップするか、上下の矢印を使用します。
4. 保存 を選択し、活動テーブル ビューを確認して更新します。

アクティビティ内の会話を表示する

[ アクティビティ ] ページでは、ビジュアル アクティビティ マップまたは会話トランスクリプトとビジュアル アクティビティ マップの両方で、アクティビティ内の会話を表示できます。 既定では、トランスクリプト + マップ ビューが表示されます。

1. アクティビティ内の会話を表示するには、アクティビティを選択します。

   • トランスクリプトと活動マップを一緒に表示するには、ビュー を選択し、トランスクリプト+ マップ ビュー を選択します。
   • 活動マップのみを表示するには、ビュー を選択し、マップ ビュー を選択します。

   

2. アクティビティの一覧に戻すには、[戻る] アイコンを選択します。

トランスクリプト + マップ ビューには、アクティビティ中にエージェントと行われた会話とビジュアル アクティビティ マップが表示されます。 トランスクリプトは、ユーザー入力、トリガー ペイロード、およびエージェントの応答を記録します。 トランスクリプトを使用して、エージェントがユーザーとの会話にどのように応答するかを確認します。 また、エージェントがイベント トリガーから受け取るトリガー ペイロード メッセージを表示することもできます。

エージェントの思考の連鎖を表示する

Chain of Thought (CoT) 機能は、アクティビティ中のエージェントの推論プロセスに関する分析情報を提供します。 入力を処理し、出力を生成する際にエージェントによって行われた中間ステップ、考慮事項、および決定が表示されます。 この機能は、複雑な相互作用とデバッグ エージェントの動作を理解するのに役立ちます。 特定のアクティビティに対するエージェントの一連の考え方は、マップ ビューでのみ表示できます。

Note

考え方の連鎖機能は、GPT-5 Reasoning、Claude Sonnet、Claude Opus などの一部のモデルでのみ使用できます。

特定のアクティビティに関するエージェントの思考過程や推論を確認するには:

1. [ アクティビティ ] タブで、確認するアクティビティを選択します。 既定では、[ トランスクリプト + マップ] ビュー が表示されます。
2. アクティビティ マップで、推論シェブロン を 選択します。 エージェントの思考チェーンが表示されます。

アクティビティを固定または解除する

[ アクティビティ ] ページでは、重要なアクティビティをアクティビティ リストの上部にピン留めして簡単にアクセスしたり、不要になったときにピン留めを外したりすることができます。

• アクティビティをピン留めするには、アクティビティにカーソルを合わせ、名前の横にある [ピン留め アイコンを選択します。
• アクティビティのピン留めを外すには、ピン留めされたアクティビティにカーソルを合わせ、名前の横にある [ のピン留めを外す] アイコンを選択します。

活動マップでエージェントのすべてのアクティビティを表示

マップ ビューは、アクティビティ中に発生する入力、決定、および反応のフローを視覚的に表します。 エージェント、ユーザー、またはトリガーが ノードで実行する各アクティビティ。 アクティビティ マップを表示しているときに、ノードを選択すると、そのアクティビティの入力、決定、出力の詳細が表示されます。

次の図は、ナレッジ ノードを選択したときに表示される内容の例です。 以下が示されます:

• ナレッジ ソースの検索に使用するエージェントのクエリ。 ユーザーが書き込むクエリや、トリガーによって提供される入力とは異なる場合があります。
• ナレッジ ソースに基づいてエージェントが作成した応答。
• エージェントが参照するソース。
• エージェントが検索したが、応答の作成に使用しなかった他のソース。 エージェントはこれらのソースを検索しましたが、クエリに関連する情報が見つかりませんでした。

この例では、入出力を表示して、明日の予報を取得する のアクション ノードの詳細を確認できます。

選択した活動に関連付けられている構成を表示および変更するには、編集 を選択します。

根拠

根拠 エージェントがどのようにして特定のツールを呼び出すことにしたかを説明します。 AI はオンデマンドで根拠を生成し、エージェントのメタデータとアクティビティに基づいています。 「根拠」は、「完了」状態のナレッジソースまたはコネクタで表示されます。 根拠を表示するには、根拠を表示する を選択します。

エージェントのアクティビティを確認するときは、 Rationale を使用して、エージェントが特定のツールを呼び出すか、パラメーターを入力することを選択した理由をより深く理解します。 エージェントの動作のトラブルシューティングに役立ちます。 ただし、AI を使用して根拠が生成されるため、正確でない可能性があるため、提供された根拠を確認する際には、最善の判断を使用してください。

エージェントの状態

次の表は、エージェントが操作中に発生する可能性があるさまざまな状態に関する情報を示しています。

状態	条件	適用対象
完了	エラーなし。 最後のメッセージは 接続の管理 ダイアログではありません。 チャットは、会話イニシエーターが定義した手順の計画が完了状態になると完了します。 会話は完了状態に出たり入ったりすることがあります。	アクションを含む自律エージェントまたは会話エージェント
Incomplete (不完全)	エラーが発生した場合 (いずれかの手順が失敗した場合)、またはすべてのステップが終了状態にあり、それらのすべてが 完了していない場合は、 不完全です。	アクションを含む自律エージェントまたは会話エージェント
失敗しました	すべてのアクティビティが失敗した場合、状態は 失敗します。	アクションを含む自律エージェントまたは会話エージェント
処理中	定義された手順の少なくとも 1 つが完了せず、まだ進行中です。	アクションを含む自律エージェントまたは会話エージェント
ユーザーを待機中	エージェントが応答し、ユーザーが会話を続けるかどうかを待機しています。 最後の手順では、人間による入力が必要です。	アクションを含む自律エージェントまたは会話エージェント
作成済み	会話が開始されました。	アクションを含む自律エージェントまたは会話エージェント
キャンセル済み	残りの動的プランを取り消し、ダイアログ スタックを空にします。

フィードバックの送信

エージェントの品質を向上させる方法に関する提案がある場合は、[アクティビティ] タブの [フィードバック アイコンを使用してフィードバックを送信します。