仮想エージェントトピックのデバッグ
カスタムの仮想エージェントトピックの予期しない動作を調査して解決します。
トピックディスカバリーの問題については、「 仮想エージェントの LLM トピックディスカバリー と 自然言語理解 (NLU) (NLU) トピックディスカバリーの問題の解決」を参照してください。
デバッグおよび変更する前にライブトピックを複製する
ライブトピックを更新するのではなくトピックを複製します。未修正の元のトピックは、参照およびバックアップのどちらにも役立ちます。元のトピックを残しておけば、トピックをすばやく復元できます。複製を発行する前に、必ず元のトピックを無効にしてください。
会話のテスト中にトピックをデバッグする
仮想エージェントデザイナーでトピックを作成または更新するときに、トピックヘッダーバーの [テスト] ボタンを使用して、会話をプレビューします。チャットテストウィンドウには、サービスポータルに表示される会話が表示されます。サードパーティのメッセージアプリケーションでは、会話の要素が異なって表示されることがあります。仮想エージェントを展開する予定のサードパーティアプリケーションで会話をテストします。
テストチャットウィンドウには、トピックのデバッグと絞り込みのための詳細情報を提供する 4 つのタブ ([テストフレーズを分析]、[変数]、[コンテキスト]、[ログ]) が表示されます。これらのタブの詳細については、「NLU/キーワードトピックのテスト」を参照してください。次の例は、テスト中にログに記録されたメッセージとエラーの処理を示しています。
トピック内のコントロールに関する警告を監視する
必要な情報が不足しているコントロールには、コントロールの左上隅に赤色の不完全バッジが表示されます。このバッジには、そのコントロール内の問題の数を示す数字が表示されます。このバッジを選択すると、コントロール内の問題のリストが表示されます。
キャンバスの左上隅に、トピック全体にある問題の数を示す別の警告バッジが表示されます。
トピックのプレビューが実行されないときのエラーをチェックする
エラーによってトピックを実行できない場合、 仮想エージェントデザイナー キャンバスのサイドバーにある [検証の問題] タブに追加情報が表示されます。問題の合計数が、各ノードの詳細およびハイパーリンクとともにリストされます。ハイパーリンクを選択してノードに進み、提供された情報を使用して会話のエラーを修正します。問題を修正せずにタブを閉じることもできますが、問題を修正するまで、[ 公開] を選択すると [検証の問題] タブが表示されます。すべての問題を修正した後 に [公開 ] を選択すると、[検証の問題] タブが閉じます。
仮想エージェントの一般的な問題
| 問題 | 考えられる解決策 |
|---|---|
| 対話型インターフェースの下にモジュールデザイナーが表示されない |
|
| トピックを編集できない | ログインしたユーザーは、トピックと同じアプリケーションスコープ内になければなりません。 |
| トピックをプレビューできない |
|
| チャットウィジェットが接続中にスタックしました... | 1 つまたは複数のトピックが欠落している可能性があります。をオンにして、トピックがインスタンスに存在し、[アクティブ] ステータスであることを確認します。 |
会話フローで実行しているトピックをレビューする
インスタンス内の各 仮想エージェント (VA) 会話は、要求者と 仮想エージェント およびライブエージェント間の会話をログに記録するインタラクション [interactions] テーブルにインタラクションレコードを自動生成します。エージェントチャットを使用している場合、ライブエージェントへの転送を含む、要求者と 仮想エージェント 間の会話の転写を確認できます。詳細については、 仮想エージェント のインタラクションレコードを参照してください。