Intent manager (NLU)

This article explains how to use the Intent Manager to activate, maintain and improve intent detection. In addition, our article on best practices associated with artificial intelligence will be of great help to you in understanding the definitions and help you understand the best way to manage such a project.




1. The principles

1.1 Function

The Intent Manager is the interface from which you drive the iAdvize artificial intelligence to use it in a bot scenario. When configured correctly, this application allows the understanding of the intents of your visitors as well as providing an adequate reply.

1.2 Managing the languages of your project

Since intent detection (also known as NLU: Natural Language Understanding) relies on written language to work, it can only work in one language at a time: that's why the interface starts by presenting to you the list of languages supported by our AI. If your visitors speak several different languages, you will have to work on the intent detection separately for each language.



1.3 Intent detection, a long-term project

Once your artificial intelligence is in place, it must be regularly monitored, trained and improved! For more information, please refer to the bot master's guide and especially to the article dedicated to the good use of artificial intelligence. To make this maintenance easier, our AI extracts every week all the undetected expressions of the last 7 days, filters them and groups them by theme to suggest you adding expressions relevant to your intentions.


1.4 Manage and create your AI Intent detection

To manage your AI Intents detection :

  • Go to the new section in the Automation section, then "Intent Manager"
  • Select the right domain for your language
NB: Our Augmented Intelligence now supports 11 languages: French, English, German, Spanish, Italian, Dutch, Portuguese, Russian, Danish, Finnish and Swedish.


To create new Intent, click on the button "See More", then "Create" on the top right.




  • Add a name
  • Add expressions to train your Intent
  • The best practice is to add around 20/25 training expressions
  • Save your intent


2. Intent suggestions: optimize intents with the help of our AI

Intent suggestions are here to save you valuable time when optimizing your intents. Every week our AI engine extracts all the undetected expressions from the past 7 days, filters them, and groups them to suggest only relevant expressions to add to your intents.

2.1 How does it work?

  • Every Monday our AI engine extracts the complete list of all undetected expressions from the past week.
  • We filter expressions that are very close to each other to suggest just one instance of each expression.
  • Our AI then groups expressions together that should go to the same intent.
  • Each group is then shown as a suggestion to add to an existing intent or to create a new intent.
  • You can now review the expressions in each suggestion and decide if you would like to validate them and if they need to be added to an existing intent or a new intent.
NB : Keep in mind that the process can take up to 24h so new suggestions might show on Tuesday sometimes.


2.2 How to review an intent suggestion?

  • Go to the Intent manager and choose the language of your intents.
  • If your intelligent bot has been running for at least 2 weeks you should be seeing new intent suggestions at the top of the screen.


  • Click on the “review” button next to a suggestion and you will be sent to the suggestion review page. If you want to remove a suggestion from the list, click the “ignore” button and the suggestion will be deleted.


  • On the Intent Suggestion review page read through the expressions and click the “validate” button for each expression you would like to add to your intents and “ignore” for each expression you don’t want to add to your intents.


  • Once you have reviewed all the expressions, you need to decide if they should go to an existing intent or a new intent.
    NB : Be mindful that intents need to be strictly distinct so if you already have an intent with similar expressions choose the option to add to an existing intent.


  • If you have chosen to add the expressions to an existing intent, you will see a dialog to select the intent to which you would like to add the expressions. Select the right intent and confirm.


NB : Please note that you have the option here to expand an intent to see the expressions that you already have in that intent and make sure that the new expressions match the existing expressions in the selected intent.

If you have chosen to add the expressions to a new intent, double check the name of the new intent at the top of the screen and click the button to create a new intent.


3. Use collaborative training to improve intent suggestions

If you have Collaborative Training activated your intent suggestions will be of even higher quality. As mentioned above, our AI groups undetected expressions into themes. By using Collaborative Training, your agents help improve the grouping done by AI and remove expressions that shouldn’t be grouped together in the same intent.

4. Test an Expression and AI detection

Do you wish to test that an intention is well detected in a visitor's request?

  • Go to the button “Test an Expression” Intent-Manager-05-EN-Test.png
  • Add your expression


  • The result of the test will give you the Intent detected with the higher score


5. Edit/delete an existing intention

Below you will find the list of already validated intentions. These may be edited or deleted at any time.



6. Import & export intents

Importing and exporting intents allows you to optimise your intents from your favourite spreadsheet program. When creating your first intents or optimising existing ones, you can work on them in a CSV file and then easily import them to your intents manager. Alternatively, you can export your existing intents in a CSV file to make it easier to add relevant expressions.



6.1 Pre-requisites for the CSV file

Please note the following pre-requisites for the CSV file before making an import:

  • The CSV file needs to be lower than 50Mo
  • The CSV file has to be with a comma separator
  • The use of a semicolon (;) character is forbidden
  • The file can’t have empty lines
  • The file can’t be empty
  • An intent can have a maximum of 2000 expressions (applies in total)
  • An expression can have a maximum of 768 characters (applies in total)
  • Intent can’t be empty without expressions
  • A line can’t miss an intent name


When a CSV file is imported, it will add new intents if the intent doesn’t exist already. It is based on the name of the intent.

The cheat sheet below includes a recap of the main features of the intent manager: