Использование сущностей

Обновлено 15 апреля 2024

Code

Brain

Вы можете использовать сущности:

• в сценарии;
• в слотах интентов;
• в паттернах;
• в тренировочных фразах для STS-классификатора.

Использование в сценарии

Все сущности, найденные во фразе пользователя, доступны в сценарии с помощью переменной $jsapi.context().entities или $entities.

Пример:

state:
    q!: Информация по продукту *
    a: Информация по продукту: {{ $entities[0].value }}

Объект entities создается при распознавании запроса пользователя. В других случаях, например при получении event!, возвращается значение undefined.

Создание слотов в интентах

При активации интента данные по соответствующему слоту попадут в переменную $parseTree._<имя слота>.

В этой переменной сохраняется исходный текст, по которому найдено совпадение, либо данные DATA, заданные для данной сущности в редакторе сущностей.

Пример:

    state:
        intent: /купить
        a: Action: {{ $parseTree._Action }}, Product: {{ $parseTree._Product }}

    state:
        intent: /продать
        a: Action: {{ $parseTree._Action }}, Product: {{ $parseTree._Product }}

Подробнее о заполнении слотов в интентах и процессе Slot filling

Использование в паттернах

Сущности можно использовать в паттернах, ссылаясь на них как @<имя сущности> или @<имя сущности>::<имя слота>.

Для сущности, указанной в паттерне, автоматически создается слот и она попадает в дерево разбора parseTree.

Значение сущности будет доступно в сценарии как $parseTree._<имя слота>.

Например:

    state:
        q!: * @Product::p1 *
        a: Информация по продукту: {{ $parseTree._p1 }}

Вы также можете использовать конвертеры в сущностях. Для этого необходимо задать сущность через именованный паттерн с помощью тега patterns, а затем объявить в нем конвертер.

Пример:

patterns:
    $four = @four || converter = function() {return 4}

В примере объявлена сущность @four, для которой задан конвертер converter. Функция конвертера вернет значение 4.