Разделы документации
Коннекторы

Загрузка файлов

Индексация локальных файлов в Charo — форматы, ZIP-архивы с метаданными и обновление содержимого.

Что индексируется

  • Загруженные документы: текстовые форматы, PDF, офисные файлы, таблицы (CSV/XLSX) и изображения (при включённой обработке изображений).
  • ZIP-архив распаковывается: индексируются вложенные файлы поддерживаемых форматов.

Полный список форматов — тот же, что для личных файлов: PDF, DOCX/DOC, PPTX, XLSX/XLSM, CSV/TSV, TXT, MD/MDX, HTML, EML, EPUB, JSON, XML, YML/YAML, SQL, LOG, CONF, PNG/JPG/WEBP.

Когда использовать

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

Настройка в Charo

  1. Откройте Админка → Добавление коннектора → Загрузка файлов.
  2. В поле «Файлы» загрузите документы или ZIP-архив.
  3. Задайте видимость (публичный или по группам) и создайте коннектор.

Учётные данные не нужны.

Метаданные в ZIP-архиве

В корень архива можно положить файл .onyx_metadata.json со списком метаданных для вложенных файлов (ссылка на первоисточник, владельцы, время обновления) — тогда в ответах ассистента ссылки будут вести на первоисточник, а не на загруженный файл.

Синхронизация прав

Не применимо: у загруженных файлов нет источника прав. Управляйте доступом видимостью коннектора и группами (см. «Права доступа»).

Ограничения и обновление

  • Максимальный размер файла задаётся конфигурацией инсталляции (по умолчанию 2 ГБ).
  • Содержимое статично: чтобы обновить документ, загрузите новую версию файла в коннектор — прежняя версия с тем же именем будет заменена при переиндексации.

Устранение неполадок

Файл не проиндексировался

Формат не поддерживается или из файла не удалось извлечь текст (например, скан без текстового слоя при выключенной обработке изображений).

Изображения не ищутся

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