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

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

примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

   • Параметры для доступа к Confluence:

     • Если вы используете Confluence Data Center или Confluence Server, вставьте ссылку на Confluence, а также токен (маркер) доступа.

       Как получить токен доступа

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

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

     • Если вы используете Confluence Cloud, укажите свой сайт (поддомен) на atlassian.net.

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

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

     подсказка

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

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

   примечание

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

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

4. Если вы подключаете Confluence Cloud, в новой вкладке откроется страница запроса доступа. Войдите в Confluence Cloud и разрешите приложению Jay Knowledge Hub доступ к своим данным.

   к сведению

   Доступ действует в течение года. Затем его нужно будет подтвердить повторно.

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

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

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

к сведению

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