Создание интента

Обновлено 25 марта 2024

Code

Brain

Интент — ключевая единица NLU-сервиса, объединяющая в себе набор фраз, намерение пользователя и другую метаинформацию.

Подробнее об использовании интентов в сценарии, определении интентов и настройке правил активации

Создание интента

Войдите в проект, на панели управления нажмите Редактор > Интенты. Вы перешли в справочник интентов для проекта.

Нажмите Создать интент. Заполните поля:

• Название — укажите название интента. Полный путь интента рассчитывается автоматически и отображается под полем ввода, он используется при обращении к интенту из сценария.
• Описание — укажите дополнительное описание или комментарий.
• Ответ — укажите стандартный ответ на интент. Вы можете обратиться к нему из сценария как $context.intent.answer.
• Тренировочные фразы — укажите примеры тренировочных фраз для распознавания данного интента.

Вы можете также создать вложенный интент. Для этого нажмите иконку

напротив названия интента > Создать вложенный интент. Уровень вложенности интентов не ограничен.

Интенты формируют дерево на правой панели. Узлы дерева отсортированы в лексикографическом порядке. Для каждого узла указывается число примеров фраз в данном интенте и через символ / число всех дочерних фраз.

Заполнение слотов для интента

Slots (слоты) — данные, которые клиент передает с запросом или в процессе дозапроса. У каждого слота есть обязательные атрибуты: Имя, Тип.

Подробнее о процессе дозапроса информации Slot filling

Для заполнения слотов нажмите Добавить слот. Заполните поля:

• Название — название слота.
• Сущность — выберите из списка сущность, определяющую тип данных, которые попадут в слот. Вы можете использовать как системные, так и кастомные сущности.
• Обязательно — переведите переключатель в активное положение, если слот является обязательным для заполнения.
• Массив — переведите переключатель в активное положение, чтобы в слот помещались все сущности данного типа, оформленные как массив.
• Вопросы — укажите вопросы, которые будут использованы при процессе Slot filling.

Подробнее о механизме обработки уточняющих вопросов

Экспорт и импорт интентов

Для экспорта интентов перейдите в раздел Настройки проекта на вкладку Экспорт/Импорт. Нажмите кнопку Экспорт проекта. В экспортированном архиве в файле caila_import.json будут все данные проекта по работе с NLU-ядром Brain.

Вы можете использовать этот архив или отдельные файлы для загрузки в новый проект.

Для импорта интентов перейдите в раздел Настройки проекта на вкладку Экспорт/Импорт. В пункте Импорт проекта нажмите на Прикрепить файл или перетащить его сюда и выберите архив проекта. Также вы можете импортировать интенты на странице Интенты. Для этого сформируйте .json файл следующего формата:

{
    "classes": [
        {
            "path": "/PlayGames/Games", // путь к интенту
            "description": "", // описание
            "disabled": false, // при `false` интент активен
            "phrases": [
                "давай поиграем в какие-нибудь игры" // тренировочные фразы
            ]
        },
        {
            "path": "/PlayGames/Games/CanYouPlay",
            "description": "",
            "disabled": false,
            "phrases": ["ты умеешь во что-нибудь играть?", "ты знаешь какие-нибудь игры?", "ты знаешь как играть?"]
        }
    ]
}

Вверху дерева интентов нажмите Импорт > загрузите файл.