自然言語理解 (NLU) (NLU) トピックディスカバリーの問題の解決

想定どおりにインテントが選択されていない場合は、NLU 予測エラーのトラブルシューティングを行うことができます。

クイックトラブルシューティングのヒント

仮想エージェントが検出されない場合は、次の点を確認してください。

セッション言語に対して NLU が有効になっていますか?

仮想エージェント の 自然言語理解 (NLU) (NLU) 設定で言語を有効にします。詳細については、「仮想エージェント設定で NLU 言語を有効にする」を参照してください。

NLU モデルはセッション言語用にトレーニングおよび公開されていますか?

トピックでモデルに対する最新の変更が使用されていない可能性があります。ServiceNow® NLU については、「NLU モデルと仮想エージェントトピックの公開をトレーニングして試す」を参照してください。

仮想エージェントトピックは公開され、検出可能で、セッション言語の公開された NLU モデルとインテントにバインドされていますか?

トピックは、指定された言語の単一のモデルとインテントにバインドされている必要があります。他のトピックにバインドされた重複インテントがないことを確認します。トピック、モデル、およびインテントが同じドメインにあることを確認してください。詳細については、「仮想エージェントトピックの公開」を参照してください。

仮想エージェントデザイナー の [プロパティ] タブの仮想エージェントトピックに何らかのロールまたは条件が指定されていますか?

トピックが特定のロールまたは特定の条件に対してのみ表示される場合、トピックディスカバリーが妨げられる可能性があります。詳細については、「[トピックのプロパティ] タブ」を参照してください。

なぜ 仮想エージェント 私のトピックはスペイン語で、フランス語では見つからなかったのですか?

いくつかの可能性があります。

• すべての言語がすべての NLU プロバイダーでサポートされているわけではありません。詳細については、「NLUサービスの言語サポート」を参照してください。
• すべてのトピックが言語固有の NLU モデルとインテントにバインドされているわけではありません。
  たとえば、トピック A は次のようにマッピングできます。

  • 英語ではモデル A とインテント A にバインド
  • スペイン語ではモデル A とインテント A にバインドされます
  • フランス語のモデルまたはインテントにバインドされない

  このシナリオでは、トピックのフランス語のモデルとインテントを作成します。詳細については、「 多言語モデル管理」を参照してください。

トピック変数がスロットに入力されなかったのはなぜですか?

次の点を確認します。

• トピックのユーザー入力ノードが関連するエンティティで構成されていません。仮想エージェントデザイナー のノードに NLU エンティティプロパティを使用します。

  

• 予測結果に、設定された信頼度しきい値未満の信頼スコアを持つ NLU エンティティが含まれていました。
• ノードの NLU エンティティ値が無効でした。たとえば、日付/時刻エンティティタイプに「赤」という単語を適用することはできません。

トピックから検出をテストします。

次のいずれかの操作を行います。

• 資産ライブラリで、ディスカバリータイプの切り替えスイッチを [NLU/キーワード] にスライドさせ、[ NLU/キーワードトピックのテスト] を選択します。発言を入力し、[ 分析 ] タブを確認します。
• 仮想エージェントデザイナーでトピックを開き、[テスト] を選択します。[テスト] ウィンドウで、[ トピックディスカバリーを含める] チェックボックスをオンにします。発言を入力し、[ 分析 ] タブを確認します。

詳細については、「NLU/キーワードトピックのテスト」を参照してください。トピックディスカバリーの仕組みについては、「 自然言語理解 (NLU) のトピックディスカバリーロジック 仮想エージェント」を参照してください。

問題のトピックは「セットアップトピック」ですか?

その場合は、検出されるように [ 対話型インターフェース チャット設定] で設定する必要があります。詳細については、「仮想エージェントチャットエクスペリエンスの構成」を参照してください。

トピックの途中での切り替えに関する質問または問題。

仮想エージェントトピック B に切り替えた後、会話がトピック A に戻ったのはなぜですか?

