Unity Gateway 讓你在編碼代理中使用不同的模型。 開始時選擇模型，工作時切換，或讓智慧路由為你的任務選擇一個。
選擇一個模型
ug 發掘你工作空間中可用的模型。 你可以選擇什麼，取決於代理的模型支援、組織的設定以及授權給你的權限。
上市時選擇型號
在你的代理的啟動指令中加入 --model ，並使用你可用模型的全名：
ug claude --model system.ai.claude-sonnet-4-6
ug codex --model system.ai.gpt-5-5
代理程式會以該模型啟動，並已準備好配合你平常的工作流程。 沒有 --model，它會從設定的預設值開始。
為了降低例行工作的每個代幣成本，建議以 開放原始碼 模式啟動，例如system.ai.glm-5-2：
ug codex --model system.ai.glm-5-2
使用 OpenCode，執行ug opencode並選擇一個開放原始碼模型，例如 system.ai.glm-5-2。 欲了解哪些代理支援開放模型，請參閱支援的 編碼代理。 關於成本理由，請參見 控制支出。
若要改為透過您組織已註冊的提供者帳戶進行路由，請將其 Unity Catalog 名稱傳遞給 --provider。 請參閱 「自帶模特兒供應商」。
在會話中切換模型
在大多數編碼代理中，輸入：
/model
從選擇器中選取模型，然後繼續操作。 你可以用更快的模型來做例行編輯，然後切換到更強大的模型來處理複雜任務。
命令因特工而異。 如果 /model 無法使用，請到代理程式的說明選單中查看其模型選取器。
使用智慧路由
Important
智慧路由目前還在 測試階段。 帳戶管理員必須在帳戶主控台的預覽頁面啟用強化版 Unity Gateway預覽功能。 請參閱 管理 Azure Databricks 預覽。
智慧路由會選擇成本最低、能處理你任務的模型，讓你不必為每個請求都選擇一個模型。 它能搭配 Claude Code 和 Codex 運作。
要求
- 強化版 Unity Gateway 預覽已為您的帳戶啟用。 帳號管理員會從帳號主控台的 預覽 頁面啟用。 請參閱 管理 Azure Databricks 預覽。 啟用後等待 1–2 分鐘，讓它傳播到你的工作區。
-
EXECUTE可存取智慧路由可選擇的每個候選模型。 智慧路由僅會在帶有system.ai前綴的模型服務中進行選擇。 若缺少存取，路由會因識別所需型號的錯誤而失敗。
- 一個位於 Unity Gateway 支援區域的 Azure Databricks 工作空間。
在 Unity Gateway CLI 中使用智慧路由
如果管理員在客服專員工作區組態中啟用 Smart Routing，ug 會自動套用。 像平常一樣啟動你的代理程式：
ug claude
ug codex
若要為某次啟動作業自行啟用智慧路由，請新增 --enable-smart-routing：
ug claude --enable-smart-routing
ug codex --enable-smart-routing
若要再次將其關閉，請使用 --disable-smart-routing 啟動。
提交第一個提示後，智慧路由會為該工作階段選擇模型。 代理程式中的通知顯示所選型號，並在可用時說明選擇原因：
Using Unity Gateway Smart Router.
Selected Model : <model name>
Reason : <reason for the selection>
代理程式繼續使用所選模型。 如果將工作委派給子代理人，每個子代理人的任務會獨立路由，且可以使用不同的模型。
若要自行選擇模型，請以 啟動。--model 在該次啟動中，明確指定的模型會優先於智慧路由。
在 Omnigent 中使用智慧路由
Omnigent 可以同時選擇編碼工具與模型來執行任務，包括委派給子代理者的工作。 使用版本 v0.8.0 或更新版本。
為您的 Azure Databricks 工作空間配置 Claude Code 與 Codex：
omni setup
將你的電腦連接到 Omnigent 伺服器：
omni host --server <workspace-url>
將 <workspace-url> 替換成你的 Azure Databricks 工作區網址。
在 Omnigent 介面中，選擇 「智慧路由 」作為線束，讓它同時選擇線束和模型：
要保留 Claude Code 或 Codex，請選擇該背帶，打開齒輪選單，並為該型號選擇 智慧路由 ：
您也可以從CLI啟用模型路由，針對所選線束：
omni claude --smart-routing --server <workspace-url>
omni codex --smart-routing --server <workspace-url>
Unity Gateway CLI 會在所選的受支援框架內，於模型之間進行路由。 Omnigent 也會在多個 harness 之間進行選擇；omni claude 和 omni codex 範例則明確指定了一個 harness。