支出の管理
Unity Gatewayでのチームのコーディングエージェントの支出を管理します。予算を設定し、コストと性能のバランスが取れたモデルを選択し、スマートルーティングを使用してモデル選択を最適化します。
予算を設定する
Unity Gateway をリソースタイプとして使用して、毎月の予算を作成します。チームの threshold を選択します:
しきい値 | 制御内容 |
|---|---|
共有 | 予算範囲内のユーザー全体の総支出。 |
ユーザーごと | 個々のユーザーごとの支出。 |
ユーザーごとのオーバーライド | 特定のユーザーまたはグループに対する上限の引き上げ。 |
共有またはユーザーごとの各thresholdに対して、 アラートを送信 、 使用をブロック 、またはその両方を選択します。アラートにより、構成された受信者に通知されます。ブロックすると、予算がResetされるか管理者がthresholdを上げるまで、それ以降のゲートウェイリクエストが防止されます。
チームが外部モデルプロバイダーを使用している場合は、 External Model Spend in Budgets のプレビューを有効にして、 Include external model usage を選択します。その後、推定外部支出が同じthresholdに加算されます。
予算の適用では、ほぼリアルタイムの見積もりが使用されます。すでに進行中のリクエストは完了できるため、最終的な支出がthresholdを超える場合があります。また、外部見積もりはプロバイダーの請求書と異なる場合があります。
For setup and coverage details, see Manage budgets for Unity Gateway.
Set model default and smart default
コーディングエージェントの構成でこれらの設定を編集します。以下のフィールドを既存の構成にMergeし、保存して変更を公開します。
Set a default model
日常業務で各エージェントが最初に使用するモデルを選択します。Claude Codeの場合は、enabled_agents の下にあるその config オブジェクト内に以下を追加します：
{
"default_models": {
"default_model": "system.ai.claude-sonnet-4-6"
}
}
これにより、Claude Sonnet 4.6がClaude Codeのdefaultに設定されます。エージェントが呼び出すことができるモデルのソースを1つ選択し、開発者がアクセスできることを確認します。スマートデフォルトの推奨事項や明示的なモデルの選択が適用されない場合、ugはこのdefaultを使用します。
For Claude Code, you can also map its Opus, Sonnet, Haiku, and Fable model families to specific models:
{
"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リストを使用する場合、すべてのdefaultもそのリストに含まれている必要があります。
支出の増加に伴い推奨事項を調整する
ベータ版
スマートデフォルトはベータ版です。アカウント管理者は、アカウントコンソールの [Previews] ページから Enhanced Unity Gateway のプレビュー版を有効にする必要があります。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 は、適用可能な予算 threshold の 80％ を意味します。その時点で、この例では Claude Haiku 4.5 を搭載した Claude Code を推奨しています。enabled_agents に推奨されるエージェントを含め、開発者にモデルへのアクセス権を付与します。そのエージェントが静的な model_services リストを使用している場合は、推奨されるモデルをリストに含めてください。複数のティアの場合、到達した最も高いthresholdによって推奨事項が決定されます。
ugを実行すると、推奨されるエージェントとモデルが起動します。エージェント固有のコマンドは、選択したエージェントを維持し、そのエージェントをターゲットにしている場合にのみモデルの推奨を適用します。明示的な--modelが推奨事項をオーバーライドします。
スマートデフォルトは新規の起動に影響します。アクティブなセッションの切り替えやモデルアクセスの制限は行いません。予算のブロックを使用してそれ以降のリクエストを停止し、Unity Catalog の権限を使用してアクセスを制限します。
オープンモデルを使用する
Databricksでは、Unity Gatewayを介したコーディングエージェントを使用して、glm-5-2などのオープンソース（OSS）モデルの実行をサポートしています。OSSモデルを使用すると、定型的なコーディングタスクのトークンごとのコストを大幅に削減できます。構成でOSSモデルをエージェントのdefaultとして設定するか、起動時に開発者に選択させます。
起動の例と手動セットアップについては、モデルの選択を参照してください。オープンモデルをサポートするエージェントを確認するには、サポートされているコーディング エージェントを参照してください。
Understand Smart Routing
スマートルーティングは、各タスクを処理できる最もコストの低いモデルを自動的に選択するため、開発者がリクエストごとにモデルを選択する必要はありません。Claude CodeおよびCodexに対応しており、チームのdefaultまたはスマートdefaultの推奨とは異なるモデルを選択できます。
スマートルーティングを default で有効にするには、サポートされている各エージェントの既存の config オブジェクト内に smart_routing を追加します。
{
"smart_routing": {
"enabled": true
}
}
構成を公開します。開発者が ug claude または ug codex で起動すると、CLI はスマートルーティングを自動的に適用します。スマートルーティングをdefaultで有効にするのを停止するには、enabled を false に設定し、アップデートを公開します。
開発者の設定と動作については、モデルの選択またはスマートルーティングの使用を参照してください。
スマートルーティングの制限事項
- Smart Routing supports only a static
models.model_serviceslist whose entries begin withsystem.ai..You cannot enable Smart Routing with amodel_provider_service, aunity_catalog_location, a custom model, an external provider, or a model サービス outsidesystem.ai. - ワークスペース管理者は、開発者にすべての候補モデルへのアクセス権を付与する必要があります。
- The Unity Gateway CLI routes among models within a harness.Routing across harnesses requires Omnigent v0.8.0 or later.
- Unity Gateway CLIを使用しないネイティブのClaude CodeおよびCodexセッションは、Unity Gatewayを通じたスマートルーティングをサポートしていません。
Review spending
Review usage and spend to adjust your budgets and model choices.See Monitor coding agent activity.