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

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

Запрос

POST /datasets

Тело запроса

Поле

Тип

Обязательное

Описание

name

string

да

Название базы знаний (1—40 символов)

description

string

нет

Описание (до 400 символов)

permission

string

нет

only_me, all_team_members или partial_members (по умолчанию only_me)

Пример запроса

POST /v1/datasets HTTP/1.1 Host: api.evo-ai.ru Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* Content-Length: 55 { "name": "text", "description": "", "permission": "only_me" }

Ответ

200 — объект базы знаний с полями id, name, description, indexing_technique, retrieval_model_dict и др.

Пример ответа

{ "id": "c42e2a6e-40b3-4330-96f8-f1e4d768e8c9", "name": "Документация по продукту", "description": "Техническая документация с характеристиками SberBoom", "provider": "vendor", "permission": "only_me", "data_source_type": null, "indexing_technique": "high_quality", "app_count": 0, "document_count": 0, "word_count": 0, "created_by": "ad313dd6-ef04-4dd1-a5b0-c0f0b9e2e7e4", "author_name": "admin", "created_at": 1741267200, "updated_by": "ad313dd6-ef04-4dd1-a5b0-c0f0b9e2e7e4", "updated_at": 1741267200, "embedding_model": "EmbeddingsR", "embedding_model_provider": "GigaChat", "embedding_available": true, "retrieval_model_dict": { "search_method": "semantic_search", "reranking_enable": false, "reranking_mode": null, "reranking_model": { "reranking_provider_name": "", "reranking_model_name": "" }, "weights": null, "top_k": 3, "score_threshold_enabled": false, "score_threshold": null }, "tags": [], "doc_form": "text_model", "external_knowledge_info": null, "external_retrieval_model": null, "doc_metadata": [], "built_in_field_enabled": true, "pipeline_id": null, "runtime_mode": null, "chunk_structure": null, "icon_info": null, "summary_index_setting": null, "is_published": false, "total_documents": 0, "total_available_documents": 0, "enable_api": true, "is_multimodal": false }

Коды ошибок

HTTP

Код

Описание

409

dataset_name_duplicate

База знаний с таким названием уже существует

500

internal_server_error

Внутренняя ошибка сервера