RAGFlow 知识库 API 手册

要解决的问题

在对接 RAGFlow 时，常见卡点不是调用单个接口，而是要在知识库、文档、切片、检索、元数据和解析配置之间保持字段一致。手动翻文档时，容易遗漏 parser_config、chunk_method、认证方式差异等关键参数，导致上传后解析失败或检索结果不符合预期。

技能如何工作

这份 RAGFlow 知识库 API 手册 把接口说明按使用流程组织：

• 知识库管理：覆盖创建、列表、编辑、删除，并说明 embedding_model、permission、chunk_method 等配置。
• 文档管理：列出文件上传、URL 导入、文档列表、编辑、下载和删除，强调 dataset_id、document_id 与处理状态 run。
• 解析与切片：解释 naive、paper、table、qa、parent_child 等切片方式，以及 parser_config 中 token 数、分隔符、布局识别、表格/图片上下文等参数。
• 检索与统计：提供知识库检索、使用量统计、重新向量化和错误码说明，便于排查召回与解析问题。

注意点

该资料偏向 API 参考，不替代服务端权限治理；部分接口使用 session 或 beta token 认证，调用前要确认凭证类型。修改 chunk_method 或 parser_config 后通常需要重新解析才会生效；删除知识库会级联删除文档、切片、文件和向量索引，生产环境应谨慎执行。