Что это
Confluence REST API дает программный доступ к корпоративной wiki Atlassian: страницам, пространствам, содержимому, меткам, версиям и вложениям. Поиск по условиям можно строить через CQL. При интеграции нужно различать Confluence Cloud и Data Center: набор методов и способы авторизации не взаимозаменяемы.
В AI-проектах API служит источником знаний. Интеграция забирает доступные страницы, очищает разметку, сохраняет идентификаторы и версии, разбивает текст на фрагменты и обновляет поисковый индекс. Агент отвечает по этим фрагментам со ссылками на оригиналы, помогает поддержке или готовит сводку по разделу.
Дополнительные сценарии - проверка устаревших страниц, поиск дублей и документов без владельца, подготовка материалов для новых сотрудников. Качество зависит от порядка в wiki: устаревший регламент не становится надежным только потому, что его нашел AI.
Главное ограничение - права доступа. Права сервисной учетной записи не равны правам каждого сотрудника. Интеграция должна проверять доступ пользователя к источнику при поиске и выдаче ответа, обновлять ограничения в индексе и убирать удаленные страницы.
Изменение wiki отделяют от чтения: сначала черновик, затем проверка владельцем страницы и запись с журналом. Нужны контроль версии, обработка конфликтов и возможность восстановить предыдущий текст. На старте безопаснее проверить поиск в одном пространстве без прав на публикацию.
Ключевые параметры
- Категория: RAG и базы знаний
- Сложность: Для разработчика
- Запуск: Один рабочий день
- Open-source: Нет
- Данные: Высокий контроль
- Чувствительные данные: Только с настройками
Доступные модели и версии
Сильные стороны
- Доступ к страницам, пространствам, меткам, версиям и поиску CQL.
- Сохранение ссылок на оригинальные источники в RAG.
- Синхронизация корпоративной базы знаний с AI-поиском.
- Сценарии аудита, проверки актуальности и онбординга.
- Интеграция знаний с Jira, Slack и внутренними сервисами.
Ограничения
- Cloud и Data Center требуют учета своих методов и авторизации.
- Макросы, вложения и форматы содержимого требуют аккуратного разбора.
- Нужна отдельная проверка прав сотрудника, а не только сервисной учетной записи.
- Устаревшие и противоречивые страницы ухудшают AI-ответы.
- Нужны обработка лимитов, повторные запросы и удаление устаревших записей индекса.
- Публикация правок требует контроля версии и подтверждения.
Как использовать
1. Уточните редакцию Confluence, выберите одно пространство и разрешенные сценарии чтения.
2. Настройте авторизацию с минимальными правами; храните секреты на сервере.
3. Получите страницы с идентификаторами, текстом, метками, версиями, датами и ссылками; учитывайте пагинацию и ограничения API.
4. Очистите разметку и проверьте обработку макросов, таблиц и вложений.
5. Разбейте текст на фрагменты, сохраняя связь с оригинальной страницей и ее версией.
6. Постройте индекс и проверяйте права конкретного пользователя до поиска и выдачи ответа.
7. Настройте повторную синхронизацию измененных, удаленных страниц и ограничений доступа; обрабатывайте лимиты и ошибки.
8. Проверьте ответы на рабочих вопросах: ссылка на источник, актуальность и честное сообщение, когда факт не найден.
9. Добавляйте запись отдельно: черновик, подтверждение владельца, контроль версии и журнал изменений.
Примеры сценариев
- Поддержка получает черновик ответа по инструкции с доступной ей ссылкой на Confluence.
- Новый сотрудник находит правила внутренних процессов без доступа к закрытым разделам.
- Владелец базы знаний получает список устаревших страниц, дублей и документов без ответственного.
- Команда получает сводку по пространству перед планированием.
- Индекс обновляется по измененным страницам и удаляет недоступные источники.
Доступ и оплата
- Модель оплаты: Платно
- Работа в РФ: Ограниченно
- VPN: Иногда может понадобиться
- Русский интерфейс: Частично
- Русский язык: Хорошо
Используйте минимальные права и хранение секретов на сервере. Проверяйте права конкретного сотрудника, версию источника и актуальность ограничений в индексе. Не используйте сервисный доступ как разрешение показывать все документы всем.
Какой тариф выбрать
- Начните с чтения одного пространства и проверьте поиск и ограничения доступа.
- Учитывайте свой тариф Confluence и расходы на модель, embeddings, индекс и синхронизацию.
- Перед расширением приведите в порядок владельцев, версии и структуру страниц.
- Запись добавляйте после тестов на копии и настройки подтверждения.
Когда не подходит
- индексация всей wiki без ACL и владельцев данных
- публикация AI-правок в Confluence без approval
- ответы по закрытым страницам пользователю без соответствующих permissions
- полная замена процесса актуализации базы знаний
- поиск по wiki без проверки версии, даты обновления и качества источника
- индексация всей wiki без учета прав доступа и владельцев данных
- ответы AI по закрытым страницам пользователю без соответствующих permissions
- полная замена редактора базы знаний и процесса актуализации
- поиск по документам без проверки freshness и версии страницы
- массовое изменение страниц без approval, audit log и rollback
Альтернативы
Notion API проще для гибких баз и небольших команд, Google Drive API и SharePoint API подходят для файлового документооборота, GitBook и Document360 удобны для публичной документации. Confluence API хорош, если знания уже живут в Atlassian-экосистеме.
