From 078ffca026430b0946a50eb6bae38878169e3ca3 Mon Sep 17 00:00:00 2001 From: liwu96 <45170497+liwu96@users.noreply.github.com> Date: Mon, 7 Sep 2026 02:10:54 -0700 Subject: [PATCH] docs: clarify user_default_llm deprecation (#19321) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fix config guide — user_default_llm is no longer supported. Now explains OSS tenants configure their own providers/defaults, links model setup guide, and notes Enterprise role-level defaults. TEI note retained. Docs only. Co-authored-by: sunshuren --- .../configurations/configurations.md | 23 +++++++------------ 1 file changed, 8 insertions(+), 15 deletions(-) diff --git a/docs/administrator/configurations/configurations.md b/docs/administrator/configurations/configurations.md index 881f05d0bc..e2408f8d86 100644 --- a/docs/administrator/configurations/configurations.md +++ b/docs/administrator/configurations/configurations.md @@ -250,21 +250,14 @@ oauth: ### `user_default_llm` -The default LLM to use for a new RAGFlow user. It is disabled by default. To enable this feature, uncomment the corresponding lines in **service_conf.yaml.template**. +Assigning default models to newly registered users through `user_default_llm` is deprecated and no longer supported in the open-source version. Uncommenting this section in **service_conf.yaml.template** does not configure models for new users. -- `factory`: The LLM supplier. Available options: - - `"OpenAI"` - - `"DeepSeek"` - - `"Moonshot"` - - `"Tongyi-Qianwen"` - - `"VolcEngine"` - - `"ZHIPU-AI"` -- `api_key`: The API key for the specified LLM. You will need to apply for your model API key online. -- `allowed_factories`: If this is set, the users will be allowed to add only the factories in this list. - - `"OpenAI"` - - `"DeepSeek"` - - `"Moonshot"` +Each tenant must configure its own model provider instances and credentials. New users do not automatically inherit an administrator's configured instances or default model selections. -:::tip NOTE -If you do not set the default LLM here, configure the default LLM on the **Settings** page in the RAGFlow UI. +Go to **User settings** **>** **Model providers** to configure provider instances, add models, and select default models. See [Configure Model API Key](../../guides/models/llm_api_key_setup.md) for instructions. + +The Enterprise Edition provides role-level default model settings. + +:::note Builtin embedding +If you deploy TEI, keep the shipped `user_default_llm.default_models.embedding_model` connection settings in **service_conf.yaml.template**. They are used by the TEI `Builtin` embedding service and do not assign administrator-owned model instances to new tenants. :::