Справочники именованных сущностей используются для обработки большого количества именованных сущностей с помощью паттернов.
Именованная сущность — это слово или словосочетание, которое выделяет предмет или являение в ряде аналогичных предметов или явлений. Примерами именованных сущностей являются названия городов, стран, валют.
Сущности задаются в файлах с расширением .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необходим для доступа к содержимому словаря из скриптовых вставок.