AI Search Genius Result Configuration form

  • Release version: Zurich
  • Updated July 31, 2025
  • 4 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of AI Search Genius Result Configuration form

    The AI Search Genius Result Configuration form in ServiceNow enables you to create and manage Genius Result configurations for AI Search profiles. These configurations determine when and how special "Genius Result" answer cards are triggered and displayed in response to user search queries, enhancing search relevance and user experience.

    Show full answer Show less

    Key Features

    • Name: Assign a unique name to each Genius Result configuration for easy identification.
    • Trigger condition: Define when the configuration activates, with these options:
      • Always: Triggers on every search query.
      • NLU: Triggers when the search query's intent matches a linked Natural Language Understanding (NLU) model intent. Note that the NLU model must be published and linked to the configuration.
      • Term: Triggers only when the search query exactly matches specific query terms in the specified order.
    • Term: Specify the exact search term that triggers the configuration when using the Term trigger condition.
    • Application: Automatically set scope for the Genius Result configuration.
    • Active: Option to activate or deactivate the configuration; inactive configurations do not trigger.
    • Processor script template: Provides a sample server-side script template as a starting point for your request or response processor scripts.
    • AI Search request processor: A server-side script that generates a search query from the triggering query. It must return a GeniusResultAnswer object containing up to three results to display as Genius Result cards. This script runs before AI Search processes the query and is required if the response processor script is not used.
    • AI Search response processor: A server-side script that runs after AI Search processes the query. It returns a GeniusResultAnswer object with key-value pairs that define fields to display on the Genius Result answer card. This script is required if the request processor script is not provided.
    • Return fields: A comma-separated list of field names to display on the Genius Result answer card. Required if using a response processor script, otherwise defaults to common AI Search index fields with optional additions.

    Practical Application for ServiceNow Customers

    By configuring Genius Result configurations, you can tailor AI Search outcomes to trigger special result cards based on specific conditions, such as exact terms or detected user intent via NLU models. This allows you to surface the most relevant information prominently, improving user search satisfaction and efficiency.

    Use the processor scripts to customize how Genius Results queries are generated and how answer data is formatted for display. The flexibility in trigger conditions and field display options helps you align AI Search results with your organization's knowledge and operational needs.

    The AI Search Genius Result Configuration form enables you to create a Genius Result configuration for use in your AI Search search profiles.

    For details on creating or editing a Genius Result configuration, see Create a Genius Result configuration.

    Table 1. AI Search Genius Result Configuration form
    Field Description
    Name Name for the Genius Result configuration.
    Trigger condition Condition that triggers evaluation of the Genius Result configuration.
    Supported values:
    • Always: The Genius Result configuration triggers for every search query.

    • NLU: The Genius Result configuration triggers when the search query's detected intent matches an NLU model intent. To use this trigger condition, you must link the NLU model and one or more of its intents to your Genius Result configuration. For instructions, see Link an NLU model and intents to a Genius Result configuration.

      Note:

      For an NLU trigger condition to function, the NLU model must be published. You can verify NLU model status by navigating to All > AI Search > Search Query Settings > Search Intents.

    • Term: The Genius Result configuration triggers when the search query exactly matches a specified set of query terms.
      Note:
      Exact matching means that the search query must contain only the specified terms in the specified order. For example, if you define conference room as the trigger term, a search for conference room triggers the Genius Result condition but searches for hotel conference room or room conference don't trigger it.
    Term Term that triggers the Genius Result configuration when it exactly matches the search query. This field appears only when you select Term from the Trigger condition field.
    Application Application scope for the Genius Result configuration. This field is automatically set.
    Active Option to activate the Genius Result configuration. Inactive Genius Result configurations never trigger.
    Processor script template Sample server-side script function. Use the code displayed in this field as a basis for your AI Search request processor and AI Search response processor scripts. This field is automatically set.
    AI Search request processor Server-side script function that takes a GeniusResultContext object as its parameter. The function must return a GeniusResultAnswer object that contains a search query. Up to three results from this search query display as Genius Result answer cards.
    Note:
    This field is required if AI Search response processor isn't populated. You can copy the code from the Processor script template to use as a starting point for your script function.

    When a search query triggers the Genius Result configuration, the system executes this script and then sends both the triggering search query and the scripted search query to the AI Search back end for computation of search results.

    To define a search query, use the GeniusResultAnswer.setTable(), GeniusResultAnswer.addSearchPhrases(), and GeniusResultAnswer.setSearchPhrase() API methods.

    For details of API methods usable in this script function, including examples of use, see the GeniusResultAnswer and GeniusResultContext scoped JavaScript API descriptions.
    Note:
    The GeniusResultContext.getMatchingDocuments() API method returns no results when invoked in an AI Search request processor script, since the script is executed before AI Search computes results for the triggering search query. Don't use this method in your request processor scripts.
    AI Search response processor Server-side script function that takes a GeniusResultContext object as its parameter. The function must return a GeniusResultAnswer object that defines one or more maps of key-value pairs. You can display these key-value pairs on the Genius Result answer card by specifying them as Return fields.
    Note:
    This field is required if AI Search request processor isn't populated. You can copy the code from the Processor script template to use as a starting point for your script function.

    When a search query triggers the Genius Result configuration, the system executes this script after AI Search computes search results.

    To define your map of key-value pairs, use the GeniusResultAnswer.addDataMap() API method. Each key-value pair represents a field name and value that you can display on the Genius Result answer card using the Return fields list.

    For details of API methods usable in this script function, including examples of use, see the GeniusResultAnswer and GeniusResultContext scoped JavaScript API descriptions.
    Return fields Comma-separated list of fields to display on the Genius Result answer card. This field is required if AI Search response processor is populated.
    Behavior depends on which processor script field is populated:
    • If AI Search response processor is populated, you must use this field to specify the names of fields defined in your GeniusResultAnswer response object that you want to display on the Genius Result answer card.
    • If AI Search response processor isn't populated, the Genius Result answer card automatically displays the common AI Search index fields:
      • ai_search_parent_title
      • ai_search_teaser_text
      • ai_search_teaser_title
      • record_class_name
      • sys_id
      • table

      You can optionally use this field to specify any additional AI Search index fields that you want to display for search results shown on the Genius Result answer cards.

      To view the list of AI Search index fields, see AI Search index fields.