Настройте пользовательское определение интентов для улучшения способности вашего чат-бота распознавать и отвечать на конкретные потребности пользователей.
Интенты - это предопределенные шаблоны пользовательских запросов, которые запускают конкретные ответы или действия. Они позволяют вашему чат-боту:
Когда интент обнаружен, система может вернуть предопределенный ответ или запустить специальное действие, такое как перенаправление к человеку-агенту или получение конкретной информации.
Вы можете настроить интенты через Панель управления проекта в разделе "Интенты" в меню проекта. Это дает вам полный контроль над созданием пользовательских интентов, которые соответствуют вашим конкретным потребностям.
Интенты настраиваются с использованием JSON структуры со следующим форматом:
{
"intentions": [
{
"name": "human_assistance",
"samples": [
"Мне нужно поговорить с человеком",
"Могу ли я поговорить с реальным человеком",
"Соедините меня со службой поддержки",
"Я хочу поговорить с представителем"
],
"response_code": "HUMAN_ASSIST_REQUESTED"
},
{
"name": "pricing_inquiry",
"samples": [
"Какие у вас цены",
"Сколько это стоит",
"Можете рассказать о ценах",
"Есть ли у вас планы оплаты",
"Какие подписочные сборы",
"Я хочу узнать о вариантах оплаты"
],
"response_code": "SALES_DEPARTMENT_REDIRECT"
}
]
}
| Свойство | Тип | Описание |
|---|---|---|
| intentions | array | Массив объектов интентов |
| name | string | Уникальный идентификатор для интента |
| samples | array | Примеры фраз, которые должны запускать этот интент (1-25 образцов, 3-200 символов каждый) |
| response_code | string | Пользовательский идентификатор для вашего ответа или действия для запуска |
Коды ответов полностью настраиваемы. Вы можете создать любой код ответа, который имеет смысл для вашего приложения. Вот несколько примеров того, как вы можете использовать пользовательские коды ответов:
| Пример кода ответа | Возможное использование |
|---|---|
| HUMAN_ASSIST_REQUESTED | Для обработки запросов на разговор с человеком-агентом |
| SALES_DEPARTMENT_REDIRECT | Для перенаправления вопросов о ценах и оплате в отдел продаж |
| SUPPORT_REQUESTED | Для направления пользователей к ресурсам поддержки |
| ORDER_STATUS_CHECK | Для обработки запросов о статусе заказа |
Коды ответов, которые вы определяете, используются в вашем приложении для определения того, как обрабатывать конкретные пользовательские интенты. У вас есть полная свобода создавать любые коды ответов, которые соответствуют вашим бизнес-потребностям.
Когда интент обнаружен через Chat API, ответ будет включать is_intention: true и возвращать указанный код ответа. Ваше приложение отвечает за обработку этого кода ответа и предоставление соответствующего пользовательского сообщения:
{
"status": "success",
"message": {
"question": "Могу ли я поговорить с человеком-агентом?",
"answer": "HUMAN_ASSIST_REQUESTED",
"source": []
},
"execution_time": 0.3,
"call_cost": 0,
"total_tokens": 1,
"is_intention": true
}
Ваша интеграция должна проверять is_intention: true и соответствующим образом обрабатывать код ответа в поле answer. Это позволяет вам настраивать то, как каждый интент представляется вашим пользователям.
Возникли проблемы с настройкой интентов? Наша команда поддержки готова помочь: