モデルを選択するか、スマートルーティングを使用する

Unity Gatewayを使用すると、コーディングエージェントでさまざまなモデルを使用できます。開始時にモデルを選択したり、作業中に切り替えたり、スマートルーティングにタスクのモデルを選択させたりできます。

モデルを選択

ug ワークスペースを通じて利用可能なモデルを検出します。選択できる内容は、エージェントのモデルサポート、組織の構成、および付与されたアクセス権によって異なります。

起動時にモデルを選択

利用可能なモデルのフルネームを使用して、エージェントの起動コマンドに --model を追加します。

Bash
ug claude --model system.ai.claude-sonnet-4-6
ug codex --model system.ai.gpt-5-5

The agent opens with that model, ready for your usual ワークフロー.Without --model, it starts with its configured default.

system.ai.glm-5-2定常作業のトークンあたりのコストを削減するには、次のようなオープンソースモデルで起動します。

Bash
ug codex --model system.ai.glm-5-2

OpenCode で ug opencode を実行し、system.ai.glm-5-2 などのオープンソースモデルを選択します。どのエージェントがオープンモデルをサポートしているかを確認するには、サポートされているコーディングエージェントを参照してください。コストの根拠については、支出の管理を参照してください。

代わりに組織の登録済みプロバイダーアカウントを経由してルーティングする場合は、そのUnity Catalog名を --provider に渡します。独自のモデルプロバイダーを持ち込むを参照してください。

セッション中のモデルの切り替え

ほとんどのコーディングエージェントで、次のように入力します。

Text
/model

ピッカーからモデルを選択して作業を続行します。ルーティン編集には高速なモデルを使用し、複雑なタスクにはより高性能なモデルに切り替えることができます。

コマンドはエージェントによって異なります。/modelが利用できない場合は、エージェントのヘルプメニューでモデルピッカーを確認してください。

Use Smart Routing

備考

ベータ版

スマートルーティングはベータ版です。アカウント管理者は、アカウントコンソールの プレビュー ページから Enhanced Unity Gateway のプレビューを有効にする必要があります。詳細については、Databricksプレビューの管理を参照してください。

スマートルーティングは、タスクを処理できる最もコストの低いモデルを選択するため、リクエストごとにモデルを選択する必要はありません。Claude Code および Codex で動作します。

要件

The Enhanced Unity Gateway preview enabled for your アカウント.An アカウント admin enables it from the アカウント console Previews page.See Manage Databricks previews.Allow 1–2 minutes after enablement for it to propagate to your ワークスペース.
EXECUTE スマートルーティングが選択可能なすべての候補モデルへのアクセス。スマートルーティングは、system.aiというプレフィックスが付いたモデルサービスの中からのみ選択を行います。アクセスが見つからない場合、必要なモデルを特定するエラーが発生してルーティングが失敗します。
Unity Gateway サポートされるリージョンの Databricks ワークスペース。

Unity Gateway CLIでスマートルーティングを使用する

If your admin enables Smart Routing in your agent's ワークスペース configuration, ug applies it automatically.Launch your agent as usual:

Bash
ug claude
ug codex

To turn on Smart Routing yourself for a launch, add --enable-smart-routing:

Bash
ug claude --enable-smart-routing
ug codex --enable-smart-routing

もう一度オフにするには、--disable-smart-routing を指定して起動します。

最初のプロンプトを送信すると、スマートルーティングによってセッションのモデルが選択されます。エージェント内の通知には、選択されたモデルと、利用可能な場合はその選択の理由が表示されます：

Text
Using Unity Gateway Smart Router.
Selected Model : <model name>
Reason : <reason for the selection>

エージェントは選択されたモデルで処理を続行します。サブエージェントに作業を委任する場合、各サブエージェントのタスクは個別にルーティングされ、異なるモデルを使用できます。

モデルを自分で選択するには、--modelを指定して起動します。その起動については、スマートルーティングよりも明示的なモデル選択が優先されます。

Omnigentでスマートルーティングを使用する

Omnigent は、サブエージェントに委任された作業を含め、タスクのコーディングハーネスとモデルの両方を選択できます。バージョン v0.8.0 以降を使用してください。

Databricks ワークスペース用に Claude Code と Codex を構成します：

Bash
omni setup

コンピュータをOmnigentサーバーに接続します：

Bash
omni host --server <workspace-url>

<workspace-url> を Databricks ワークスペースの URL に置き換えます。

Omnigent UI で、ハーネスとして スマートルーティング を選択すると、ハーネスとモデルの両方が自動的に選択されます：

Omnigentでハーネスとしてスマートルーティングを選択する

Claude CodeまたはCodexを保持するには、そのハーネスを選択し、歯車メニューを開いて、モデルに対して スマートルーティング を選択します：

Omnigentでモデルとしてスマートルーティングを選択する

選択したハーネスに対して、CLIからモデルルーティングを有効にすることもできます。

Bash
omni claude --smart-routing --server <workspace-url>
omni codex --smart-routing --server <workspace-url>

Unity Gateway CLIは、選択されたサポート対象ハーネス内のモデル間でルーティングを行います。また、Omnigentはハーネス間での選択も行います。omni claudeおよびomni codexの例では、ハーネスが明示的に選択されます。