Типы сущностей

Обновлено 15 декабря 2023

Code

Brain

Сущность — единица NLU-ядра Brain, которая представляет собой последовательность слов, объединенных некоторым смыслом или правилом. Например, имена, дата и время, местоположение.

Пользовательские сущности

Пользовательские сущности — это сущности, которые вы самостоятельно заполняете и настраиваете в редакторе сущностей.

Чтобы создать пользовательскую сущность:

1. На панели слева выберите вкладку Редактор → Сущности.
2. На вкладке Мои сущности нажмите Создать сущность и заполните ее поля:
3. В поле Название укажите имя сущности.
4. Задайте настройки сущности.
5. Добавьте значения сущности в справочник.

Все изменения сохраняются автоматически.

Включить или отключить определение сущности можно с помощью переключателя в правом верхнем углу редактора.

Настройка пользовательских сущностей

Вы можете настроить поведение сущности в разделе Настройки.

Используйте переключатель Сделать сущность клиентской, чтобы значения сущности были уникальны для каждого пользователя.

В раскрывающемся списке Исправление орфографии:

• Выберите Исправлять опечатки, если хотите, чтобы сущность определялась после исправления опечаток. Исправление опечаток выполняется с учетом клиентского словаря.
• Выберите Не исправлять опечатки, если хотите, чтобы сущность определялась без исправления опечаток, независимо от настроек проекта. Таким образом, если во фразе есть значение сущности с опечаткой, Code не определит данную сущность.

Если список не раскрывается, убедитесь, что в настройках проекта активен флажок Исправление орфографии.

Установите флажок Приводить слова к нормальной форме, если хотите, чтобы перед определением сущности все слова в запросе были приведены к нормальной форме. Приведение к нормальной форме доступно только для русского и английского языков.

Значения справочника сущности не приводятся к нормальной форме вне зависимости от включения параметра. Для корректной работы сущностей нужно вносить значения в справочник в нормальной форме.

Установите флажок Использовать нечеткий поиск / поиск по подстроке, чтобы включить нечеткий поиск сущности.

По умолчанию сущность в запросе определяется только при строгом совпадении значений. Например, если наименование сущности состоит из нескольких слов, необходимо, чтобы в запросе присутствовали все эти слова и шли в заданном порядке.

При включенном нечетком поиске для определения сущности допускается:

• наличие посторонних слов между словами, составляющими название сущности.
• отсутствие в запросе некоторых слов, составляющих название сущности.

Добавление значений сущности

Чтобы добавить значение:

1. В разделе Справочник нажмите Добавить запись.

2. Выберите один способ, с помощью которого будет задана запись:

   • Синонимы позволяет указать синонимы и варианты написания, которые считаются эквивалентными этому значению.
   • Pattern позволяет указать формальное правило, описывающее ключевые слова и выражения. Используйте базовые элементы паттернов.

Нажмите кнопку DATA, чтобы задать значение сущности в формате string или JSON.

Вы также можете импортировать CSV-справочник сущности.

Системные сущности

Системные сущности — это встроенные сущности, которые вы можете активировать в редакторе сущностей.

Чтобы включить распознавание системных сущностей:

1. На панели слева выберите вкладку Разработка → Редактор → Сущности.
2. Выберите вкладку Системные.
3. Выберите сущность в списке, чтобы просмотреть ее описание и распознаваемые форматы.
4. Включите сущность с помощью переключателя.