NLQ Genius 結果回答カードのナビゲーションアクションの構成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：6分

    • ユーザーが NLQ Genius 結果アクションカードで [テーブル全体を表示] を選択したときにトリガーされるナビゲーションアクションを構成します。各ナビゲーションアクションにはリダイレクトペイロードが含まれており、オプションでテーブルの名前、テーブルを返した NLQ ソース、または検索アプリケーションで使用される検索プロファイルのフィルターを含めることができます。

    始める前に

    必要なロール：ais_admin

    このタスクについて

    NLQ Genius 結果回答カードで [テーブル全体を表示] を選択した場合、実行されるアクションは、一致するテーブルがどのように見つかったかによって異なります。デフォルトのアクションは次のとおりです。
    • アナリティクスセンターテーブルクエリによって見つかったテーブルの場合、テーブルはリストビューに表示されます。
    • CMDB テーブルクエリによって見つかったテーブルの場合、CMDB ワークスペースが開きます。

    検索アドミニストレーターは、NLQ Genius 結果回答カードに使用できるアクションをカスタマイズできます。

    手順

    1. AI 検索 NLQ ナビゲーション [ais_nlq_navigation] テーブルのリストビューに移動します。
      1. [すべて] を選択します。
      2. [フィルター] フィールドで、「ais_nlq_navigation.list」と入力します。
      3. Enter を押します。
    2. 既存のナビゲーションレコードを編集するか、[新規] を選択して新しいナビゲーションレコードを作成します。
    3. AI 検索 NLQ ナビゲーションフォームで、ナビゲーションアクションのフィールドを入力します。
      フィールド 説明
      ソース

      ナビゲーションアクションのオプションの NLQ ソースフィルター。アクションは、このソースフィルターを満たすテーブルに対してのみ動作します。

      このフィールドを空のままにすると、ナビゲーションアクションは、別のナビゲーションアクションの [ソース] フィールドで指定されていない NLQ ソースのテーブルに対して動作します。

      たとえば、2 つのナビゲーションアクションがあるとします。1 つは [ソース] が CMDB_WS に設定され、もう 1 つには [ソース] フィールド値がありません。
      • NLQ Genius 結果回答カードが CMDB NLQ ソースから返されたテーブルをプレビューするときに、[テーブル全体を表示] を選択すると、テーブル名がアクションの NLQ ソースフィルターを満たすため、最初のナビゲーションアクションがトリガーされます。
      • NLQ Genius 結果回答カードが アナリティクスセンター NLQ ソースからのテーブルをプレビューしている場合、[テーブル全体を表示] を選択すると、そのテーブルの NLQ ソースが最初のアクションの NLQ ソースフィルターを満たしていないため、代わりに 2 番目のナビゲーションアクションがトリガーされます。
      • タイプ：文字列
      • デフォルト値：なし
      • サポートされている値は次のとおりです。
        • AC：ナビゲーションアクションは、アナリティクスセンター NLQ ソースから返されたテーブルに対してのみ動作します。
        • CMDB_WS：ナビゲーションアクションは、CMDB NLQ ソースから返されたテーブルに対してのみ動作します。
      アクションペイロード

      ナビゲーションアクションの JSON ペイロード。このフィールドの値は、NLQ Genius 結果回答カードで [テーブル全体を表示] を選択したときに AI 検索 がリダイレクトする場所を決定します。

      リダイレクトするために JSON ペイロードを送信するときに、AI 検索は次の参照を適切な値に置き換えます。
      • ${logID}：システムログに示される NLQ トランザクションの ID に置き換えられます。
      • ${query}：NLQ Genius 結果をトリガーした元の検索クエリのクエリフィルターに置き換えられます。
      • ${table}：NLQ Genius 結果回答カードでプレビューされるテーブルの名前に置き換えられます。
      • ${utterance}：NLQ Genius 結果をトリガーした元の検索クエリに置き換えられます。
      たとえば、CMDB ワークスペースでテーブルを開くデフォルトのナビゲーションアクションでは、これら 4 つの参照をすべて使用するこのアクションペイロードを指定します。
      { "external": { "url": "now/cmdb/home/sub/smart-search-results/${table}/${utterance}/params/encoded-query/${query}/nlq-query-log/${logID}", "target": "_self" } }
      • タイプ：JSON
      • デフォルト値：なし
      プロフィール

      検索プロファイルレコードへのオプションの参照。ナビゲーションアクションは、参照された検索プロファイルを使用する検索アプリケーションでのみ動作します。

      このフィールドを空のままにすると、別のナビゲーションアクションの [プロファイル] フィールドで参照される検索プロファイルを使用しない検索アプリケーションに対して、ナビゲーションアクションが動作します。

      たとえば、2 つのナビゲーションアクションがあるとします。1 つは サービスポータル Default Search Profile レコードを参照する [プロファイル] があり、もう 1 つには [プロファイル] 参照フィールド値がありません。
      • サービスポータルのデフォルトサービスプロファイルを使用するアプリケーションで検索する場合、NLQ Genius 結果回答カードで [テーブル全体を表示] を選択すると、最初のナビゲーションアクションがトリガーされます。これは、使用中の検索プロファイルがアクションで参照されるためです。
      • 他の検索アプリケーションで検索する場合、[テーブル全体を表示] を選択すると、使用中の検索プロファイルは最初のナビゲーションアクションで参照されていないため、代わりに 2 番目のナビゲーションアクションがトリガーされます。
      • タイプ：参照
      • デフォルト値：なし
      アクション

      ナビゲーションアクションの名前。

      • タイプ：文字列
      • デフォルト値：なし
      テーブル

      ナビゲーションアクションのオプションのテーブルフィルター。アクションは、名前がこのフィルターに一致するテーブルに対してのみ動作します。

      このフィールドを空のままにすると、ナビゲーションアクションは、別のナビゲーションアクションの [テーブル] フィールドで名前が指定されていないテーブルに対して動作します。

      たとえば、2 つのナビゲーションアクションがあるとします。1 つは [テーブル] が my_custom_table に設定され、もう 1 つには [テーブル] フィールド値がありません。
      • NLQ Genius 結果回答カードがカスタムテーブルをプレビューするときに、[テーブル全体を表示] を選択すると、テーブル名がアクションのテーブルフィルターを満たすため、最初のナビゲーションアクションがトリガーされます。
      • NLQ Genius 結果回答カードがその他のテーブルをプレビューする場合、[テーブル全体を表示] を選択すると、テーブル名が最初のアクションのテーブルフィルターを満たしていないため、代わりに 2 番目のナビゲーションアクションがトリガーされます。
      • タイプ：table_name
      • デフォルト値：なし
    4. 既存のナビゲーションアクションレコードを編集する場合は [更新] を選択し、新しいレコードを作成する場合は [送信] を選択します。