Important
スマートルーティングはベータ版で、アカウントごとに有効化されています。 アカウント管理者はスマートルーティングプレビューを有効にする必要があります。 ベータ期間中は、入手可能性、対応モデル、APIが変更される可能性があります。
スマートルーティングは、コーディングエージェントが引き受ける各タスクに最適なモデルを自動的に選択します。 Omnigentでは、最適なコーディングハーネスも選択します。 すべての開発者にリクエストごとにモデルを選ぶよう求めるのではなく、Unity AI Gatewayは各タスクを処理可能な最もコストの低いモデルにルーティングします。
コーディングエージェントの使い方に応じて、Omnigentまたは ucodeでSmart Routingを設定しましょう。
Requirements
- アカウントのスマートルーティングプレビューが有効になっています。 アカウント管理者に連絡して有効化を依頼し、有効化後1〜2分でワークスペースに移行させる時間を待ちましょう。
- Smart Ringingが選択できる候補モデルへのアクセス。 スマートルーティングは
system.ai接頭辞付きモデルサービスのみを選択します。
- Unity AI Gateway でサポートされているリージョン内のAzure Databricks ワークスペース。
- モデルだけでなく、コーディングハーネス間でのルーティングには、Omnigentバージョンv0.8.0以降をご利用ください。 ハーネス間のルーティングはOmnigentでのみ利用可能です。
Omnigentを使ってスマートルーティングを設定する
Omnigentは『Smart Routing』の本格的な形態を生み出しています。 各タスクに対してモデルとコーディングハーネスの両方を選択できます。 選択はメインエージェントおよびセッションが起動するすべてのサブエージェントに適用されます。
オムニジェントの設定:
Claude CodeとCodexを使ってAzure Databricksワークスペースで推論を行うように設定してください:
omni setupパソコンをOmnigentサーバーに接続:
omni host --server <workspace-url><workspace-url>をAzure Databricksワークスペースの URL に置き換えます。
その後、UIやCLIからスマートルーティングをオンにしてください。
UIから
ハーネスとして 「スマートルーティング」 を選択し、Omnigentがモデルとハーネスの両方を選択できるようにします:
または、Claude CodeやCodexを選択した後、歯車アイコンをクリックしてモデルの スマートルーティング を選択してください:
CLIから
ハーネスに渡す --smart-routing :
omni claude --smart-routing --server <workspace-url>
omni codex --smart-routing --server <workspace-url>
<workspace-url>をAzure Databricksワークスペースの URL に置き換えます。
スマートルーティングの設定 ucode
ucodeはUnity AI Gatewayに対してコーディングエージェントを実行するためのAzure Databricks CLIです。
ucodeでCodexまたはClaude Codeを実行する場合は、エージェントごとにスマートルーティングを有効にしてください:
ucode codex --enable-smart-routing
ucode claude --enable-smart-routing
この設定はエージェントごとに維持されるため、後の ucode codex セッションや ucode claude セッションでもスマートルーティングはオンのままになります。 オフにするには:
ucode codex --disable-smart-routing
ucode claude --disable-smart-routing
スマートルーティングが有効になったら、コマンドラインでプロンプトを渡してルーティングしてください。 スマートルーティングはインタラクティブルートセッションには適用されないため、以下の条件を提示する必要があります --:
ucode claude -- "<prompt>"
ucode codex -- "<prompt>"
スマートルーティングはそのプロンプトのモデルを選択し、タスクが生成するサブエージェントも同じ方法でルーティングされます。 ハーネス間のルーティングはOmnigentでのみ利用可能です。
制限事項
- スマートルーティングはベータ版で、アカウントごとに有効になっています。
- スマートルーティングは、
system.ai接頭辞付きモデルサービスのみを選択します。 カスタムモデルサービスは現在サポートされていません。 - ユーザーはルーターが選択できるすべての候補モデルにアクセスする必要があり、そうでなければスマートルーティングは失敗します。 例えば、ルーターが
gpt-5.5、claude-opus-4-8、glm-5.2にルーティングできる場合、ユーザーはsystem.ai.gpt-5-5、system.ai.claude-opus-4-8、system.ai.glm-5-2モデルのサービスでEXECUTEが必要です。 もしユーザーが候補ノードにアクセスできない場合、リクエストは必要なモデルサービスの名前をエラーで返します。 - Omnigent以外では、スマートルーティングは
ucodeのみ設定可能です。 ネイティブのClaudeコードとCodex(直接実行、ucodeを経由しない)はUnity AI Gatewayを通じたスマートルーティングをサポートしていません。 -
ucodeハーネス内のモデル間のルート。 ハーネス間ルーティングにはOmnigent v0.8.0以降が必要です。
