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

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

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

Web アプリケーション

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

会話をプレビューする

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

   

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

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

   

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

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

   

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

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

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

変数値のテスト

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

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

   

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

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

   

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

   

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

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

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

警告

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

1. エージェントのテスト ウィンドウの上部にあるその他アイコン (...) を選択し、スナップショットの保存 を選択します。

   

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

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 が会話の問題をトラブルシューティングするために使用する一意識別子です。 会話のスナップショット ファイルに格納されている内容などのその他の情報は、問題を報告しても送信されません。 収集された情報はすべて匿名とし、コパイロットの品質向上に役立てられます。