Rule - Action Mapping form

  • Release version: Xanadu
  • Updated March 28, 2025
  • 3 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 Rule - Action Mapping form

    The Rule - Action Mapping form in ServiceNow defines the relationships between AI Search result improvement rules and boost actions. It is used to link boost actions to result improvement rules, enabling tailored relevancy adjustments in search results.

    Show full answer Show less

    Key Features

    • Label: Unique identifier for each boost action.
    • Type: Automatically set to "Boost Action" to specify the action type.
    • Application: Automatically set to the current application's scope.
    • Order: Determines the sequence of evaluation for boost actions within a result improvement rule.
    • Boost Type: Specifies how the boost is applied, including:
      • Boost All Documents In Indexed Source: Applies relevancy boost to all search results from a selected indexed source.
      • Boost By User Context (dynamic): Applies boost based on matching a searcher's dynamic user context field.
      • Boost By Field Match (static): Applies boost when a search result field matches a specified static value.
    • Indexed Source: References the specific indexed source for which the boost action applies.
    • Boost Weight: An integer value that modifies the relevancy score of affected search results. Positive values increase relevancy, while negative values decrease it. For example:
      • A boost weight of 100 increases relevancy by 10% (e.g., a score of 60 becomes 66).
      • A boost weight of -150 decreases relevancy by 15% (e.g., a score of 100 becomes 85).
      • Multiple boosts are additive, allowing cumulative relevancy adjustments.
    • Field Name and Matching Values: When using dynamic or static boost types, specify the field in the indexed source to evaluate and the matching values:
      • When field: The indexed source field to compare.
      • Matches field: For dynamic boosts, selects which user context element to compare.
      • Contains field: For static boosts, specifies the static value to match.

    Practical Use for ServiceNow Customers

    By configuring the Rule - Action Mapping form, you can precisely control how AI Search boosts relevancy for search results based on indexed sources, user context, and specific field matches. This enables more relevant and personalized search experiences within your ServiceNow environment, helping users find the most pertinent information faster.

    Adjusting boost weights allows you to fine-tune search result rankings, enhancing or diminishing the visibility of results as needed. The ability to combine multiple boost actions provides flexibility to address complex relevancy scenarios.

    The Rule - Action Mapping form contains information about relationships between AI Search result improvement rules and boost actions. Use this form when linking boost actions to result improvement rules.

    For information on configuring boost actions in result improvement rules, see Boost search results using a result improvement rule.

    Table 1. Rule - Action Mapping form
    Field Description
    Label Unique label for the boost action.
    Type Action type. This field is automatically set to Boost Action.
    Application Application scope for the boost action. This field is automatically set to the name of the current application.
    Order Order of evaluation for the boost action in the context of the result improvement rule.
    Boost Action
    Boost Type Type of boost the action applies to search results from the selected indexed source.
    Supported types include:
    • Boost All Documents In Indexed Source: Applies relevancy boost to every search result from the indexed source.
    • Boost By User Context (dynamic): Applies relevancy boost to search results from the indexed source if they include a value for the selected field that matches a field value specified in the dynamically populated user context.
    • Boost By Field Match (static): Applies relevancy boost to search results from the indexed source if they include a value for the selected field that matches a specified static value.
    Indexed Source Reference to an indexed source. The boost action only applies to search results for records from this indexed source.
    Boost Weight Integer value that AI Search uses to alter the relevancy scores for search results affected by the boost action. Boost weights can be positive or negative.

    Positive boost weights increase the relevancy scores for boosted search results. Each boost weight of 1 increases a boosted search result's relevancy score by 0.1% of its original value. For example, if you set a boost weight of 100, you increase each boosted search result's relevancy by +10%, so a search result with an original relevancy score of 60 gets a final relevancy score of 66. Setting a boost weight of 1000 adds +100%, doubling the relevancy scores for boosted search results.

    Negative boost weights reduce the relevancy scores for boosted search results. Each boost weight of –1 reduces a boosted result's relevancy score by 0.1% of its original value. As an example, if you set a boost weight of –150, you reduce a boosted search result's relevancy by 15%, so a search result with an original relevancy score of 100 gets a final relevancy score of 85. Any boost weight of –1000 or lower reduces a boosted search result's relevancy score to 0, causing it to appear at the end of the search result list.

    When a single search result is affected by multiple boost actions, AI Search adds the individual boost weights together to determine the total relevancy score modifier. For example, a search result boosted by three rules with boost weights 100, 150, and –25 has a total boost weight of 225, increasing its final relevancy score by 22.5% of its original value.

    When Name of a field from the selected indexed source. This field appears only when you select Boost By User Context (dynamic) or Boost By Field Match (static) as the boost type.
    Matches the Searcher's Dynamically populated user context element to compare with a search result's value for the field selected in the When field. This field appears only when you select Boost By User Context (dynamic) as the boost type.

    The choice list displays the source table and field for each user context element. As an example, the Language user context element is populated using the User [sys_user] table's language field value for the search user.

    Contains Static value to compare with a search result's value for the field selected in the When field. This field appears only when you select Boost By Field Match (static) as the boost type.