トピックで [ トピック切り替え属性が有効になった後にトピックフローを再開 (Resume topic flow after topic switching)] 属性。この切り替えスイッチは、下の [ プロパティ] タブにあります 詳細プロパティ > 追加.

仮想エージェントトピック B に切り替えた後、会話がトピック A に戻らなかったのはなぜですか?

トピックで [ トピックの切り替え属性が無効になった後にトピックフローを再開する (Resume topic flow after topic switching attribute)] です。この切り替えスイッチは、下の [ プロパティ] タブにあります 詳細プロパティ > 追加.

仮想エージェントインテントが見つからない場合、トピックの途中でキーワード検索が使用されますか?

番号：

トピック A の変数は、切り替え後にトピック B で使用できますか?

番号：

トピック A が再開されたときに、トピック B の変数をトピック A で使用できますか?

番号：

追加のトラブルシューティングについては、次の表の情報を確認してください。

Open NLU テーブルでの NLU 予測情報の確認

自然言語理解 (NLU) (NLU) を使用するトピックをレビューまたはデバッグするときに、さまざまな Open NLU テーブルを使用して、トピックの NLU 予測結果を表示できます。たとえば、Open NLU 予測インテントフィードバックテーブルと Open NLU 予測エンティティフィードバックテーブルは、トピックのインテントとエンティティ (スロット入力) を決定するためにアプリケーション ( 仮想エージェント など) によって実行される NLU 処理に関する詳細情報を提供します。

Open NLU 予測インテントフィードバックテーブル

Open NLU 予測インテントフィードバック [open_nlu_predict_intent_feedback] テーブルには、NLU インテント予測結果に応じてアプリケーション (この場合は 仮想エージェント) が実行するインテント処理が表示されます。仮想エージェントの目標は、予測された NLU インテントを仮想エージェントトピックにマップすることです。仮想エージェントがトピックを提案するたびに、予測結果のレコードがこのテーブルに追加されます。仮想エージェントトピックが見つからない場合、予測は行われず、Skippedとマークされたレコードがこのテーブルに追加されます。

テーブルを表示するには、[ すべて] に移動し、ナビゲーションフィルターに「 open_nlu_predict_intent_feedback.list 」と入力します。

表 : 1. Open NLU 予測インテントフィードバックテーブルの主要なフィールド

