---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

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

# 仮想エージェントトピックのデバッグ {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

カスタムの仮想エージェントトピックの予期しない動作を調査して解決します。
トピックディスカバリーの問題の詳細については、「 [仮想エージェントの LLM トピックディスカバリー](https://servicenow-prod.fluidtopics.net/5~3OlIec6OG3qXAeXfW3hA "大規模言語モデル (LLM) を使用すると、仮想エージェントはわかりやすい言葉でユーザーステートメントを処理できるようになります。LLM を使用する会話は、自然言語理解 (NLU) (NLU) を使用する会話よりも優れており、セットアップも簡単です。") と [自然言語理解 (NLU) (NLU) トピックディスカバリーの問題の解決](https://servicenow-prod.fluidtopics.net/JjmT6vJLUjy8UNklhkEoiw "想定どおりにインテントが選択されていない場合は、NLU 予測エラーのトラブルシューティングを行うことができます。")」を参照してください。

## デバッグおよび変更する前にライブトピックを複製する {#virtual-agent-troubleshooting-guide__section_bbn_d12_d2b}

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

## 会話のテスト中にトピックをデバッグする {#virtual-agent-troubleshooting-guide__section_ehd_j5d_12b}

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

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

## トピック内のコントロールに関する警告を監視する {#virtual-agent-troubleshooting-guide__section_plt_gbx_c2b}

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

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

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

## トピックのプレビューが実行されないときのエラーをチェックする {#virtual-agent-troubleshooting-guide__section_pzf_vkd_12b}

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

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

## 仮想エージェントの一般的な問題 {#virtual-agent-troubleshooting-guide__section_trx_w3z_12b}

{#virtual-agent-troubleshooting-guide__table_j3r_2jz_12b__entry__2}

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

{#virtual-agent-troubleshooting-guide__table_j3r_2jz_12b}

## 会話フローで実行しているトピックをレビューする {#virtual-agent-troubleshooting-guide__section_dc2_vgl_xhb}

インスタンス内の各 仮想エージェント (VA) 会話は、要求者と 仮想エージェント およびライブエージェント間の会話をログに記録するインタラクション \[interactions\] テーブルにインタラクションレコードを自動生成します。エージェントチャットを使用している場合、ライブエージェントへの転送を含む、要求者と 仮想エージェント 間の会話の転写を確認できます。詳細については、[仮想エージェント のインタラクションレコード](https://servicenow-prod.fluidtopics.net/P5Xqji70SlUrCvIzi~7FSg "仮想エージェント の会話が発生するたびに、インタラクションレコードは、インタラクション [interaction] テーブルで会話全体をキャプチャします。レコードには、会話で使用されるすべてのトピック要素と、ライブエージェントの転送が含まれます。")を参照してください。
* **[自然言語理解 (NLU) (NLU) トピックディスカバリーの問題の解決](https://servicenow-prod.fluidtopics.net/JjmT6vJLUjy8UNklhkEoiw)**   
  想定どおりにインテントが選択されていない場合は、NLU 予測エラーのトラブルシューティングを行うことができます。
* **[仮想エージェント での 自然言語理解 (NLU) トピックディスカバリーロジック](https://servicenow-prod.fluidtopics.net/XxzcoeN_tqxK45oOmcXvUA)**   
  仮想エージェントがインテントを返す方法と、ユーザーに表示するインテントを選択する方法を把握します。