Controlar gastos
Controle quanto sua equipe gasta com agentes de codificação no Unity Gateway. Defina orçamentos, escolha modelos que equilibrem custo e capacidade e use o Smart Routing para otimizar a seleção de modelos.
Definir orçamentos
Crie um orçamento mensal com o Unity Gateway como o tipo de recurso. Escolha os limites para sua equipe:
Threshold | O que ele controla |
|---|---|
Compartilhado | Gasto total entre usuários no escopo do orçamento. |
Por usuário | Gastos para cada usuário individual. |
Per-user override | Um limite maior para usuários ou grupos específicos. |
Para cada limite compartilhado ou por usuário, escolha Enviar alerta , Block usage ou ambos. Os alertas notificam os destinatários configurados. O bloqueio evita novas solicitações de gateway até que o orçamento seja Reset ou um administrador aumente o limite.
Se a sua equipe usar provedores de modelos externos, ative a prévia de External Model Spend in Budgets e selecione Include external model usage . Os gastos externos estimados também são contabilizados em relação aos mesmos limites.
A aplicação do orçamento usa estimativas em tempo real. As solicitações já em andamento podem ser concluídas, portanto, o gasto final pode exceder o limite. As estimativas externas também podem diferir da fatura do provedor.
Para obter detalhes sobre a configuração e a cobertura, consulte Gerenciar orçamentos do Unity Gateway.
Definir default de modelo e smart defaults
Edite essas configurações na configuração do seu agente de programação. Faça o merge dos campos abaixo na configuração existente e, em seguida, salve para publicar suas alterações.
Definir um modelo default
Escolha o modelo com o qual cada agente começa para o trabalho diário. Para o Claude Code, adicione o seguinte dentro do objeto config em enabled_agents:
{
"default_models": {
"default_model": "system.ai.claude-sonnet-4-6"
}
}
Isso define o Claude Sonnet 4.6 como o default do Claude Code. Escolha um modelo compatível com o agente e garanta que os desenvolvedores tenham acesso a ele. ug usa este default quando nenhuma recomendação de default inteligente ou escolha explícita de modelo se aplica.
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"
}
}
Especifique apenas os mapeamentos de família que você deseja substituir. Se models usar um serviço de provedor de modelos, use IDs de modelo desse serviço de provedor. Caso contrário, use nomes completos de serviços de modelo do Unity Catalog. Com uma lista estática de model_services, todos os default também devem aparecer nessa lista.
Ajuste as recomendações à medida que os gastos aumentam
Beta
Smart defaults estão em Beta. Um administrador account deve habilitar a prévia do Enhanced Unity Gateway na página Previews do console da account. Consulte Gerenciar prévias do Databricks.
Para recomendar um agente e um modelo diferentes à medida que os gastos aumentam, adicione smart_defaults no nível superior da configuração do seu agente de código existente:
{
"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"
}
]
}
}
Substitua o ID do orçamento por budget_configuration_id do seu orçamento. O valor 0.8 significa 80% do limite de orçamento aplicável. Nesse ponto, este exemplo recomenda o Claude Code com o Claude Haiku 4.5. Inclua o agente recomendado em enabled_agents e conceda aos desenvolvedores acesso ao modelo. Se esse agente usar uma lista estática model_services, inclua o modelo recomendado na lista. Para vários níveis, o limite mais alto atingido determina a recomendação.
A execução de ug inicia o agente e o modelo recomendados. Um comando específico do agente mantém o agente escolhido e aplica uma recomendação de modelo apenas se ela for direcionada a esse agente. Um --model explícito substitui a recomendação.
Os padrões inteligentes afetam novos lançamentos; eles não alternam sessões ativas nem restringem o acesso ao modelo. Use o bloqueio de orçamento para interromper novas solicitações e as permissões do Unity Catalog para restringir o acesso.
Use open models
O Databricks dá suporte à execução de modelos de código aberto (OSS), como glm-5-2, com agentes de codificação por meio do Unity Gateway. Os modelos OSS podem reduzir substancialmente o custo por token para tarefas de rotina de codificação. Defina um modelo OSS como o default de um agente em sua configuração ou faça com que os desenvolvedores selecionem um no momento do lançamento.
Para ver exemplos de lançamento e configuração manual, consulte Selecionar modelos. Para ver quais agentes dão suporte a modelos abertos, consulte Agentes de codificação compatíveis.
Entenda o Roteamento Inteligente
O Smart Routing seleciona automaticamente o modelo de menor custo capaz de lidar com cada tarefa, de modo que os desenvolvedores não precisam escolher um modelo para cada solicitação. Ele funciona com o Claude Code e o Codex e pode selecionar um modelo diferente da recomendação default ou smart-default da equipe.
Para habilitar o Smart Routing por default, adicione smart_routing dentro do objeto config existente de cada agente compatível:
{
"smart_routing": {
"enabled": true
}
}
Publique a configuração. Quando os desenvolvedores iniciam com ug claude ou ug codex, a CLI aplica o Roteamento Inteligente automaticamente. Para parar de habilitar o Roteamento Inteligente por default, defina enabled como false e publique a atualização.
Para obter informações sobre a configuração e o comportamento do desenvolvedor, consulte Selecionar modelos ou usar o Roteamento Inteligente.
Limitações do roteamento inteligente
- O Roteamento Inteligente é compatível apenas com uma lista estática de
models.model_servicescujas entradas começam comsystem.ai.. Não é possível habilitar o Roteamento Inteligente com ummodel_provider_service, umunity_catalog_location, um modelo personalizado, um provedor externo ou um serviço de modelo fora desystem.ai. - Os administradores do workspace devem conceder aos desenvolvedores acesso a cada modelo candidato.
- A CLI do Unity Gateway faz o roteamento entre modelos dentro de um harness. O roteamento entre harnesses exige o Omnigent v0.8.0 ou posterior.
- As sessões nativas do Claude Code e do Codex que não usam a CLI do Unity Gateway não oferecem suporte ao Smart Routing por meio do Unity Gateway.
Analisar gastos
Revise o uso e os gastos para ajustar seus orçamentos e escolhas de modelos. Consulte Monitorar a atividade do agente de programação.