メインコンテンツまでスキップ
に最終更新

コーディングエージェント向けのスマートルーティング

備考

ベータ版

スマートルーティングはベータ版であり、アカウントごとに有効になります。ユーザーがスマートルーティングを使用するには、その前にアカウント管理者がプレビューを有効にする必要があります。可用性、サポートされるモデル、およびAPIは、ベータ期間中に変更される可能性があります。

Codex または Claude Code でスマートルーティングを有効にするには、Unity Gateway CLI (ug) を使用します。スマートルーティングは、各タスクを処理できる最も低コストなモデルを自動的に選択するため、開発者がリクエストごとにモデルを選択する必要はありません。

要件​

  • お客様のアカウントで スマートルーティング のアカウントレベルのプレビューが有効になりました。アカウント管理者に連絡して有効化を依頼し、有効化後、ワークスペースに反映されるまで1～2分お待ちください。

  • スマートルーティングが選択可能な候補モデルへのアクセス。スマートルーティングは、system.aiというプレフィックスが付いたモデルサービスの中からのみ選択を行います。

  • Unity Gateway がサポートされているリージョンの Databricks ワークスペース。

Unity Gateway CLIを使用したスマートルーティングのセットアップ​

Unity Gateway CLI は、Unity Gateway に対してコーディングエージェントを実行します。Unity Gateway CLI を通じて Codex または Claude Code を実行する場合は、エージェントごとにスマートルーティングを有効にしてください：

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

この設定はエージェントごとに保持されるため、その後のug codexまたはug claudeセッションでもスマートルーティングはオンのままになります。オフにするには：

Bash
ug codex --disable-smart-routing
ug claude --disable-smart-routing

スマートルーティングを有効にした後、コマンドラインでプロンプトを渡してルーティングします。スマートルーティングはインタラクティブなルートセッションには適用されないため、--を使用してプロンプトを提供する必要があります：

Bash
ug claude -- "<prompt>"
ug codex -- "<prompt>"

スマートルーティングはそのプロンプトに対してモデルを選択し、タスクが生成するすべてのサブエージェントも同様の方法でルーティングされます。ハーネス間でのルーティングは、Omnigentでのみ利用可能です。

Omnigentを使用したスマートルーティングのセットアップ​

コーディングハーネス間でルーティングを行うには、Omnigentバージョンv0.8.0以降を使用してください。Omnigentは、各タスクに対してモデルとコーディングハーネスの両方を選択できます。この選択は、メインエージェントおよびセッションが起動するすべてのサブエージェントに適用されます。

Omnigentをセットアップするには：

  1. 推論にDatabricksワークスペースを使用するようにClaude CodeおよびCodexを構成します：

    Bash
    omni setup

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

    Bash
    omni host --server <workspace-url>

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

次に、UIまたはCLIからスマートルーティングを有効にします。

UIから

ハーネスとして スマートルーティング を選択すると、Omnigentがモデルとハーネスの両方を選択します：

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

または、Claude CodeまたはCodexを選択した後、歯車アイコンをクリックし、モデルに対して スマートルーティング を選択します：

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

CLIから

--smart-routingをハーネスに渡します：

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

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

制限事項​

  • スマートルーティングはベータ版であり、アカウントごとに有効になります。
  • スマートルーティングは、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を必要とします。ユーザーがいずれの候補にもアクセスできない場合、リクエストは必要なモデルサービス名を指定するエラーを返します。
  • Unity Gateway CLIは、ハーネス内のモデル間でルーティングを行います。ハーネス間でのルーティングには、Omnigent v0.8.0以降が必要です。
  • Unity Gateway CLIを使用しないネイティブのClaude CodeおよびCodexセッションは、Unity Gatewayを通じたスマートルーティングをサポートしていません。

その他のリソース​

このページの見出し