Создание и настройка баз знаний

Список баз знаний рабочего пространства, создание базы, изменение её названия, описания и доступа, удаление.

Объект KnowledgeBase

Поле	Тип	Описание
`id`	string	Идентификатор базы знаний
`name`	string	Название, от 1 до 40 символов, уникальное в пространстве
`description`	string	Описание, до 400 символов
`type`	string	`rag` — база знаний с поиском, `files` — файловая база знаний
`access`	string	Кто видит базу: `private` — только создатель, `workspace` — все участники пространства, `members` — выбранные участники
`member_ids`	string[]	Участники при `access: members`, иначе пустой список. Владелец пространства всегда среди них
`tags`	array	Теги базы знаний: `{id, name}`
`document_count`	integer	Число документов
`system`	boolean	Системная ли это база знаний
`created_at`	string	Время создания
`updated_at`	string	Время последнего изменения

Список баз знаний

GET /v1/knowledge-bases

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

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

Параметр	Тип	Обязательный	Описание
`page`	integer	нет	Номер страницы, по умолчанию 1
`limit`	integer	нет	Размер страницы: от 1 до 100, по умолчанию 20
`search`	string	нет	Поиск по названию — так же, как поиск в интерфейсе
`tag_id`	string	нет	Фильтр по тегу. Параметр можно повторить: `?tag_id=...&tag_id=...` — в список попадут базы хотя бы с одним из тегов

Ответ

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

curl "https://api.evo-ai.ru/v1/knowledge-bases?search=Договоры" \
  -H "Authorization: Bearer evo_kb_..."

Создание базы знаний

POST /v1/knowledge-bases

Тело запроса

Поле	Тип	Обязательное	Описание
`name`	string	да	Название, от 1 до 40 символов
`description`	string	нет	Описание, до 400 символов
`type`	string	нет	`rag` или `files`, по умолчанию `rag`. Тип потом изменить нельзя

База знаний, созданная через API, доступна всем участникам пространства (access: workspace). Файловая база знаний создаётся с политикой Аналитик данных и принимает файлы CSV, XLS, XLSX.

Ответ

201 — объект KnowledgeBase.

curl https://api.evo-ai.ru/v1/knowledge-bases \
  -H "Authorization: Bearer evo_kb_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Договоры", "description": "Типовые договоры компании"}'

{
  "id": "3a9d5e27-8c14-4b6f-a0e2-7d1c9b5f3e82",
  "name": "Договоры",
  "description": "Типовые договоры компании",
  "type": "rag",
  "access": "workspace",
  "member_ids": [],
  "tags": [],
  "document_count": 0,
  "system": false,
  "created_at": "2026-09-24T10:20:00Z",
  "updated_at": "2026-09-24T10:20:00Z"
}

База знаний

GET /v1/knowledge-bases/{knowledge_base_id}

200 — объект KnowledgeBase.

Изменение базы знаний

PATCH /v1/knowledge-bases/{knowledge_base_id}

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

Тело запроса

Поле	Тип	Описание
`name`	string	Название, от 1 до 40 символов
`description`	string	Описание, до 400 символов; `null` — очистить
`access`	string	`private`, `workspace` или `members`
`member_ids`	string[]	Идентификаторы участников пространства. Обязателен и не пуст при `access: members`, при другом `access` передавать нельзя

Владелец пространства всегда входит в member_ids, даже если запрос его не назвал. Поле type передавать нельзя: тип базы знаний не меняется.

Ответ

200 — объект KnowledgeBase.

curl -X PATCH https://api.evo-ai.ru/v1/knowledge-bases/3a9d5e27-8c14-4b6f-a0e2-7d1c9b5f3e82 \
  -H "Authorization: Bearer evo_kb_..." \
  -H "Content-Type: application/json" \
  -d '{"description": null}'

Удаление базы знаний

DELETE /v1/knowledge-bases/{knowledge_base_id}

204 — без тела. Если базы нет или ключ её не видит, ответ тоже 204; если у базы выключен доступ по API — 403 с кодом api_disabled. База знаний, подключённая к агентам, удаляется. Исключение — системная база знаний, которую используют агенты: её удаление отклоняется с кодом knowledge_base_in_use.

Ошибки

HTTP	Код	Когда
`400`	`invalid_request`	Неверные поля; `access: members` без `member_ids` или `member_ids` при другом `access`
`400`	`knowledge_base_name_taken`	Такое название в пространстве уже есть
`400`	`knowledge_base_type_immutable`	В изменении передано поле `type`
`400`	`knowledge_base_in_use`	Удаление системной базы знаний, которую используют агенты
`404`	`knowledge_base_not_found`	Базы нет, она в другом пространстве или недоступна ключу
`429`	`rate_limited`	Превышен лимит запросов тарифа — создание, изменение и удаление учитываются в нём

Базы знаний

Документы