跳转到主内容
版本：开发版

发布版本

最新版本中的主要功能、改进和错误修复。

信息

每个 RAGFlow 版本都提供两种版本：

  • 精简版 (Slim edition)：不包含内置的 embedding 模型，版本名称后带有 -slim 后缀。例如：infiniflow/ragflow:v0.19.1-slim
  • 完整版 (Full edition)：包含内置的 embedding 模型，版本名称后没有后缀。例如：infiniflow/ragflow:v0.19.1
重要

完整版中包含的 embedding 模型有：

  • BAAI/bge-large-zh-v1.5
  • maidalun1020/bce-embedding-base_v1

这两个 embedding 模型专门针对英文和中文进行了优化，因此如果用于嵌入其他语言的文档，性能可能会受影响。

v0.20.0​

发布于 2025 年 8 月 4 日。

兼容性变更​

从 v0.20.0 开始，Agent 不再与早期版本兼容，升级后所有来自旧版本的 Agent 都必须重新构建。

新功能​

  • 统一了 Agent 和工作流的编排。
  • 对 Agent 进行了全面重构，极大地增强了其功能和可用性，支持多 Agent 配置、规划和反思，以及可视化功能。
  • 完全实现了 MCP 功能，允许导入 MCP Server、Agent 作为 MCP Client 运行，以及 RAGFlow 本身作为 MCP Server 运行。
  • 可以访问 Agent 的运行时日志。
  • 通过管理面板可以查看与 Agent 的聊天历史记录。
  • 集成了新版更强大的 Infinity，使得以 Infinity 作为底层文档引擎的自动打标功能成为可能。
  • 提供兼容 OpenAI 的 API，支持文件引用信息。
  • 支持新的 embedding 模型，包括 Kimi K2、Grok 4 和 Voyage。
  • RAGFlow 的代码库现已镜像到 Gitee。
  • 引入了新的模型提供商 Gitee AI。

新 Agent 模板​

  • 基于多 Agent 的深度研究：由一个主 Agent 和多个子 Agent 组成的协作团队，不同于传统的工作流编排。
  • 利用内部知识库的智能问答聊天机器人，专为客户服务和培训场景设计。
  • RAGFlow 团队用于筛选、分析和记录候选人信息的简历分析模板。
  • 将原始创意转化为 SEO 友好型博客内容的工作流。
  • 智能客服工作流。
  • 通过语义分析将用户反馈导向相应团队的用户反馈分析模板。
  • 旅行规划师：使用网络搜索和地图 MCP 服务器来协助旅行规划。
  • 图像翻译：翻译上传照片中的内容。
  • 信息搜索助手，可从内部知识库和网络中检索答案。

v0.19.1​

发布于 2025 年 6 月 23 日。

修复的问题​

  • 高并发请求期间的内存泄漏问题。
  • 启用 GraphRAG 实体解析时大文件解析卡顿的问题。#8223
  • 在独立模式下使用沙盒时出现的上下文错误。#8340
  • 由 Ollama 引起的 CPU 使用率过高问题。#8216
  • 代码组件中的一个错误。#7949
  • 通过 API 创建知识库时，增加了对通过 Ollama 或 VLLM 安装的模型的支持。#8069
  • 为 S3 存储桶访问启用了基于角色的身份验证。#8149

新增模型​

  • Qwen 3 Embedding。#8184
  • Voyage Multimodal 3。#7987

v0.19.0​

发布于 2025 年 5 月 26 日。

新功能​

  • 在知识库和聊天模块中支持跨语言搜索，提高了在多语言环境（如中英知识库）中的搜索准确性和用户体验。
  • Agent 组件：新增的代码组件支持 Python 和 JavaScript 脚本，使开发人员能够处理更复杂的任务，如动态数据处理。
  • 增强的图片显示：聊天和搜索中的图片现在直接在响应中渲染，而不是作为外部引用。知识库检索测试可以直接检索图片，而不是从图片中提取的文本。
  • Claude 4 和 ChatGPT o3：开发人员现在可以使用新发布的、最先进的 Claude 模型和 OpenAI 最新的 ChatGPT o3 推理模型。

