Intent_automation

INTRODUCTION

Each chatbot contains automation modules. These modules are: INTENT, TRIGGER and WORKFLOW. This document provides a detailed description of the user's work with each module. Screenshots have been added for visualization and better understanding of the written text. To go to the automation modules, click the AUTOMATION tab on the left menu.

When the AUTOMATION tab is open, the following buttons are displayed at the top of the window: INTENTS, TRIGGERS, WORKFLOWS (1* Hereafter: this number indicates the image element to which the text is referencing.). There is also a button to validate the automation module - VALIDATE ALL (2) and a button to create a new automation module - NEW (3).

Screenshots have been added for better understanding of the written text. See the relevant sections for more details.

---

INTENTS

Intents are automation modules that can be used in Triggers to recognise input from visitors. Speaking of intents, we should note the following fact: an intention is a task that is formulated by a certain cue.

Creating an Intent:

To create an Intent, click the INTENTS button at the top of the Automation block.

Then, in the intent list, click the NEW INTENT button at the top of the Intent block (Image A). This will display the new intent creation card (Image B).

^{Image A.}

^{Image B.}

The intent creation card has the following attributes (or card field elements):

• Field FOLDER

In this field, specify the folder in which you want to put the new intent. In other words, used to structure the location of a group of Intents. This field is a drop-down list and must be filled in. If there is only one HOME folder and no other folders have been created, the default location for Intentions is the HOME folder. The FOLDER field is filled in automatically when you go to the Intent creation card. However, if there are at least two folders for saving the Intent, the FOLDER field isn’t filled automatically. In this case, it is possible to manually select the desired folder. To do this, click on the FOLDER field. Then a drop-down list with the folder names will appear. Only one folder can be selected in this list.

• Field NAME

In this field you must specify the name of the new Intent for further easy and quick identification in the system. In this field you can enter characters that meet the following requirements:

1. The name can be from 1 to 255 elements inclusive.
2. The entered characters (elements) can be of any alphabet (Latin, Chinese, Russian, etc.).
3. Characters (elements) can be in upper register, lower register or mixed register.
4. You can enter any numeric value.
5. You can enter any special characters (for example: brackets, percentages, commas, etc.).
6. It is possible to save the name if only characters such as - "space" are entered.
7. It is possible to move text characters (e.g. from a text editor). It isn't possible to move any files into this field.

• Field TERMS

This field contains a list of values which are the main content of the Intent. To add a value, click on the TERMS field. Then enter the desired value and click the ENTER button. It is recommended to create at least three Terms values to work correctly.

In this field you can enter characters that meet the following requirements:

1. The value must be at least one character.
2. The entered characters (elements) can be of any alphabet (Latin, Chinese, Russian, etc.).
3. Characters (elements) can be in upper register, lower register or mixed register.
4. You can enter any numeric value.
5. You can enter any special characters (for example: brackets, percentages, commas, etc.).
6. It is possible to save the name if only characters such as - "space" are entered.
7. It is possible to move text characters (e.g. from a text editor). It isn't possible to move any files into this field.

After the ENTER button is clicked, the value(s) is displayed above the TERMS field as a tag(s).

If you want to delete the created value, you should click on the "X" element in the tag. The system has the ability to edit the tag. To edit a value, click on the tag. After that a second pop-up window will be displayed.

In the edit window, the SIMPLE tab is active by default. In the edit box, it is possible to make adjustments to the value (tag). It is possible to edit the value (tag) extensively. To do this, click the ENTITY tab.
In order for this Terms value to be offered, the Intent's special toggle checkbox - Use as variant for low confidence must be enabled. To do this, select the TERMS value you are interested in by clicking the mouse and in the window that opens, switch Use as a variant for low confidence to the “ON” position.

To save the changes, click the SUBMIT button. After that the editing window closes automatically and the changes are saved. Clicking the CANCEL button closes the window, and the changes made will not be saved.

• ENABLED checkbox

It is the checkbox of general toggle Intent. This checkbox allows you to temporarily enable or disable an Intent. It is worth noting that disabled Intents aren’t taken into account by the system when determining the match level of the phrase being checked. By default, the checkbox is always active.

