Result improvement rules
Summarize
Summary of Result improvement rules
Result improvement rules in ServiceNow Yokohama release enable you to customize search results by defining rules with trigger conditions that boost, block, or promote specific search results. These rules can target searches based on query terms, user context (such as country, OS, or device type), and language. They override the default AI Search relevancy and result ordering to tailor the search experience for your users.
Show less
Rule Structure and Conditions
Each result improvement rule consists of:
- Activation conditions: including a date range, language, and optional trigger conditions based on query keywords, full query, or user context attributes (like department or browser version). All trigger conditions must be met for the rule to activate.
- Actions: a single action type per rule—either boost, block, or promote—with one or more actions of that type.
Action Types
- Boost: increases relevancy scores for results from specified indexed sources, which can be dynamically matched to user context, static values, or synonyms from dictionaries.
- Block: excludes specified results from the search results list, taking precedence over other actions.
- Promote: places specific results at the top of the results list.
Language and Search Feature Interaction
Rules are language-dependent and must be configured per language activated in your instance. They integrate with other search features as follows:
- Query terms modified by lemma or Unicode normalization can trigger rules.
- Stop words are evaluated against triggers before removal.
- Synonym expansions can activate rules unless the "Expand Synonyms For Query Conditions" option is disabled.
- Auto-corrected (typo-handled) terms can trigger rules.
Practical Uses for ServiceNow Customers
- Create rules to dynamically adjust relevancy, exclude unwanted results, or highlight important records based on precise conditions.
- Boost search results to promote content most relevant to specific user contexts or queries.
- Block results to filter out irrelevant or sensitive documents, including blocking Genius Results.
- Promote results to ensure critical content appears first in search results.
- Share rules across search profiles to maintain consistent search experiences in different parts of your ServiceNow instance.
Define rules with configurable trigger conditions to boost, block, or promote search results for specific searches. You can also boost search results for documents matching elements of the user context, such as a user's country, OS, or device type.
Result improvement rules with boost actions override the default search result order produced by the AI Search machine learning relevancy feature. Rules with block or promote actions override the default result set for a search query.
Rule structure
- A set of conditions that determine when the rule activates.
- A set of boost, block, or promote actions that determine how the rule modifies the search query's results when activated. The rule can only include actions of a single type, but can include multiple actions of that type.
- A date range bounded by start and end dates. The rule can only activate during the specified date range.
- A language. The rule can only activate if this language matches the search query's language.
- Optionally, a set of one or more trigger conditions. Triggers can operate on individual search query keywords, the full search query, or elements of the search user's context such as their department, language, or browser version. The rule can only activate if all of its trigger conditions are met.
- Boost: Increase the relevancy scores for search results from an indexed source that satisfy your specified conditions. You can select any of the following options:
- Boost relevancy for all search results from the indexed source.
- Boost relevancy for search results from the indexed source that include field values matching a dynamically populated value from the user context.
- Boost relevancy for search results from the indexed source that include field values matching a static string value that you specify.
- Boost relevancy for search results from the indexed source that include field values matching synonyms from one of your synonym dictionaries.
- Block: Exclude specific results from the search query's results list.
- Promote: Display specific results at the start of the search query's results list.
Block actions take precedence over other actions. For example, if two result improvement rules block and promote the same search result, AI Search excludes the search result from the search query's results list.
Language dependence
Result improvement rule activation is language-dependent. You specify a language for each result improvement rule.
AI Search supports result improvement rules for all languages activated in your instance. For the list of languages you can activate, see Activate a language.
Interaction with other search features
The following table describes interactions between result improvement rules with Query triggers and other search features.
| Feature | Interaction with result improvement rules |
|---|---|
| Lemma and Unicode normalization | A search query term added by lemma or Unicode normalization can trigger a result improvement rule if it matches the rule's Query trigger. |
| Stop words | If a search query term that matches a result improvement rule's Query trigger is defined as a stop word, AI Search evaluates the rule trigger before removing the stop word from the search query. |
| Synonyms | By default, a synonym expansion term can activate a result improvement rule if it matches the rule's Query trigger. You can prevent synonym expansion terms from activating a rule with a Query trigger by clearing the Expand Synonyms For Query Conditions option that appears when you define the Query trigger. |
| Typo handling | An auto-corrected search query term can trigger a result improvement rule if it matches the rule's Query trigger. |