フィールド	説明
アプリケーション	NLU を使用するアプリケーション。例: VA (仮想エージェント)。
アプリドキュメント	アプリケーションレコードのsys_id。例：sys_cs_topic.sys_id。
アプリドキュメントテーブル	アプリケーションレコードのテーブル。例: sys_cs_topic (トピックテーブル)。
自動選択	システムが予測しきい値を超えるインテントを 1 つだけ検出したため、アプリケーションが同じインテントに一致するトピック ( true または false) を実行することを選択したかどうかを示すブール値。
現在のインテント	NLU 予測が送信されたときにアプリケーションによって使用された NLU インテント。このフィールドは空 (空白) にすることができます。たとえば、 仮想エージェント アプリケーションで使用されるインテントは Change passwordできます。
ドメイン	インテントのドメイン。たとえば、グローバルや ITSM などです。
外部モデルの表示名	外部 NLU モデルの名前。たとえば、 IBM Watson Assistant NLU アプリケーションの名前などです。
インテント切り替え原因	ユーザーに確認を求める元のトピックの名前。この列の値には、次の 2 つのシナリオが考えられます。 ユーザーは、発言の最初のインテント一致について確認を求められます (VA が選択したトピックが正しいかどうかをユーザーに確認 します。切り替えスイッチは NLU 設定で有効になっています)。 ユーザーが最初の発言の入力を求められた場合、この値は挨拶トピックである可能性があります。値が empty の場合、ユーザーは最初の一致について確認を求められなかったか、最初に一致したトピックインテントを拒否しました。 ユーザーは、トピックの途中でインテントを切り替えるための確認を求められます (切り替えられたトピックが正しいかどうかをユーザーに確認 し、 NLU 設定で切り替えスイッチが有効になっている)。 ユーザーがトピックの途中で切り替えの確認を求められた場合、この値は切り替え時に表示していたトピックの名前です。 注: システムタスクもここに表示される場合がありますが、無視してかまいません。例：__silent_TerminateGoal_a3817a5f7ca7439b8。
インテント切り替え原因の現在のタスク	ユーザーが切り替える前のタスク (ノード) の名前。 注: システムタスクもここに表示される場合がありますが、無視してかまいません。例：__silent_TerminateGoal_a3817a5f7ca7439b8。
マップ済み	インテントを利用可能なトピック (true または false) と照合することで、アプリケーション (仮想エージェント) が予測が使用可能であると判断したかどうかを示すブール値。
モデルの表示名	ServiceNow NLU モデルの名前。
モデル ID	予測が送信された NLU モデルの ID。
モデル名	予測が送信された NLU モデルの名前。
NLU トピックディスカバリー結果	トピックディスカバリーの一環としての会話内の最初の発言の予測結果: AI 検索の代替:予測は行われませんでした。 AI 検索 が代替として使用されました。 正解:単一の予測が行われました。トピックが正しいことをユーザーが確認しました。 複数の中で正解:複数の予測が行われました。この結果は、ユーザーがこの予測を選択したことを示しています。その他の予測レコードは [未分類] としてマークされます。 確認なしで終了:ユーザーは確認なしで終了します。 正しくない:単一の予測が行われました。トピックが正しくないことをユーザーが確認しました。 複数の中で正しくない:複数の予測が行われましたが、ユーザーは提案されたトピックのいずれも選択しませんでした。この結果は、この予測の [予測の信頼性] 値が最も高いことを示しています。他の予測レコードは [未分類] としてマークされます。 トピック予測のセットアップ: AI 検索を使用せずにセットアップトピック関連の予測が行われました。 スキップ:予測は行われませんでした。 新しい発言でスキップ:[トピック] メニューが表示されたときに、ユーザーが新しい発言を入力しました。 未分類:上記のいずれの条件も満たされていないか、ユーザーが会話を破棄しました。
NLU モデル言語	予測に使用される NLU モデルの言語。
予測	予測インテントの名前。
予測監査ログ	Open NLU 予測ログ [open_nlu_predict_log] テーブルへの参照。
予測の信頼性	予測の信頼性の値。
要求者のセッション言語	動的翻訳が有効な場合の要求者セッション言語の言語コード。 たとえば、ユーザーがフランス語で入力すると、コード fr が保存されます。言語検出が有効になっている場合、ユーザーがデフォルト以外の言語でテキストを入力すると、 仮想エージェント はユーザーに言語の確認を求めます。確認すると、検出された言語がセッションのデフォルト値になります。
選択済み	一致するトピックとしてエンドユーザーに表示される複数の予測インテントが実際にエンドユーザーによって選択されたかどうかを示すブール値 ( true または false)。
表示	アプリケーション (仮想エージェント) がエンドユーザーが選択できる選択肢として予測されたインテントを表示したかどうかを示すブール値 ( true または false)。
切り替わったトピック	ユーザーが確認を求められた場合のトピックの名前 (ユーザーの選択が「はい」か「いいえ」とは無関係)。
発言	エンドユーザーがチャットクライアントウィンドウに入力したフレーズ。

Open NLU 予測エンティティフィードバックテーブル

Open NLU 予測エンティティフィードバック [open_nlu_predict_entity_feedback] テーブルには、NLU エンティティ予測結果に応じてアプリケーション (この場合は 仮想エージェント) が実行するエンティティ (スロット入力) 処理が表示されます。たとえば、 仮想エージェント の目的は、予測された NLU エンティティを 仮想エージェント トピック入力変数にマップすることです。

テーブルを表示するには、ナビゲーションフィルターに「 open_nlu_predict_entity_feedback.list 」と入力します。

