エージェントをテストする

Copilot Studioで エージェント を設計する際には、 [エージェント をテスト] ペインを使用して、エージェント が顧客との会話をどのように導くかを確認できます。

予期しない動作を見つけて修正するには、トピック間の追跡を有効にして、手順 による エージェント 会話 手順 をたどり、作成キャンバス内の対応するノードに移動することができます。

Web アプリケーション

エージェント をテストする ペインを使用して、ユーザーとして エージェント の会話を確認します。 これは、トピックが機能し、および会話が期待どおりに流れることを確認するための良い方法です。

会話をプレビューする

1. 「エージェント をテストする」 ペインが非表示になっている場合は、ページ上部の 「テスト」 を選択して開きます。

   

2. 「エージェント をテストする」 ペインの下部にあるフィールドにテキストを入力します。 テキストがトピックのトリガー フレーズに類似している場合は、そのトピックが開始されます。

3. 「エージェント をテストする」 ペインで、エージェント ポイントする を 選択 します。 これにより、トピックおよび応答を送信したノードに移動します。 起動したノードには、色付きのチェックマークと色付きの下境界線が表示されます。

   

   アクティブなトピック内で会話を続けると、起動する各ノードがチェックボックスと下の境界線でマークされ、キャンバスの中央に配置されることに注意してください。

4. 会話が トピック から トピック に移動するときに、会話全体を自動的に 選択 したい場合は、[ エージェント をテストする ] ペインの上部にある 追跡 をオンにします。

   

5. 意図したとおりの流れに満足するまで会話を続けます。

テスト エージェント を操作している間は、いつでも トピック を更新できます。 トピック を保存するだけで変更が適用され、エージェント との会話を続けることができます。

トピックを保存しても、会話は自動的にクリアされません。 いつでも、テストから会話をクリアして最初からやり直したい場合は、 リセット アイコンをクリックします。

変数値のテスト

エージェント をテストするときに、変数の値を観察できます。

1. セカンダリ ツールバーの 変数 を選択して、変数 ペインを開きます。

   

2. テスト タブに切り替え、目的の変数カテゴリを展開します。

   会話のテストを進めると、使用中の変数の値を監視できます。

   

3. 変数のプロパティを検査するには、目的の変数を選択します。 変数プロパティ パネルが表示されます。

   

変数ペインを使用してスロット充填をテストする方法については、「 エージェントでのエンティティとスロット充填の使用」を参照してください。

会話のスナップショットを保存する

エージェント をテストしている間、会話の内容と診断データをキャプチャし、ファイルとして保存できます。 その後、データを分析して、エージェント が期待どおりに応答しないなどの問題をトラブルシューティングできます。

警告

追従する ファイルには、機密情報が含まれる可能性のあるすべての エージェント コンテンツが含まれています。

1. エージェント pane, 選択 をテストするには、上部にあるその他アイコン (…) をクリックし、次に 選択 Saveスナップショット をクリックします。

   

   スナップショット ファイルに機密情報が含まれている可能性があることを通知するメッセージが表示されます。

2. 選択 保存 をクリックすると、エージェント コンテンツと会話診断が botContent.zip という名前の .zipアーカイブに保存されます。

   botContent.zip アーカイブには 2 つのファイルが含まれています:

   • dialog.json では、エラーの詳細な説明を含む会話型診断が含まれています。
   • botContent.yml には、エージェント のトピックと、エンティティや変数などのその他のコンテンツが含まれています。

接続の管理

エージェント で エンドユーザー接続が必要な場合、テスト チャットで使用する接続を管理するには、テスト ペインの上部にある [その他] アイコン (…) を 選択 クリックし、次に 選択 接続を管理 します。

クラシック

ボットをテストするのウィンドウでトピックをテストする

ボットのテスト ウィンドウを使用して、ユーザーとしてボット会話を見ていきます。 これは、トピックが機能し、および会話が期待どおりに流れることを確認するための良い方法です。

1. ボットのテスト ウィンドウが非表示になっている場合、サイド ウィンドウの下部にあるボットのボットのテスト アイコンを選択して開きます。

   

