Наряду со стандартными сущностями и справочниками, Graph дает вам возможность создавать свои собственные справочники, чтобы смартап мог извлекать из фразы пользователя сущности из вашей базы данных.
Как создать свою сущность
Для этого в меню редактора смартапа есть пункт Сущности. При клике откроется страница, где вы можете создавать сущности и управлять ими. Эти сущности можно использовать аналогично стандартным сущностям и справочникам.
Как создать справочник
Все управление пользовательскими справочниками происходит на вкладке Сущности в редакторе смартапа. Вкладка содержит список системных справочников и кнопку Создать сущность.
При нажатии на Создать сущность, открывается окно, в котором необходимо указать название нового справочника.
Название справочника может содержать только латинские буквы, цифры и знак подчеркивания.
Сущности справочника
Каждая сущность — это идентификатор записи в вашем справочнике. Для каждой записи нужно указать хотя бы один синоним на естественном языке, чтобы смартап понимал, какие именно слова пользователя относятся к этой записи.
Синонимы нужно указывать в словарной форме слова (именительный падеж единственного числа). Смартап будет автоматически понимать эти синонимы в других формах во время работы.
Сущности с несколькими значениями
Чтобы создать сущность, которая будет содержать несколько значений, в поле Имя нужно вписать значения в формате JSON.
Например:
{"name":"Иван", "surname":"Иванов", "eyes":"голубые", "height":"181"}
где «name» — это название одного из полей, а «Иван» — значение, которое хранится в этом поле.
В сценарии можно обратиться к конкретному полю из значения сущности, указав его как $<имя справочника>.<имя поля>.
Загрузка справочника
Вы можете загрузить список сущностей и их синонимов, описанных в CSV или XLS-файле.
Для этого:
Откройте проект Graph.
Перейдите в раздел Сущности.
Создайте новый справочник.
Вы также можете выбрать уже существующий пользовательский справочник.
Откройте справочник, в который нужно загрузить список сущностей, и нажмите кнопку Загрузить справочник.
Прикрепите CSV или XLS-файл со списком сущностей и нажмите кнопку Загрузить.
Максимальный размер файла — 1 Мб.
Загруженный список сущностей и их синонимов отобразится в справочнике.
При включении опции Добавлять значения сущностей в формате JSON вы сможете загрузить справочник, содержащий не только синонимы сущностей, но и их значения в JSON-формате. Это позволит использовать поля из значений сущностей в сценарии смартапа.
При использовании значений сущностей в формате JSON строки нужно записывать следующим образом:
- В строке для сущности сначала указывается JSON со значениями сущности, а затем синонимы.
- Если вы загружаете справочник в формате CSV, синонимы должны отделяться от объекта JSON точкой с запятой, а сами синонимы между собой отделяются запятыми.
Пример строки CSV-файла:
{"name":"macbook","full":"MacBook Pro 13"}; mackbook, mac, mac book, macos
В сценарии можно обратиться к конкретному полю из значения сущности, указав его как $<имя справочника>.<имя поля>.