表 : 2. Open NLU 予測エンティティフィードバックテーブルの主要なフィールド

フィールド	説明
アプリケーション	NLU を使用するアプリケーション。例:VA (仮想エージェント)。
アプリドキュメント	アプリケーションレコードのsys_id。例：sys_cs_topic.sys_id。
アプリドキュメントテーブル	アプリケーションレコードのテーブル。例：sys_cs_topic。
自動選択	アプリケーションがユーザーに通知せずにエンティティを使用することを自動的に選択するかどうかを示すブール値 ( true または false)。
外部モデルの表示名	外部 NLU モデルの名前。たとえば、 IBM Watson Assistant NLU アプリケーションの名前などです。
マップ済み	アプリケーション (仮想エージェント) が予測を使用可能と見なしたかどうかを示すブール値 ( true または false)。
マップ先	エンティティがマッピングされたアプリケーション内のアイテム。
モデルの表示名	ServiceNow NLU モデルの名前。
モデル ID	予測が送信された NLU モデルの ID。
モデル名	予測が送信された NLU モデルの名前。
予測	予測エンティティの名前。
予測監査ログ	Open NLU 予測ログ [open_nlu_predict_log] テーブルへの参照。
予測の信頼性	予測の信頼値。
選択済み	アプリケーションがエンティティの使用を選択したかどうかを示すブール値 ( true または false)。
表示	アプリケーションがエンドユーザーに対して選択する選択肢として予測エンティティを表示したかどうかを示すブール値 ( true または false)。
発言	チャットクライアントウィンドウに入力されたユーザーのフレーズ。
値	予測エンティティの値。

NLU 予測ログを開く

Open NLU 予測ログ [open_nlu_predict_log] テーブルには、トピックの NLU 予測レコードの統合された概要が表示されます。ログ内の各レコードは、発言と、NLU サービスによって決定された対応するインテント (トピック) およびエンティティを識別します。各レコードには、トピックディスカバリー (インテント照合) およびエンティティ抽出中に計算された NLU 予測スコアも含まれます。

注:

NLU 予測ノードログは自動的に生成されます。デバッグにノードログを使用しているが、NLU 予測ノードログの自動生成を抑制したい場合は、 com.glide.opennlu.predict.node_logging_enabled システムプロパティを追加し、値を false に設定します。

Open NLU 予測ログを表示するには、ナビゲーションフィルターに「 open_nlu_predict_log.list 」と入力します。

表 : 3. Open NLU 予測ログテーブルの主要なフィールド

フィールド	説明
非同期	非同期予測処理のインジケーター: true または false。True は、予測が非同期に実行され、 仮想エージェント ワーカースレッドの続行が許可されていることを示します。
作成日時	NLU 予測レコードが作成された日時。
期間	インテントとエンティティの値を返す予測の処理時間の長さ。
言語	NLU 予測要求の言語。
レベル	メッセージのタイプ:情報レベル。
メッセージ	返された予測結果:インテントとエンティティの数。
要求	認識されたインテントの発言と NLU モデルを含む NLU 予測パラメーター。
応答	0 (なし) 以上の採点済みインテントと採点済みエンティティを含む NLU 予測結果。
ソース	プロセスまたはエリア: OpenNLU - Predict。
発言	ボットによって認識されるユーザーステートメントで、NLU モデルで定義されたインテントにマップされます。

注:

Open NLU 予測インテントフィードバックテーブルおよび Open NLU 予測エンティティフィードバックテーブルには、詳細なインテントとエンティティの結果を表示できます。

Open NLU 統合の HTTP 接続情報の確認

Open NLU ドライバーの HTTP 接続 [open_nlu_driver_http_connection] テーブルを使用して、HTTP 認証情報、接続の詳細、および NLU サービスプロバイダーのインテント、エンティティ、NLU モデル、および予測のメソッドをすばやく確認します。

テーブルを表示するには、ナビゲーションフィルターに「 open_nlu_driver_http_connection.list 」と入力します。