Overview of BotBuilder and its tabs

icon picker
Intents tab

The Intents tab is where you create and edit
@Intent
⁠
s for their future use in the
@Agent
⁠
s.
An
@Intent
⁠
represents a specific topic or action that the
@Agent
⁠
should recognize.
⁠
@Intent
⁠
s are reusable and can be used in any number of
@Agent
⁠
s, including multiple
@Agent
⁠
s simultaneously.
Each
@NLU
⁠
in an
@Agent
⁠
is trained on only the
@Training Dataset
⁠
s of its
@Intent
⁠
s. Other
@Intent
⁠
s are not involved in the recognition in the specific
@NLU
⁠
, but can be used in another
@NLU
⁠
.

Navigating to the Intents tab

There are two ways to navigate to the list of
@Intent
⁠
s:
Go to the Resources tab and click on the Intents button.
Go to the Agent Designer and open the Intents tab.

List of Intents

The
@Intent
⁠
s tab presents a list of all the
@Intent
⁠
s: ​
image.png
⁠
⁠
⁠
@Intent
⁠
s are sorted alphabetically. Clicking the sort button changes the sorting order: from the beginning of the alphabet to the end and vice versa. ​
image.png
⁠
⁠
Opposite each
@Intent
⁠
its language is indicated. ​
image.png
⁠
⁠
In use column displays the usage of
@Intent
⁠
s in the
@Agent
⁠
s. ​
image.png
⁠
⁠
Next to each
@Agent
⁠
where the
@Intent
⁠
is used, there is a checkmark and a Clarify button.
Clicking the Clarify button displays icons of
@Agent
⁠
s that use this
@Intent
⁠
. ​
image.png
⁠
⁠

Searching for Intents

You can search by name, language, and
@Intent
⁠
usage in
@Agent
⁠
s. The search can be performed using one parameter or several parameters simultaneously.

Searching by Intent Name

To search for
@Intent
⁠
s by name, enter the desired value in the search field.
The list will display only the
@Intent
⁠
s that contain the search string in their name. ​
image.png
⁠
⁠

Searching by Intent Usage

Searching by
@Intent
⁠
usage in the
@Agent
⁠
s is done using the In use and Not in use filters:
Clicking the In use button displays only the
@Intent
⁠
s that are used in the
@Agent
⁠
s. ​
image.png
⁠
⁠
Clicking the In use button replaces the Not in use filter with the Agent filter — a filter by
@Agent
⁠
s.
Clicking the Agent button opens the search panel by
@Agent
⁠
s. ​
image.png
⁠
⁠
To find
@Intent
⁠
s used in specific
@Agent
⁠
s, click on the desired
@Agent
⁠
s in the list.
Clicking the Not in use button displays the
@Intent
⁠
s that are not used in the
@Agent
⁠
s. ​
image.png
⁠
⁠

Search by Intent Language

Search by
@Intent
⁠
language is performed using the Language filter.
Clicking on the Language button opens the search panel for
@Intent
⁠
language. ​
image.png
⁠
⁠
To select
@Intent
⁠
s in a specific language or languages, click on the desired language(s) in the dropdown list. ​
image.png
⁠
⁠
After that, the
@Intent
⁠
s on the tab will be filtered and only the
@Intent
⁠
s in the selected language(s) will be displayed.

Creating, Editing, and Deleting Intents

Creating a New Intent in Company Resources

To create new
@Intent
⁠
s, follow these steps:
Go to the list of
@Intent
⁠
s.
Click the Create new button. ​
image.png
⁠
⁠
Clicking the button opens the form to create a new
@Intent
⁠
. ​
image.png
⁠
⁠
Fill in the fields in the form:
Name — the name of the
@Intent
⁠
. The maximum length of the name is 1000 characters.
Requests — the
@Training Phrase
⁠
s of the
@Intent
⁠
. It can be filled in manually or copied and pasted from a document or table. The maximum length of one request is 1000 characters. The maximum number of requests is 500.
Language of the
@Intent
⁠
.
The language can be changed after saving the
@Intent
⁠
.
The languages are presented in the table .
Currently, the language selection for the
@Intent
⁠
is only for visual representation and does not affect the recognition of
@Intent
⁠
s in
@NLU
⁠
@Slot
⁠
s.
Save the changes by clicking the CREATE button.
To cancel creating the
@Intent
⁠
, click the CANCEL button.
Important: Read the recommendations for filling in the
@Intent
⁠
examples in the article .
Languages of Intents
4
Language
Abbreviation in the dropdown list
1
Russian
image.png
2
English
image.png
3
Portuguese
image.png
4
Ukrainian
image.png
5
Spanish
image.png
6
Vietnamese
image.png
7
Thai
image.png
8
Indonesian
image.png
9
Malay
image.png
10
Filipino
image.png
11
Serbian
image.png
12
German
image.png
13
Polish
image.png
14
French
image.png
15
Pakistani (urdu)
image.png
16
Kyrgyz
image.png
17
Arabian
image.png
There are no rows in this table
⁠

Editing an Intent

