Интенты

Настройте пользовательское определение интентов для улучшения способности вашего чат-бота распознавать и отвечать на конкретные потребности пользователей.

Обзор

Интенты - это предопределенные шаблоны пользовательских запросов, которые запускают конкретные ответы или действия. Они позволяют вашему чат-боту:

  • Распознавать, когда пользователям нужна помощь человека
  • Обнаруживать конкретные запросы информации, такие как цены или детали продукта
  • Определять потребности в поддержке или устранении неполадок
  • Запускать пользовательские рабочие процессы на основе ввода пользователя

Когда интент обнаружен, система может вернуть предопределенный ответ или запустить специальное действие, такое как перенаправление к человеку-агенту или получение конкретной информации.

Настройка

Вы можете настроить интенты через Панель управления проекта в разделе "Интенты" в меню проекта. Это дает вам полный контроль над созданием пользовательских интентов, которые соответствуют вашим конкретным потребностям.

JSON Схема

Интенты настраиваются с использованием 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 Для обработки запросов о статусе заказа

Коды ответов, которые вы определяете, используются в вашем приложении для определения того, как обрабатывать конкретные пользовательские интенты. У вас есть полная свобода создавать любые коды ответов, которые соответствуют вашим бизнес-потребностям.

Лучшие практики

  • Включайте вариации: Для каждого интента включайте несколько формулировок для улучшения точности обнаружения
  • Будьте конкретны: Сосредоточьтесь на четких, конкретных интентах, а не на широких, общих категориях
  • Тщательно тестируйте: Тестируйте настроенные интенты с реальными пользовательскими запросами для обеспечения точного обнаружения
  • Ограничивайте перекрытие: Избегайте значительного перекрытия между различными образцами интентов для предотвращения путаницы
  • Регулярно обновляйте: Пересматривайте и обновляйте ваши интенты по мере того, как вы узнаете больше о поведении и потребностях ваших пользователей
  • Используйте осмысленные коды ответов: Создавайте описательные коды ответов, которые четко указывают цель каждого интента

API Интеграция

Когда интент обнаружен через Chat API, ответ будет включать is_intention: true и возвращать указанный код ответа. Ваше приложение отвечает за обработку этого кода ответа и предоставление соответствующего пользовательского сообщения:

API Ответ с обнаруженным интентом
{
  "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. Это позволяет вам настраивать то, как каждый интент представляется вашим пользователям.

Примеры использования

Поддержка клиентов

  • Запросы на эскалацию к человеку
  • Обнаружение запросов о выставлении счетов
  • Определение запросов на возврат

Продажи и цены

  • Перенаправление запросов о ценах
  • Вопросы о планах оплаты
  • Информация о подписочных сборах

Нужна помощь?

Возникли проблемы с настройкой интентов? Наша команда поддержки готова помочь: