コーディングエージェント向けのスマートルーティング
ベータ版
スマートルーティングはベータ版であり、アカウントごとに有効になります。ユーザーがスマートルーティングを使用するには、その前にアカウント管理者がプレビューを有効にする必要があります。可用性、サポートされるモデル、およびAPIは、ベータ期間中に変更される可能性があります。
スマートルーティングは、コーディングエージェントが引き受ける各タスクに対して最適なモデルを自動的に選択します。Omnigentでは、最適なコーディングハーネスも選択されます。すべてのリクエストに対して開発者がモデルを選択する代わりに、Unity AI Gatewayは各タスクを処理可能な最も低コストのモデルにルーティングします。
コーディングエージェントの実行方法に応じて、Omnigentまたはucodeを通じてスマートルーティングをセットアップします。
要件
-
お客様のアカウントで スマートルーティング のアカウントレベルのプレビューが有効になりました。アカウント管理者に連絡して有効化を依頼し、有効化後、ワークスペースに反映されるまで1～2分お待ちください。
-
スマートルーティングが選択可能な候補モデルへのアクセス。スマートルーティングは、
system.aiというプレフィックスが付いたモデルサービスの中からのみ選択を行います。 -
Unity AI Gatewayがサポートされるリージョン内のDatabricksワークスペース。
-
モデルだけでなくコーディングハーネス全体でルーティングを行うには、Omnigentバージョンv0.8.0以降を使用してください。ハーネス間でのルーティングは、Omnigentでのみ利用可能です。
Omnigentを使用したスマートルーティングのセットアップ
Omnigentはスマートルーティングの機能を最大限に引き出します。各タスクに対してモデルとコーディングハーネスの両方を選択できます。この選択は、メインエージェントおよびセッションが起動するすべてのサブエージェントに適用されます。
Omnigentをセットアップするには：
-
推論にDatabricksワークスペースを使用するようにClaude CodeおよびCodexを構成します：
Bashomni setup -
コンピュータをOmnigentサーバーに接続します：
Bashomni host --server <workspace-url><workspace-url>を 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> を Databricks ワークスペースの URL に置き換えます。
スマートルーティングのセットアップ方法 ucode
ucodeは、Unity AI Gatewayに対してコーディングエージェントを実行するための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 CodeおよびCodex（ucode経由ではなく直接実行されるもの）は、Unity AI Gatewayを通じたスマートルーティングをサポートしていません。 ucodeハーネス内のモデル間でルーティングします。ハーネス間でのルーティングには、Omnigent v0.8.0以降が必要です。