---
sourceDocument: オーストラリアの対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/conversational-interfaces

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリアの対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

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

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

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

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

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

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

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

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

テストチャットウィンドウには、トピックのデバッグと絞り込みのための詳細情報を提供する 4 つのタブ ( テストフレーズ、 変数、 コンテキスト、 およびログの分析) が表示されます。これらのタブの詳細については、「 [NLU/キーワードトピックのテスト](https://servicenow-prod.fluidtopics.net/TF5mpmHyGRAVtJ7wGUUY~w "チャットテストウィンドウを使用して、自然言語理解 (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/W6DuGnH2rv2lbMx2uUhR_A "仮想エージェント会話が発生するたびに、インタラクションレコードはインタラクション [interaction] テーブル内の会話全体をキャプチャします。レコードには、会話で使用されるすべてのトピック要素と、ライブエージェントの転送が含まれます。")」を参照してください。
* **[自然言語理解 (NLU) (NLU) トピックディスカバリーの問題の解決](https://servicenow-prod.fluidtopics.net/ciGem4kGOGSCkKRr6YPfrQ)**   
  想定どおりにインテントが選択されていない場合は、NLU 予測エラーのトラブルシューティングを行うことができます。
* **[自然言語理解 (NLU) のトピックディスカバリーロジック 仮想エージェント](https://servicenow-prod.fluidtopics.net/HXe4zOHa0zr1HCodLrTs3g)**   
  仮想エージェント がインテントを返す方法と、ユーザーに表示するインテントを選択する方法を理解します。