跳转到主要内容
POST
/
datasets
创建空知识库
curl --request POST \
  --url http://{apiBaseUrl}/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "indexing_technique": "high_quality",
  "permission": "only_me",
  "provider": "vendor",
  "external_knowledge_api_id": "<string>",
  "external_knowledge_id": "<string>",
  "embedding_model": "<string>",
  "embedding_model_provider": "<string>",
  "retrieval_model": {
    "search_method": "hybrid_search",
    "reranking_enable": true,
    "reranking_mode": {
      "reranking_provider_name": "<string>",
      "reranking_model_name": "<string>"
    },
    "top_k": 123,
    "score_threshold_enabled": true,
    "score_threshold": 123,
    "weights": 123
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "provider": "<string>",
  "permission": "<string>",
  "data_source_type": "<string>",
  "indexing_technique": "<string>",
  "app_count": 123,
  "document_count": 123,
  "word_count": 123,
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": 123,
  "updated_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updated_at": 123,
  "embedding_model": "<string>",
  "embedding_model_provider": "<string>",
  "embedding_available": true
}

Authorizations

​
Authorization
string
header
required

API-Key 鉴权。所有 API 请求都应在 Authorization HTTP Header 中包含你的 API-Key，格式为 Bearer {API_KEY}。强烈建议开发者把 API-Key 放在后端存储，而非分享或者放在客户端存储，以免 API-Key 泄露，导致财产损失。

Body

application/json
​
name
string
required

知识库的名称。

​
description
string

知识库的描述（可选）。

​
indexing_technique
enum<string>

要使用的索引技术。

可用选项:
high_quality,
economy
​
permission
enum<string>

知识库的访问权限。

可用选项:
only_me,
all_team_members,
partial_members
​
provider
enum<string>

知识库的提供商。

可用选项:
vendor,
external
​
external_knowledge_api_id
string

外部知识 API 的 ID（如果提供商是 'external'）。

​
external_knowledge_id
string

外部知识的 ID（如果提供商是 'external'）。

​
embedding_model
string

嵌入模型的名称。

​
embedding_model_provider
string

嵌入模型的提供商。

​
retrieval_model
object

Response

成功创建数据集。

​
id
string<uuid>
​
name
string
​
description
string | null
​
provider
string
​
permission
string
​
data_source_type
string | null
​
indexing_technique
string | null
​
app_count
integer
​
document_count
integer
​
word_count
integer
​
created_by
string<uuid>
​
created_at
integer
​
updated_by
string<uuid>
​
updated_at
integer
​
embedding_model
string | null
​
embedding_model_provider
string | null
​
embedding_available
boolean | null