Документы

Документы базы знаний: список, добавление файла, статус обработки, переименование, включение и выключение, удаление.

Объект Document

Статусы документа

Список документов

GET /v1/knowledge-bases/{knowledge_base_id}/documents

Документы базы знаний с поиском идут от новых к старым, файловой базы знаний — в том же порядке, что в интерфейсе.

Параметры запроса

Ответ

200 — постраничный список {items, total, has_more} объектов Document.

Добавление документа

POST /v1/knowledge-bases/{knowledge_base_id}/documents

Content-Type: multipart/form-data

Поля формы

Форматы и размер файла зависят от типа базы знаний: у базы знаний с поиском — CSV, DOC, DOCX, HTM, HTML, MARKDOWN, MD, MDX, PDF, PPT, PPTX, PROPERTIES, TXT, VTT, XLS, XLSX до 50 МБ, у файловой — CSV, XLS, XLSX до 100 МБ.

Ответ

201 — объект Document.

• База знаний с поиском. Документ приходит со статусом queued и обрабатывается с теми же параметрами, что документ, добавленный в интерфейсе. Чтобы узнать, когда он готов, запрашивайте документ: статус сменится на processing, затем на enabled или error.

• Файловая база знаний. Документ сразу приходит со статусом enabled и доступен агенту без ожидания.

curl https://api.evo-ai.ru/v1/knowledge-bases/3a9d5e27-8c14-4b6f-a0e2-7d1c9b5f3e82/documents \
  -H "Authorization: Bearer evo_kb_..." \
  -F "file=@price-list.xlsx"

{
  "id": "b61f0d3c-4e92-47a8-9c5d-1a7e3f8b2d09",
  "name": "price-list.xlsx",
  "source": "file",
  "status": "queued",
  "error": null,
  "progress": null,
  "chunk_count": 0,
  "word_count": null,
  "created_at": "2026-09-24T10:25:00Z",
  "updated_at": "2026-09-24T10:25:00Z"
}

Замена данных в файловой базе знаний

Отдельного метода замены файла нет. Чтобы обновить данные, удалите документ и добавьте новый файл. Замена всегда выполняется в два запроса, поэтому есть окно, когда агент видит не то состояние базы, которое ожидается:

• «удалить → добавить» — какое-то время база без этих данных;

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

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

Документ

GET /v1/knowledge-bases/{knowledge_base_id}/documents/{document_id}

200 — объект Document.

Изменение документа

PATCH /v1/knowledge-bases/{knowledge_base_id}/documents/{document_id}

Меняются только переданные поля.

Тело запроса

• Выключить документ, который ещё не обработан, нельзя. Включать и выключать документ нельзя и пока он переиндексируется после прошлого включения или выключения. В обоих случаях — 400 с кодом document_processing, и документ не меняется.

• Архивный документ базы знаний с поиском изменить нельзя: 400 с кодом document_archived.

Ответ

200 — объект Document.

curl -X PATCH https://api.evo-ai.ru/v1/knowledge-bases/3a9d5e27-8c14-4b6f-a0e2-7d1c9b5f3e82/documents/b61f0d3c-4e92-47a8-9c5d-1a7e3f8b2d09 \
  -H "Authorization: Bearer evo_kb_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Удаление документа

DELETE /v1/knowledge-bases/{knowledge_base_id}/documents/{document_id}

204 — без тела. Документ, который ещё обрабатывается, тоже удаляется, а его обработка отменяется. Если документа нет, ответ тоже 204.

Ошибки