Разделы документации
Обзор коннекторов
Все восемь источников данных Charo — вики, хранилища, задачи, почта, сайты и файлы. Какие переносят права доступа из источника.
Что такое коннекторы
Коннектор подключает источник знаний к Charo: система периодически забирает из него документы, индексирует их и делает доступными в поиске и ответах ассистента. Коннекторы добавляются на странице Админка → Добавление коннектора.
Источников восемь. Список закрытый: подключить можно только то, что есть в таблице ниже. Для систем, которых в списке нет, остаются два обходных пути — «Веб-сайты» (индексация внутреннего портала по ссылкам) и «Загрузка файлов» (выгрузки из любых систем).
Как добавляется коннектор
Настройка проходит в три шага (у части коннекторов шагов меньше):
- Учётные данные — выберите сохранённые или создайте новые: токен, ключ API или сервис-аккаунт источника. Что именно нужно и где это взять — на странице конкретного коннектора. Учётным данным не нужны никакие права, кроме чтения: Charo ничего не пишет обратно в источник.
- Настройка — название коннектора и параметры источника: что именно индексировать (пространства, проекты, диски, бакеты). У BookStack параметров нет: индексируется всё, что доступно учётным данным.
- Расширенная конфигурация (необязательно) — «Частота обновления» (в минутах), «Частота очистки» устаревших документов (в часах) и «Дата начала индексации».
Там же задаётся доступ к документам коннектора:
| Вариант | Что означает |
|---|---|
| Приватный | документы видны выбранным группам пользователей Charo |
| Общий | документы видны всем пользователям Charo |
| Автосинхронизация прав | Charo наследует права источника и показывает документ только тому, кому он там доступен |
«Приватный» и «Автосинхронизация прав» требуют активной лицензии: без неё блок выбора доступа не показывается и все коннекторы общие. Подробнее — «Права доступа».
Все коннекторы
В списке источников админки коннекторы сгруппированы по разделам: базы знаний и вики, облачные хранилища, тикеты и задачи, мессенджеры и прочее.
| Источник | Что индексируется | Синхронизация прав |
|---|---|---|
| Confluence | страницы, комментарии, вложения | ✓ |
| BookStack | полки, книги, главы, страницы | ✓ |
| Google Drive | файлы общих дисков и «Моих дисков» | ✓ |
| S3-совместимые хранилища | объекты бакета | — |
| Jira | задачи с комментариями | ✓ |
| Электронная почта (IMAP) | письма выбранных папок | — |
| Веб-сайты | страницы сайта и PDF по ссылкам | — |
| Загрузка файлов | загруженные документы и ZIP-архивы | — |
В интерфейсе карточки подписаны короче, чем страницы этой документации: «Почта» — это IMAP, «S3» — S3-совместимые хранилища, «Веб» — веб-сайты, «Файл» — загрузка файлов.
Из документов и вложений извлекается текст, а со сканов и изображений он распознаётся — отдельно включать это не нужно. Исключение одно: при обходе сайтов картинки не распознаются.
Единственный источник в списке, которому нужен доступ в интернет, — Google Drive: серверу Charo потребуется сетевой доступ к API Google. Confluence, Jira, BookStack и S3-совместимые хранилища подключаются внутри вашего контура.
Набор карточек может быть уже: администратор установки вправе скрыть отдельные источники, а также целиком раздел «Прочее» — «Веб» и «Файл». Если нужной карточки нет, начните с настроек своей инсталляции.
Синхронизация прав
Права наследуют четыре источника: Confluence, BookStack, Google Drive и Jira. Для остальных четырёх доступ задаётся только внутри Charo — видимостью коннектора и группами пользователей.
Наследование прав означает, что Charo забирает права из самой подключённой системы: документ найдёт только тот, кому он доступен в источнике. Все четыре источника переносят и состав групп, поэтому доступ, выданный группе, работает без перечисления людей.
Права пересинхронизируются по собственному расписанию, независимо от индексации документов — примерно раз в пять минут.
Оговорки по источникам:
- Google Drive переносит состав групп только при заполненном поле «Email администратора Workspace». Без него права файлов синхронизируются, а группы — нет.
- Jira не различает права отдельных задач: читатели задачи — это читатели её проекта.
- BookStack требует, чтобы у токена были права на управление ролями и пользователями. Полка при этом не передаёт права стоящим на ней книгам.
Если нужного источника нет
Напишите на contact@charo.tech — расскажите, какую систему хотите подключить.