Unity Gateway 允许你在编码代理中使用不同的模型。 使用代理的模型选择器选择和切换模型,或让智能路由为委派任务选择模型。
选择模型
ug 发现您工作区中可用的模型。 你可以选择什么取决于代理的模型支持、组织配置以及授予你的访问权限。
使用 ug codex 启动 Codex CLI,使用 ug claude 启动 Claude Code,或使用 ug copilot 启动 GitHub Copilot CLI。 在代理中,输入:
/model
从选择器中选择一个可用模型,然后继续工作。 对于支持的开源模型(如 GLM 5.3 )system.ai.glm-5-3使用相同的选择器。 每当你想切换时,比如选择更快的模型进行日常编辑,或更强大的模型处理复杂任务时,都可以再次输入 /model 。
请参见《使用开源模型》以获取设置示例,并请参见《控制支出》以了解成本依据。
关于脚本启动,请参见ug CLI参考。
在 ChatGPT 桌面版中,使用模型选择器在 Codex 对话中选择模型,包括支持的开源模型。 参见 “在ChatGPT桌面中使用开源模型”。 在Visual Studio Code的GitHub Copilot中,从Copilot 对话助手模型选择器中的Databricks组中选择一个模型。 在其他代理中,查看模型选择器的帮助菜单。
如需使用贵组织注册的供应商账户,请参见 “自带模型提供商”。
使用智能路由
Important
智能路由还处于 测试阶段。 账户管理员必须从账户控制台预览页面启用增强版 Unity Gateway 预览。 请参阅 Manage Azure Databricks 预览版。
智能路由选择能够处理你任务的最低成本模型,这样你就不用为每个请求都选一个模型。 它能和Claude Code配合使用。 Codex 的智能路由已在 Unity Gateway CLI 中暂停。 GitHub Copilot不支持智能路由。
要求
- 已为您的帐户启用 增强版 Unity 网关 预览。 帐户管理员从帐户控制台 预览 页启用它。 请参阅 Manage Azure Databricks 预览版。 启用后等待1-2分钟,让它传播到你的工作区。
-
EXECUTE访问智能路由可选择的所有候选模型。 候选模型来自代理人的 模型源。 在 Unity Gateway 托管配置 测试版中,模型sources源可以包含模型提供者服务背后的外部模型。 如果缺少访问权限,路由将失败,并报错指出所需的模型。
- 一个位于Unity Gateway支持区域中的Azure Databricks工作空间。
使用 Unity Gateway CLI 启用智能路由
如果您的管理员在您的代理的工作区配置中启用了智能路由,ug 会自动应用它。 照常启动 Claude Code:
ug claude
要自己开启智能路由进行启动,请添加:--enable-smart-routing
ug claude --enable-smart-routing
要在启动时关闭它(即使管理员已启用),请使用 --disable-smart-routing 启动。
要在会话中关闭或重新开启智能路由,请输入 /smart-router off 或 /smart-router on。
启用智能路由后,您的智能体将任务交接给子智能体。 每个子代理的任务独立路由,可以使用不同的模型。 代理显示每个子代理所选模型,并在可用时说明选择原因。 主会话保持在其默认模型上:如果设置的有,则使用管理员的默认值或智能默认值;否则将使用智能体配置的默认值。 要让任务保持在主会话中,可以要求代理不要使用子代理。
有关使用 Azure Databricks 托管的非 Anthropic 基础模型的 Claude Code 子智能体的自动工具调用安全检查,请参阅自动模式。
要自己选择模型,请用上方的会话命令关闭智能路由,然后使用 /model。 仅更改 /model 模型并不会关闭智能路由。
在 Omnigent 中使用智能路由
Omnigent 可以为任务选择编码工具和模型,包括分配给子代理的工作。 使用版本 0.8.0 或更高版本。
配置 Claude Code 和 Codex 用于你的 Azure Databricks 工作空间:
omni setup
将您的电脑连接到Omnigent服务器:
omni host --server <workspace-url>
将 <workspace-url> 替换为Azure Databricks工作区 URL。
在 Omnigent 界面中,选择 智能路由 作为线束,这样它就能同时选择线束和型号:
若要保留 Claude Code 或 Codex,请选择对应的运行框架,打开其齿轮菜单,然后为模型选择 智能路由:
你也可以从CLI中启用模型路由,针对所选的线束:
omni claude --smart-routing --server <workspace-url>
omni codex --smart-routing --server <workspace-url>
Unity Gateway CLI 在所选的受支持框架内在各模型之间进行路由。 Omnigent 还会在不同测试框架之间进行选择;而 omni claude 和 omni codex 这两个示例则明确指定了测试框架。