Confluence: интеграция с AI Flowi Workflow
Автор: Ai Flowi · Опубликовано
Официальный источник: документация Confluence Cloud REST API
Интеграция Confluence предоставляет компонент для чтения вики, который настраивается с помощью URL сайта, имени пользователя, ключа API и ключа пространства. Используйте его для исследования содержимого разрешённого пространства в последующем процессе работы с документами. Экспортированный интерфейс Confluence в AI Flowi Workflow имеет выход JSON и не содержит описанной операции записи страниц.
Его описание в каталоге: Платформа совместной работы с вики Confluence
. Чтение пространства с настройками ниже — пример настройки.
1. Выберите разрешённую область источника
Подтвердите адрес сайта и тип развёртывания для этой учётной записи; ограничьте первую проверку разрешёнными искусственными страницами.
Ключ пространства выбирает запрашиваемый источник, но не создаёт разрешения на чтение каждой страницы. Установите, какую учётную запись использует запрос, и сравните возвращённый материал со страницами, доступными этой учётной записи. Последующая копия может попасть к другой аудитории, поэтому проверьте место назначения перед перемещением закрытого текста вики в другой сервис.
Этот контракт источника дополняет каталог компонентов, где компонент указан среди других сервисов. Для механизмов учётных данных, уже описанных во всём продукте, используйте раздел подключений, не рассматривая ключ API вики как подключение Google OAuth.
2. Заполните семь экспортированных входов
Шесть полей отмечены как обязательные. Только max_pages необязателен; без этого поля поведение ограничения числа страниц остаётся непроверенным, и его отсутствие не доказывает чтение всего пространства.
Пример по каталогу; Ai Flowi не проверяла его в рабочей среде.
| Поле | Что выбрать | Тип / обязательность | Типы подключений / варианты |
|---|---|---|---|
api_key | Настройте собственные учётные данные источника в закрытом поле; процедура выдачи учётных данных здесь не установлена. | str / Да | Wiki: input_types — [] |
cloud | Выберите логическое значение, соответствующее вашему развёртыванию; оно обязательно, хотя его интерпретация при выполнении не экспортирована. | bool / Да | Wiki: input_types отсутствует |
content_format | Выберите один из перечисленных форматов содержимого и изучите реальное представление перед форматированием для места назначения. | str / Да | Wiki: input_types отсутствует; варианты: “body.editor”, “body.export_view”, “body.anonymous_export_view”, “body.storage”, “body.view” |
max_pages | Используйте намеренно небольшое целое число при проверке охвата; значение по умолчанию, максимум и контракт пагинации не перечислены. | int / Нет | Wiki: input_types отсутствует |
space_key | Укажите идентификатор исходного пространства, подтверждённый в собственной вики, а не его отображаемое название, если они различаются. | str / Да | Wiki: input_types отсутствует |
url | Используйте адрес нужного сайта Confluence; проверьте требования к конечной точке в редакторе. | str / Да | Wiki: input_types отсутствует |
username | Укажите идентификатор авторизованной учётной записи, ожидаемый вашим развёртыванием и схемой учётных данных. | str / Да | Wiki: input_types отсутствует |
3. Решите, какое представление содержимого проверить
Варианты content_format: "body.editor", "body.export_view", "body.anonymous_export_view", "body.storage" и "body.view". Это точные значения параметра из каталога. Их названия не гарантируют результат в виде обычного текста, переносимый формат документа или сохранение макросов страниц.
Для проверки на искусственных тестовых данных выберите "body.view" и сравните возвращённый текст с видимой страницей вики. Если месту назначения нужен обычный текст, проверьте возвращённое содержимое вики на разметку перед выбором преобразования. Значение формата содержимого со словом «export» не устанавливает охват вложений, комментариев или редакций.
Также "body.anonymous_export_view" не отменяет необходимость обязательных полей имени пользователя и ключа API. Каталог сохраняет эти обязательные входы независимо от выбранного формата. Проверяйте доступ явно, не выводя поведение аутентификации из названия варианта.
4. Проведите исследование источника с заданными границами
- Создайте или выберите небольшое разрешённое тестовое пространство с содержимым, заголовок и текст которого вы можете изучить. Запишите страницы, которые ожидаете получить через свою учётную запись.
- Добавьте Confluence. Задайте
url,username,api_keyиspace_keyс помощью собственных настроек источника. Выберитеcloudдля этой среды. - Задайте
content_formatкак"body.view"для этой проверки иmax_pagesкак2в качестве примерного ограничения. Выбранное число не является зафиксированным выходом или утверждением о полноте. - Изучите выход JSON
data. Найдите реальный текст страниц, идентификаторы и присутствующие ссылки на источник. Экспорт не задаёт схему ключей результата, поэтому проверяйте имена, а не придумывайте их. - Сравните возвращённые страницы с ожидаемым тестовым набором. Проверьте, что происходит, когда учётная запись не может прочитать страницу и когда достигается выбранный предел страниц.
- Только после подтверждения структуры настройте принимающий компонент, совместимый с JSON. Сохраните доступ к первому результату источника для проверки последующего преобразования.
5. Рассматривайте выход как источник, а не готовый документ
Отображаемое имя выхода — JSON, его порт — data, а объявленный тип — JSON. Для этого компонента не экспортированы Table, Message или отдельный порт ошибок. Это различие определяет, какие следующие узлы могут принять выход напрямую.
Изучите Parser, решая, как содержимое вики должно стать текстом для целевого сервиса, и руководство Confluence to Google Docs для подготовки проверенной копии выбранных страниц вики.
Каковы ограничения охвата вики в интеграции Confluence?
Эта категория не предоставляет действий создания страницы, редактирования страницы, комментирования или триггера событий. В экспортированных входах также нет выбора по идентификатору страницы, переключателя вложений, курсора для инкрементального чтения или управления историей версий. Выбор пространства и ограничение числа страниц не доказывают согласованное чтение всех страниц вики.
Не используйте этот пример для архивного экспорта, который должен сохранять все связи, вложения и редакции. Избегайте его, если не можете подтвердить право доступа к источнику или контролировать аудиторию последующего текста. Повторные запуски и ошибки сервиса требуют проверки в вашей среде; успешный объединённый процесс здесь не заявлен.
Если цель — векторный поиск, отдельно изучите контракт Pinecone. Его настройки индекса, пространства имён и эмбеддингов не наследуют правила доступа вики автоматически, поэтому и чтение источника, и поиск должны иметь подходящие границы доступа.
Использование и расходы на сервис
Считайте фактические запуски и последующие узлы, а ограничения сервиса проверяйте независимо. Другие контракты источников представлены в каталоге интеграций.