ragflow v0.20.5 更新详解：性能优化、Agent 框架开放、SQL 组件增强

在最新发布的 ragflow v0.20.5 版本（发布日期：2025 年 9 月 10 日）中，系统在性能、功能与用户体验方面进行了多项重要优化与修复。本次更新带来了更高的执行效率、更灵活的开发能力，以及更完善的检索与聊天功能。以下是详细内容。

功能改进

1. 1. Agent 性能优化
   • • 提升了简单任务的规划与反思速度。
   • • 优化了可并行场景下的工具并发调用，大幅减少整体响应时间。
2. 2. Agent Prompt 框架开放
   • • 现在开发者能够在系统提示词部分自定义和覆盖 框架级提示词，增强了灵活性与可控性。
3. 3. Execute SQL 组件增强
   • • 将原有的变量引用组件替换为文本输入框，支持直接编写 SQL 语句，并支持变量引用功能。
4. 4. 聊天功能优化
   • • 重新启用 推理模式（Reasoning） 功能。
   • • 重新启用 跨语言搜索 功能。
5. 5. 检索 API 增强
   • • /api/v1/retrieval 的 Retrieve chunks 方法新增 元数据过滤 支持，实现更精准的数据检索。

新增模型

• • 美团 LongCat
• • Kimi 系列：kimi-k2-turbo-preview、kimi-k2-0905-preview
• • Qwen：qwen3-max-preview
• • SiliconFlow：DeepSeek V3.1

修复的问题

• • 数据集：已删除的文件仍能被检索到的问题已修复。
• • 聊天：修复了无法与 Ollama 模型对话的问题。
• • Agent：
  • • 修复引用开关失效的问题。
  • • 修复任务模式必须通过对话触发的问题。
  • • 修复多轮对话中重复回答的问题。
  • • 修复并行执行结果重复总结的问题。

详细更改列表

• • 修正拼写错误。
• • 支持工作流中英文切换。
• • 修复第二轮交互值移除的问题。
• • 优化上传至 MinIO 时的重试逻辑。
• • 在翻译表中添加俄语支持。
• • 更新文档中 pre-commit 与 uv 的安装说明。
• • 新增头像上传组件，并替换数据集与搜索页中的头像设置功能。
• • Agent 在任务模式下可直接输出结果。
• • 优化模型标签渲染，将逗号分隔字符串拆分为独立组件。
• • 修复 Agent 模板错误。
• • 优化变量节点显示，Agent 模板支持多语言。
• • 统一 Agent Completion 与 OpenAI 兼容 Completion API 的引用格式。
• • 修复聊天页推理模式无法关闭的问题。
• • 初始化 Dataflow 数据流功能。
• • 数据集与聊天配置保存按钮独立到单独文件以提升权限控制能力。
• • 优化输入与多选组件功能与数据集 Chunk 页样式。
• • 修复 Ollama 聊天无法访问远程部署的问题。
• • 修复聊天与搜索配置中相似度阈值修改无效的问题。
• • Agent 引入 SearXNG 搜索工具（前后端+ i18n）。
• • 优化组件样式与功能。
• • 支持用户删除头像。
• • 上传文件前可先创建会话。
• • 优化搜索设置加载状态 UI。
• • 改进页面布局与样式。
• • 数据集权限下拉框拆分到单独文件更好地进行权限控制。
• • 重构检索组件引用文档。
• • 优化 vision_llm_chunk 缓冲区关闭逻辑。
• • embedding 格式显式使用 float 类型。
• • 修复 Agent 第二轮交互问题。
• • 修复主页中的 Agent 与聊天卡片无法删除的问题。
• • 默认每页显示 50 条记录。
• • 初始化数据管道画布。
• • 修复 ModelMetaclass JSON 序列化错误。
• • 优化列表显示与重命名功能。
• • 增加 macOS 平台安装 jemalloc 指南。
• • 修复点击“+”新增操作符导致与原操作符重叠的问题。
• • LiteLLM 聊天引入 指数退避重试 机制。
• • 更新 Code 组件文档。
• • 为 UserCanvas 与 CanvasTemplate 添加 canvas_category 字段。
• • 更新 Sandbox 中引入第三方包的说明。
• • 更新 README 文档。
• • SQL 操作符支持用户直接输入 SQL 语句。
• • 修复聊天中助手引用的文档可能在当前知识库之外的问题。
• • API 返回 Agent 列表时使用 title 代替 name 字段。
• • 在 Storybook 中展示公共组件。
• • 修复重新解析文档并保留原有分块时的分块数量错误。
• • 在 Storybook 中展示 AvatarUpload 与 RAGFlowAvatar。
• • docker-compose 启动前先执行 down 并清理。
• • 修复知识库隔离无限连接问题。
• • 在 Storybook 中新增 RenameDialog、NumberInput、Spin 组件。
• • 优化国际化配置。
• • 修复 show_env.sh 脚本在 Python3 环境下的版本检测问题。
• • 修复 excel_parser 中的 XSS 漏洞。
• • 修复 S3 客户端初始化时的 signature_version 与 addressing_style 配置问题。
• • 完善 .env 文件。
• • /api/v1/retrieval 新增元数据过滤功能。
• • 优化权重方法实现方式。
• • 修复 Agent/tools 中的 bug。
• • Agent 操作符支持选择提示词模板。
• • 使用 Sonner 替换原有提示信息组件。
• • 优化 Dataflow 并初始化 Dataflow 应用。
• • 修复 token 数量计算错误。
• • 修复 import 导入问题。
• • 新增模型 qwen3-max-preview。
• • 删除数据流中未使用的代码。
• • 修复文件管理页中知识库文件夹下文件不应被删除的问题。
• • 优化测试结果页布局与国际化。
• • 支持用户自定义提示词。
• • 为 Storybook 增加 ConfirmDeleteDialog 组件。
• • 优化中文分页提示文本，将“page”改为“条/页”。
• • Agent 外部页面在任务模式重置后支持填写 begin 参数。
• • 新增 LongCat-Flash-Chat。
• • 为数据管道新增 ParserForm 组件。
• • 修复正则替换错误。
• • 修复 retrieval_test API 相关权重调整无效的问题。
• • 移除两个提示词。
• • 修复运行后未高亮边缘的问题。
• • 优化目录样式与首页卡片布局。
• • 修复执行 SQL 功能问题。
• • 优化搜索功能。
• • “plan” 提示词仅在 Agent 操作符包含子 Agent 或子工具时显示。
• • 重构提示词。
• • 新增 Agent 组件的框架提示词文档。
• • 翻译聊天设置中的 maxRounds 字段。
• • 修复拼写错误。
• • 文档与 README 更新至 v0.20.5 版本。
• • 新增 v0.20.5 版本更新说明。

总结

ragflow v0.20.5 版本不仅在 Agent 性能、SQL 查询、检索功能等核心能力上实现了升级，还针对多项 UI 细节和开发体验进行了优化。 对于需要高效构建多智能体系统、处理复杂检索任务或进行跨语言内容处理的开发者来说，此次更新将显著提升生产力与可扩展性。

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。