设置默认模型

什么时候用

当你希望未绑定模型的智能体能自动回退使用某个模型或模型组时设置。设置默认模型可以避免智能体调用时报 503 错误，同时也能统一的默认模型选择。

你需要准备

• 已配置好至少一个可用模型（参见「添加与配置模型」）
• 或者已创建好模型组（参见「模型组：多模型路由」）

操作步骤

第 1 步：进入系统设置

左侧菜单 -> 系统设置。

在「基础设置」卡片中，你会看到默认模型、默认模型组和模型展示模式的配置项。

第 2 步：配置默认模型或模型组

重要： 默认模型与默认模型组互斥——选择一个会自动清空另一个。

配置项说明：

选择好后点击「保存设置」。

第 3 步：模型展示模式（可选）

根据需要设置模型展示模式：

• 全部展示（默认）：同时展示单个模型和模型组
• 仅展示模型：只展示单个模型，隐藏模型组
• 仅展示模型组：只展示模型组，隐藏单个模型

这个设置会影响：

• 控制台的模型选择下拉
• OpenAI API 的 /models 端点返回内容

怎么验证成功了

1. 保存后刷新页面，能看到配置已生效
2. 创建一个不绑定模型的智能体，调用时能正常使用默认模型/模型组
3. 查看 OpenAI API 的 /models 端点，返回内容符合展示模式设置

常见问题

默认模型与默认模型组同时设置了

这是不可能的。界面上选择一个会自动清空另一个，系统也会强制互斥约束。

设置后智能体调用还是 503

请检查：

• 默认模型/模型组确实是「启用」状态
• 智能体确实没有绑定自己的模型/模型组（智能体绑定的优先于默认）
• 默认模型/模型组确实属于当前

模型展示模式不生效

请保存设置后刷新页面试试，或者重新调用 API。

我想移除默认设置

直接在下拉选择器中清空选择即可，保存后无默认模型/模型组。

深入

核心概念

租户默认模型 / 默认模型组

在租户设置中可以设置一个默认模型或默认模型组。当智能体未绑定任何模型时，系统会先回退使用租户默认模型组，再回退使用租户默认模型。

• 默认模型与默认模型组互斥：设置一个会自动清空另一个
• 租户默认模型/默认模型组仅在智能体路径下且智能体未绑模型时生效

权限边界

• 智能体绑定模型/模型组：参见「创建并配置智能体」
• 其他设置：参见「全局配置」