Product Selector

Fusion 5.12
    Fusion 5.12

    Synonym Query Rewrite API ConfigurationsFusion Query Rewrite API

    Table of Contents

    This query rewrite configuration is used in the Query Rewrite API.

    For a complete list of rule and rewrite types in the Query Rewrite API, see Query Rewrite API Configurations.

    Synonym

    The Synonym Detection feature generates pairs of synonyms and pairs of similar queries. Two words are considered potential synonyms when they are used in a similar context in similar queries. A query that contains a matching term is expanded to include all of its synonyms, with the original term boosted by a factor of two.

    For more information, see Synonym detection.

    General information

    • Endpoint: https://FUSION_HOST:FUSION_PORT/api/apps/APP_NAME/query-rewrite/schema/RULE_TYPE

    • Required parameters are:

      • surface_form

      • mappings

      • type

    • The values for the hints parameter include:

      • hidden: Do not display in the Fusion UI, but can be read and written in the schema.

      • readonly: Cannot be set by the user. If attempted, an error is generated and the operation fails.

    Parameter Schema

    type

    type

    string

    properties

    confidence

        "confidence": {
          "type": "number",
          "title": "Confidence",
          "description": "Confidence score from the synonym job.",
          "default": 1.0
        }
    ----

    id

        "id": {
          "type": "string",
          "title": "ID",
          "description": "The ID for this Rule. Used in the API to reference this query rewrite rule. Allowed characters: a-z, A-Z, 0-9, dash (-) and underscore (_)",
          "maxLength": 128,
          "pattern": "^[A-Za-z0-9_\\-]+$"
        }

    source

        "source": {
          "type": "string",
          "title": "Source",
          "description": "The source for this query rewrite rule, such as a Spark Job.",
          "hints": [
            "hidden"
          ]
        }

    sourceType

        "sourceType": {
          "type": "string",
          "title": "Source Type",
          "description": "Source type",
          "hints": [
            "hidden"
          ]
        }

    createdOn

        "createdOn": {
          "type": "string",
          "title": "Created Date/Time",
          "description": "Date/Time this rule was created.",
          "format": "date-time"
        }

    updatedOn

        "updatedOn": {
          "type": "string",
          "title": "Updated Date/Time",
          "description": "Date/Time this rule was last updated.",
          "format": "date-time"
        }

    reviewer

        "reviewer": {
          "type": "string",
          "title": "Reviewer",
          "description": "Who reviewed this rewrite rule.",
          "hints": [
            "hidden"
          ]
        }

    reviewedOn

        "reviewedOn": {
          "type": "string",
          "title": "Reviewed Date/Time",
          "description": "Date/Time this rule was last reviewed.",
          "hints": [
            "hidden"
          ],
          "format": "date-time"
        }

    review

        "review": {
          "type": "string",
          "title": "Review",
          "enum": [
            "approved",
            "denied"
          ],
          "default": "approved",
          "hints": [
            "readonly"
          ]
        }

    deployed

        "deployed": {
          "type": "boolean",
          "title": "Deployed Flag",
          "description": "Flag to indicate if this rewrite rule has been deployed.",
          "hints": [
            "hidden"
          ]
        }

    tags

        "tags": {
          "type": "array",
          "title": "Tags",
          "description": "Conditional tags to restrict the triggering of this query rewrite rule.",
          "items": {
            "type": "string"
          }
        }

    surface_form

    Required

        "surface_form": {
          "type": "string",
          "title": "Surface Form",
          "description": "The term that has synonyms."
        }

    count

        "count": {
          "type": "integer",
          "title": "Count",
          "description": "How many times this term occurred in the signal data when it was discovered"
        }

    mappings

    Required

        "mappings": {
          "type": "array",
          "title": "Synonym Mappings",
          "description": "Synonyms for the surface form.",
          "items": {
            "type": "object",
            "properties": {
              "synonym": {
                "type": "string",
                "title": "Synonym"
              },
              "context": {
                "type": "string",
                "title": "Context"
              },
              "direction": {
                "type": "string",
                "title": "Direction",
                "enum": [
                  "oneway",
                  "symmetric"
                ]
              },
              "similarity": {
                "type": "number",
                "title": "Similarity"
              },
              "count": {
                "type": "integer",
                "title": "Count"
              },
              "category": {
                "type": "string",
                "title": "Category",
                "enum": [
                  "context",
                  "synonym",
                  "misspelling",
                  "acronym"
                ]
              },
              "suggestion": {
                "type": "string",
                "title": "Suggestion",
                "enum": [
                  "context",
                  "pair"
                ]
              }
            }
          }
        }

    type

    Required

        "type": {
          "type": "string",
          "title": "Type",
          "enum": [
            "synonym"
          ],
          "default": "synonym",
          "hints": [
            "readonly"
          ]
        }

    doc_type

        "doc_type": {
          "type": "string",
          "title": "Doc Type",
          "enum": [
            "query_rewrite"
          ],
          "default": "query_rewrite",
          "hints": [
            "readonly"
          ]
        }
      }

    additionalProperties

    additionalProperties

    "additionalProperties": true