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.