AI 検索 の検索プレビュー UI
検索プレビュー UI では、選択した検索プロファイルの設定を使用して AI 検索 クエリをテストできます。アドミニストレーターツールを使用すると、検索クエリのパフォーマンスデータとフィードバックを確認し、クエリをデバッグし、テスト目的でデフォルトのクエリ設定を上書きすることができます。
検索プレビュー UI にアクセスするには、次に移動します: .
必要な ServiceNow AI Platform® ロール
- 検索プレビュー UI を表示して使用するには、ais_admin ロールが必要です。
- 一部の AI 検索 アドミニストレーターツールでは、代理操作ロールが必要です。
- ais_high_security_admin ロールは、検索ソースとコンテンツセキュリティのフィルタリングをバイパスするために必要です。この手順の詳細については、「検索プレビュー UI を使用して検索結果のアクセスの問題を診断」を参照してください。
検索 UI コンポーネントのプレビュー
| コンポーネント | 説明 |
|---|---|
| 1. 検索プロファイルリスト | 検索クエリをプレビューするときに適用する検索プロファイルを選択します。 リストには、1 つ以上のリンクされた検索ソースを持つ公開済みの検索プロファイルのみが含まれます。 注: 検索プロファイルに未公開の変更がある場合、リストには警告アイコンが  表示され、プロファイル名の後に [DRAFT] と表示されます。検索プロファイルを公開して、これらの変更が検索クエリプレビューに反映されることを確認します。 |
| 2. 検索入力フィールド | このフィールドに検索クエリの用語と演算子を入力します。選択した検索プロファイルの設定を使用してクエリの結果をプレビューするには、[検索] を選択します。 |
| 3. テーブルファセットフィルター | ソーステーブル別の検索クエリ結果の分布を表示します。テーブル別にクエリ結果をフィルタリングするには、テーブルの名前を選択します。テーブルファセットフィルターを削除するには、[すべて] を選択します。 |
| 4. Genius 結果の回答 | 選択した検索プロファイルで実行されたときに検索クエリが生成する Genius 結果回答ごとに、キーと値のペアを確認します。 注: Genius 結果回答が一部の検索クエリで表示されない場合があります。 |
| 5. 検索クエリ結果 | 選択された検索プロファイルで実行されたときに検索クエリが生成する結果を確認します。結果のページを移動するには、[次へ] または [前へ] を選択します。 |
| 6. AI 検索 アドミニストレーターツール | 次の使用するアドミニストレーターツールのアイコンを選択します。
各アドミニストレーターツールの出力、コントロール、およびフィールドの詳細については、次の参照セクションを参照してください。 |
:検索クエリのトリガーされた結果改善ルール、一致した 
:検索クエリの処理中に生成されたアラートフィードバックメッセージを確認します。
:辞書とクエリのフィードバックメッセージを確認し 
:検索クエリのユーザーコンテキスト値を指定して、結果改善ルールをトリガーします。
:検索クエリのユーザーまたはロケールを変更して、アクセス設定をテストし、翻訳されたドキュメントを表示します。検索プレビューアドミンツール
検索プレビュー UI のアドミンツールによって提供される出力、コントロール、およびフィールドを理解します。
データ処理ツール
| エントリ | 説明 |
|---|---|
| トリガーされたクエリルール | 検索クエリによってトリガーされた結果改善ルールの数 |
| 一致するインテント | 検索クエリで検出された NLU モデルインテントの数と名前 |
| 合計時間 | 検索クエリの処理に費やされた合計時間。前処理、検索クエリ、Genius 結果計算、およびセキュリティ処理時間が含まれます。 |
| 前処理時間 | 検索クエリを実行する準備に費やした時間。コンテンツセキュリティのためのユーザーのアクセス権限の検索に費やされた時間を含みます。 |
| 検索クエリ時間 | 検索クエリに一致するレコードを取得して結果セットを生成するために費やした時間 |
| Genius 結果計算 | 検索クエリの Genius 結果回答の計算に費やされた時間 |
| セキュリティ処理時間 | ユーザーのアクセス権限に基づいて、アクセスできないレコードを検索クエリの結果セットからフィルタリングするために費やした時間 |
アラートツール
このツールは、検索クエリの処理中に生成されたアラートフィードバックメッセージのリストを表示します。
検索クエリがアラートフィードバックメッセージを生成しなかった場合、ツールは代わりに「No Alert Feedback」を表示します。
辞書およびクエリフィードバックツール
このツールは、辞書フィードバックエントリとクエリフィードバックコントロールに対して別々のペインを表示します。
| エントリ | 説明 |
|---|---|
| ストップワード | 検索クエリのストップワードの削除に関連するフィードバックメッセージのリスト |
| スペルチェック | 検索クエリのタイポ処理自動修正に関連するフィードバックメッセージのリスト |
| 同義語 | 検索クエリの同義語拡張に関連するフィードバックメッセージのリスト |
| コントロール | 説明 |
|---|---|
| すべてのフィードバックを表示 | 検索クエリ用に生成されたフィードバックメッセージの JSON 配列を表示します。 |
| すべてのインテントデータを表示 | 検索クエリで検出された NLU モデルインテントの JSON 配列を表示します。 注: このツールを使用するには、代理操作ロールが必要です。 |
| デバッグ | 検索プレビュークエリを送信するときに sysparm_debug を true に設定するために、このオプションを有効にします。 注: このツールを使用するには、代理操作ロールが必要です。 |
コンテキスト設定ツール
これらのツールを使用すると、ユーザーコンテキスト値を指定して、結果改善ルールのユーザーコンテキストトリガーをテストできます。
| フィールド | 説明 |
|---|---|
| ユーザードメイン | 検索プレビューのユーザーコンテキストでドメインを設定するには、グループ [sys_user_group] テーブルからグループの名前を入力します。 |
| ユーザー会社 | 検索プレビューのユーザーコンテキストで会社を設定するには、会社 [core_company] テーブルから会社の名前を入力します。 |
| ユーザーオフィス | 検索プレビューのユーザーコンテキストでオフィスを設定するには、建物 [cmn_building] テーブルから建物の名前を入力します。 |
| ユーザー部門 | 検索プレビューのユーザーコンテキストで部門を設定するには、部門 [cmn_department] テーブルから部門の名前を入力します。 |
| ユーザーの役職 | 検索プレビューのユーザーコンテキストで役職を設定するには、リストから役職を選択します。このリストには、ユーザー [sys_user] テーブルにあるすべての役職値が含まれています。 |
| ユーザーの場所 | 検索プレビューのユーザーコンテキストで場所を設定するには、場所 [cmn_location] テーブルから場所の名前を入力します。 |
| ユーザーロール | 検索プレビューのユーザーコンテキストでロールを設定するには、ロール [sys_user_role] テーブルからロールの名前を入力します。 |
| ユーザーの国 | 検索プレビューのユーザーコンテキストで国を設定するには、リストから国を選択します。このリストには、ユーザー [sys_user] テーブルからのユーザーの場所で見つかったすべての国が含まれます。 |
| ユーザー言語 | 検索プレビューのユーザーコンテキストで言語を設定するには、サポート対象言語のリストから言語を選択します。 |
| ユーザーオフィスの国 | 検索プレビューのユーザーコンテキストでオフィスの国を設定するには、リストからそれを選択します。このリストには、ユーザー [sys_user] テーブルからのユーザーの場所で見つかったすべての国が含まれます。 |
| ユーザーオフィスの都市 | 検索プレビューのユーザーコンテキストでオフィスの都市を設定するには、オフィスの都市をこのフィールドに入力します。有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
| ユーザーオフィスの州 | 検索プレビューのユーザーコンテキストでオフィスの州を設定するには、このフィールドに入力します。有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
| ユーザー OS | 検索プレビューのユーザーコンテキストのオペレーティングシステムを設定するには、名前をこのフィールドに入力します。有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
| ユーザーデバイスタイプ | 検索プレビューのユーザーコンテキストでユーザーデバイスタイプを設定するには、このフィールドにそれを入力します、有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
| ユーザー OS バージョンタイプ | 検索プレビューのユーザーコンテキストのオペレーティングシステムのバージョンタイプを設定するには、このフィールドにそれを入力します。有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
| ユーザーブラウザーエージェント | 検索プレビューのユーザーコンテキストでブラウザエージェント文字列を設定するには、このフィールドにそれを入力します。有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
| ユーザーブラウザー | 検索プレビューのユーザーコンテキストでブラウザー名を設定するには、このフィールドにそれを入力します。有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
| ユーザーデバイスフォーム | 検索プレビューのユーザーコンテキストでデバイスフォームを設定するには、このフィールドにそれを入力します。有効にできます AI 検索のセッションデバッグ ユーザークエリのこのユーザーコンテキストフィールドに送信された値を確認します。 |
ユーザー代理操作ツール
| フィールド | 説明 |
|---|---|
| 検索基準 | 検索プレビュークエリを別のユーザーとして送信するには、ユーザー [sys_users] テーブルからユーザーの名前を入力します。代理操作ロールが必要です。 このコントロールを使用して、コンテンツセキュリティが特定のユーザーアカウントの検索クエリ結果にどのように影響するかを確認します。 別のユーザーの代理操作中に実行された検索は、 AI 検索 アナリティクスダッシュボードの「検索ユーザー」のメトリクス、傾向、およびレポートには影響しません。 注: このフィールドの値を変更すると、ais_high_security_admin ロールの昇格された権限が終了します。このフィールドの値を変更した後にフィルターをバイパスするには、ais_high_security_admin ロールに再度昇格する必要があります。 |
| クエリロケール | サポートされている特定の言語を使用して検索プレビュークエリを送信するには、リストから言語を選択します。 このコントロールを使用して、異なる言語の検索クエリ結果の違いを確認します。 |