• Enabled Low-Confidence checkbox

It is Special toggle Intent. By default, the checkbox is always active. Some of the values can be highlighted. This selection is for the following situation, when a message to the bot is entered, but it (because of low Confidence) cannot be used by any of the available triggers.

Saving the Intent:

When all required fields are filled in, it is possible to save the Intent. In order to do this you need to click on the SAVE button.

If the ENABLED and ENABLED LOW-CONFIDENCE checkboxes are active or deactivate or if the ENABLED checkbox is disable and ENABLED LOW-CONFIDENCE checkbox is active and vice versa, then after saving the Intent, two notifications appear in the lower right corner of the browser screen. The first: about the successful creation of the Intent. The second: the need to train the bot.

If changes are made but you don't click the SAVE button and close the card, the changes remain in the card, but are not saved.

Editing the Intent:

To edit an already created Intent, click in the NAME column of the desired Intent in the list of intents. If you click not in the NAME column, the Intent card won't open. Then open the Intent card, where you can make adjustments.

Deleting the Intent:

To delete an existing Intent, in the list of intents, click in the NAME column on the Intent to be deleted. In the lower left corner of the Intent card, click the REMOVE INTENT button. After that, the Intent card automatically closes and the Intent is removed from the list.

It is worth noting that if you click on REMOVE INTENT in the Intent creation card, a pop-up message will appear in the lower right corner saying that this action cannot be performed on an Intent that has not yet been created.

Tracking the history of changes to the Intent:

It is possible to track how a particular Intent has changed. To do this, in the list of the Intents, click in the NAME column on the name of the desired Intent. Click the CHANGES HISTORY button in the lower part of the appeared Intent card.

The window that appears contains a list of changes that have been made to the specific Intent. The list contains the date and time of the change, the Email of the person who changed the Intent, and what exactly was changed.

Creating a note to the Intent:

To create an Intent note, in the list of intents, click in the NAME column on the desired Intent. Click the button in the lower part of the Intent card that appears.

After that, a window will be displayed in which it is possible to create a note.

Actions with the Intent card:

In the upper right corner of the Intent card, there are buttons that allow to minimize (1), fix (2), or close (3) it.

When the user clicks item Collapse (1), the card minimizes its size and collapses to the lower right corner. When the user clicks item Fix (2), the card doesn't change its size and is fixed in the lower right corner. And if the user clicks item Close (3) the card closes and changes are not saved.

Check the LowConfidence value:*

For example, if there is such a Terms in the Intent, the level of which is higher than the LowConfidence threshold set in the bot, then the Trigger in which this Intent is in the “Visitor entered intent” activation condition will be activated. In other words, the Intent will work and execute the corresponding Workflow assigned in its “Execute function” setting.

The Terms level can be checked by following these steps: Bot -> Settings -> Common -> Preferences -> Field The lower bound of the match level for "Intents" (0-1). On the page that opens, pay attention to the value of the field The lower bound of the match level for "Intents" (0-1).

Checking for current (active) Intent in the system?

In order to check the presence of current (active) Intents in the system and their compliance with the tested (presumed) phrase of the visitor, you must perform the following steps:

1. Go to the Intents section in the current bot.
2. Press the Test intents button.

3. In the opened form for checking intents, specify the phrase to be checked;
4. Click the Send button.

As a result a list of available intents will be displayed:

• the name of the most relevant Intent (1);
• id of the most relevant Intent (2);
• the level of matching of the checked phrase with the value of Terms available in the Intents (3).
• If the switch is set to "ON", the less relevant search word/phrase Intents are also displayed (4).

If the switch is set to the "OFF" position, the less relevant Intents aren't displayed for the searched word/phrase.

Bot training:

If any changes were made to the Intent, then for the correct operation of the bot, it is necessary to carry out the procedure for training it. To do this, you need to take the following steps:

1. In the workspace menu of the desired bot, click the TRAIN button.

or

2. Select the necessary bot.
3. Go to the DASHBOARD tab on the left menu.
4. Сlick on the TRAIN button.