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

功能改进

1. Agent 性能优化

   • 提升了简单任务的规划与反思速度。
   • 优化了可并行场景下的工具并发调用，大幅减少整体响应时间。

2. Agent Prompt 框架开放

   • 现在开发者能够在系统提示词部分自定义和覆盖 框架级提示词，增强了灵活性与可控性。

3. Execute SQL 组件增强

   • 将原有的变量引用组件替换为文本输入框，支持直接编写 SQL 语句，并支持变量引用功能。

4. 聊天功能优化

   • 重新启用 推理模式（Reasoning） 功能。
   • 重新启用 跨语言搜索 功能。

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 细节和开发体验进行了优化。
对于需要高效构建多智能体系统、处理复杂检索任务或进行跨语言内容处理的开发者来说，此次更新将显著提升生产力与可扩展性。