2. 以前の会話をクリアするには、ボットのテスト ペインの上部にある リセット アイコンを選択します。

   リセットすると、以前の会話に惑わされないため、現在のトピックのフローに従うのが容易になります。

   

3. メッセージを入力するプロンプトで、トピックのトリガー フレーズの 1 つを入力します。

トピックの会話パスを追跡する

トリガー フレーズが会話を開始します。 ボットのテスト ウィンドウには、ボットの応答および指定したユーザー応答の選択肢が表示されます。

1. 会話を続行し、トピックで設計されたとおりに流れることをテストします。

2. いつでもトピックの作成キャンバスに戻って、会話パスを変更することができます。 トピックに変更を加えると、ボットのテスト ウィンドウは自動的に更新されます。

会話のスナップショットを保存する

ボットのテスト中に、会話の内容と診断データをキャプチャし、ファイルとしてこれを保存できます。 さらに、データを分析して、ボットが期待どおりに応答しないなど、問題のトラブルシューティングができます。

警告

スナップショット ファイルには、機密情報が含まれている可能性があるすべてのボット コンテンツが含まれています。

1. ボットのテスト ペインの上部で その他 アイコン (⋮) を選択してから、スナップショットの保存 を選択します。

   

   スナップショット ファイルに機密情報が含まれている可能性があることを通知するメッセージが表示されます。

2. 保存 を選択すると、ボット コンテンツと会話診断が DSAT.zip という名前の .zip アーカイブに保存されます。

   DSAT.zip アーカイブには 2 つのファイルが含まれています:

   • dialog.json では、エラーの詳細な説明を含む会話型診断が含まれています。
   • botContent.json では、エンティティや変数を含むボットのトピックやその他のコンテンツが含まれています。

Teams

ボットをテストするのウィンドウでトピックをテストする

1. ボットのテスト ペインが非表示になっている場合は、ナビゲーション メニューで チャットボットのテスト を選択して開きます。

   

2. 以前の会話をクリアするには、ボットのテスト ペインの上部にあるリセットを選択することをお勧めします。 以前の会話をクリアすると、以前の会話に惑わされないため、見たいトピックのフローを確認しやすくなります。

   

3. ボットのテスト ペインの下部にあるメッセージの入力プロンプトで、トピックのトリガー フレーズを入力します。

   トリガー フレーズはトピックの会話を開始し、ボットをテストするウィンドウに指定したボット応答およびユーザー応答の選択肢が表示されます。

4. 会話を続行し、トピックで設計 されているとおりに流れることをテストします。

5. ボットをテストするウィンドウで応答を選択し、そのトピックの会話エディターの応答に移動します。 作成キャンバスには強調表示されているノードが緑色で表示されます。

   

トピックの作成キャンバスに戻り、いつでも会話パスを変更できます。 トピックへの変更を保存すると、チャットをテストするウィンドウは自動的に更新されます。

トピックの会話パスを追跡する

ボットを微調整するときにトピック間の追跡を有効にすると、会話パスを段階的にたどることができます。

1. ボットのテスト ペインが非表示になっている場合は、ナビゲーション メニューで チャットボットのテスト を選択して開きます。

   

2. ボットのテスト ペインの上部で、トピック間の追跡をオンに設定します。

   

3. 確認するトピックのトリガー フレーズを入力して、会話のテストを続けます。

4. ボットのテスト ペインで会話を移動すると、作成キャンバスで会話パスの現在の位置が強調表示されます。 作成キャンバスには強調表示されているノードが緑色で表示されます。

5. 作成キャンバスで会話パスの前の場所に移動するには、ボットのテスト ペインでその場所を選択します。

ボットのテスト ペインで会話パスがトピック間を移動すると、作成キャンバスが最新の情報に更新されて、トピック間を適切に強調表示されたノードまで移動します。

注意

問題を報告することで、Copilot Studio の改善にご協力ください。 テスト ペインの上部近くにあるフラグ アイコンを使用して、会話 ID を Microsoft に送信します。 ID は、Microsoft が会話の問題をトラブルシューティングするために使用する一意識別子です。 会話のスナップショット ファイルに格納されている内容などのその他の情報は、問題を報告しても送信されません。 収集された情報はすべて匿名とし、コパイロットの品質向上に役立てられます。