检索与同步

提交导入任务

向已创建的知识库追加导入文档

POST

/api/v1/indices/rag/index/job/create

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/index/job/create" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "indexId": "your_kb_id",
    "categoryIds": ["cate_abc123"]
  }'

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

Authorizations

string

header

required

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

Body

application/json

string

required

知识库 ID。

enum<string>

required

数据来源类型。DATA_CENTER_CATEGORY 表示按类目导入（需指定 categoryIds），DATA_CENTER_FILE 表示按文件导入（需指定 documentIds）。

Available options:DATA_CENTER_CATEGORY,DATA_CENTER_FILE

string[]

类目 ID 列表。当 sourceType 为 DATA_CENTER_CATEGORY 时必填。

string[]

文件 ID 列表。当 sourceType 为 DATA_CENTER_FILE 时必填。

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

string

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

object

Show child attributes

string

知识库 ID。

string

导入任务 ID。

string

任务状态，提交后为 PENDING。

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/indices/rag/index/job/create" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "indexId": "your_kb_id",
    "categoryIds": ["cate_abc123"]
  }'

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

提交导入任务 - Knowledge Studio