以下功能由我们的社区贡献：

  • Agent 组件：在生成组件中启用工具调用。感谢 notsyncing。
  • Markdown 渲染：Markdown 文件中的图片引用在分块后可以显示。感谢 Woody-Hu。
  • 文档引擎支持：现在可以使用 OpenSearch 作为 RAGFlow 的文档引擎。感谢 pyyuhao。

文档​

新增文档​

v0.18.0​

发布于 2025 年 4 月 23 日。

兼容性变更​

从本版本开始，移除了内置的 rerank 模型，因为它们对召回率的影响微乎其微，但显著增加了检索时间。

新功能​

  • MCP 服务器：允许通过 MCP 访问 RAGFlow 的知识库。
  • DeepDoc 在文档版面识别过程中支持采用 VLM 模型作为处理流程，实现了对 PDF 和 DOCX 文件中图片的深度分析。
  • 兼容 OpenAI 的 API：可以通过兼容 OpenAI 的 API 调用 Agent。
  • 用户注册控制：管理员可以通过环境变量启用或禁用用户注册。
  • 团队协作：Agent 可以与团队成员共享。
  • Agent 版本控制：所有更新都会被持续记录，并可以通过导出回滚到之前的版本。

export_agent

改进​

  • 增强的答案引用：提高了生成响应中引用的准确性。
  • 增强的问答体验：用户现在可以在对话中手动停止流式输出。

文档​

新增文档​

v0.17.2​

发布于 2025 年 3 月 13 日。

兼容性变更​

  • 从聊天配置中移除了 Max_tokens 设置。
  • 从生成、改写、分类、关键词 Agent 组件中移除了 Max_tokens 设置。

从本版本开始，如果您仍然发现 RAGFlow 的响应被截断，请检查您的模型提供商的 Max_tokens 设置。

改进​

  • 增加兼容 OpenAI 的 API。
  • 引入德语用户界面。
  • 加速知识图谱提取。
  • 在检索 Agent 组件中启用基于 Tavily 的网络搜索。
  • 新增通义千问 QwQ 模型（兼容 OpenAI）。
  • 在通用分块方法中支持 CSV 文件。

修复的问题​

  • 无法通过 Ollama/Xinference 添加模型，此问题由 v0.17.1 引入。

HTTP API​

Python API​

v0.17.1​

发布于 2025 年 3 月 11 日。

改进​

  • 提高英文分词质量。
  • 改进 Markdown 文档解析中的表格提取逻辑。
  • 更新 SiliconFlow 的模型列表。
  • 支持解析 XLS 文件（Excel 97-2003），并改进了相应的错误处理。
  • 支持 Huggingface rerank 模型。
  • 在聊天助手和改写 Agent 组件中启用相对时间表达式（如“现在”、“昨天”、“上周”、“明年”等）。

修复的问题​

  • 知识图谱重复提取问题。
  • API 调用相关问题。
  • PDF 解析器（即文档解析器）下拉菜单中选项缺失。
  • Tavily 网络搜索问题。
  • 无法在 AI 聊天中预览图表或图片。

文档​

新增文档​

v0.17.0​

发布于 2025 年 3 月 3 日。

