Skip to content

Machine learning Intents

Intents are collections of identified user intents (e.g. what does the user want).

The user input is scored against all example sentences and Cognigy.AI will identify the intent with the highest score as the intent for this input if it is above the configured thresholds.

Building the NLU Model

The building menu is available under the "NLU" tab in the flow editor. Any Flow that requires building of their NLU model will display a red indicator next to its name in the list of Flows and on the NLU tab in the flow editor.

Flows that are only processed as an attached Flow do not need to be individually built (the exclamation mark can be ignored) as the building of the attaching Flow will pull in the Intents of the attached Flows and the Build will be done there. Flows that are used separately with intent mapping need to be built separately.

Cognigy NLU requires pre-building of the intent mapping model.

To build your model go to the Intents tab in your Flow Editor and click the blue Build Model button.

A new Task will begin and the spinning task icon indicates model building is in progress. While new models are built the latest version of your flow will fall back to the most recently trained model.

Successful builds are indicated with a green success notification. It is possible that builds may fail, this will be indicated by a red error notification. Expand the error message to learn more, for example, you may have to add more example sentence data to complete the build successfully.

Any time adjustments are made to the model data, the NLU model must be rebuilt to incorporate the changes. The following actions also trigger the need to build the model (the red exclamation point next to the Build Model icon will appear):

  • creating, editing and deleting an intent
  • attaching a Lexicon
  • editing a Lexicon
  • attaching and detaching a Flow

Quick Build

Version badge

When clicking the arrow on the Build Model button, a Quick Build option can be selected. This option will build a machine learning model for your intents which doesn't contain specifications for States and Intent Conditions and is thus significantly faster in building your model.

If you're not using States or Intent Conditions, the training speed (as in the time it takes for Cognigy.AI to build the model after you clicked the button) and quality of the model will be the same whether you use the regular Build Model or Quick Build options.

Example Sentences

This is where creators are given the power to add unique levels of customized understanding to virtual agents which enable them to react intelligently to any message received by an end user.

Even though each Intent can have up to 2000 example sentences, we recommend a minumum of 5 and a maximum of 100. These sentences should be a broad range of possible user inputs that are expected to activate the Intent. Building a comprehensive example sentence list is a critical step in the process of building a smart AI service.

When entering the example sentences you can use the ENTER key to go to the next NLU example sentence field.

Machine Learning Intents: Example Sentences
Avoid Repetition

Rather than writing similar sentences for different entity names i.e. I want to order Pizza, I want to order Pasta... build and attach a Lexicon to the flow that can be Annotated into your sentence.

A minimum of 5 example sentences are required for each Machine Learning Intent to ensure the NLU model can be sufficiently trained. If the minimum of 5 example sentences is not reached, a yellow warning icon will be displayed to prompt the user for further sentences. Any attempt at training the intents when less than 5 example sentences have been added will result in an error message being displayed.

Machine Learning Intents: Minimum Example Sentence warning

Intent example sentences should be as distinct and unique as possible. If there is too much similarity and overlap with other intents, then the intent mapping will become less predictable and, if configured, intent confirmation sentences will be triggered more frequently.

Evaluation of Example Sentences

Find out more about how Cognigy.AI evaluates example sentences on the Intent Analyzer Page.

Slots and Lexicons

When writing example sentences, it is possible to add System Slots and attached Lexicons to the sentence structure by using the Annotations feature.

If you have configured Lexicons with similar items (e.g. pizza = FOOD and cake = FOOD), you don't need to enter similar sentences for both. Build a general sentence that will be configured with Annotations to recognize your custom Lexicon keyphrases e.g. I want to order some FOOD.

Machine Learning Intents: Slot & Lexicon Annotations

Simply highlight the word that should be mapped as a slot or lexicon and click the "+" at the right end of the text field to open the Annotations menu. The annotations menu provides options to select the type of slot that should be mapped to the highlighted word.

Example Sentence Annotation

Find out more about recognizing Slots and Lexicons in example sentences on the Annotations Page.


Intents can fall into one of three thresholds:

  • Confirmed The Intent has a score higher than the confirmation threshold and is considered "confirmed"

  • Reconfirmation Needed The Intent has a score higher than the reconfirmation threshold, but lower than the confirmation threshold and must be reconfirmed by the system

  • Not found The Intent has a score lower than the reconfirmation threshold and isn't considered a valid result for this input

You can change these thresholds in Agent Settings.

Confirmation Sentence

In case you haven't defined a confirmation sentence for your Machine Learning intent the reconfirmation threshold is used to confirm an intent.

So the reconfirmation threshold is used in two different ways depending on the existence of a confirmation sentence:

  • With confirmation sentence: the reconfirmation threshold triggers the reconfirmation sentence

  • Without confirmation sentence: the reconfirmation threshold confirms the input

Confirmation Sentence and Reconfirmations

If an Intent has been marked as Reconfirmation Needed and it is the highest found Intent, Cognigy AI will ask the user the question set in the Confirmation Sentence property for the Intent. If the user confirms the question with a positive answer, Cognigy AI will remember the answer for this user and not ask the user again.

How Reconfirmation Works
  • User: "I want to order a snack"
  • Cognigy AI scores the Intent orderPizza with 0.7
  • Cognigy AI: "Do you mean you want to order a pizza?"
  • User: "Yes"
  • Cognigy AI executes the sentence as if the user had said "I want to order pizza", plus remembers the confirmation for the future
Machine Learning Intents: Confirmation Sentence

If a certain number of users confirm the sentence, the sentence will be added to the list of example sentences trained to this Intent.

Back to top