サービスポータル AI 検索 UX トラブルシューティングガイドSummary<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } この記事は、サービスポータルでの AI 検索 UX の問題のトラブルシューティングを支援することを目的としています。以下は、この記事の目次です。 デバッグに役立つプロパティNow Assist 全般トラブルシューティング 適切な検索プロファイルと EVAM を見つける方法AMB から Genius 結果構成とビューテンプレートを見つける方法 シナリオ 1:ポータルに Genius 結果が返されないシナリオ 2: パフォーマンスのトラブルシューティングシナリオ 3:マルチコンテンツ応答の引用をクリックできませんシナリオ 4:[フォローアップを依頼] をクリックできないシナリオ 5:MCR はレンダリングされているが、引用がないその他の問題のシナリオ デバッグに役立つプロパティ: プロパティ 説明 デフォルト値 glide.search.evam.use_legacy_template_generation Evam Lite とレガシーの切り替えに役立ちます。(このプロパティが true の場合、テーブルのraw_citationフィールドの最大長が 500000 に設定されていることを確認してくださいsys_search_genius_result_field) false glide.search.evam.logger.enabled Evam Lite ログ記録 falseプリフィックス [SEARCH EVAM] glide.search.genius_results.portal_streaming_enabled ストリーミングプロパティ true glide.search.genius_results.async.max_loading_time UX コンポーネントのタイムアウト 15 glide.search.logger.enabled 検索ログ falseプリフィックス [SEARCH API] glide.search.performance.logger.enabled パフォーマンスログ記録 falseプリフィックス [SEARCH PERFORMANCE] glide.ais.query.disable_async_mode 非同期モードを無効にする false sn_ais_assist.dpr_ingestion_completed true に設定する必要があります。このプロパティが設定されていない場合、AIS は DPR 検索を実行しないため、LLM 呼び出しに必要なドキュメントを取得しません。 DPR 取り込みが完了したら、これを true に設定する必要があります Now Assist の一般的なトラブルシューティング: 1.[Genius 結果] 関連リストの検索プロファイルで、Now Assist Genius 結果があるかどうかを確認します。現在、ポータルでは、3つの「Now Assist」(NA) Genius 結果をサポートしています。 Now Assist Q&ANow Assist アクションNow Assist マルチコンテンツ応答 2. ポータルで使用されている EVAM 定義の [EVAM ビュー構成バンドル] で、[マルチコンテンツポータル応答バンドル] が存在するかどうかを確認します。「仮想エージェント」(VA) の場合は、「Now Assist セルフサービスマルチコンテンツ応答バンドル」が存在することを確認します。 3.デフォルトでは、システムプロパティ「glide.ais.query.disable_async_mode」(このプロパティ OOTB は出荷されていません)によって制御される非同期モードがサポートされています。顧客インスタンスに存在する場合は、false に設定されていることを確認してください。 4.「glide.search.evam.use_legacy_template_generation」プロパティが false に設定されていることを確認して、最新の EVAM Lite コードが使用されているかどうかを確認します。何らかのパフォーマンス上の理由でこのプロパティが true に設定されている場合は、テーブルのraw_citationフィールドの「最大長」sys_search_genius_result_field 500000 に設定されていることを確認してください。 5.システムプロパティ「sn_ais_assist.dpr_ingestion_completed」が true に設定されているかどうかを確認してください。設定しないと、ドキュメントが検索結果に挿入されないため、AI 検索から結果は返されません。 適切な検索プロファイルと EVAM を見つける方法: ポータルで右クリックして開き、[ネットワーク] タブをクリックして検査し、「exec」と入力してネットワーク呼び出しをフィルタリングします以下に示すように、exec 呼び出しタイプ GRAPHQL をクリックします。次に、次に示すようにこの /exec 要求のプレビューを確認して、入力値が渡されていることを確認します。searchContextConfigId を選択し、「sys_search_context_config」でルックアップします同様に、searchEvamConfigId を選択し、「sys_ux_composite_data」でルックアップします AMB から使用する Genius 結果構成とビューテンプレートを見つける方法: ポータルで右クリックして開き、[ネットワーク] タブを検査すると、これがブラウザ開発ツールになります次に、ページ全体をリロードしてから、検索用語の起動を開始します[ネットワーク] タブに移動し、amb をフィルタリングすると、多くの AMB 要求/応答が表示されます/search チャネルでフィルタリングユーザー名を持つ要求にフォーカスし、ゲストユーザーからの要求は無視します以下のスクリーンショットに示すように、Genius 結果構成sys_idと EVAM ビューテンプレートを選択しますまたは、テーブルレベルでAMBを調べることもできます。つまり、ポータルで検索が実行されたら、「sys_amb_message」テーブルを開き、作成日、チャネル名「/search」でソートし、「user_name」によって作成されたレコードを開き、「シリアル化された彗星メッセージ」を確認すると、上記のスクリーンショットと同じ情報が含まれます。 GR がポータルに返されない 1.使用された正しいバージョン: 上記のセクション「適切な検索プロファイルと EVAM を見つける方法」で説明されているように、ネットワークタブで /exec 呼び出しを調べて、正しい GR 構成が検索プロファイルにリンクされているかどうかを確認します。次に、GR 構成を調べて、カスタマーが使用している Glide バージョンに基づく最新の変更があるすべての OOTB バージョンを使用していることを確認します 2.優先順位:マルチコンテンツ応答 GR が Now Assist Q&A やポータル検索のカタログなどの他の GR 構成とリンクされている場合、優先順位はマルチコンテンツ応答 GR (MCR) にのみ指定されます 3.AMB: 上記のすべてのステップが想定どおり場合は、「AMB から使用された Genius 結果と EVAM ビューテンプレートを見つける方法」セクションで詳述されているように、Genius 結果が AMB チャネルに存在するかどうかを確認します。 4.ストリーミングオン (デフォルト):ストリーミングはシステムプロパティ「glide.search.genius_results.portal_streaming_enabled」によって制御されます。true に設定されていることを確認してください。ストリーミングがオンになっている場合、ユーザーがゲストである複数の AMB 要求が表示されます。 5. ストリーミングオフ:このシナリオでも、ゲストユーザーと同じまたは類似のタイムスタンプの複数のレコードが存在しますが、オンシナリオと比較すると少なくなります。ユーザー名を含むレコードを重視します。レコードを展開して「geniusResultsTemplates」オブジェクトにドリルダウンする「data」オブジェクトを見つけます 6.SYNC モード (glide.ais.query.disable_async_mode true に設定):非同期プロパティが true に設定されている場合は、AMB を使用しなくなるため、AMB チェックをスキップします。/exec (GRAPHQL) 呼び出しのプレビュータブに geniusResultstemplate が入力されているかどうかを確認する必要があります 7.EVAM: 正しいビュー構成が Evam 定義にマッピングされているかどうかを確認しましょう。 入力値で使用されている EVAM 定義を見つけ (searchContextConfigId を見つけたのと同じ方法で)、使用されている searchEvamConfigId を探します。 「sys_ux_composite_data」テーブルで検索します。「ポータルのマルチコンテンツ応答バンドル」かどうかを確認します。 パフォーマンスのトラブルシューティング ポータル環境での Now Assist の応答時間の大幅な増加が確認されています。このパフォーマンスの低下は、1 つ以上のコンテンツアイテムが引用として返されるカタログ結果であるマルチコンテンツ応答に関連しているようです。 症状： このパフォーマンスの問題は、次の条件が満たされた場合に確認できます。 ブラウザーコンソールに、応答生成時間が 15 秒を超えたことを示すタイムアウトメッセージが表示されます。ポータルでの Now Assist クエリのエンドツーエンドの応答生成時間が 15 秒を超えている。sys_gen_ai_log_metadataを見ると、BGEリランカーが完了した時間と合成された回答が開始される時間の間には大きなギャップがあります。 開発ツールコンソール設定でタイムスタンプを有効にする方法: 以下のスクリーンショットに示すように、[検査] タブでコンソールステートメントのタイムスタンプを有効にします (ポータルを右クリックして検査を開き、右上隅の歯車アイコンをクリックして、[コンソールセクション] の下に [タイムスタンプを表示] をクリックします)。 タイムスタンプを比較: タイムスタンプがコンソールタブの [詳細] セクションにある場合は、GR タイマーの有効期限が切れたことに関するメッセージが表示されます。 合成された GR が「sys_gen_ai_log_metadata」テーブルで生成されたときのタイムスタンプを検索します。 コンソール タイムスタンプが生成 AI ログテーブル より前である場合、これはタイムアウトの問題であり、システムプロパティ「glide.search.genius_results.async.max_loading_time」を介して制御される応答のレンダリングを待機中にコンポーネントがタイムアウトしました デフォルト値は 15 です 生成 AI の呼び出し後に タイムアウトが発生し amb チャネルに GR がない場合は、次のいずれかの欠陥が原因である可能性があります。この問題を解決するために、次の欠陥が発生し、対処されました。 PRB1888352:カタログ会話バッチ API を呼び出すための Glide 変更。この変更は、会話型カタログストアアプリの変更 (バージョン 4.2.6) の Now Assist に依存しています。 PRB1893377:検索アプリでの Now Assist が、VA などの会話型クライアントのカタログ LLMUtil API への呼び出しを制限するように変更されました。これは、「AI 検索の Now Assist」ストアアプリの v12 で修正されました。PRB1925760:「AI 検索の Now Assist」(v14) の 10 月リリースの検索での Now Assist アプリの変更により、ストリーミング用の会話型クライアントの呼び出しが制限され、変更にはコードのリファクタリングの変更も含まれます。PRB1932120:Glide 変更により、AISearchCatalogConversationalHelper スクリプトをクリーンアップし、古い API にフォールバックを追加します。カタログ会話テーブルのカタログ機能拡張。オーストラリア、Yokohama Patch8、Zurich Patch2で利用可能です。 速度低下のほとんどは、「AI 検索の Now Assist」ストアアプリバージョンとファミリーリリースで修正されたものをアップグレードすることで解決できます。生成 AI の呼び出し後に タイムアウトが発生し、AMB に GR があるものの表示されない場合は これらの詳細を含むケースをログに記録することで確認 サポートPRB1917739して調整します。 マルチコンテンツ応答 引用はクリックできません a) このストリーミングが有効で、最終的なペイロードが AMB で受信されませんでしたか? ステップ1:ストリーミングの場合、最初のトークンを受信するとすぐに回答が表示されます。つまり、インライン引用を含むメッセージは受信されましたが、最終的なペイロード (データブローカー応答全体) は受信されませんでした。ステップ2:ストリーミングを無効にし(上記のプロパティリストを参照)、回答がまだ表示されているかどうかを確認します。おそらくそうではないでしょう。ステップ 3:ポータルに添付された EVAM 定義に「マルチコンテンツポータル応答バンドル」があることを確認する b) 最終的なペイロードを受信しましたか? ステップ1:AMBチャネルで、受信した最終的なペイロードを確認します。ステップ 2:sn-search-genius-synthesized-card テンプレートを使用してペイロードに正しい応答がありますか?そうでない場合は、上記の (a) のうちのステップ 3 を参照してくださいステップ 3:受信した応答ペイロードには、合成された回答で引用されたすべての引用が含まれていますか?そうでない場合は、AIS Glide の問題である可能性があります [フォローアップを依頼する] はクリックできません フォローアップを依頼するは、拡張チャットが有効になっているポータルでのみ有効ですステップ 1: コンソールにエラーはありますか?ステップ 2:「vaEVAMItem」は AMB で受信した各 geniusResultTemplates アイテムペイロードの一部であるステップ 3:検索要求ペイロード実行に vaEVAMDefinitionId が存在し、それがポータルに添付されたアシスタントの EVAM 定義のsys_idに対応しているかどうかを確認します。 MCR はレンダリングされていますが、引用がありません 次に「amb」呼び出しの [ネットワーク] タブを確認し、geniusResultsTemplates に移動します各アイテムのプロパティ値で、json オブジェクトの [モデル] を展開して移動します。 フィールド「columns.result_type」を探します。result_type:「合成」の場合、画面に引用を表示するには、「引用」というresult_typeのアイテムが少なくとも 1 つ必要です。 これが存在する場合は、[columns.raw_citations] フィールドを確認し、値をコピーしてテキストエディターに貼り付けます。フィールド「doc_x」または「cat_x」が存在するかどうかを確認します (x は数値を表します)。 2/3 が存在しない場合は、Dev-AIS Glide アサイン先グループのケースをオープンしてください。存在してもまだ引用が表示されない場合は、Dev-Search UX のケースをオープンしてください 引用ポップアップが開かない (散発的) Genius 結果制限が 10 に設定されていて、10 件を超える引用が返された場合、引用ポップアップが常に開くわけではありません。 回避策:Genius 結果の上限を 10 に増やします (ストーリーの WIP は第 4 四半期で修正予定) その他の問題のシナリオ: 1. 「KB2038160 - VA is frozen or not responding after upgrading to March 2025 release of Now Assist」(「glide.search.evam.use_legacy_template_generation」システムプロパティが true であるが、sys_search_genius_result_fieldテーブルのraw_citationフィールドの最大長が 500000 に設定されていないため) 2.Q&A GR が検索プレビューに表示されるが、ポータルには表示されない (ATG 検索 Q&A):検索プレビューは、関連性モデルのチェックをスキップするデバッグモードで検索を実行するため、バックエンドから返された場合は結果が表示されますが、ポータル検索には関連性モデルのチェックがあり、モデルが関連性があると判断した場合のみ UI に戻ります。 3.完全一致:完全一致はポータルではサポートされていません。検索アプリケーションにも同じメッセージが表示されます。数値フィールドがインデックス付けされて検索された場合、API は一致するものを返します。