控制支出

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

設定預算

以 Unity Gateway 作為資源類型建立預算。 為你的團隊選擇門檻:

閾值 它控制的是什麼
共用 在預算範圍內,所有使用者合計的每月總支出。
每位使用者 每日支出、每月支出,或兩者皆可,針對每位使用者。
逐用戶覆寫 針對特定使用者或群組較高的每日或每月額度。

對於每個共用門檻,以及每個每位使用者門檻的期間,選擇 「寄送電子郵件」、「封鎖使用」 和 「觸發 webhook」 中的一個或多個。 系統會寄送電子郵件通知已設定的收件人。 阻擋會阻止進一步的閘道請求,直到門檻的週期重置或管理員提高門檻值為止。 每日門檻於 00:00 UTC 重置。

如果您的團隊使用外部模型提供者,請啟用「外部模型預算支出」預覽,並選擇「包含外部模型提供者」。 估計的外部支出也會計入相同的門檻。

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

有關設定與覆蓋範圍的詳細資訊,請參閱 設定 Unity Gateway 的預算與支出上限。

設定模型預設值與智慧預設值

在你的 編碼代理設定中編輯這些設定。 將下方欄位合併到現有設定,然後儲存以發佈你的變更。

設定預設模型

請選擇每位經紀人日常工作時所採用的模式。 對於 Claude Code,請在其 enabled_agents 物件中的 config 下方加入以下內容:

{
  "default_models": {
    "default_model": "system.ai.claude-sonnet-5-5"
  }
}

這會將 Claude Sonnet 5.5 設定為 Claude Code 的預設版本。 選擇代理所支援的模型,並確保開發者能存取它。 ug 當沒有智慧預設建議或明確模型選擇適用時,會使用此預設值。

對於 Claude Code,你也可以將其 Opus、Sonnet、Haiku 和 Fable 模型族映射到特定模型:

{
  "default_models": {
    "default_model": "system.ai.claude-sonnet-5-5",
    "default_opus_model": "system.ai.claude-opus-4-8",
    "default_sonnet_model": "system.ai.claude-sonnet-5-5",
    "default_haiku_model": "system.ai.claude-haiku-5-5",
    "default_fable_model": "system.ai.claude-fable-5"
  }
}

只指定你想覆蓋的家族映射。 若 models 使用模型提供者服務,則使用該提供者服務的模型 ID。 否則,請使用完整的 Unity Catalog 模型服務名稱。 靜態 model_services 清單中,所有預設值也必須同時出現在該清單中。 使用 sources 清單時,每個預設必須是條 sources 目所包含的特定型號,該模型可以直接列出或由萬用字元匹配。

隨著支出增加而調整建議

Important

智慧預設值目前為 Beta。 帳戶管理員必須在帳戶主控台的預覽頁面啟用強化版 Unity Gateway預覽功能。 請參閱 管理 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-5-5"
      }
    ]
  }
}

把預算ID換成你的預算 budget_configuration_id。 該價值 0.8 指適用預算門檻的80%。 此時,此範例建議使用 Claude Code 搭配 Claude Haiku 5.5。 將推薦的代理加入 enabled_agents ,並授權開發者存取該模型。 如果該代理使用靜態 model_services 清單,請將推薦的模型納入清單中。 使用 sources 清單時,推薦的模型必須是條目所包含的特定模型 sources ,可以直接列出或以萬用字元匹配。 若有多個級別,則以所達到的最高門檻來決定建議結果。

執行時 ug 會啟動推薦的代理和模型。 代理專屬指令會保留所選代理,僅在針對該代理時套用模型推薦。 明確指定的 --model 會覆寫該建議。 對於 GitHub Copilot,建議適用於以 ug copilot 啟動的 Copilot CLI 工作階段,而非 Visual Studio Code 中的 Copilot。

智慧預設只會影響新啟動的工作階段;不會切換目前使用中的工作階段,也不會限制模型存取。 使用預算封鎖來停止更多請求,並使用 Unity 目錄權限 來限制存取權限。

使用開放模型

Azure Databricks 支援透過 Unity Gateway 執行開源模型,例如 system.ai.glm-5-3,並搭配編碼代理程式。 開源模型能大幅降低日常編碼任務的每個代幣成本。 在你的設定中,將開源模型設為代理的預設,或讓開發者在模型選擇器中選擇一個。

關於模型選擇器的操作說明與設定範例,請參見 「選擇模型」。 欲了解哪些代理支援開放模型,請參閱 支援開放模型的編碼與工作代理。

了解智慧路由

Important

智慧路由目前還在 測試階段。 帳戶管理員必須在帳戶主控台的預覽頁面啟用強化版 Unity Gateway預覽功能。 請參閱 管理 Azure Databricks 預覽。

啟用智慧路由時,編碼代理會將任務交接給子代理。 智慧路由選擇能處理每個子代理任務的最低成本模型,因此每個任務可以使用不同的模型。 主工作階段會以團隊的 預設或智慧預設運作。 智慧路由是用 Claude Code 來運作的。 適用於 Codex 的智慧路由在 Unity Gateway CLI 中暫停。 GitHub Copilot 不支援智慧路由。 在 Unity Gateway Managed Configuration 測試版中,Smart Routing 也可以選擇模型提供者服務背後的外部模型。 請參閱 「為每個代理人選擇模型來源」。

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

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

發佈設定。 當開發者以 ug claude 啟動時,CLI 會自動套用智慧路由。 開發者可以在啟動時用 --disable-smart-routing 將其關閉。 要停止預設啟用智慧路由,請設定 enabled 為 false 並發佈更新。

關於開發者的設定與行為,請參見 選擇模型或使用智慧路由。 要衡量節省成效,請參閱 Smart Routing 分頁。

智慧路由的限制

  • 在靜態 models.model_services 清單下,智慧路由僅支援以 system.ai.為開頭的條目。 如果您正在使用 Unity Gateway 託管設定 測試版,Smart Routing 也支援 model_provider_service 和 models.sources 清單,因此它可以路由到模型提供者服務背後的外部模型。 關於設定,請參閱 「為每個代理人選擇模型來源」。
  • 您無法搭配 unity_catalog_location 啟用智慧路由。
  • 在 sources的情況下,清單中的每個模型服務必須在其所有目的地(包括備援目的地)中解析為恰好一個模型。
  • 在 sources 清單中,萬用字元必須是整個最後一個區段。 像是 system.ai.claude-* 這樣的部分模式會被拒絕。
  • 當清單中的 sources 兩個項目解析為相同模型時,智慧路由只會使用清單順序中的第一個項目,並忽略後續重複項目。
  • Workspace 管理員必須授權開發者使用所有候選模型。
  • Unity Gateway CLI 會在 harness 中的各個模型之間進行路由。 跨線束路由需要 Omnigent v0.8.0 或更新版本。
  • 原生 Claude Code 與未使用 Unity Gateway CLI 的 Codex 會話,不支援透過 Unity Gateway 進行智慧路由。

檢討經費

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

其他資源