Перейти к основному содержимому

Экспорт и импорт проекта

Вы можете сохранить в файл копию проекта или только его настройки. Это удобно для переноса данных между аккаунтами и окружениями, создания шаблонов и резервного копирования.

Для экспорта и импорта требуется роль не ниже KHUB_OWNER.

Проект целиком​

Данные проекта — источники, чанки и настройки — сохраняются в ZIP-архив.

Чанки, выгруженные в составе проекта, можно отредактировать вручную.

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

Состав архива​

✔️ ZIP-архив проекта содержит следующие данные:

  • files — папка с документами-источниками.
  • chunks.ndjson — результат индексации: все чанки, в том числе суммаризации, вместе с их эмбеддингами.
  • settings.json  — настройки проекта.
  • manifest.json — информация о проекте и список источников.

❌ Следующие данные не попадают в архив:

Экспорт проекта​

  1. Откройте проект и перейдите в раздел Импорт и экспорт.
  2. Нажмите Экспортировать.
  3. Выберите Проект целиком. Нажмите Подтвердить.
  4. Если вы экспортируете проект повторно после внесения изменений, нажмите Запустить заново.
  5. Jay Knowledge Hub запустит подготовку архива в фоне. Нажмите вверху страницы, чтобы посмотреть статус и скачать результат.
примечание

Архив хранится 2 часа с момента создания. После этого он удаляется автоматически. Скачайте архив сразу после получения уведомления.

Ручное редактирование чанков​

Чанки, выгруженные в составе проекта, можно отредактировать — например, уточнить формулировки или добавить ответы на частые вопросы.

предупреждение

Эта возможность предназначена для лингвистов-разработчиков и специалистов по работе с данными и предполагает самостоятельную подготовку чанков и эмбеддингов для них. Убедитесь в корректности внесенных изменений.

Чтобы отредактировать чанки:

  1. Распакуйте ZIP-архив.
  2. Откройте файл chunks.ndjson в текстовом редакторе.
  3. Добавьте или отредактируйте чанки.
  4. Чтобы чанки сохранились при переиндексации базы знаний, добавьте в их JSON-объекты поле "persistent": true.
  5. Сохраните файл, упакуйте проект обратно в ZIP. Включайте в архив не папку, в которую был распакован проект, а только ее содержимое.

Persistent-чанки​

Чанки с атрибутом "persistent": true остаются в базе знаний при переиндексации. Однако при удалении проекта или источника они удаляются вместе с остальными.

Метка persistent у чанка:

Импорт проекта​

Импорт всегда создает новый проект. Если проект с таким именем уже существует в аккаунте, Jay Knowledge Hub добавит к имени суффикс _imported_<случайный код>.

Загрузить данные в существующий проект нельзя.

  1. Перейдите на страницу Проекты.
  2. Перетащите ZIP-архив в область загрузки или нажмите на нее, чтобы выбрать файл. Нажмите Импортировать.
  3. Jay Knowledge Hub загрузит и обработает архив в фоне. Нажмите вверху страницы, чтобы посмотреть статус и перейти в импортированный проект.

Если значения импортируемых настроек не подходят для текущего окружения, Jay Knowledge Hub автоматически корректирует их. Подробнее об этом смотрите в подразделе Валидация настроек ниже.

Ограничения​

ОграничениеЗначение
Максимальный размер архива1 Гб: слишком большие проекты не получится ни экспортировать, ни импортировать.
Основной объем занимают источники — перед экспортом оценить их размер (без учета сжатия) можно в разделе Источники
Время хранения архива экспорта2 часа: после истечения архив удаляется автоматически
Параллельные операции1 активный импорт на аккаунт
1 экспорт на проект

Только настройки​

Настройки проекта сохраняются в JSON-файл.

Экспорт настроек​

  1. Откройте проект и перейдите в раздел Импорт и экспорт.
  2. Нажмите Экспортировать.
  3. Выберите Только настройки. Нажмите Подтвердить.

Импорт настроек​

  1. Откройте проект и перейдите в раздел Импорт и экспорт.
  2. Нажмите Импортировать.
  3. Перетащите файл с настройками в область загрузки или нажмите на нее, чтобы выбрать файл. Нажмите Подтвердить.

Валидация настроек​

Если значения настроек в импортируемом файле не подходят для текущего окружения, Jay Knowledge Hub автоматически корректирует их. В уведомлении о завершении импорта вы можете посмотреть список таких настроек с исходным и примененным значением.

Возможные типы ошибок:

  • Значение выходит за допустимый диапазон. В этом случае Jay Knowledge Hub применяет ближайшее граничное значение.
  • Значение недоступно в целевом окружении — например, отсутствует указанная модель. Jay Knowledge Hub заменяет его на значение по умолчанию.
  • Недостаточно прав для применения настройки — например, ваша роль не позволяет редактировать промт. В случае импорта проекта Jay Knowledge Hub применяет значение по умолчанию, а в случае импорта настроек в существующий проект — оставляет прежнее значение.
к сведению

Если векторизатор исходного проекта был заменен, переиндексируйте проект после импорта.