Intent Mapping Priority - Cognigy Documentation

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

Updated in 4.43 The Intent Mapping Priority feature helps avoid ambiguity between parent and child Intents, which can occur when user input matches both. With the Intent mapping priority, you can choose whether to prioritize the parent Intent or its child Intents. This approach allows you to control which Intent is more likely to be selected. For better accuracy, use full sentences when creating example phrases for Intents.

Key Benefits

• Enhanced Accuracy in Intent detection. By setting priorities, you can guide the system to focus on either parent or child Intents as desired.
• Flexible customization. Adjust mapping behavior to suit specific use cases, ensuring the right Intent is triggered.

Prerequisites

Before using this feature, ensure the following:

• A Flow is created or available in your Project.
• Parent and child Intents are defined in NLU > Intents.

Restrictions

• This feature works best with full-sentence Intent examples. Single words or short phrases may lead to inaccurate mapping results.

How to Use

To set a priority, follow these steps:

1. Open an Intent in NLU > Intents.
2. In the Intent Mapping Priority field, select one of the following options:

• Prioritise This Intent — set a priority for the current parent Intent. By default, this option is set up.
  • Prioritise Child Intents — set a priority for child Intents.

3. Save changes and click Build model. Build a model every time you want to apply your changes to the NLU model.

Examples

Assume that you have the following Intent data:

Consider various examples of how each option of the Intent Mapping Priority setting works.

Prioritise This Intent

Set up Prioritise This Intent for the parent Intent.
User input: I want to order a bacon pizza
Result: intent: Order Pizza, intent score: 0.33
JSON example of object stored in the nlu.intentMapperResults.scores array:

"scores": [\
        {\
          "id": "6262e9e7-9dc5-4146-9153-96ef0693c18f",\
          "name": "Order Pizza",\
          "score": 0.3363160895380178,\
          "negated": false,\
          "confirmationSentence": null,\
          "confirmationSentences": null,\
          "disambiguationSentence": null,\
          "flow": "898601c7-c5db-44f3-bfa0-bce265af02ad"\
        }\
      ]

Prioritise Child Intents

Set up Prioritise Child Intents for the parent Intent.
User input: I want to order a bacon pizza
Result: intent: Order Ham Pizza, intent score: 0.63
JSON example of object stored in the nlu.intentMapperResults.scores array:

"scores": [\
        {\
          "id": "8bba4b5a-1166-4459-bd1c-9e8b5391727e",\
          "name": "Order Ham Pizza",\
          "score": 0.6494886591790712,\
          "negated": false,\
          "confirmationSentence": null,\
          "confirmationSentences": null,\
          "disambiguationSentence": null,\
          "flow": "898601c7-c5db-44f3-bfa0-bce265af02ad"\
        },\
        {\
          "id": "c16f7afc-2875-49dc-8d7a-e06629d7fef9",\
          "name": "Order Cheese Pizza",\
          "score": 0.24775283391091624,\
          "negated": false,\
          "confirmationSentence": null,\
          "confirmationSentences": null,\
          "disambiguationSentence": null,\
          "flow": "898601c7-c5db-44f3-bfa0-bce265af02ad"\
        }\
      ]

More Information

• Overview
• Inheritance Mechanism
• Intents

Last modified on April 21, 2026