Unity Gatewayでチームがエージェントのコーディングにどれだけ費やすかをコントロールしましょう。 予算を設定し、コストと能力のバランスを取ったモデルを選択し、スマートルーティングを使ってモデル選択を最適化しましょう。
予算を設定する
Unity Gatewayをリソースタイプにして月額予算を作成しましょう。 チームの閾値を選択してください:
| しきい値 | 制御する内容 |
|---|---|
| Shared | 予算範囲内のユーザー全体の総支出。 |
| ユーザーごと | 各ユーザーごとに支出しましょう。 |
| ユーザーごとのオーバーライド | 特定のユーザーやグループに対してより高い許容度。 |
共有またはユーザーごとの閾値ごとに、アラート を送信、 使用量をブロック、または両方を選択します。 アラートは設定された受信者に通知します。 ブロックは、予算がリセットされるか管理者が閾値を引き上げるまで、さらなるゲートウェイリクエストを阻止します。
チームが外部モデルプロバイダーを使用している場合は、「 予算内での外部モデル支出 プレビュー」を有効にし、「 外部モデルの使用を含める」を選択してください。 推定の外部支出も同じ閾値にカウントされます。
予算執行ではほぼリアルタイムの見積もりが用いられます。 進行中のリクエストは完了できるため、最終支出額を超えることもあります。 外部見積もりは提供者の請求書と異なる場合もあります。
セットアップおよびカバレッジの詳細については、「 Unity Gatewayの予算管理」をご覧ください。
モデルのデフォルト設定とスマートデフォルトを設定する
これらの設定は コーディングエージェントの設定で編集してください。 下のフィールドを既存の設定に統合し、変更を公開するために保存してください。
デフォルトモデルを設定する
各エージェントが日常業務で最初に持つモデルを選びましょう。 Claude Codeの場合、enabled_agentsのconfigオブジェクト内に以下を追加します。
{
"default_models": {
"default_model": "system.ai.claude-sonnet-4-6"
}
}
これにより、Claude Sonnet 4.6がClaude Codeのデフォルト設定となります。 エージェントがサポートするモデルを選び、開発者がそれにアクセスできるようにしましょう。
ug スマートデフォルト推奨や明示的なモデル選択が適用されない場合にこのデフォルトを使用します。
Claude Codeでは、Opus、Sonnet、Haiku、Fableのモデルファミリーを特定のモデルにマッピングすることもできます。
{
"default_models": {
"default_model": "system.ai.claude-sonnet-4-6",
"default_opus_model": "system.ai.claude-opus-4-8",
"default_sonnet_model": "system.ai.claude-sonnet-4-6",
"default_haiku_model": "system.ai.claude-haiku-4-5",
"default_fable_model": "system.ai.claude-fable-5"
}
}
オーバーライドしたいファミリーマッピングだけを指定します。 モデルプロバイダーサービスを使用している models 、そのプロバイダーサービスのモデルIDを使いましょう。 それ以外の場合は、Unity Catalogの完全なモデルサービス名を使用してください。 静的 model_services リストでは、すべてのデフォルトもそのリストに含まれます。
支出の増加に応じて推奨事項を調整する
Important
スマートデフォルトは ベータ版です。 アカウント管理者は、アカウントコンソールのプレビューページからEnhanced Unity Gatewayプレビューを有効にする必要があります。 Manage Azure Databricks プレビューを参照してください。
支出が増えるにつれて異なるエージェントやモデルを推奨するには、既存のコーディングエージェント構成の最上位に smart_defaults を追加してください:
{
"smart_defaults": {
"budget_id": "<budget-configuration-uuid>",
"tiers": [
{
"spending_percentage": 0.8,
"recommended_agent": "CODING_AGENT_CLAUDE_CODE",
"recommended_model": "system.ai.claude-haiku-4-5"
}
]
}
}
予算IDを予算の budget_configuration_idに置き換えてください。 値 0.8 は、該当する予算しきい値の80%を意味します。 その時点で、この例ではClaude CodeとClaude Haiku 4.5を推奨します。 推奨エージェントを enabled_agents に組み込み、開発者にモデルへのアクセスを許可します。 そのエージェントが静的な model_services リストを使用している場合は、推奨モデルもリストに含めてください。 複数のティアでは、到達した最高閾値が推奨事項を決定します。
ugを実行すると推奨エージェントとモデルが起動します。 エージェント固有のコマンドは選択したエージェントを保持し、そのエージェントをターゲットにした場合のみモデル推奨を適用します。 明示的な --model は推奨事項を上書きします。
スマートデフォルトは新規ローンチに影響を与えます。アクティブセッションを切り替えたり、モデルアクセスを制限したりしません。 予算ブロックでさらなるリクエストを止め、 Unityカタログの権限 でアクセスを制限してください。
オープンモデルを使う
Azure Databricks Unity Gatewayを通じてコーディングエージェントを使ってglm-5-2などのオープンソース(OSS)モデルの実行をサポートしています。 OSSモデルは、ルーチンコーディング作業においてトークンあたりのコストを大幅に削減できます。 設定でエージェントのデフォルトとしてOSSモデルを設定するか、開発者にローンチ時に選択してもらうこともできます。
打ち上げの例や手動セットアップについては「 セレクトモデル」をご覧ください。 どのエージェントがオープンモデルをサポートしているかを見るには、「 サポートされたコーディングエージェント」をご覧ください。
スマートルーティングの理解
スマートルーティングは各タスクを処理できる最もコストの低いモデルを自動的に選択するため、開発者はすべてのリクエストに対してモデルを選ぶ必要はありません。 Claude CodeやCodexに対応し、チームのデフォルトまたはスマートデフォルト推奨から異なるモデルを選択できます。
スマートルーティングをデフォルトで有効にするには、各サポートエージェントの既存のconfigオブジェクト内にsmart_routingを追加してください:
{
"smart_routing": {
"enabled": true
}
}
構成を発行します。 開発者が ug claude や ug codexで起動すると、CLIは自動的にスマートルーティングを適用します。 スマートルーティングのデフォルト有効化を停止するには、 enabled を false に設定し、アップデートを公開してください。
開発者の設定や動作については「 モデル選択」または「スマートルーティング」を参照してください。
スマートルーティングの制限
- スマートルーティングは、
system.ai.で始まるエントリの静的models.model_servicesリストのみをサポートしています。model_provider_service、unity_catalog_location、カスタムモデル、外部プロバイダー、またはsystem.ai外のモデルサービスではスマートルーティングを有効にすることはできません。 - ワークスペース管理者は、すべての候補モデルへのアクセスを開発者に許可しなければなりません。
- Unity Gateway CLIはハーネス内のモデル間をルーティングします。 ハーネス間ルーティングにはOmnigent v0.8.0以降が必要です。
- Unity Gateway CLIを使用しないネイティブのClaude CodeおよびCodexセッションは、Unity Gatewayを介したスマートルーティングをサポートしていません。
支出を見直す
使用状況や支出を見直し、予算やモデルの選択を調整しましょう。 詳細は 「コーディングエージェントの活動監視」を参照してください。