To change the name or examples of an existing
@Intent
⁠
, follow these steps:
Go to the list of
@Intent
⁠
s.
Click on the row of the
@Intent
⁠
that needs to be edited.
Edit the
@Intent
⁠
:
To change the name, click on the Name field and modify its content.
To change the examples, click on the Requests field and modify its content.
To change the
@Intent
⁠
language, you need to click on the language selection field and select another language.
Save the changes by clicking the SAVE button.

Deleting an Intent

To delete a single
@Intent
⁠
, follow these steps:
Go to the list of
@Intent
⁠
s.
Click on the
@Intent
⁠
name or the checkmark in the selector next to it.
Click on the Delete intent or Delete button on the right panel. ​
image.png
⁠
⁠
⁠
image.png
⁠
⁠
Confirm the action in the modal window by clicking the DELETE INTENT button. ​
image.png
⁠
⁠
If the deleted
@Intent
⁠
is used in the
@Agent
⁠
s, a warning will appear during deletion, indicating that it needs to be removed from the
@Agent
⁠
s first. ​
image.png
⁠
⁠

Cloning an Intent

To clone a single
@Intent
⁠
, follow these steps:
Go to the list of
@Intent
⁠
s.
Click on the
@Intent
⁠
name or the checkmark in the selector next to it.
Click on the Duplicate intent or Duplicate button on the right panel. ​
image.png
⁠
​
image.png
⁠
⁠
Confirm the action in the modal window by clicking the YES, I’M SURE button. ​
image.png
⁠
⁠
Clicking the YES, I’M SURE button will create a copy of the
@Intent
⁠
with the name <cloned intent name> CLONE. ​
image.png
⁠
⁠

Bulk Actions with Intents

Multiple
@Intent
⁠
s can be selected and bulk actions can be applied to the group of
@Intent
⁠
s.

Multiple Selection

Multiple selection of
@Intent
⁠
s can be done in the following ways:
Check the selectors next to the desired
@Intent
⁠
s manually. ​
image.png
⁠
⁠
Check the selector for mass selection — in this case, all
@Intent
⁠
s on the page will be selected. ​
image.png
⁠
⁠
Select one of the groups of
@Intent
⁠
s. Clicking on the arrow opens a dropdown list: ​
image.png
⁠
⁠
In the dropdown list, select the group of
@Intent
⁠
s on the current page: ​
image.png
⁠
⁠
All - all
@Intent
⁠
s.
In use - only
@Intent
⁠
s used in the
@Agent
⁠
s.
Not in use - only
@Intent
⁠
s not used in the
@Agent
⁠
s.

Deselecting Intents

⁠
@Intent
⁠
s can be deselected in the following ways:
Manually remove the checkmarks from the selectors.
Use the mass selection selector. ​
image.png
⁠
⁠
Select the Clear selection option in the dropdown list: ​
image.png
⁠
⁠

Bulk Deletion of Intents

To delete multiple
@Intent
⁠
s at once, follow these steps:
Select multiple
@Intent
⁠
s as described in the section.
Click the Delete intents button. ​
image.png
⁠
⁠
Confirm the action in the modal window by clicking the DELETE INTENTS button. ​
image.png
⁠
⁠
If the selected
@Intent
⁠
s include those used in the
@Agent
⁠
s, a warning will appear during deletion, indicating that the specified
@Intent
⁠
s were not deleted. ​
image.png
⁠
The remaining
@Intent
⁠
s will be deleted.

Bulk Cloning of Intents

To clone multiple
@Intent
⁠
s at once, follow these steps:
Select multiple
@Intent
⁠
s as described in the section.
Click the Duplicate intents button. ​
image.png
⁠
⁠
Confirm the action in the modal window by clicking the YES, I’M SURE button. ​
image.png
⁠
⁠
Clicking the YES, I’M SURE button will create copies of the
@Intent
⁠
s with the names <cloned intent name> CLONE. ​
image.png
⁠
⁠

Export-import of Intents when exporting-importing an Agent

When an
@Agent
⁠
is exported, all
@Intent
⁠
s contained in its
@Script
⁠
are also exported. The
@Agent
⁠
with the
@Intent
⁠
s included in it is exported as a .cfg file.
When importing an
@Agent
⁠
, the
@Intent
⁠
s used in it are imported and:
If the
@Company
⁠
has an
@Intent
⁠
with an identical name and
@Training Dataset
⁠
, duplication of
@Intent
⁠
s does not occur.
If the
@Company
⁠
has an
@Intent
⁠
with an identical name but a different
@Training Dataset
⁠
, a duplicate of this
@Intent
⁠
will be created with an automatically generated name: ​
image.png
⁠
⁠
If the
@Company
⁠
has an
@Intent
⁠
with a different name, but an identical
@Training Dataset
⁠
, then the
@Intent
⁠
in the
@Script
⁠
of the imported
@Agent
⁠
will be replaced with the
@Intent
⁠
from the
@Company Resources
⁠
.
If the
@Company
⁠
does not have such an
@Intent
⁠
, it will be imported and appear in the list of
@Intent
⁠
s.
Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.