Skip to main content
切片管理

删除切片

批量删除切片,单次最多 10 个。

前提

已完成 Endpoint 与鉴权配置,详见 API 总览和认证。

接口

POST /api/v1/indices/rag/index/chunk/delete 批量删除指定知识库中的切片,单次最多删除 10 个。
此操作不可逆,删除后切片无法恢复。单次最多删除 10 个切片。

请求体

字段必填类型说明
pipelineId是string知识库 ID
chunkIds是array<string>要删除的切片 ID 列表,单次最多 10 个

请求示例

curl -X POST "$BASE_URL/api/v1/indices/rag/index/chunk/delete" \
  -H "Authorization: Bearer $BAILIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pipelineId": "your_index_id",
    "chunkIds": ["chunk_abc123", "chunk_def456"]
  }'
其中 BASE_URL 为 https://{workspace_id}.cn-beijing.maas.aliyuncs.com({workspace_id} 为业务空间 ID),BAILIAN_API_KEY 为阿里云百炼 API Key。

响应示例

删除成功返回 200。
{
  "code": "Success",
  "status_code": 200,
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

响应字段

字段类型说明
codestring响应码,成功时为 Success
status_codeintegerHTTP 状态码
request_idstring请求唯一标识,排查问题时请提供此 ID
dataobject操作成功时返回空对象
successboolean操作是否成功
messagestring响应消息,成功时为 success
statusstring请求状态:SUCCESS 或 FAILED

错误码

HTTP 状态码错误码错误信息说明
400Index.InvalidParameterRequired parameter missing or invalid.请求参数无效
401InvalidApiKeyInvalid API-key provided.鉴权失败,API Key 无效或缺失
Managed Agents
Sandbox
Security
RAG
应用调用
长期记忆
ParseX
框架