新功能​

  • AI 聊天：实现 Agent 式推理的深度研究。要激活此功能，请在聊天助手对话框的提示词引擎选项卡下启用推理开关。
  • AI 聊天：利用基于 Tavily 的网络搜索来增强 Agent 式推理的上下文。要激活此功能，请在聊天助手对话框的助手设置选项卡下输入正确的 Tavily API 密钥。
  • AI 聊天：支持在不指定知识库的情况下开始聊天。
  • AI 聊天：除了 PDF 文件，HTML 文件现在也可以预览和引用。
  • 数据集：在数据集配置中增加了一个PDF 解析器（即文档解析器）下拉菜单。这包括一个耗时的 DeepDoc 模型选项，一个速度快得多的朴素选项（纯文本），该选项跳过了 DLA（文档版面分析）、OCR（光学字符识别）和 TSR（表格结构识别）任务，以及几个目前处于实验性阶段的大模型选项。请参阅此处。
  • Agent 组件：在生成或模板组件的系统提示字段中，可以使用 (x) 或正斜杠 / 来插入可用的键（变量）。
  • 对象存储：支持使用阿里云 OSS（对象存储服务）作为文件存储选项。
  • 模型：更新了通义千问（Qwen）支持的模型列表，增加了 DeepSeek 专用模型；新增 ModelScope 作为模型提供商。
  • API：可以通过 API 更新文档元数据。

下图展示了 RAGFlow 深度研究的工作流程

Image

以下是集成了深度研究的对话截图

Image

HTTP API​

向更新文档方法添加了请求体参数 "meta_fields"。

Python API​

向更新文档方法添加了键选项 "meta_fields"。

文档​

新增文档​

v0.16.0​

发布于 2025 年 2 月 6 日。

新功能​

  • 支持 DeepSeek R1 和 DeepSeek V3。
  • GraphRAG 重构：知识图谱现在是基于整个知识库（数据集）动态构建的，而不是基于单个文件，并且在上传新文件开始解析时会自动更新。请参阅此处。
  • 新增迭代 Agent 组件和研究报告生成器 Agent 模板。请参阅此处。
  • 新 UI 语言：葡萄牙语。
  • 允许为知识库中的特定文件设置元数据，以增强 AI 聊天功能。请参阅此处。
  • 将 RAGFlow 的文档引擎 Infinity 升级到 v0.6.0.dev3。
  • 支持 DeepDoc 的 GPU 加速（请参阅 docker-compose-gpu.yml）。
  • 支持创建和引用标签知识库，这是弥合查询和响应之间语义鸿沟的关键里程碑。
重要

标签知识库功能在 Infinity 文档引擎上不可用。

文档​

新增文档​

v0.15.1​

发布于 2024 年 12 月 25 日。

升级​

  • 将 RAGFlow 的文档引擎 Infinity 升级到 v0.5.2。
  • 增强了文档解析状态的日志显示。

修复的问题​

此版本修复了以下问题：

  • Infinity 返回的 SCORE not found 和 position_int 错误。
  • 一旦某个特定知识库中的 embedding 模型被更改，其他知识库中的 embedding 模型就无法再更改。
  • 由于 embedding 模型的重复加载，导致问答和 AI 搜索响应缓慢。
  • 使用 RAPTOR 解析文档失败。
  • 使用表格解析方法导致信息丢失。
  • 杂项 API 问题。

HTTP API​

为以下 API 添加了可选参数 "user_id"：

v0.15.0​

发布于 2024 年 12 月 18 日。

新功能​

  • 引入了更多 Agent 专用 API。
  • 支持使用页面排名分数来提高跨多个知识库搜索时的检索性能。
  • 在聊天和 Agent 中提供 iframe，以便将 RAGFlow 集成到您的网页中。
  • 新增用于在 Kubernetes 上部署 RAGFlow 的 Helm chart。
  • 支持以 JSON 格式导入或导出 Agent。
  • 支持 Agent 组件/工具的单步运行。
  • 新增 UI 语言：日语。
  • 支持从失败中恢复 GraphRAG 和 RAPTOR，增强了任务管理的弹性。
  • 新增更多 Mistral 模型。
  • 为 UI 增加了深色模式，允许用户在浅色和深色主题之间切换。

改进​

  • 升级了 DeepDoc 中的文档版面分析模型。
  • 在使用 Infinity 作为文档引擎时，显著增强了检索性能。

HTTP API​

Python API​

v0.14.1​

发布于 2024 年 11 月 29 日。

改进​

