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"
}
文档管理 API
处理文档
触发文档处理(异步)— 解析、分块、向量化
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 | 返回 "文档已处理完成" |
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"
}