Product Selector

Fusion 5.11
    Fusion 5.11

    Text Tagger Stage

    Table of Contents

    This stage uses the SolrTextTagger handler to identify known entities in the query by searching the COLLECTION_NAME_query_rewrite collection. See Manage Collections in the Fusion UI for more information.

    For Fusion 5.x.x organizations that do not have a Predictive Merchandiser license, the Solr Text Tagger handler also searches the COLLECTION_NAME_query_rewrite_staging collection in the case of the Fusion query rewriting Simulator).

    The purpose of the search is to perform query rewriting using matches from the following items:

    When the query rewrite entails boosting, the boosting is applied later in the pipeline, during the Solr Query stage.

    The below diagram shows the process flow for the Text Tagger Stage:

    Text Tagger Stage Process

    The underlying SolrTextTagger currently only supports single-shard collections. Fusion users should ensure their COLLECTION_NAME_query_rewrite collection, or whatever collection the Text Tagger stage is configured to use, is single-sharded before enabling this stage.
    Although this stage is available without a Fusion license, it is only effective after running Fusion jobs or creating Fusion rules. See Query Rewriting for details.

    Configuration

    When entering configuration values in the UI, use unescaped characters, such as \t for the tab character. When entering configuration values in the API, use escaped characters, such as \\t for the tab character.

    Queries a Solr text tagger request handler to perform spell correction, phrase boosting, and synonym expansion.

    skip - boolean

    Set to true to skip this stage.

    Default: false

    label - string

    A unique label for this stage.

    <= 255 characters

    condition - string

    Define a conditional script that must result in true or false. This can be used to determine if the stage should process or not.

    taggerCollectionId - string

    Collection to send the tagger request to; defaults to the query_rewrite collection for the application in context. Collection must contain only one shard, as the underlying Text Tagger in Solr doesn't currently support multi-shard collections. Supports template expressions.

    >= 1 characters

    paramToTag - string

    Name of the parameter in the request containing text to tag, defaults to 'q'. Ignored on DSL requests.

    Default: q

    taggedOutputParam - string

    Apply the matching tags to the 'paramToTag' value and set the parameter specified by this option; defaults to the value of the 'paramToTag' setting. Ignored on DSL requests.

    saveTagsInContextKey - string

    Save tags in context instead of applying directly to the incoming query in this stage; allows downstream stages to apply the tags after doing other processing. Ignored on DSL requests.

    spell_corrections_enabled - boolean

    If checked, then this stage will perform spell corrections on the incoming query.

    Default: true

    phrase_boosting_enabled - boolean

    If checked, then this stage will perform phrase boosting on the incoming query.

    Default: true

    synonym_expansion_enabled - boolean

    If checked, then this stage will perform synonym expansion on the incoming query.

    Default: true

    remove_words_enabled - boolean

    If checked, then this stage will perform applicable Remove Words rewrites on the incoming query.

    Default: true

    tail_rewrites_enabled - boolean

    If checked, then this stage will perform tail rewrites on the incoming query.

    Default: true

    filterOverride - string

    Use this option to override filtering for built-in tagger doc types with your own filter.

    synonymExpansionBoost - number

    Boost applied to the original term when doing synonym expansion; set to -1 to disable this behavior.

    Default: 2

    phraseBoost - number

    Default boost to be applied to phrases that don't have a boost set; set to -1 to disable this behavior.

    Default: 2

    phraseSlop - integer

    Default phrase slop to be applied to detected phrases.

    Default: 10

    overlaps - string

    Choose the algorithm to determine which tags in an overlapping set should be retained, versus being pruned away. Ignored on DSL requests (longest_dominant_right is always used). The available options correspond to Solr Tagger Handler overlaps: all, no_sub, longest_dominant_right; defaults to longest_dominant_right, which ensures the retained tags have no overlaps. Setting this to all or no_sub allows more rewrites to potentially be applied to a query, but can increase the chance of producing undesirable rewrites.

    Default: longest_dominant_right

    Allowed values: longest_dominant_rightallno_sub

    params - array[object]

    object attributes:{key required : {
     display name: Parameter Name
     type: string
    }
    value : {
     display name: Parameter Value
     type: string
    }
    }

    maxWaitMs - integer

    Max time to wait for call to remote tagger collection to return; set to -1 to disable.

    Default: 500

    skipQueryRegex - string

    Pattern to find queries to skip matching on, such as single term queries with wildcards.