This site is no longer updated.Go to new Conversational Cloud docs

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


.csv — справочники именованных сущностей.

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

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

Задаются в виде файла с расширением .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 же используется для доступа к содержимому словаря из скриптовых вставок.