跳转到主要内容
POST
/
api
/
knowledge-base
/
{id}
/
documents
/
{docId}
/
process
curl --request POST \
  --url https://zeus-api.agentspro.cn/api/knowledge-base/kb_abc123/documents/doc_xyz789/process \
  --header 'Authorization: Bearer <token>'

{
  "message": "文档处理已启动",
  "status": "processing"
}
手动触发文档的后台处理流程：加载文件 → SmartChunker 智能分块 → Embedding 向量化 → 存储到 pgvector。 处理在 BackgroundTasks 中异步执行，状态通过 获取文档详情 轮询。

​
状态机

当前状态行为
pending / failed启动后台处理任务
processing返回 "文档正在处理中"
completed返回 "文档已处理完成"
​
Authorization
string
必填
Bearer JWT Token
​
id
string
必填
知识库 ID
​
docId
string
必填
文档 ID
​
message
string
操作结果消息
​
status
string
文档当前状态
curl --request POST \
  --url https://zeus-api.agentspro.cn/api/knowledge-base/kb_abc123/documents/doc_xyz789/process \
  --header 'Authorization: Bearer <token>'

{
  "message": "文档处理已启动",
  "status": "processing"
}