v0.20.5

infiniflow/ragflowv0.20.5Sep 10, 2025by yuzhichang

AI Summary

Optimizes Agent performance, exposes Prompt framework for customization, enhances Execute SQL component with free-form SQL, and adds metadata filtering to the retrieval API.

Key Highlights

  • Agent performance optimization (planning, reflection, parallel tool calls)
  • Prompt framework exposed for customization
  • Execute SQL component enhanced with free-form SQL writing
  • Retrieval API enhanced with metadata filtering

New Features

  • Agent performance optimizations
  • Prompt framework customization
  • Execute SQL component free-form input
  • Retrieval API metadata filtering

Full Release Notes

## Summary

### Improvements
- Agent Performance Optimized: Improved planning and reflection speed for simple tasks; optimized concurrent tool calls for parallelizable scenarios, significantly reducing overall response time.
- Agent Prompt Framework exposed: Developers can now customize and override framework-level prompts in the system prompt section, enhancing flexibility and control.
- Execute SQL Component Enhanced: Replaced the original variable reference component with a text input field, allowing free-form SQL writing with variable support.
- Chat: Re-enabled Reasoning and Cross-language search.
- Retrieval API Enhanced: Added metadata filtering support to the Retrieve chunks method.
### Added models
- Meituan LongCat
- Kimi: kimi-k2-turbo-preview and kimi-k2-0905-preview
- Qwen: qwen3-max-preview
- SiliconFlow: DeepSeek V3.1
### Fixed issues
- Dataset: Deleted files remained searchable.
- Chat: Unable to chat with an Ollama model. 
- Agent: Resolved issues including cite toggle failure, task mode requiring dialogue triggers, repeated answers in multi-turn dialogues, and duplicate summarization of parallel execution results.