增加了 Infinity 的配置文件，以便于将 Infinity 作为文档引擎进行集成和定制。从本版本开始，对 Infinity 配置的更新可以直接在 RAGFlow 中进行，并在使用 docker compose 重启 RAGFlow 后立即生效。#3715

修复的问题​

此版本修复了以下问题：

  • 点击一个 chunk 后无法显示或编辑其内容。
  • Elasticsearch 中出现 'Not found' 错误。
  • 解析过程中中文文本乱码。
  • 与 Polars 的兼容性问题。
  • Infinity 和 GraphRAG 之间的兼容性问题。

v0.14.0​

发布于 2024 年 11 月 26 日。

新功能​

  • 支持使用 Infinity 或 Elasticsearch（默认）作为文档引擎，用于向量存储和全文索引。#2894
  • 通过为 Agent 增加更多变量和实现自动保存来增强用户体验。
  • 受 吴恩达的翻译 Agent 启发，新增了一个三步翻译 Agent 模板。
  • 新增了一个 SEO 优化的博客写作 Agent 模板。
  • 提供用于与 Agent 对话的 HTTP 和 Python API。
  • 在检索过程中支持使用英语同义词。
  • 优化了词权重计算，将检索时间缩短了 50%。
  • 通过增加额外的性能指标，改进了任务执行器监控。
  • 用 Valkey 替换了 Redis。
  • 新增了三种新的 UI 语言（由社区贡献）：印度尼西亚语、西班牙语和越南语。

兼容性变更​

从本版本开始，service_config.yaml.template 取代 service_config.yaml 用于配置后端服务。在 Docker 容器启动时，此模板文件中定义的环境变量会自动填充，并从中自动生成一个 service_config.yaml 文件。#3341

这种方法无需在更改 .env 文件后手动更新 service_config.yaml，从而便于动态环境配置。

重要

在尝试这种新方法之前，请确保您已将您的代码和 Docker 镜像都升级到此版本。

HTTP API​

Python API​

文档​

新增文档​

v0.13.0​

发布于 2024 年 10 月 31 日。

新功能​

  • 为所有用户增加了团队管理功能。
  • 更新了 Agent UI 以提高可用性。
  • 在通用分块方法中增加了对 Markdown 分块的支持。
  • 在 Agent UI 中引入了一个 invoke 工具。
  • 集成了对 Dify 知识库 API 的支持。
  • 增加了对 GLM4-9B 和 Yi-Lightning 模型的支持。
  • 引入了用于数据集管理、数据集中文件管理和聊天助手管理的 HTTP 及 Python API。
说明

下载 RAGFlow 的 Python SDK

pip install ragflow-sdk==0.13.0

文档​

新增文档​

v0.12.0​

发布于 2024 年 9 月 30 日。

新功能​

  • 提供 RAGFlow Docker 镜像的精简版，不包含内置的 BGE/BCE embedding 或 reranking 模型。
  • 改进了多轮对话的结果。
  • 允许用户移除已添加的 LLM 供应商。
  • 增加了对 OpenTTS 和 SparkTTS 模型的支持。
  • 在通用分块方法中实现了一个 Excel 转 HTML 开关，允许用户将电子表格解析为 HTML 表格或按行解析为键值对。
  • 新增 Agent 工具 YahooFinance 和 Jin10。
  • 新增投资顾问 Agent 模板。

兼容性变更​

从本版本开始，RAGFlow 提供其 Docker 镜像的精简版，以改善网络受限用户的体验。RAGFlow Docker 镜像的精简版不包含内置的 BGE/BCE embedding 模型，大小约为 1GB；RAGFlow 的完整版大小约为 9GB，既包含内置的 embedding 模型，也包含在 RAGFlow UI 中选择后会下载的 embedding 模型。

