Intent
The Intent API handles Intents and their utterances, also handling their mass import through files, known as Bulk Training.
Intents
Pagination and Listings
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
It is the bot where the intents are, it is used to filter intents.
It is the status of the intents, represents whether are active, default value true.
true
It is the number of pages that will be returned, default value 0.
0
Example: 1
It is the number of intent per page, default value 5.
5
Example: 1
It is the intent attribute used for ordination the page, default attribute name.
name
It is the sorting type, default value ASC.
ASC
It is the parameter that contains the user data entry, that will be used to filter the intents.
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents?enabled=true&page=0&linesPerPage=5&orderBy=name&direction=ASC&searchTerms=text HTTP/1.1
Host:
Accept: */*
{
"totalPages": 1,
"totalElements": 1,
"pageable": {
"unpaged": true,
"pageSize": 1,
"paged": true,
"pageNumber": 1,
"offset": 1,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
}
},
"numberOfElements": 1,
"size": 1,
"content": [
{
"name": "text",
"utterances": [
"text"
],
"tags": [
{
"name": "text"
}
],
"id": "text",
"flows": [
"text"
],
"lastModified": {
"uuid": "text",
"image": "text",
"name": "text",
"timestamp": 1
}
}
],
"number": 1,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"first": true,
"last": true,
"empty": true
}
It is the organization where the flow is, used to connect to the correct database
It is the environment where the flow is, used to connect to the correct database
It is the bot where the flow is, used to filter intents
It is the parameter used to search for intents related to the entered value
It is the max number of result, default value 6
6
Example: 6
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents/quicksearch?name=text HTTP/1.1
Host:
Accept: */*
[
"text"
]
It is the organization where the intents are, used to connect to the correct database.
It is the environment where the intents are, used to connect to the correct database.
It is the bot where the intents are, used to filter intents.
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents/list-on-flow HTTP/1.1
Host:
Accept: */*
[
{
"name": "text",
"utterances": [
"text"
],
"tags": [
{
"name": "text"
}
],
"id": "text",
"flows": [
"text"
],
"lastModified": {
"uuid": "text",
"image": "text",
"name": "text",
"timestamp": 1
},
"about": "text",
"firstCell": true
}
]
CRUD Operations
It is the organization where the intents are, used to connect to the correct database.
It is the bot where the intents are, it is used to create intents.
It is the bot where the intents are, used to filter intents.
It is an identifier provided by the API client that will be used to identify distributed logs.
Is the data provided for generating example utterances
Name of the intent.
Utterances of the intent.
About of the intent.
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 77
{
"name": "text",
"utterances": [
"text"
],
"tags": [
{
"name": "text"
}
],
"about": "text"
}
{
"name": "text",
"utterances": [
"text"
],
"tags": [
{
"name": "text"
}
],
"id": "text",
"flows": [
"text"
],
"lastModified": {
"uuid": "text",
"image": "text",
"name": "text",
"timestamp": 1
}
}
It is the organization where the intents are, used to connect to the correct database.
It is the environment where the intents are, used to connect to the correct database.
It is the bot where the intents are, used to filter intents.
It is the uuid used to search for an intent.
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents/{uuid} HTTP/1.1
Host:
Accept: */*
{
"success": 1,
"expWithItents": 1,
"intWithExp": 1,
"duplicateExp": 1,
"intAlerExistsInRepo": 1,
"expAlerExistsInRepo": 1,
"invalidIntentName": 1,
"notLines": true,
"exceedsMaxEmptyLines": true
}
It is the organization where the intents are, used to connect to the correct database.
It is the environment where the intents are, used to connect to the correct database.
It is the bot where the intents are, used to filter intents.
It is the uuid used to search for an intent, in this case it is the intent will be updated.
It is an identifier provided by the API client that will be used to identify distributed logs.
Is the data provided for generating example utterances
Name of the intent.
Utterances of the intent.
About of the intent.
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents/{uuid} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 77
{
"name": "text",
"utterances": [
"text"
],
"tags": [
{
"name": "text"
}
],
"about": "text"
}
{
"name": "text",
"utterances": [
"text"
],
"tags": [
{
"name": "text"
}
],
"id": "text",
"flows": [
"text"
],
"lastModified": {
"uuid": "text",
"image": "text",
"name": "text",
"timestamp": 1
}
}
It is the organization where the intents are, used to connect to the correct database.
It is the environment where the intents are, used to connect to the correct database.
It is the bot where the intents are, used to filter intents.
It is the uuid used to delete an intent.
It is an identifier provided by the API client that will be used to identify distributed logs.
DELETE /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents/{uuid} HTTP/1.1
Host:
Accept: */*
No content
Auxiliary Methods
It is the organization where the intents are, used to connect to the correct database.
It is the environment where the intents are, used to connect to the correct database.
It is the bot where the intents are, it is used to check the utterance.
It is an identifier provided by the API client that will be used to identify distributed logs.
It is the value of the intent example that will be checked if it already exists.
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents/validate-utterance HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 6
"text"
No content
Its function is responsible for communicating with the genai service to bring examples of utterances.
It is the organization where the intents are, used to connect to the correct database.
It is the environment where the intents are, used to connect to the correct database.
It is the bot where the intents are, it is used to check the utterance.
It is an identifier provided by the API client that will be used to identify distributed logs.
Is the data provided for generating example utterances
Name of the intent.
Utterances of the intent.
About of the intent.
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/intents/complete HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 77
{
"name": "text",
"utterances": [
"text"
],
"tags": [
{
"name": "text"
}
],
"about": "text"
}
[
"text"
]
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
it is the bot where the intents are, it is used to filter intents for token counting.
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/tokens HTTP/1.1
Host:
Accept: */*
{
"maxTokens": 1,
"usedTokens": 1,
"reservedTokens": 1
}
Bulk Trainings
CRUD Operations
Its function is to load intents and utterances to analyze data consistency, and generate a pre-save of the analyzed data.
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
Bot where intents and examples will be imported.
It is an identifier provided by the API client that will be used to identify distributed logs.
It is the file that contains the data to be analyzed.
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/bulk-training/intents HTTP/1.1
Host:
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17
{
"file": "binary"
}
{
"message": "text",
"data": {
"success": 1,
"expWithItents": 1,
"intWithExp": 1,
"duplicateExp": 1,
"intAlerExistsInRepo": 1,
"expAlerExistsInRepo": 1,
"invalidIntentName": 1,
"notLines": true,
"exceedsMaxEmptyLines": true
}
}
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
Bot where intents and examples will be imported.
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/bulk-training HTTP/1.1
Host:
Accept: */*
{
"id": "text",
"botUuid": "text",
"type": "text",
"percentage": 1,
"status": "text",
"result": "text",
"fileName": "text"
}
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
Bot where intents and examples will be created.
It is an identifier provided by the API client that will be used to identify distributed logs.
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/bulk-training/intents HTTP/1.1
Host:
Accept: */*
{
"message": "text",
"data": 1
}
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
Bot that contains the bulk training that will be canceled
It is the id of the bulk training.
It is an identifier provided by the API client that will be used to identify distributed logs.
DELETE /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/bulk-training/{id} HTTP/1.1
Host:
Accept: */*
No content
Auxiliary Methods
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
Bot where intents and examples will be imported.
It is an identifier provided by the API client that will be used to identify distributed logs.
It is the file that contains the data to be analyzed.
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/bulk-training/utterances HTTP/1.1
Host:
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17
{
"file": "binary"
}
{
"message": "text",
"data": {
"success": 1,
"uttWrong": 1,
"expAlerExistsInRepo": 1,
"notLines": true
}
}
It is the organization where the intents are, it is used to connect to the correct database.
It is the environment where the intents are, it is used to connect to the correct database.
Bot where the examples were loaded
It is an identifier provided by the API client that will be used to identify distributed logs.
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/bulk-training/utterances HTTP/1.1
Host:
Accept: */*
{
"message": "text",
"data": [
"text"
]
}
Last updated
Was this helpful?