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

Интеграция с Confluence

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

примечание

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

Какие данные будут загружены​

В базу знаний будут загружены все страницы выбранного пространства Confluence, исключая комментарии. Возможность загрузить только отдельные страницы или исключить отдельные страницы не предусмотрена.

Вместе со страницами будут загружены прикрепленные к ним изображения.

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

Изображения загружаются в любом случае.

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

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

Токен доступа к Confluence​

Чтобы предоставить базе знаний доступ к Confluence, необходимо получить токен:

  1. В Confluence нажмите на свой аватар в правом верхнем углу и перейдите в меню Настройки.
  2. В боковой панели выберите Личные маркеры доступа.
  3. Нажмите Создать маркер. Заполните параметры и нажмите Создать.
  4. Скопируйте токен доступа.

Подробнее о токенах доступа читайте в документации Confluence.

Создание интеграции​

Чтобы загрузить данные из Confluence:

  1. Перейдите в раздел Интеграции и нажмите Подключить → Confluence.

    Если при создании проекта вы выбрали Подключить интеграцию с Confluence, то попадете на страницу новой интеграции автоматически.

    Настройки интеграции с Confluence

  2. Укажите настройки интеграции:

    • Название интеграции — отображается в разделе Источники в виде префикса к названиям страниц, загруженных из этой интеграции.

    • Сегмент — к нему будут относиться источники, загруженные из этой интеграции. Сегмент позволяет сгруппировать источники с общей темой. В дальнейшем сегмент можно указывать в запросе к базе знаний для поиска информации только в этом сегменте.

    • Имя пространства — название пространства или раздела (но не ключ и не идентификатор).

    • Ссылка на Confluence — домен, например https://example.atlassian.com.

    • Токен доступа из настроек профиля — см. подраздел Токен доступа выше.

    • Загружать прикрепленные к страницам файлы — включите, чтобы загружать прикрепленные к страницам файлы в допустимых форматах. Эта настройка не влияет на загрузку изображений: они загружаются в любом случае.

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

      подсказка

      Не допускайте размещения некорректных или конфиденциальных данных в выбранном пространстве Confluence, ведь они автоматически появятся в базе знаний при очередной синхронизации.

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

    примечание

    Все настройки впоследствии можно изменить.

  3. Нажмите Подключить.

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

Источники, загруженные из Confluence

В дополнение к данным из интеграций вы можете загрузить файлы вручную.

После загрузки данных нужно проиндексировать базу знаний.

к сведению

О принудительной синхронизации и изменении настроек читайте в разделе Управление интеграциями.