创建知识库并导入

POST

/api/v1/indices/rag/index/create_v2

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/index/create_v2" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-knowledge-base",
    "structureType": "unstructured",
    "sinkType": "DEFAULT",
    "sourceType": "DATA_CENTER_FILE",
    "embeddingModelName": "text-embedding-v4",
    "chunkSize": 600,
    "docIds": ["file_abc123", "file_def456"],
    "dataSources": [{"sourceType": "DATA_CENTER_FILE"}]
  }'

{
  "code": "Success",
  "status_code": 200,
  "success": true,
  "message": "success",
  "data": {
    "pipelineId": "your_pipeline_id",
    "ingestionId": "ing_abc123",
    "status": "PENDING",
    "created_at": 1783657930436,
    "updated_at": 1783657930436
  },
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "SUCCESS"
}

文件 ID 参数名为 docIds，不是 file_ids 或 fileIds。数据源参数 dataSources 为必填。

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://agent.console.aliyun.com/settings/apikey）获取。

Body

application/json

string

required

知识库名称，1-20 字符。

Required range:length: 1–20

enum<string>

required

结构类型：unstructured（非结构化）或 structured（结构化）。

Available options:unstructured,structured

string

default"DEFAULT"

required

存储类型，默认 DEFAULT。

string

required

数据源类型，如 DATA_CENTER_FILE。

object[]

required

数据源配置列表。

Show child attributes

string

数据源类型，如 DATA_CENTER_FILE。

string

向量嵌入模型名称，如 text-embedding-v4。

integer

文档切片大小（字符数）。建议值 300-800。

Required range:x >= 1

string[]

创建知识库时可同步导入文件。传入数据中心文件 ID 列表，值来自 addFile 注册文件后返回的 fileId，或通过 listFile 查询已有文件获取。建议导入不超过 10000 个。注意参数名为 docIds，不是 file_ids 或 fileIds。

string[]

创建知识库时可同步导入文件。通过指定类目 ID，可导入对应类目下的所有文件，建议导入不超过 10000 个。

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

boolean

请求是否成功，成功时为 true。

string

响应消息，成功时为 success。

string

请求唯一标识，排查问题时请提供此 ID。

string

请求状态，成功时为 SUCCESS。

object

Show child attributes

string

知识库 ID。

string

导入任务 ID。

string

任务状态，创建后为 PENDING。

integer

知识库创建时间（Unix 毫秒时间戳）。

integer

知识库最近更新时间（Unix 毫秒时间戳）。