Файловая база знаний

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

Файловая база знаний

База знаний с поиском (RAG)

Возвращается в GET /datasets

Нет

Да

Адресация

Только по dataset_id

По dataset_id; находится в списке

Статус документа после загрузки

Сразу completed

Проходит обработку до completed

Статус индексации (indexing-status)

404 — индексации нет

Отдаёт прогресс

Поле batch в ответе

Не используется

Идентификатор пакета индексирования

Как получить dataset_id

Файловые базы знаний не возвращаются методом GET/datasets, поэтому найти нужную базу перебором списка нельзя — обращайтесь к ней по идентификатору напрямую. Идентификатор (dataset_id) виден в адресной строке браузера при открытии базы знаний в интерфейсе платформы.

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

POST /v1/datasets/{dataset_id}/document/create-by-file HTTP/1.1
    Host: api.evo-ai.ru
    Authorization: Bearer YOUR_SECRET_TOKEN
    Content-Type: multipart/form-data
    Accept: */*

    {
      "file": "<бинарный файл>"
    }

Поддерживаются форматы csv, xls, xlsx, максимальный размер файла — 100 МБ. За один запрос принимается один файл.

Индексация не выполняется: документ сразу возвращается в статусе completed и доступен агенту без ожидания. Поле batch для файловой базы знаний не используется, а запрос статуса индексации отвечает 404.

Сохраните document.id из ответа на своей стороне — он потребуется для обновления данных.

Обновление данных

Отдельного метода обновления документа нет. Чтобы заменить данные в базе, удалите существующий документ и загрузите новый:

  1. DELETE /v1/datasets/{dataset_id}/documents/{document_id} — удалить документ.

  2. POST /v1/datasets/{dataset_id}/document/create-by-file — загрузить новый файл.

Атомарной замены данных нет. Замена всегда выполняется в два действия, и при любом порядке возникает окно, в котором агент видит не то состояние базы, которое ожидается:

  • «удалить → загрузить» — база какое-то время пуста.

  • «загрузить → удалить» — в базе временно находятся два набора данных.

Выбирайте порядок исходя из того, что менее критично для вашего сценария.

Блок API в интерфейсе

Отсутствие блока API на вкладке «Управление» и иконки API на карточке базы знаний не означает, что у базы нет API: скрыт блок API агента-аналитика, а сама база знаний управляется публичным API, как описано на этой странице.