v0.20.1

Release v0.20.1 created from 9b026fc5b6f234a3abdf954f359bc2f9e99d9ba8 at 2025-08-08 18:51:10+08:00

# Summary

## New Features
- The Retrieval components now support the dynamic specification of knowledge base names using variables.
- The user interface now includes a French language option.
## Added Models
- GPT 5
- Claude 4.1
## New agent Templates (both workflow and agentic)
- SQL Assistant Workflow: Empowers non-technical teams (e.g., operations, product) to independently query business data. 
- Choose Your Knowledge Base Workflow: Lets users select a knowledge base to query during conversations. [#9325](https://github.com/infiniflow/ragflow/pull/9325)
- Choose Your Knowledge Base Agent: Delivers higher-quality responses with extended reasoning time, suited for complex queries. [#9325](https://github.com/infiniflow/ragflow/pull/9325)
## Fixed Issues
- The Agent component was unable to invoke models installed via vLLM.
- Agents could not be shared with the team.
- Embedding an Agent into a webpage was not functioning properly.

## What's Changed
* Feat: Add the migration script and its doc, added `backup` as default… by @Treedy2020 in https://github.com/infiniflow/ragflow/pull/8245
* Fix: list tags api by using tenant id instead of user id by @whhe in https://github.com/infiniflow/ragflow/pull/9103
* Fix:Error when parsing files using Gemini: **ERROR**: GENERIC_ERROR - Unknown field for GenerationConfig: max_tokens by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9195
* Fix: enlarge the timeout limits. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9201
* Fix:Repeated images when parsing markdown files with images by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9196
* Refactor: support config strong test by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9198
* Fix: migrate deprecated Langfuse API from v2 to v3 by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9204
* docs(agent): Correct several spelling errors, such as: Ouline -> Outline by @Kennytian in https://github.com/infiniflow/ragflow/pull/9188
* fix #8424 NPE in dify_retrieval.py, add log exception by @mustangxu in https://github.com/infiniflow/ragflow/pull/9212
* fix "TypeError: '<' not supported between instances of 'Emu' and 'Non… by @mustangxu in https://github.com/infiniflow/ragflow/pull/9209
* fix "out of memory" if slide.get_thumbnail() to a huge image by @mustangxu in https://github.com/infiniflow/ragflow/pull/9211
* Feat: New Agent startup parameters add knowledge base parameter #9194 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9210
* Fix: Web Server Accepts Invalid Data That Could Cause Problems in uv.lock by @kira-offgrid in https://github.com/infiniflow/ragflow/pull/8966
* Feat: list documents supports range filtering by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9214
* Fix: Fixed the issue where the prompt word edit box had no scroll bar #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9215
* Fix: Fixed the loss of Await Response function on the share page and other style issues #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9216
* v0.20.0 release notes by @writinwaters in https://github.com/infiniflow/ragflow/pull/9218
* Fix: Fixed the issue where the agent's chat box could not automatically scroll to the bottom #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9219
* Fix: correct single base64 image handling in image prompt by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9220
* Fix: Add prompt text to the form in the MCP module by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9222
* Perf Impr: Decouple reasoning and extraction for faster, more precise logic by @es-zx in https://github.com/infiniflow/ragflow/pull/9191
* Fix: self-deployed LLM error, by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9217
* Refa: ensure Redis stream queue could be created properly by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9223
* Docs: Updated tips for max rounds by @writinwaters in https://github.com/infiniflow/ragflow/pull/9235
* Fix:local variable 'response' referenced before assignment by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9230
* Fix: Set the maximum number of rounds for the agent to 1 #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9238
* Fix: fix mismatch of assitant message and its reference by @sinopec in https://github.com/infiniflow/ragflow/pull/9233
* Refactor:Improve the chat stream logic for NvidiaCV by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9242
* Fix: update broken agent OpenAI-Compatible completion due to v0.20.0 changes by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9241
* Feat: Render dialog list #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9249
* Fix: PlainParser using fix in presentation by @yzztin in https://github.com/infiniflow/ragflow/pull/9239
* Fix: resolve the prompt problem of Customer Support Workflow by @YyBoom233 in https://github.com/infiniflow/ragflow/pull/9251
* Feat: Limit the appearance of loops in operators in the agent canvas #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9253
* Fix: local variable issue. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9255
* Fix: template error. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9258
* Update readme by @JinHai-CN in https://github.com/infiniflow/ragflow/pull/9260
* Docs: fixed errors by @writinwaters in https://github.com/infiniflow/ragflow/pull/9259
* Added French language support by @ramincedric in https://github.com/infiniflow/ragflow/pull/9173
* Feat: Added history management and paste handling features #3221 by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9266
* Feat: advanced list dialogs by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9256
* FIX: If chunk["content_with_weight"] contains one or more unpaired surrogate characters (such as incomplete emoji or other special characters), then calling .encode("utf-8") directly will raise a UnicodeEncodeError. by @gooodboyAo in https://github.com/infiniflow/ragflow/pull/9246
* Feat: add Claude Opus 4.1 by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9268
* Fix:remove a img close which can not operate by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9267
* Refactor:Improve the logic so that it does not decode base 64 for the test image each time by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9264
* Feat: Create a conversation #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9269
* Refa: add provider info while adding model. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9273
* Feat: Search conversation by name #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9283
* Add **kwargs to model base class constructors by @isthaison in https://github.com/infiniflow/ragflow/pull/9252
* fix: add missing env vars and default values of service_conf.yaml by @whhe in https://github.com/infiniflow/ragflow/pull/9289
* fix: Optimized popups and the search page by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9297
* Feat: Render chat page #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9298
* Refactor:naive_merge_with_images close useless images by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9296
* Fix: virtual file cannot be displayed in KB by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9282
* Feat: Configure colors according to the design draft#3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9301
* Feat: Replace color variables according to design draft #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9305
* Fix: bytes style image issue and pressure test. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9304
* Fix: model type error. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9308
* Feat: Restore the button's background color #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9307
* Add files viaContribute a new workflow template: SQL Assistant upload by @YyBoom233 in https://github.com/infiniflow/ragflow/pull/9311
* Fix: update broken agent completion due to v0.20.0 changes by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9309
* Feat: Render agent setting dialog #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9312
* Feat: supports GPT-5 by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9320
* fix model type by @isthaison in https://github.com/infiniflow/ragflow/pull/9250
* Update chat_model.py by @Woody-Hu in https://github.com/infiniflow/ragflow/pull/9318
* Feat: Add xai logo #1853 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9321
* Feat: Set the description of the agent, which can be null #3221 by @cike8899 in https://github.com/infiniflow/ragflow/pull/9327
* Fix: add prologue to api. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9322
* New workflow templates: choose your knowledge base by @satoruhanayo in https://github.com/infiniflow/ragflow/pull/9325
* Update the sql assistant workflow by @YyBoom233 in https://github.com/infiniflow/ragflow/pull/9329
* Docs: v0.20.1 release notes by @writinwaters in https://github.com/infiniflow/ragflow/pull/9331
* feat(agent): Adds prologue functionality by @dcc123456 in https://github.com/infiniflow/ragflow/pull/9336
* Revert: revert token_required decorator of agent_bot completions and inputs by @yongtenglei in https://github.com/infiniflow/ragflow/pull/9332
* Docs: Update version references to v0.20.1 in READMEs and docs by @asiroliu in https://github.com/infiniflow/ragflow/pull/9335
* Fix: canvas sharing bug. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9339
* Refa: code format. by @KevinHuSh in https://github.com/infiniflow/ragflow/pull/9342

## New Contributors
* @Treedy2020 made their first contribution in https://github.com/infiniflow/ragflow/pull/8245
* @mustangxu made their first contribution in https://github.com/infiniflow/ragflow/pull/9212
* @yzztin made their first contribution in https://github.com/infiniflow/ragflow/pull/9239
* @YyBoom233 made their first contribution in https://github.com/infiniflow/ragflow/pull/9251
* @ramincedric made their first contribution in https://github.com/infiniflow/ragflow/pull/9173
* @gooodboyAo made their first contribution in https://github.com/infiniflow/ragflow/pull/9246
* @satoruhanayo made their first contribution in https://github.com/infiniflow/ragflow/pull/9325

**Full Changelog**: https://github.com/infiniflow/ragflow/compare/v0.20.0...v0.20.1