Экспорт и импорт сущностей

Обновлено 12 февраля 2024

Code

Brain

С помощью Code вы можете импортировать и экспортировать сущности в файлах формата JSON.

Вы также можете импортировать справочник отдельной сущности в формате CSV.

Экспорт и импорт поможет при переносе сущностей между проектами.

Обратите внимание: при импорте проекта происходит сброс текущей обученной модели классификатора на модель Brain, поэтому после завершения импорта рекомендуются обязательно пересобрать сценарий или запустить тестирование в разделе Интенты или Сущности.

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

Чтобы экспортировать сущности проекта:

1. Откройте проект в Code.
2. Перейдите в раздел Редактор → Сущности.
3. Нажмите кнопку Экспорт.

Браузер загрузит JSON-файл, который содержит массив сущностей с описанием настроек и записей справочника.

Чтобы импортировать сущности проекта:

1. Откройте проект в Code.

2. Перейдите в раздел Редактор → Сущности.

3. Нажмите кнопку Импорт.

4. Выберите нужный JSON-файл с описанием сущностей

   Максимальный размер файла — 10 Мб.

5. В окне Импорт сущностей задайте параметры импорта.

   Параметры определяют поведение Code при совпадении путей или названии сущностей.

6. Нажмите кнопку Импортировать.

Сущности будут импортированы в соответствии с заданными параметрами.

Пример JSON-файла с описанием сущностей проекта

Каждый объект в массиве содержит поля entity и records с описанием параметров сущности и данными записей соответственно.

[
    {
        "entity": {
            "id": 45002,
            "name": "Сity",
            "type": "annotation",
            "enabled": true,
            "noSpelling": true,
            "noMorph": false,
            "fuzzySearch": false,
            "client": false
        },
        "records": [
            {
                "type": "pattern",
                "rule": ["(Москв*/МСК)"],
                "value": "{\n  \"name\": \"Москва\"\n}",
                "id": 1798875
            },
            {
                "type": "synonyms",
                "rule": ["Санкт Петербург", "СПб", "Ленинград"],
                "value": "{\n  \"name\": \"Санкт-Петербург\"\n}",
                "id": 1798874
            }
        ]
    }
]

Описание полей.

Поле	Описание
entity	object В этом блоке передается вся информация о создаваемой сущности
id	number Идентификатор сущности
name	string Имя сущности
type	string Тип сущности. Поддерживается только тип annotation
enabled	boolean Включение и отключение распознавания сущности
noSpelling	boolean Включение и отключение исправления орфографии
noMorph	boolean Включение и отключение приведения слов к нормальной форме
fuzzySearch	boolean Включение и отключение нечеткого поиска (поиска по подстроке)
client	boolean Признак клиентской сущности
records	array Массив, описывающий записи справочника
id	number Идентификатор записи
type	string Тип записи. Возможные значения: pattern — паттерны; synonyms — список синонимов.
rule	array of strings Массив с правилами распознавания сущности
value	string Дополнительные данные записи

Импорт справочника значений сущности

Кроме импорта всех сущностей, вы можете импортировать CSV-справочник отдельной сущности.

Для этого:

1. Откройте проект в Code.
2. Перейдите в раздел Редактор → Сущности.
3. Выберите сущность, в которую нужно импортировать справочник.
4. Нажмите кнопку Импорт справочника.
5. Выберите CSV-справочник для импорта.
6. Нажмите кнопку Импортировать.

Формат импортируемого файла полностью соответствует формату справочников именованных сущностей, подключаемых к сценарию.

Пример csv-справочника:

1;Москва, МСК;{"name": "Москва"}
2;Санкт-Петербург, СПб, Ленинград;{"name": "Санкт-Петербург"}

Слова, перечисленные во втором столбце через запятую, задаются в сущности как синонимы.

Объекты в третьем столбце задаются в сущности как данные, характеризующие запись.