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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • カスタム 仮想エージェント トピック、トピックブロック、およびコントロールの予期しない動作を調査して解決します。

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

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

    ライブトピックを更新するのではなく、トピックを複製します。未変更の元のトピックは、参照およびバックアップの両方として機能します。元のトピックを保持すると、トピックをすばやく復元できます。複製を公開する前に、必ず元のトピックを非アクティブ化してください。

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

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

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

    トピックのプレビューウィンドウに表示される会話プレビューログ。

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

    図 : 1. [フロー] タブのトピックノードに関する警告
    キャンバスと個々のコントロールに赤で表示された警告の数。テキストユーザー入力コントロールの場合、ノード名とプロンプトは必須です

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

    キャンバスの左上隅に別の警告バッジが表示され、トピック全体内の問題の数を示します。

    トピックのプレビューが実行されないときにエラーがないか確認する

    図 : 2. キャンバス上のトピックプレビューエラー
    キャンバスにエラーのプレビューを表示するトピック検証ウィンドウ。

    エラーによってトピックが実行できない場合、 仮想エージェントデザイナー キャンバスのサイドバーにある [検証の問題] タブに追加情報が表示されます。問題の合計数が、各ノードの詳細およびハイパーリンクとともにリストされます。ハイパーリンクを選択してノードに移動し、提供された情報を使用して会話のエラーを修正します。問題を修正せずにタブを閉じることはできますが、問題が修正されるまで、[ 公開] を選択すると [検証の問題] タブが表示されます。すべての問題を修正した後に [公開 ] を選択すると、[検証の問題] タブが閉じます。

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

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

    会話フローで実行されるトピックをレビューします

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