Сущность — единица NLU-ядра Brain, которая представляет собой последовательность слов, объединенных некоторым смыслом или правилом. Например, имена, дата и время, местоположение.
Brain предоставляет для работы:
- Системные сущности — встроенные сущности, которые вы можете активировать в редакторе сущностей.
- Пользовательские сущности — сущности, которые вы заполняете и настраиваете в редакторе сущностей самостоятельно.
Пользовательские сущности
Пользовательские сущности — это сущности, которые вы самостоятельно заполняете и настраиваете в редакторе сущностей.
Чтобы создать пользовательскую сущность:
- На панели слева выберите вкладку Редактор → Сущности.
- На вкладке Мои сущности нажмите Создать сущность.
- В разделе Параметры укажите название и описание сущности.
- Задайте настройки сущности.
- Добавьте значения сущности в справочник.
Все изменения сохраняются автоматически.
Включить или отключить определение сущности можно с помощью переключателя в правом верхнем углу редактора.
Настройка пользовательских сущностей
Вы можете настроить поведение сущности в разделе Настройки.
Используйте переключатель Сделать сущность клиентской, чтобы значения сущности были уникальны для каждого пользователя.
В раскрывающемся списке Исправление орфографии укажите, как должно работать исправление орфографии для выбранной сущности:
- Выберите Исправлять опечатки, если хотите, чтобы сущность определялась после исправления опечаток. Исправление опечаток выполняется с учетом клиентского словаря.
- Выберите Не исправлять опечатки, если хотите, чтобы сущность определялась без исправления опечаток, независимо от настроек проекта. Таким образом, если во фразе есть значение сущности с опечаткой, Code не определит данную сущность.
Установите флажок Приводить слова к нормальной форме, если хотите, чтобы перед определением сущности все слова в запросе были приведены к нормальной форме. Приведение к нормальной форме доступно только для русского и английского языков.
Значения справочника сущности не приводятся к нормальной форме вне зависимости от включения параметра. Для корректной работы сущностей нужно вносить значения в справочник в нормальной форме.
Установите флажок Использовать нечеткий поиск / поиск по подстроке, чтобы включить нечеткий поиск сущности.
По умолчанию сущность в запросе определяется только при строгом совпадении значений. Например, если наименование сущности состоит из нескольких слов, необходимо, чтобы в запросе присутствовали все эти слова и шли в заданном порядке.
При включенном нечетком поиске для определения сущности допускается:
- наличие посторонних слов между словами, составляющими название сущности.
- отсутствие в запросе некоторых слов, составляющих название сущности.
Добавление значений сущности
Чтобы добавить значение:
- В разделе Словарь синонимов и шаблонов нажмите Добавить.
- Выберите способ, с помощью которого будет задана запись:
- Синонимы — позволяет указать синонимы и варианты написания, которые считаются эквивалентными этому значению.
- Шаблон — позволяет указать формальное правило, описывающее ключевые слова и выражения. Используйте базовые элементы паттернов.
Добавьте как минимум один синоним или шаблон. Нажмите на кнопку Добавить данные JSON, чтобы задать значение сущности в формате string или JSON.
Вы также можете импортировать CSV-справочник сущности.
Системные сущности
Системные сущности — это встроенные сущности, которые вы можете активировать в редакторе сущностей.
Чтобы включить распознавание системных сущностей:
- На панели слева выберите вкладку Редактор → Сущности.
- Выберите вкладку Системные.
- Выберите сущность в списке, чтобы просмотреть ее описание и распознаваемые форматы.
- Включите сущность с помощью переключателя.