Справочники именованных сущностей в Code

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

Code

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

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

Сущности задаются в файлах с расширением .csv в следующем формате:

id; имя; значение

Где:

• id — уникальный идентификатор сущности;
• имя — имя сущности. Внутри элемента вы через запятую можете перечислить синонимы. При подключении справочника к сценарию, указанные слова станут элементами паттерна, на который будет реагировать бот;
• значение — значение сущности, string или json. Значение может содержать дополнительную информацию о сущности, которая может быть использована в сценарии.

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

Пример части справочника именованных сущностей:

149;Кузьма;{"name": "Кузьма", "sex": "male"}
150;Карл;{"name": "Карл", "sex": "male"}
151;Клавдий;{"name": "Клавдий", "sex": "male"}
152;Клод;{"name": "Клод", "sex": "male"}
153;Константин,Костя;{"name": "Константин", "sex": "male"}
154;Климент;{"name": "Климент", "sex": "male"}

Подключение справочника

Справочники подключаются с помощью тега require, в котором требуется указать путь к файлу, а также значения параметров name и var:

require: dictionary/cities.csv
         name = City
         var = $City

Где:

• Параметр name требуется при создании именованного паттерна, использующего данный словарь;
• Параметр var необходим для доступа к содержимому словаря из скриптовых вставок.