默认的 Docker 镜像版本是 nightly-slim。以下列表阐明了不同版本之间的差异：

  • nightly-slim：最新测试过的 Docker 镜像的精简版。
  • v0.12.0-slim：最新正式发布的 Docker 镜像的精简版。
  • nightly：最新测试过的 Docker 镜像的完整版。
  • v0.12.0：最新正式发布的 Docker 镜像的完整版。

有关升级说明，请参阅升级 RAGFlow。

文档​

新增文档​

v0.11.0​

发布于 2024 年 9 月 14 日。

新功能​

  • 在 RAGFlow UI 中引入了 AI 搜索界面。
  • 通过 FishAudio 或 通义千问 TTS 支持音频输出。
  • 除了 MySQL，还允许使用 Postgres 进行元数据存储。
  • 支持使用 S3 或 Azure Blob 的对象存储选项。
  • 支持模型供应商：Anthropic、Voyage AI 和 Google Cloud。
  • 支持使用腾讯云 ASR 进行音频内容识别。
  • 新增金融专用 Agent 组件：问财、AkShare、YahooFinance 和 TuShare。
  • 新增医疗顾问 Agent 模板。
  • 支持在以下数据集上运行检索基准测试：

v0.10.0​

发布于 2024 年 8 月 26 日。

新功能​

  • 在 Agent UI 中引入了一个文本到 SQL 的模板。
  • 实现了 Agent API。
  • 集成了对任务执行器的监控。
  • 引入了 Agent 工具 GitHub、DeepL、百度翻译、和风天气 和 Google 学术搜索。
  • 支持对 EML 文件进行分块。
  • 支持更多 LLM 或模型服务：GPT-4o-mini、PerfXCloud、TogetherAI、Upstage、Novita AI、01.AI、SiliconFlow、PPIO、讯飞星火、百度文心一言 和 腾讯混元。

v0.9.0​

发布于 2024 年 8 月 6 日。

新功能​

  • 支持 GraphRAG 作为一种分块方法。
  • 引入了 Agent 组件关键词和搜索工具，包括百度、DuckDuckGo、PubMed、维基百科、必应和谷歌。
  • 支持对音频文件进行语音转文本识别。
  • 支持模型供应商 Gemini 和 Groq。
  • 支持推理框架、引擎和服务，包括 LM studio、OpenRouter、LocalAI 和 Nvidia API。
  • 支持在 Xinference 中使用 reranker 模型。

v0.8.0​

发布于 2024 年 7 月 8 日。

新功能​

  • 支持 Agentic RAG，能够为 RAG 和 Agent 构建基于图的工作流。
  • 支持模型供应商 Mistral、MiniMax、Bedrock 和 Azure OpenAI。
  • 在手动分块方法中支持 DOCX 文件。
  • 在问答分块方法中支持 DOCX、MD 和 PDF 文件。

v0.7.0​

发布于 2024 年 5 月 31 日。

新功能​

  • 支持使用 reranker 模型。
  • 集成了 reranker 和 embedding 模型：BCE、BGE 和 Jina。
  • 支持 LLM 百川和火山方舟。
  • 实现了 RAPTOR 以改进文本检索。
  • 在通用分块方法中支持 HTML 文件。
  • 提供用于通过 ID 删除文档的 HTTP 和 Python API。
  • 支持 ARM64 平台。
重要

虽然我们也在 ARM64 平台上测试 RAGFlow，但我们不维护用于 ARM 的 RAGFlow Docker 镜像。

如果您在 ARM 平台上，请遵循本指南来构建 RAGFlow Docker 镜像。

HTTP API​

Python API​

v0.6.0​

发布于 2024 年 5 月 21 日。

新功能​

  • 支持流式输出。
  • 提供用于检索文档块的 HTTP 和 Python API。
  • 支持监控系统组件，包括 Elasticsearch、MySQL、Redis 和 MinIO。
  • 在通用分块方法中支持禁用版面识别，以减少文件分块时间。

HTTP API​

Python API​

v0.5.0​

发布于 2024 年 5 月 8 日。

新功能​

  • 支持 LLM DeepSeek。