AISの |AI 検索の一般的なトラブルシューティングとデバッグ<!-- .SOKMKBArticle div.margin { padding: 10px 40px 40px 30px; color: #283d40; font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; font-size: 10pt; } .SOKMKBArticle div.fed{ background-color: #f5f8fa; border: 1px solid; border-color: #bfbfbf; padding: 10px; } .SOKMKBArticle .FedRestricted{ background-color: #c00000; color: #ffffff; padding: 10px; margin-top: 10px; text-align: center; font-size: 14pt; font-weight: bold; } .SOKMKBArticle .CustRestricted{ background-color: #ff0000; color: #ffffff; padding: 10px; margin-top: 10px; text-align: center; font-size: 14pt; font-weight: bold; } .SOKMKBArticle .SNRestricted{ background-color: #ea700d; color: #ffffff; padding: 10px; margin-top: 10px; text-align: center; font-size: 14pt; font-weight: bold; } .SOKMKBArticle .SNConfidential{ background-color: #ffc000; color: #ffffff; padding: 10px; margin-top: 10px; text-align: center; font-size: 14pt; font-weight: bold; } .SOKMKBArticle .Public{ background-color: #00b050; color: #ffffff; padding: 10px; margin-top: 10px; text-align: center; font-size: 14pt; font-weight: bold; } .SOKMKBArticle table.tocTable { border: 1px solid; border-color: #f2f2f2; background-color: #f2f2f2; padding-top: .6em; padding-bottom: .6em; padding-left: .9em; padding-right: .6em; } .SOKMKBArticle table.noteTable { align: left; border: none; border-color: #81b5a1; background-color: #f2f2f2; width: 100%; border-spacing: 2; font-size: 11px; } .SOKMKBArticle table.internalTable { border-top: 1px solid; border-left: 1px solid; border-color: #81b5a1; width: 100%; border-spacing: 1px; } .SOKMKBArticle .sp td { border-bottom: 1px solid; border-right: 1px solid; border-color: #81b5a1; background-color: #ffffff; height: 20px; padding-top: .5em; padding-bottom: .5em; padding-left: .5em; padding-right: .5em; } .SOKMKBArticle .sphr td { border-right: 1px solid; border-bottom: 1px solid; border-color: #81b5a1; background-color: rgb(245, 245, 245); padding-top: .5em; padding-bottom: .5em; padding-left: .5em; padding-right: .5em; height: 20px; } .SOKMKBArticle .sh td { border-bottom: 1px solid; border-right: 1px solid; border-color: #81b5a1; background-color: #81b5a1; color: #ffffff; height: 20px; padding-top: .5em; padding-bottom: .5em; padding-left: .5em; padding-right: .5em; } .SOKMKBArticle th { padding-top: .5em; padding-bottom: .5em; padding-left: .5em; padding-right: .5em; border-bottom: 1px solid; border-right: 1px solid; border-color: #81b5a1; background-color: #283d40; font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; font-size: 10pt; color: #ffffff; height: 20px; } .SOKMKBArticle td { border-color: #81b5a1; margin: 5px 5px 5px 5px; font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; font-size: 10pt; color: #283d40; } .SOKMKBArticle p { color: #283d40; font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; } .SOKMKBArticle li { color: #283d40; font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; font-size: 10pt; line-height: 1.5; } .SOKMKBArticle pre { font-family: Courier New; } .SOKMKBArticle div { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; } .SOKMKBArticle hr { border-top-width: 1px; border-top-style: solid; border-top-color: #81b5a1; } .SOKMKBArticle a { color: #81b5a1; } .SOKMKBArticle a.two:link { padding: 15px 45px 15px 45px; margin-top: 20px; color: #ffffff; text-align: center; background-color: #1F8476; border: 1px solid; border-color: #1F8476; } .SOKMKBArticle a.two:visited { padding: 15px 45px 15px 45px; margin-top: 20px; color: #ffffff; text-align: center; background-color: #1F8476; border: 1px solid; border-color: #1F8476; } .SOKMKBArticle a.two:hover { color: #ffffff; background-color: #259b8a; } .SOKMKBArticle .button { padding: 15px 45px 15px 45px; margin-top: 20px; color: #ffffff; text-align: center; background-color: #1F8476; border: 1px solid; border-color: #1F8476; } .SOKMKBArticle .title { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #81b5a1; font-size: 30pt; } .SOKMKBArticle .hd1 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-size: 20pt; border-bottom: 1px solid; border-bottom-color: #81b5a1; text-decoration: none; } .SOKMKBArticle h1 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-size: 20pt; font-weight: normal; border-bottom: 1px solid; border-bottom-color: #81b5a1; text-decoration: none; } .SOKMKBArticle .hd2 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #68a1af; font-weight: bold; font-size: 16pt; text-decoration: none; } .SOKMKBArticle h2 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #68a1af; font-weight: bold; font-size: 16pt; font-weight: normal; text-decoration: none; } .SOKMKBArticle .hd3 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: normal; font-size: 14pt; text-decoration: none; } .SOKMKBArticle h3 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: normal; font-size: 14pt; text-decoration: none; } .SOKMKBArticle .hd4 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: normal; font-size: 12pt; text-decoration: none; } .SOKMKBArticle h4 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: normal; font-size: 12pt; text-decoration: none; } .SOKMKBArticle .hd5 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: bold; font-size: 10pt; text-decoration: bold; } .SOKMKBArticle h5 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: bold; font-size: 10pt; text-decoration: bold; } .SOKMKBArticle .hd6 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: normal; font-size: 10pt; text-decoration: underline; } .SOKMKBArticle h6 { font-family: Century Gothic, Verdana, Helvetica, Arial, sans-serif; color: #283d40; font-weight: normal; font-size: 10pt; text-decoration: underline; } .SOKMKBArticle details { font-size: 10pt; } .SOKMKBArticle details[open] summary ~ * { animation: sweep .5s; margin-top: 0; padding-top: 10px; } @keyframes sweep { 0% {opacity: 0; margin-top: -10px} 100% {opacity: 1; margin-top: 0px} } .SOKMKBArticle summary { cursor: pointer; outline: none; margin-bottom: 3px; } .SOKMKBArticle .summary { background-color: #81b5a1; font-size: 10px; color: white; cursor: pointer; padding: 5px; width: 100%; border: none; text-align: left; outline: none; vertical-align: top; } --> Description (説明) この記事では、AISの問題に取り組むための基本的なトラブルシューティングとデバッグの手順について説明します AI 検索のトラブルシューティングとデバッグ 1.ログをオンにするには、フィルターナビゲーターから [システム診断] > AI 検索のデバッグ以下に同様のデバッグメッセージが表示されます 2.ログを確認するには、 AI 検索 > すべて または AI 検索 >取り込みの警告とエラー] に移動します。AI を参照してください AI 検索のログ記録とデバッグ 3.アプリケーションをインストールして、 検索プレビュー UI を使用します 高度な AI 検索管理ツール アプリのインストール後、 AI 検索>プレビュー>に移動します 3. a.左上のドロップダウンで検索プロファイルを選択します 3.b.[ここで検索] と書かれたフィールドに検索用語を入力し>[検索] ボタンを押します 4. localhostログも確認します。 5.NLU モデルの検索クエリをテストする場合は、[スクリプト - バックグラウンド] から検索し、結果とデバッグログを確認できます テストするソリューション名を「ml_x_snc_sn_km_mr_global_ais_gra_b8bc699a67621010b3d782f45685efa5のように #1 の行に入力します//Enter the solution name you are testing in the line #1 like ml_x_snc_sn_km_mr_global_ais_gra_b8bc699a67621010b3d782f45685efa5var geniusSearchSolutionName = 'enter the solution name'; var searchQuery = new sn_ml.GeniusSearchQuery("abraham lincoln");var searchContext = new sn_ml.GeniusSearchContext({"session" : ""});var geniusSearchSolution = sn_ml.GeniusSearchSolutionStore.get(geniusSearchSolutionName)geniusSearchSolution = sn_ml.GeniusSearchSolutionStore.get(geniusSearchSolutionName);var result = geniusSearchSolution.search(searchQuery, searchContext, {});gs.print(JSON.stringify(JSON.parse(result), false, 4)); 6.検索プレビュー UI とともに、以下のスクリプトを使用して、検索プロファイルで結果をデバッグしたり、検索の問題を絞り込んだりすることができます。以下の AISASearchUtil API はサポートされていないため、デバッグ目的でのみ使用してください。 //Make changes to the searchParams based on your requirements.//Just need to change searchContextConfigId and searchTerm to get started.searchParams = { searchContextConfigId: '00731b9d5b231010d9a5ce1a8581c7dd', //sys_id of the Search Application configuration[sys_search_context_config] record that you want to use for searching. searchTerm: '***', // The search term *** returns all records that have been indexed. paginationToken: '', // Leaving paginationToken empty returns the data for the first page. To get the paginationToken for 2nd page, click the next page button on the portal after doing the search and check the URL for paginationToken. disableSpellCheck: false, facetFilters: [], searchFilters: [], requestedFields: {}, rpSysId: 'test' // Just a dummy value that is needed for the script to work.};var aiSearchUtil = new AISASearchUtil();var result = aiSearchUtil.search(searchParams);var searchResult = result.data.search.searchResults;gs.info(searchResult.length);for (var i=0; i<searchResult.length; i++){gs.info(searchResult[i].title + " | " + searchResult[i].text);}gs.info(JSON.stringify(result));//Note: Ensure that search sources have been indexed before trying to search.注意:検索を試みる前に、検索ソースがインデックス化されていることを確認してください。 AI 検索で検索結果が表示されない場合に実行する一般的なスポットチェック: 1.AI 検索が有効になっているかどうかを確認します 「glide.ais.enabled」を true に設定します。また AI 検索>接続>テスト接続もオンにします 接続に問題がある場合は、テクニカルサポートにお問い合わせください2.Genius 結果が返されない場合は、「glide.ais.genius_result.enabled」が「true」に設定されているかどうかを確認してください。 2.a.ファセットがクリックされても Genius 結果が表示されないことを確認し、[glide.ais.genius_result.enabled_with_facet_filter] を false にチェックします 2.b.英語以外の言語の場合、Genius 結果はサポートされていないため機能しません。AI 検索は複数の言語をサポートしていますが、Genius 結果は英語でのみサポートされています AI 検索のインターナショナリゼーションサポート 2.c.Genius 結果が機能しない場合は、対応する Genius 結果に EVAM 構成が追加されているかどうかを確認します。たとえば、Peoplefind Genius 結果は、sys_ux_composite_data_template_predicate_bundle に手動で追加しない限り機能しません。 3.期待する結果が>表示されない場合は、次の点を確認してください 3.a.正しい「検索プロファイル」がリンクされているかどうかを確認します 3.b.「検索プロファイル」が「公開」であるかどうかを確認し、再度公開されていない場合は再テストします 4.期待する結果が存在しない場合は、[検索ソース] フィルター条件を確認します。たとえば、「検索ソース」で特定のレコードが除外された場合、それらのレコードは結果に表示されません。その他の理由としては、 ACL、 ドメイン セパレーション、 ユーザー 基準、およびクエリ前ビジネスルールが挙げられます。 5.期待する結果数が表示されない場合は、 Search アプリケーション構成 (sys_search_context_config) に移動し、 search results limit を確認します AI 検索に関するその他の問題: 1.エッジ暗号化と暗号化のサポートは、Quebec の時点でサポートされていないため、有効になっているかどうかを確認します 2.イベント関連の問題がある場合:すべてのイベントが「ais_index」で始まるイベントキュー 3.パフォーマンス関連の問題については、検索結果に適用されているコンテンツセキュリティ機能を特定します。 •評価対象のユーザー基準は多数ありますか? •検索対象のテーブルに多数の ACL がありますか? クローン作成された非本番インスタンスで AI 検索のパフォーマンスをテストする場合は注意が必要です。同じ専用 AI 検索ノードが、すべてのインスタンスからの検索クエリトラフィックを処理します。その結果、非本番インスタンスでの検索クエリが、本番インスタンスでの検索クエリのパフォーマンスに影響を与える可能性があります。 4.AI 検索モジュールが見つからない場合は、最近のクローンがあるかどうかを確認し、テクニカルサポートにお問い合わせください。KB0967216 (これは ServiceNow 内部 KB です) を参照することもできます 5.特定のサービスポータルに対して AI 検索を有効にできない場合は、利用できない可能性があります。AI 検索は、カスタム作成されたすべてのポータルで有効にできますが、OOB ポータル/ストアポータルの場合、利用可能な場合はデフォルトで有効になります。 6.タスク、cmdb 関連テーブル、および zing ブロックリスト内のその他のテーブルは、sc_cat_item と kb_knowledge を除いてインデックスを作成できません。親テーブルにインデックスを作成し、すべての子テーブルも手動で追加してインデックスを作成する必要がある場合。 Reference (参照) AI 検索AI 検索リファレンス AI 検索のログ記録とデバッグ 検索プレビュー UI高度な AI 検索管理ツール