重试已上传文件

接口说明

手动重试一个处理失败的已上传 Markdown 文件。

接口信息

字段	值
方法	POST
路径	/openapi/v2/knowledge-bases/{knowledgeBaseId}/source-files/{sourceFileId}/retry
Operation ID	retryKnowledgeBaseSourceFile
鉴权	Bearer OpenAPI key

入参

名称	位置	必填	类型	示例	说明
knowledgeBaseId	path	是	string	knowledge-base-11111111-1111-4111-8111-111111111111	知识库 API 返回的知识库标识。
sourceFileId	path	是	string	source-file-11111111-1111-4111-8111-111111111111	上传接口或已上传文件列表接口返回的文件标识。

请求体

这个接口没有请求体。

请求示例

curl -X POST "https://openapi.example.com/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/source-files/source-file-11111111-1111-4111-8111-111111111111/retry" \
  -H "Authorization: Bearer <openapi-key>"

成功响应

202

返回已上传文件和已接受的重试信息。

字段	必填	类型	说明
sourceFile	是	object	已上传 Markdown 文件记录。
retry	是	object	服务器已经接收的重试请求。

成功响应示例

{
  "sourceFile": {
    "sourceFileId": "source-file-11111111-1111-4111-8111-111111111111",
    "knowledgeBaseId": "knowledge-base-11111111-1111-4111-8111-111111111111",
    "directoryId": "directory-11111111-1111-4111-8111-111111111111",
    "name": "guide.md",
    "relativePath": "handbook/guide.md",
    "generatedPath": "pages/handbook/guide.md",
    "contentType": "text/markdown; charset=utf-8",
    "sizeBytes": 1024,
    "resourceRevision": 1,
    "contentRevision": 1,
    "state": "waiting",
    "workProgress": {
      "required": 8,
      "completed": 0,
      "activeKinds": [],
      "blockingKind": "prepare",
      "retryingKind": null
    },
    "failure": null,
    "generatedOutputStatus": "unavailable",
    "actions": [],
    "links": {
      "self": "/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/source-files/source-file-11111111-1111-4111-8111-111111111111",
      "generatedContent": "/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/files/content?path=pages%2Fhandbook%2Fguide.md",
      "search": "/openapi/v2/knowledge-bases/knowledge-base-11111111-1111-4111-8111-111111111111/files/search?query=guide.md"
    },
    "createdAt": "2026-06-17T00:00:00.000Z"
  },
  "retry": {
    "kind": "document_processing",
    "scope": "source_file",
    "coalesced": false
  }
}

错误码

下表列出这个接口已声明的全部错误响应。

HTTP 状态	错误码	说明
401	UNAUTHORIZED	Bearer API key 缺失、格式错误、未知、已撤销或已删除。
404	NOT_FOUND	请求的资源不存在。
409	CONFLICT	请求与资源当前状态冲突。
429	RATE_LIMITED	请求超过当前配置的速率限制。
500	INTERNAL_ERROR	API 遇到内部错误。
503	DATABASE_REPOSITORY_UNAVAILABLE	当前接口所需的数据暂时不可用。

后续操作

• 获取已上传文件