AI Search Genius Result Configuration form
Summarize
Summary of AI Search Genius Result Configuration form
The AI Search Genius Result Configuration form enables ServiceNow customers to create and manage Genius Result configurations that enhance AI Search profiles. These configurations define custom conditions and scripts to trigger specialized search results, improving the relevance and presentation of AI Search answer cards.
Show less
Key Features
- Name: Assign a name to identify the Genius Result configuration.
- Trigger condition: Defines when the Genius Result activates. Options include:
- Always: Triggers for every search query.
- NLU: Triggers when the search intent matches a linked, published NLU model intent.
- Term: Triggers on exact matches of specified query terms in order.
- Term: Specifies the exact query term that triggers the configuration (visible only if 'Term' trigger is selected).
- Application: Automatically sets the scope for the configuration.
- Active status: Enables or disables the Genius Result configuration.
- Processor script template: Provides sample server-side JavaScript to help develop custom request or response processor scripts.
- AI Search request processor: Server-side script that generates a modified search query using GeniusResultContext and returns a GeniusResultAnswer with up to three results to display as Genius Result answer cards. Required if no response processor is defined.
- AI Search response processor: Server-side script that runs after AI Search computes results, returning key-value data maps for customizable display on Genius Result answer cards. Required if no request processor is defined.
- Return fields: Specifies which fields from the GeniusResultAnswer object to display on the answer card. Mandatory if a response processor is used; otherwise, default AI Search index fields display automatically, with optional additional fields allowed.
Practical Application and Benefits
ServiceNow customers can leverage the AI Search Genius Result Configuration form to tailor AI Search outputs precisely to their organizational needs by:
- Triggering specialized search results based on query conditions or natural language intents.
- Customizing the search queries sent to the AI Search backend for refined results.
- Designing how results appear in answer cards through custom data mappings and selected display fields.
- Activating or deactivating configurations as needed to manage search experience dynamically.
This flexibility helps enhance search relevance, user satisfaction, and efficiency in finding critical information within ServiceNow.
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.
| Field | Description |
|---|---|
| Name | Name for the Genius Result configuration. |
| Trigger condition | Condition that triggers evaluation of the Genius Result configuration.
Supported values:
|
| 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:
|