仮想エージェントトピックのデバッグ

カスタムの仮想エージェントトピックの予期しない動作を調査して解決します。

トピックディスカバリーの問題については、「自然言語理解 (NLU) (NLU) トピックディスカバリーの問題の解決」を参照してください。

デバッグおよび変更する前にライブトピックを複製する

ライブトピックを更新するのではなくトピックを複製します。未修正の元のトピックは、参照およびバックアップのどちらにも役立ちます。元のトピックを残しておけば、トピックをすばやく復元できます。複製を発行する前に、必ず元のトピックを無効にしてください。

会話のテスト中にトピックをデバッグする

仮想エージェントデザイナーでトピックを作成または更新するときに、トピックヘッダーバーの [テスト] ボタンを使用して、会話をプレビューします。チャットテストウィンドウには、サービスポータルに表示される会話が表示されます。サードパーティのメッセージアプリケーションでは、会話の要素が異なって表示されることがあります。仮想エージェントを展開する予定のサードパーティアプリケーションで会話をテストします。

テストチャットウィンドウには、トピックのデバッグと絞り込みのための詳細情報を提供する 4 つのタブ ([テストフレーズを分析]、[変数]、[コンテキスト]、[ログ]) が表示されます。これらのタブの詳細については、「NLU/キーワードトピックのテスト」を参照してください。次の例は、テスト中にログに記録されたメッセージとエラーの処理を示しています。

トピック内のコントロールに関する警告を監視する

図 : 1. [フロー] タブのトピックノードに関する警告

必要な情報が不足しているコントロールには、コントロールの左上隅に赤色の不完全バッジが表示されます。このバッジには、そのコントロール内の問題の数を示す数字が表示されます。このバッジを選択すると、コントロール内の問題のリストが表示されます。

デザイナーの左上隅に別の警告バッジが表示され、トピック全体にある問題の数を示します。

トピックのプレビューが実行されないときのエラーをチェックする

図 : 2. キャンバスに表示されるトピックのプレビューのエラー

エラーによってトピックが実行できない場合、追加情報は、 仮想エージェントデザイナーキャンバスに表示されます。問題の合計数が、それぞれの詳細およびハイパーリンクとともにリストされます。ハイパーリンクを選択してノードに進み、提供された情報を使用して会話のエラーを修正します。

仮想エージェントの一般的な問題

問題	考えられる解決策
対話型インターフェースの下にモジュールデザイナーが表示されない	ユーザーには virtual_agent_admin ロールが割り当てられていない可能性があります。 仮想エージェントプラグインが有効になっていない可能性があります。
トピックを編集できない	ログインしたユーザーは、トピックと同じアプリケーションスコープ内になければなりません。
トピックをプレビューできない	ノードプロパティのすべての必須フィールドが入力されていることを確認してください。 インスタンスからのポップアップを許可するようにブラウザが設定されていることを確認してください。
接続時に Web クライアントがスタックする	1 つまたは複数のトピックが欠落している可能性があります。[トピック] ページをチェックして、インスタンスにトピックが存在し、[アクティブ] 状態であることを確認します。

会話フローで実行しているトピックをレビューする

インスタンス内の各 仮想エージェント (VA) 会話は、要求者と 仮想エージェント およびライブエージェント間の会話をログに記録するインタラクション [interactions] テーブルにインタラクションレコードを自動生成します。エージェントチャットを使用している場合、ライブエージェントへの転送を含む、要求者と 仮想エージェント 間の会話の転写を確認できます。詳細については、 仮想エージェント のインタラクションレコードを参照してください。

• 自然言語理解 (NLU) (NLU) トピックディスカバリーの問題の解決
  想定どおりにインテントが選択されていない場合は、NLU 予測エラーのトラブルシューティングを行うことができます。
• 仮想エージェント での 自然言語理解 (NLU) トピックディスカバリーロジック
  仮想エージェントがインテントを返す方法と、ユーザーに表示するインテントを選択する方法を把握します。