[说明] 完整使用流程示例

Generated by Claude Opus 4.5😂

1. 前端生成 user_id

2. 上传文档

响应：

{
  "document_id": 1,
  "filename": "机器学习入门.pdf",
  "file_size": 2097152,
  "status": "pending",
  "message": "文档上传成功，正在后台处理索引"
}

3. 轮询文档状态

响应（处理中）：

{
  "document_id": 1,
  "status": "processing",
  "chunk_count": null,
  "error_message": null
}

响应（完成）：

{
  "document_id": 1,
  "status": "completed",
  "chunk_count": 45,
  "error_message": null
}

4. RAG 查询

响应（SSE 流）：

data: {"role": "assistant", "content": "梯度下降"}

data: {"role": "assistant", "content": "是一种"}

data: {"role": "assistant", "content": "优化算法..."}

data: [DONE]

注意事项

文档状态：只有状态为 completed 的文档才能用于 RAG 查询

多租户隔离：每个用户只能访问自己上传的文档

流式响应：RAG 查询使用 SSE 流式响应，前端需要正确处理

超时处理：大文件索引可能需要较长时间，建议前端实现轮询机制

错误重试：索引失败的文档可以通过 /documents/{id}/index 重新触发

[说明] 完整使用流程示例

1. 前端生成 user_id#

2. 上传文档#

3. 轮询文档状态#

4. RAG 查询#

注意事项#

1. 前端生成 user_id

2. 上传文档

3. 轮询文档状态

4. RAG 查询

注意事项