Коннекторы
Коннекторы -- это подключения к внешним хранилищам данных, из которых база знаний загружает документы. Коннектор хранит учётные данные и параметры подключения, что позволяет обращаться к хранилищу многократно без повторной настройки.
Поддерживаемые типы
| Тип | Описание | Примеры использования |
|---|---|---|
| S3 | Amazon S3 и совместимые хранилища (MinIO, DigitalOcean Spaces) | Основные документы, архивы, экспорты |
| GCS | Google Cloud Storage | Документы в Google Cloud |
| Azure | Azure Blob Storage | Документы в Microsoft Azure |
| Local | Локальное хранилище | Файлы на сервере платформы |
Создание коннектора
- Перейдите в раздел База знаний → вкладка Коннекторы
- Нажмите Добавить коннектор
- В открывшейся панели заполните:
- Название -- понятное имя для коннектора (например, "Документы компании")
- Тип -- выберите тип хранилища (S3, GCS, Azure, Local)
- Конфигурация -- параметры подключения (зависят от типа)
Конфигурация S3
Для подключения к Amazon S3 или совместимому хранилищу:
| Параметр | Описание | Обязательный |
|---|---|---|
| Bucket | Имя бакета S3 | Да |
| Region | Регион AWS (например, us-east-1) | Да |
| Access Key ID | Ключ доступа AWS | Да |
| Secret Access Key | Секретный ключ AWS | Да |
| Endpoint URL | Кастомный endpoint (для MinIO, DigitalOcean Spaces и др.) | Нет |
Если вы используете MinIO или другое S3-совместимое хранилище, укажите Endpoint URL в формате http://minio-host:9000. Без этого параметра система будет обращаться к AWS S3.
Конфигурация GCS
Для подключения к Google Cloud Storage:
| Параметр | Описание | Обязательный |
|---|---|---|
| Bucket | Имя бакета GCS | Да |
| Project ID | ID проекта Google Cloud | Да |
| Service Account JSON | JSON-ключ сервисного аккаунта | Да |
Конфигурация Azure
Для подключения к Azure Blob Storage:
| Параметр | Описание | Обязательный |
|---|---|---|
| Container | Имя контейнера | Да |
| Connection String | Строка подключения Azure | Да |
Безопасность
Все учётные данные коннекторов (ключи доступа, пароли, токены) автоматически шифруются перед сохранением в базе данных. При загрузке данные расшифровываются на лету. Это означает:
- Учётные данные никогда не хранятся в открытом виде
- Даже при доступе к базе данных невозможно прочитать ключи
- Шифрование выполняется на уровне приложения
При создании ключей доступа к хранилищу рекомендуется использовать принцип минимальных привилегий. Создайте отдельного пользователя / сервисный аккаунт с правами только на чтение нужных бакетов.
Управление коннекторами
Список коннекторов
На странице коннекторов отображается таблица со следующими колонками:
| Колонка | Описание |
|---|---|
| Название | Имя коннектора |
| Тип | Тип хранилища (S3, GCS, Azure, Local) |
| Статус | Текущий статус: Активен, Неактивен, Ошибка |
| Создан | Дата создания |
Статусы коннектора
| Статус | Описание |
|---|---|
| Активен | Подключение работает корректно |
| Неактивен | Коннектор отключён вручную |
| Ошибка | Проблема с подключением (неверные учётные данные, недоступное хранилище) |
Доступные действия
Через панель действий (при выборе строки):
- Тест -- проверить подключение к хранилищу
- Изменить -- отредактировать параметры коннектора
- Удалить -- удалить коннектор (также удаляются связанные источники)
Тестирование подключения
Перед началом работы рекомендуется протестировать подключение:
- Выберите коннектор в таблице
- Нажмите Тест в панели действий
- Система попытается подключиться к хранилищу и покажет результат:
- Успех -- подключение установлено, отображается превью файлов
- Ошибка -- причина ошибки (неверные учётные данные, таймаут и т.д.)
Тестирование подключения не индексирует документы -- оно только проверяет, что система может подключиться к хранилищу и получить список файлов.
Удаление коннектора
При удалении коннектора:
- Удаляется само подключение и все сохранённые учётные данные
- Источники, созданные на основе этого коннектора, также удаляются
Удаление коннектора -- необратимая операция. Убедитесь, что вам не нужны связанные источники и документы, перед удалением.