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

コーディングエージェント向けのSmart Routing

備考

ベータ版

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

Smart Routingは、コーディングエージェントが引き受ける各タスクに対して最適なモデルを自動的に選択します。Omnigentでは、最適なコーディングハーネスも選択されます。すべてのリクエストに対して開発者がモデルを選択する代わりに、Unity AI Gatewayは各タスクを処理可能な最も低コストのモデルにルーティングします。

コーディングエージェントの実行方法に応じて、Omnigentまたはucodeを通じてSmart Routingをセットアップします。

要件​

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

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

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

  • モデルだけでなくコーディングハーネス全体でルーティングを行うには、Omnigentバージョンv0.8.0以降を使用してください。ハーネス間でのルーティングは、Omnigentでのみ利用可能です。

Omnigentを使用したSmart Routingのセットアップ​

OmnigentはSmart Routingの機能を最大限に引き出します。各タスクに対してモデルとコーディングハーネスの両方を選択できます。この選択は、メインエージェントおよびセッションが起動するすべてのサブエージェントに適用されます。

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

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

    Bash
    omni setup

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

    Bash
    omni host --server <workspace-url>

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

次に、UIまたはCLIからSmart Routingを有効にします。

UIから

ハーネスとして Smart Routing を選択すると、Omnigentがモデルとハーネスの両方を選択します：

OmnigentでハーネスとしてSmart Routingを選択する

または、Claude CodeまたはCodexを選択した後、歯車アイコンをクリックし、モデルに対して Smart Routing を選択します：

OmnigentでモデルとしてSmart Routingを選択する

CLIから

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

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

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

Smart Routingのセットアップ方法 ucode​

ucodeは、Unity AI Gatewayに対してコーディングエージェントを実行するためのDatabricks CLIです。ucodeを通じてCodexまたはClaude Codeを実行する場合は、エージェントごとにSmart Routingを有効にしてください：

Bash
ucode codex --enable-smart-routing
ucode claude --enable-smart-routing

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

Bash
ucode codex --disable-smart-routing
ucode claude --disable-smart-routing

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

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

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

制限事項​

  • Smart Routingはベータ版であり、アカウントごとに有効になります。
  • Smart Routingは、system.aiがプレフィックスとして付加されたモデルサービスの中からのみ選択します。カスタムモデルサービスは現在サポートされていません。
  • ユーザーはルーターが選択可能なすべての候補モデルへのアクセス権を持っている必要があります。そうでない場合、Smart Routingは失敗します。例えば、ルーターが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以外では、Smart Routingはucodeでのみ構成可能です。ネイティブのClaude CodeおよびCodex（ucode経由ではなく直接実行されるもの）は、Unity AI Gatewayを通じたSmart Routingをサポートしていません。
  • ucode ハーネス内のモデル間でルーティングします。ハーネス間でのルーティングには、Omnigent v0.8.0以降が必要です。

その他のリソース​

このページの見出し