如何切换模型
按场景在账号、Agent、定时任务和会话中选择模型配置，并确认何时生效。
Poco 通过“模型配置”切换模型。管理员可以把主任务模型、轻量模型、视觉模型和子代理模型等整理成一组配置，并按业务场景或办公场景分配给全局、团队或用户。用户只需从当前账号可用的列表中选择，不需要填写具体模型名称。
切换前确认
开始前需要满足两个条件：
- 管理员已经创建并启用至少一个模型配置。
- 当前账号的功能角色拥有“模型选择”权限。
如果设置中看不到“模型配置”，请联系管理员检查模型配置和功能角色权限。
账号默认模型
- 桌面端点击左下角的用户头像；移动端先打开侧边栏，再点击用户头像。
- 在用户菜单中点击“个性化”。如果已经打开“设置”窗口，也可以直接切换到“个性化”页签。
- 找到“模型配置”，打开右侧下拉列表。
- 选择需要使用的模型配置。
- 看到“模型配置已更新”提示后，检查下方的“当前生效来源”。显示“用户已选配置”表示切换成功。
设置会自动保存，不需要再次点击确认按钮。管理员填写配置说明后，说明会显示在“模型配置”下方，可用于比较不同配置的用途。
账号选择会按业务、办公场景分别保存。切换场景后，下拉列表和账号默认模型都会使用该场景对应的配置。
任务与会话模型
以下位置可以从当前账号在对应场景下的可用列表中选择模型：
- 新建对话，包括业务首页、办公首页和临时对话。
- Agent 配置与 Agent 启动页；Agent 选择“跟随账号”时使用账号在当前场景下的默认模型。
- 定时任务的新建和编辑页。
- 历史会话顶部的模型选择器；切换后从下一轮消息开始生效。
- 工作台“继续使用 AI”入口。
会话和定时任务会保存创建时的场景，不会因为账号后来切换业务/办公场景而改变列表。这样可以避免旧会话在继续对话时意外跨场景切换模型。
跟随范围默认配置
如果不想固定使用某个配置，请在账号设置中选择“跟随默认”，或在 Agent 配置中选择“跟随账号”。后台为当前范围单独配置模型列表后，列表第一项就是范围默认；未单独配置时继续沿用原全局默认规则。默认变化只影响之后启动的运行。
选择“跟随默认”后，“当前生效来源”会显示实际继承来源：单独配置范围显示“当前范围首项”，未单独配置时显示“系统默认配置”。如果原全局默认记录缺失，页面会明确显示“首个可用配置”或“环境变量兜底”。
两种方式的区别：
| 选择方式 | 生效规则 | 适合场景 |
|---|---|---|
| 指定模型配置 | 只要配置仍在当前可用列表中，就持续使用，直到再次切换 | 希望稳定使用固定的质量、成本或能力组合 |
| 跟随默认 | 使用当前场景和账号范围解析出的默认配置 | 没有特殊要求，希望由管理员统一维护 |
什么时候生效
新选择会在之后启动的运行中生效，包括新任务、原会话中发送下一条消息或触发重试后产生的新运行。已经执行中的运行保留创建时的模型快照，不会在中途更换模型。定时任务每次触发前都会重新校验其已选模型是否仍对当前账号可用。
如果你正在比较两个模型配置，建议先等待当前运行结束，再切换配置并创建一个目标、输入和能力完全相同的新任务。需要比较单个模型时，还应确保两组配置中的其他字段一致。
常见问题
看不到“模型配置”
当前账号的功能角色可能没有“模型选择”权限，或管理员尚未提供可用配置。请管理员检查后台模型配置和你的功能角色。
下拉列表里没有需要的配置
普通用户只能选择管理员为当前场景和账号范围分配且仍处于启用状态的配置。如果下拉列表缺少目标配置，请管理员依次检查用户、团队、全局范围及对应场景；如果整个列表为空、一直显示加载中或刷新后仍无法展开，请按加载失败处理，并检查模型配置接口。
已选择的配置被移出范围或停用后，系统只会在原场景的当前可用列表内回退；单独配置列表使用第一项，未配置列表继续按原全局默认规则处理，不会跨场景回退。
已切换，但当前任务仍在使用原模型
这是正常现象。切换不会修改已经执行中的运行，请在下一次运行中验证。
可以在对话中发送“查看当前使用的模型配置相关环境变量”，或进入执行器容器检查 POCO_EXECUTION_SCENE、POCO_MODEL_CONFIG_ID 和 DEFAULT_MODEL。
保存时提示失败
先刷新页面后重新选择，并再次确认成功提示、下拉列表选中项和“当前生效来源”。如果仍然失败，请联系管理员检查该配置是否仍处于启用状态，以及当前账号的功能角色是否拥有“模型选择”权限。
管理员如需新增配置、调整默认配置或开放权限，可继续阅读管理员配置。