## What's Changed
* Fix typo by @JinHai-CN in https://github.com/infiniflow/ragflow/pull/9766
* Feature/workflow en cn by @YyBoom233 in https://github.com/infiniflow/ragflow/pull/9742
* Fix: second round value removal. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9756
* Refactor: Improve the try logic for upload_to_minio by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9735
* add Russian in translation table index.tsx by @rjohny55 in https://github.com/infiniflow/ragflow/pull/9773
* Clarify installation of pre-commit alongside uv in README by @aopstudio in https://github.com/infiniflow/ragflow/pull/9749
* Feat: Add AvatarUpload component #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9777
* Add Russian language Update app.tsx by @rjohny55 in https://github.com/infiniflow/ragflow/pull/9772
* The agent directly outputs the results under the task model #9745 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9746
* Improve model tag rendering by splitting comma-separated string into styled <Tag> components by @aopstudio in https://github.com/infiniflow/ragflow/pull/9762
* Fix: agent template error. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9784
* Feat: Use AvatarUpload to replace the avatar settings on the dataset and search pages #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9785
* Fix: Optimized variable node display and Agent template multi-language support #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9787
* Refa: unify reference format of agent completion and OpenAI-compatible completion API by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9792
* Fix: Fixed the issue where the thinking mode on the chat page could not be turned off #9789 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9794
* Feat: init dataflow. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9791
* Feat: Extract the save buttons for dataset and chat configurations to separate files to increase permission control #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9803
* Fix: Optimized Input and MultiSelect component functionality and dataSet-chunk page styling  #9779 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9815
* Fix: Ollama chat cannot access remote deployment by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9816
* Fix: Fixed the issue that similarity threshold modification in chat and search configuration failed #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9821
* Feat: add SearXNG search tool to Agent (frontend + backend, i18n) by @RuyXu in https://github.com/infiniflow/ragflow/pull/9699
* Fix: Optimized the style and functionality of multiple components #3221 #9817 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9824
* Feat: Allow users to delete their profile pictures  #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9826
* Refa: revise the implementation of LightRAG and enable response caching by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9828
* Feat: Create a conversation before uploading files #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9832
* UI updates by @writinwaters in https://github.com/infiniflow/ragflow/pull/9836
* Fix: Optimize styling and add a search settings loading state #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9830
* Fix: Optimize page layout and style #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9852
* Feat: Move the dataset permission drop-down box to a separate file for better permission control #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9850
* Docs: Refactored Retrieval component reference by @writinwaters in https://github.com/infiniflow/ragflow/pull/9862
* Refactor: Improve the buffer close for vision_llm_chunk by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9845
* Use 'float' explicitly for OpenAI's embedding "encoding_format" by @haiyuewa in https://github.com/infiniflow/ragflow/pull/9838
* Fix: agent second round issue. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9863
* Fix: Fixed the issue where the agent and chat cards on the home page could not be deleted #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9864
* Feat: By default, 50 records are displayed per page. #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9867
* Feat: Initialize the data pipeline canvas. #9869 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9870
* Fix JSON serialization error for ModelMetaclass objects by @SaurabhLingam in https://github.com/infiniflow/ragflow/pull/9812
* Fix: Optimize list display and rename functionality #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9875
* Add jemalloc install instruction for mac by @aopstudio in https://github.com/infiniflow/ragflow/pull/9879
* Fix: The operator added by clicking the plus sign will overlap with the original operator. #9886 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9887
* Feat: add exponential back-off for Chat LiteLLM by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9880
* Docs: Updated the Code component reference by @writinwaters in https://github.com/infiniflow/ragflow/pull/9884
* Feat: add `canvas_category` field for UserCanvas and CanvasTemplate by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9885
* Docs: Updated instructions on importing third-party packages to Sandbox by @writinwaters in https://github.com/infiniflow/ragflow/pull/9890
* Update README by @yingfeng in https://github.com/infiniflow/ragflow/pull/9904
* Feat: Allow users to enter SQL in the SQL operator #9897 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9898
* During the chat, the assistant's response cited documents outside current chat's kbs by @GrubbyLee in https://github.com/infiniflow/ragflow/pull/9900
* Update API reference to use 'title' instead of 'name' for listing agents by @jayant-yadav in https://github.com/infiniflow/ragflow/pull/9907
* Feat: Use storybook to display public components. #9914 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9915
* Fix: wrong chunk number while re-parsing document and keeping original chunks by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9912
* Feat: Display AvatarUpload and RAGFlowAvatar in Storybook #9914 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9920
* before docker-compose up, first down it,and cleans. by @zhanluxianshen in https://github.com/infiniflow/ragflow/pull/9908
* Fix kb isolation infinity conn by @SyedShahmeerAli12 in https://github.com/infiniflow/ragflow/pull/9913
* Feat: Added RenameDialog NumberInput and Spin storybook #9914 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9925
* fix: Optimize internationalization configuration #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9924
* Fix python_version in show_env.sh when its meets python3. by @zhanluxianshen in https://github.com/infiniflow/ragflow/pull/9894
* fix xss in excel_parser by @zhanluxianshen in https://github.com/infiniflow/ragflow/pull/9909
* Fix S3 client initialization with signature_version and addressing_style by @SyedShahmeerAli12 in https://github.com/infiniflow/ragflow/pull/9911
* code cleans. by @zhanluxianshen in https://github.com/infiniflow/ragflow/pull/9916
* Update .env by @kevinhonor in https://github.com/infiniflow/ragflow/pull/9923
* Feat: Add metadata filtering function for /api/v1/retrieval by @huang-aoqin in https://github.com/infiniflow/ragflow/pull/9877
* Refactor: Use re compile for weight method by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9929
* Fix bugs for agent/tools. by @zhanluxianshen in https://github.com/infiniflow/ragflow/pull/9930
* Feat: Allow users to select prompt word templates in agent operators. #9935 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9936
* Feat: Use sonner to replace the requested prompt message component #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9951
* Feat: refine dataflow and initialize dataflow app by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9952
* Fix miscalculated token count by @biyuhao in https://github.com/infiniflow/ragflow/pull/9776
* Refa: import issue. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9958
* add model: qwen3-max-preview by @TeslaZY in https://github.com/infiniflow/ragflow/pull/9959
* Feat: Delete unused code in the data pipeline #9869 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9971
* Fix: The files in the knowledge base folder on the file management page should not be deleted #9975 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9976
* Fix: Optimized the test results page layout and internationalization #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9974
* Feat: user defined prompt. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9972
* Feat: Add ConfirmDeleteDialog storybook #9914 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9977
* Fix: Update the pagination prompt text in zh.ts, changing "page" to "item/page" #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9978
* Feat: The agent's external page should be able to fill in the begin parameter after being reset in task mode #9745 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9982
* Feat: add LongCat-Flash-Chat by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9973
* Feat: Add ParserForm to the data pipeline  #9869 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9986
* Fix: re sub error. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9985
* Fix: Issue of ineffective weight adjustment for retrieval_test API-related functions #9854 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9989
* Fix: remove 2 prompts. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9990
* Fix: Highlight the edges after running #9538 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9994
* Fix: Optimized the table of contents style and homepage card layout #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9993
* Fix: exesql issue. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9995
* Fix: Optimize search functionality #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/10002
* Feat: The prompt words "plan" are displayed only when the agent operator has sub-agent operators or sub-tool operators. #10000 by @cike8899 in https://github.com/infiniflow/ragflow/pull/10001
* Fix: refactor prompts by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/10005
* Docs: v0.20.5 - Added Framework prompt block documentation for the Agent component by @writinwaters in https://github.com/infiniflow/ragflow/pull/10006
* Feat: Translate the maxRounds field of the chat settings #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/10010
* Fix: typo. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/10011
* Docs: Update version references to v0.20.5 in READMEs and docs by @asiroliu in https://github.com/infiniflow/ragflow/pull/10015
* Docs: Added v0.20.5 release notes. by @writinwaters in https://github.com/infiniflow/ragflow/pull/10014

## New Contributors
* @haiyuewa made their first contribution in https://github.com/infiniflow/ragflow/pull/9838
* @SaurabhLingam made their first contribution in https://github.com/infiniflow/ragflow/pull/9812
* @GrubbyLee made their first contribution in https://github.com/infiniflow/ragflow/pull/9900
* @jayant-yadav made their first contribution in https://github.com/infiniflow/ragflow/pull/9907
* @SyedShahmeerAli12 made their first contribution in https://github.com/infiniflow/ragflow/pull/9913
* @kevinhonor made their first contribution in https://github.com/infiniflow/ragflow/pull/9923
* @biyuhao made their first contribution in https://github.com/infiniflow/ragflow/pull/9776

**Full Changelog**: https://github.com/infiniflow/ragflow/compare/v0.20.4...v0.20.5