Working with the User Intent Node

As a bot developer, you typically create a task to resolve one primary user intent. Yet, user conversations can branch into related intents (follow-up or sub-intents) as a part of the primary intent.

Let us take a look into this sample conversation for a Book Flights bot:

Bot: Hi, how may I help you today?
User: Hey, what flight options have I got from LA to NYC?
Bot: Sure, let me know the travel date.
User: Wait a minute, will it rain there this Sunday?

The primary intent of this conversation is to book flight tickets. But the user wants to know the weather forecast before completing the booking, which is a valid use case.

User Intent Nodes help you add root intent or follow-up (or sub-intents) to your dialog tasks. The flow for a follow-up intent is built within the same dialog task using transitions, and cannot be linked to external tasks. When the execution of a follow-up intent is completed, the conversation flow continues within the same dialog tasks based on the transitions you add.

Set Up a User Intent Node

Setting up a User Intent Node involves the following steps:

Add a User Intent Node to the Dialog Task

To add a user intent node to the dialog task, follow the below steps:

1. Open the dialog task in which you want to add the user intent node.
2. Click the + icon next to the node; then select Intent > New user intent node.
3. On the New Intent window, enter a Name and Description (optional) in the respective fields.
4. Click Create.
   
5. The User Intent window is displayed with the Component Properties tab selected by default.

Note: You can also select an existing User Intent.

Configure Component Properties

1. On the Component Properties tab, under the General Settings, you can modify the Name and Description.
2. Click the Connections tab and set the transition properties to determine the node in the dialog task to execute next. You can write the conditional statements based on the values of any Entity or Context Objects in the dialog task, or you can use intents for transitions.
   • Under the Connection Rules section, click Add IF.
   • Configure the conditional expression based on one of the following criteria:
     • Entity: Compare an Entity node in the dialog with a specific value:
       • Select the Entity.
       • Select an operator from the drop-down list: Exists, equals to, greater than equals to, less than equals to, not equal to, greater than, and less than.
       • Type the number in the Value field. For example, PassengerCount (entity) greater than (operator) 5 (specified value).
     • Context: Compare a context object in the dialog with a specific value using one of these operators: Exists, equals to, greater than equals to, less than equals to, not equal to, greater than, and less than. For example, Context.entity.PassengerCount (Context object) greater than (operator) 5 (specified value).
     • Intent: Select an intent that matches the next user utterance.
   • In the Then go to drop-down list, select the next node to execute in the dialog flow if the conditional expression succeeds. For example, if the PassengerCount (entity) greater than (operator) 5 (specified value), Then go to Offers (sub-dialog).
   • In the Else drop-down list, select the node to execute if the condition fails.
     Note: If you want to write multiple If conditions, click + Add Else If below the last If conditional expression.
3. From the NLP Properties tab, you can perform actions from the below-listed sections:
   • Machine Learning settings to provide user utterances to improve the detection for this intent.
   • Bot Synonyms or related phrases for this user intent.
   • Patterns & Rules to capture this intent if the user’s utterance contains these specific patterns.
   • Manage Context to control the flow of conversation.