AI Search Genius Result Configuration form
Summarize
Summary of AI Search Genius Result Configuration
The AI Search Genius Result Configuration form is essential for defining and managing Genius Result configurations linked to your search profiles in ServiceNow's AI Search. This form is used for both creating new configurations and modifying existing ones, enabling efficient search result management tailored to user queries.
Show less
Key Features
- Name: Assign a unique name for the Genius Result configuration.
- Trigger Condition: Specify when the configuration activates. Options include:
- Always: Triggers on every search query.
- NLU: Activates when the search query matches an NLU model intent (requires linking to an NLU model).
- Term: Triggers for exact matches of specified query terms.
- Application: Automatically set application scope for the configuration.
- Active: Option to activate or deactivate the configuration.
- Processor Script Template: Provides a sample server-side script for request and response handling.
- AI Search Request Processor: Script that processes the search query and returns search results.
- AI Search Response Processor: Script to define key-value pairs for display on Genius Result answer cards.
- Return Fields: Comma-separated list of fields to display on the answer card, which can include standard AI Search index fields.
Key Outcomes
By effectively configuring the AI Search Genius Result options, customers can enhance search experiences through tailored results based on user queries. This leads to improved search accuracy, user satisfaction, and overall efficiency in accessing information within the ServiceNow platform.
The AI Search Genius Result Configuration form contains information about Genius Result configurations defined for your search profiles in AI Search. Use this form when creating or modifying a Genius Result configuration.
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:
|