Controlla la spesa

Controlla quanto il tuo team spende per gli agenti di codifica in Unity Gateway. Stabilisci budget, scegli modelli che bilanciano costi e capacità e utilizza Smart Routing per ottimizzare la selezione dei modelli.

Impostare il budget

Crea un budget mensile usando Unity Gateway come tipo di risorsa. Scegli le soglie per il tuo team:

Soglia Che cosa controlla
Shared Spesa totale per tutti gli utenti nell'ambito del budget.
Per utente Spesa per ogni singolo utente.
Override per utente Una maggiore concessione per utenti o gruppi specifici.

Per ogni soglia condivisa o per utente, scegli Invia avviso, Blocco utilizzo o entrambi. Gli avvisi notificano i destinatari configurati. Il blocco impedisce ulteriori richieste gateway finché il budget non si resetta o un amministratore non aumenta la soglia.

Se il tuo team utilizza fornitori di modelli esterni, abilita l'anteprima Spesa Modello Esterno nei Budget e seleziona Include l'uso del modello esterno. La spesa esterna stimata conta quindi per le stesse soglie.

L'applicazione del bilancio utilizza stime quasi in tempo reale. Le richieste già in corso possono essere completate, quindi la spesa finale può superare la soglia. Anche le stime esterne possono differire dalla fattura del fornitore.

Per dettagli su configurazione e copertura, vedi Gestire i budget per Unity Gateway.

Imposta i valori predefiniti del modello e i valori predefiniti intelligenti

Modifica queste impostazioni nella configurazione del tuo agente di codifica. Unisci i campi qui sotto nella configurazione esistente, poi salva per pubblicare le tue modifiche.

Imposta un modello predefinito

Scegli il modello con cui ogni agente inizia per il lavoro quotidiano. Per il codice Claude, aggiungi quanto segue all'interno del suo config oggetto sotto enabled_agents:

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

Questo imposta Claude Sonnet 4.6 come opzione predefinita di Claude Code. Scegli un modello supportato dall'agente e assicurati che gli sviluppatori vi abbiano accesso. ug Usa questo predefinito quando non si applica alcuna raccomandazione smart-default o scelta esplicita del modello.

Per Claude Code, puoi anche mappare le famiglie di modelli Opus, Sonnet, Haiku e Fable a modelli specifici:

{
  "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"
  }
}

Specifica solo le mappe familiari che vuoi sovrascrivere. Se models utilizza un servizio di fornitore modello, usa gli ID modello di quel servizio. Altrimenti, usa i nomi completi dei servizi modello del Catalogo Unity. Con una lista statica model_services , ogni impostazione predefinita deve apparire anche in quella lista.

Modifica le raccomandazioni man mano che aumenta la spesa

Importante

I valori smart di default sono in Beta. Un amministratore dell'account deve abilitare l'anteprima Enhanced Unity Gateway dalla pagina delle anteprime della console account. Vedere Gestire le anteprime di Azure Databricks.

Per raccomandare un agente e un modello diversi man mano che le spese aumentano, aggiungi smart_defaults al livello superiore della configurazione esistente dell'agente di codifica:

{
  "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"
      }
    ]
  }
}

Sostituisci l'ID del budget con quello budget_configuration_iddel tuo budget. Il valore 0.8 rappresenta l'80% della soglia di bilancio applicabile. A quel punto, questo esempio consiglia di usare Claude Code con Claude Haiku 4.5. Includi l'agente enabled_agents consigliato e concedi agli sviluppatori l'accesso al modello. Se quell'agente utilizza una lista statica model_services , includi il modello consigliato nella lista. Per più livelli, la soglia più alta raggiunta determina la raccomandazione.

Eseguendo ug si avviano l'agente e il modello consigliati. Un comando specifico per l'agente mantiene l'agente scelto e applica una raccomandazione di modello solo se mira a quell'agente. Un esplicito --model prevale sulla raccomandazione.

Le impostazioni predefinite intelligenti influiscono sui nuovi avvii; non modificano le sessioni attive né restringono l'accesso ai modelli. Usa il blocco del budget per fermare ulteriori richieste e i permessi del Catalogo Unity per limitare l'accesso.

Usa modelli aperti

Azure Databricks supporta l'esecuzione di modelli open source (OSS), come glm-5-2, con agenti di codifica tramite Unity Gateway. I modelli OSS possono ridurre notevolmente il costo per token per compiti di codifica di routine. Imposta un modello OSS come predefinito per un agente nella tua configurazione, oppure fai scegliere uno agli sviluppatori al lancio.

Per esempi di avvio e configurazione manuale, vedi Select models. Per vedere quali agenti supportano modelli aperti, vedi Agenti di codifica supportati.

Comprendere il routing intelligente

Smart Routing seleziona automaticamente il modello a basso costo in grado di gestire ogni compito, così gli sviluppatori non devono scegliere un modello per ogni richiesta. Funziona con Claude Code e Codex e può selezionare un modello diverso da quello predefinito del team o da quello consigliato automaticamente.

Per abilitare Smart Routing per impostazione predefinita, aggiungi smart_routing all'interno dell'oggetto config esistente di ciascun agente supportato:

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

Pubblicare la configurazione. Quando gli sviluppatori avviano il comando con ug claude o ug codex, la CLI applica automaticamente Smart Routing. Per evitare che Smart Routing venga abilitato per impostazione predefinita, imposta enabled su false e pubblica l'aggiornamento.

Per la configurazione e il comportamento degli sviluppatori, vedi Seleziona modelli o usa Smart Routing.

Limitazioni del Smart Routing

  • Smart Routing supporta solo una lista statica models.model_services le cui voci iniziano con system.ai.. Non puoi abilitare Smart Routing con un model_provider_service, un unity_catalog_location, un modello personalizzato, un provider esterno o un servizio di modelli al di fuori di system.ai.
  • Gli amministratori dello spazio di lavoro devono concedere agli sviluppatori l'accesso a ogni modello candidato.
  • La CLI di Unity Gateway instrada le richieste tra i modelli all'interno di un ambiente di test. Il routing tra i cablaggi richiede Omnigent v0.8.0 o successiva.
  • Le sessioni native di codice Claude e Codex che non utilizzano la CLI del Gateway Unity non supportano lo Smart Routing tramite Unity Gateway.

Rivedere la spesa

Rivedi l'uso e la spesa per modificare budget e scelte di modello. Vedi Monitorare l'attività dell'agente di codifica.

Risorse aggiuntive

  • Ultimo aggiornamento: