How-to: Design your NLU Data

Since it will hold and run your model, verify that the device setup is compatible with the expected model footprint. If the device does not have enough memory, then the model will not generate any results.

These are the actions that the user wants to accomplish with the device. Any user should be able to distinguish them easily without confusion. start and stop are good Intents because they are different and clear. If you keep these two, avoid defining begin, activate, or similar intents in addition, because not only your model but also humans will confuse them with start. Even turn-on is to be avoided, for the same reason.

You might assume the best way to design data is to increase the number of Intents. No! Keep your Intents general and avoid having detailed ones like increase_heat_maximum or increase_heat_medium, merge them in the same Intent: increase_heat.

Always include an out-of-scope Intent. If you only have start and stop Intents, then the model will always provide one of them as Intent, even if the user command is hello world. Here, the intent None will include what the model should not handle/recognize.

Gather maximum information from the use case specification, draw a table containing all your expected actions and transform them into intents.

If you expect only Intents from your model, then you can skip this paragraph, slots are optional.

Otherwise, remember that slots are the information that your device needs for the action (intent).

For example, if you have the intent increase_heat, then your cooker should be able to increase the heat to a precise value. In Increase the heat to 5, 5 must be recognized as the slot: heat_level. Choose relevant slot names. At this level, in order to define your potential slots, just focus on the categories of slots and ignore what values they would have. You will come back to this later.

In your initial table add a column Intent Specification containing all specifications that each intent may have.
In this column, contrary to the previous table, you need more specifications for your intents. It will help you gather all the slots you need.
For start, the user can simply ask for start action, or start action later (or another wanted time). This specification can be modeled by start + time.
Here, you got a first slot: action_time. Remember that slots are optional, some specifications would need no slots at all.

Now, the data is starting to take shape. If you identify some bottlenecks at this level, remember that often in NLU, what is difficult for humans will probably be difficult for models. Thus, simplify the data structure as much as possible so the model can understand it.

These are the expected user commands and also what the model will learn during the training process.

Intents need examples that reflect the real use case. For the model to effectively distinguish different intents, it is crucial to have distinct examples.

Remember two rules:

• For each example: The more your example is close to the real use case, the more successful the user experience will be. Each example should be inspired by a real use case. Put yourself into the shoes of the final user.

• For each intent: The more your examples are consistent, the more accurate your model will be. Put yourself into the shoes of a learner. If you want to learn an Intent, but Examples do not express the same meaning, you would not be able to learn it well.

When creating your examples, keep in mind the following tips:

• Inside the same intent:

  • Each intent should contain only consistent examples: They must have the same meaning and they must cover the most common ways to express an Intent. start the cooker and you can start the cooking program are two acceptable ways to express the same Intent: start.

  • Each example should be typical of its intent: One example should fit with only one intent. start the cooker and you can start the cooking program are typical examples of start intent only. You can also consider go ahead, or let the cooking start as common ways to express the same Intent. Sometimes, you want to add less typical examples as everything is in the cooker, finish the job for start or not enough heat for increase_heat. These implicit examples should not be confused with another intent.

  • Avoid making redundancy: The model will process examples as patterns, so avoid adding similar examples that do not bring new knowledge to the intent. Knowledge can be a new word position like start in 2 min or in 2 min starts, a new word, or information that may help a human learner (and thus, the model).

  • Avoid negative forms. Traditionally in Human Machine Interfaces, machines accomplish positive actions. do not increase the heat is not an appreciated form by the model.

  • Entities (and also words) should have the same distribution: In general, NLU models can be sensitive to data distribution. Except if you want your model to recognize some Intents depending on some “key words”, avoid having a dominant word or dominant entities. Make your data balanced. Otherwise, if the intent start only has examples like start now, start in two minutes, start... the model would not recognize turn the cooking program on. Instead, if you need 12 examples, then use three with start.., three with begin..., three with turn-on..., and three with activate....

• Between intents:

  • Examples must be distinct across intents: So avoid having similar examples in different intents as it can lead to confusion. Examples that share many words are too similar.

  • Examples should be balanced across intents. Avoid having Intents with less examples than others. If you have one dominant intent in terms of number of examples (100 for one versus less than 10 for others), that means that your model will always recognize this intent (since it is the most probable).

  • Entities (and also words) should be balanced: If an entity (or a word) occurs in several intents, make sure that it appears with the same number in these intents.

Go back to the previous table and add a new column “Example”. For every Intent Specification row, add three examples with the previous tips in mind.
The following table is an example for the intent start

Now, you can delete the Intent Specification column, and add a new column Relevant Tokens. This column contains the relevant words/entities for each Intent. If a token occurs only in one intent, it can be discriminative for it: the model will probably recognize intents thanks to these tokens. If it fits with the target use case, it will increase the model accuracy. Otherwise, add examples including these words to the right Intents.

This looks simple, but sometimes while defining examples it is possible to realize that the initial intents cut is not clear. If you start to gather similar examples in different intents, it makes sense to reassess your intent design and merge similar Intents into a more general one.

Finally, once you've made improvements to your data in the previous table, the final step is to define each slot’s values, called entities. You do not need to list all the possible words. Add only the main words that represent the slot. For cooking_mode, values could be high, low, medium, gentle and gentle high. If you expect numeric values like action_time, then choose them randomly: 1 min, 3.4 min, 5 min, 7.10 min, 10 min etc. Some values can be shared in different slots. It will be handled by the model. For the cooker, action_time and cooking_duration have numerical values. It would be better to avoid adding exactly the same values to these slots.