控制支出

控制團隊在 Unity Gateway 中撰寫代理程式的花費。 設定預算，選擇能平衡成本與能力的模型，並使用智慧路由優化模型選擇。

設定預算

建立每月預算，並將 Unity Gateway 設為資源類型。 為你的團隊選擇門檻：

對於每個共享或每位使用者的門檻，請選擇 發送警報、 封鎖使用量，或兩者皆有。 警報會通知已設定的收件人。 封鎖會阻止進一步的閘道請求，直到預算重置或管理員提高門檻。

若團隊使用外部模型供應商，請啟用 外部模型預算支出 預覽並選擇 包含外部模型使用。 估計的外部支出也會計入相同的門檻。

預算執行使用近乎即時的估算。 已在進行中的請求仍可完成，因此最終支出可能會超過門檻。 外部估價也可能與供應商的發票不同。

關於設置與覆蓋細節，請參見 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 清單中，所有預設值也必須同時出現在該清單中。

隨著支出增加而調整建議

若要在支出增加時改為推薦不同的代理和模型，請在現有編碼代理設定的頂層加入 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 搭配程式設計代理執行開放原始碼（OSS）模型，例如 glm-5-2。 OSS 模型能大幅降低例行編碼任務的每個代幣成本。 在你的設定中將 OSS 模型設為代理的預設，或讓開發者在啟動時選擇一個。

有關啟動範例及手動設定，請參閱 選擇模型。 欲了解哪些代理支援開放模型，請參閱支援的 編碼代理。

了解智慧路由

智慧路由會自動選擇能處理每個任務的最低成本模型，因此開發者不必為每個請求都選擇模型。 它能使用 Claude Code 和 Codex，並能從團隊的預設或智慧預設推薦中選擇不同的模型。

要預設啟用智慧路由，請在每個支援代理的現有config物件內加入smart_routing：

{
  "smart_routing": {
    "enabled": true
  }
}

發佈設定。 當開發者以 ug claude 或 ug codex啟動時，CLI 會自動套用智慧路由。 要停止預設啟用智慧路由，請設定 enabled 為 false 並發佈更新。

關於開發者的設定與行為，請參見 選擇模型或使用智慧路由。

智慧路由的限制

• 智慧路由僅支援一個靜態 models.model_services 清單，其條目以 system.ai.開頭。 你無法將智慧路由搭配 model_provider_service、unity_catalog_location、自訂模型、外部供應商或 system.ai 以外的模型服務一起啟用。
• Workspace 管理員必須授權開發者使用所有候選模型。
• Unity Gateway CLI 會在 harness 中的各個模型之間進行路由。 跨線束路由需要 Omnigent v0.8.0 或更新版本。
• 原生 Claude Code 與未使用 Unity Gateway CLI 的 Codex 會話，不支援透過 Unity Gateway 進行智慧路由。

檢討經費

檢視使用情況與支出，調整預算與車型選擇。 請參見 監控編碼代理活動。

其他資源

• 大規模管理 AI 編碼成本