Controla os gastos

Controla quanto a tua equipa gasta em agentes de programação no Unity Gateway. Defina orçamentos, escolha modelos que equilibrem custo e capacidade, e use o Smart Routing para otimizar a seleção dos modelos.

Definir orçamentos

Crie um orçamento mensal com o Unity Gateway como tipo de recurso. Escolha limiares para a sua equipa:

Limite O que controla
Partilhado Despesa total de todos os utilizadores no âmbito do orçamento.
Por utilizador Despesa por utilizador.
Override por utilizador Uma maior tolerância para utilizadores ou grupos específicos.

Para cada limiar partilhado ou por utilizador, escolha Enviar alerta, Bloquear utilização ou ambos. Os alertas notificam os destinatários configurados. O bloqueio impede novos pedidos ao gateway até que o orçamento seja reposto ou um administrador aumente o limite.

Se a sua equipa usar fornecedores de modelos externos, ative a pré-visualização de Despesa de Modelo Externo nos Orçamentos e selecione Incluir utilização de modelos externos. A despesa externa estimada é assim contabilizada para os mesmos limiares.

A fiscalização orçamental utiliza estimativas quase em tempo real. Pedidos já em curso podem ser concluídos, pelo que o gasto final pode ultrapassar o limiar. As estimativas externas também podem diferir da fatura do fornecedor.

Para detalhes de configuração e cobertura, consulte Gerir orçamentos para o Unity Gateway.

Definir os padrões do modelo e os padrões inteligentes

Edita estas definições na configuração do teu agente de codificação. Junta os campos abaixo na configuração existente e depois guarda para publicar as tuas alterações.

Definir um modelo padrão

Escolha o modelo com que cada agente começa para o trabalho diário. Para o Claude Code, adicione o seguinte dentro do objeto config sob enabled_agents:

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

Isto define o Claude Sonnet 4.6 como o padrão do Claude Code. Escolha um modelo suportado pelo agente e garanta que os programadores têm acesso a ele. ug utiliza este padrão quando não se aplica nenhuma recomendação smart-default ou escolha explícita do modelo.

Para Claude Code, também pode mapear as famílias de modelos Opus, Sonnet, Haiku e Fable para modelos específicos:

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

Especifica apenas os mapeamentos familiares que queres sobrepor. Se models utilizar um serviço fornecedor de modelos, use os IDs dos modelos desse serviço fornecedor. Caso contrário, use os nomes completos dos serviços de modelo do Unity Catalog. Com uma lista estática model_services , todos os predefinidos também devem aparecer nessa lista.

Ajustar as recomendações à medida que os gastos aumentam

Importante

As predefinições inteligentes estão na fase Beta. Um administrador de conta deve ativar a Visualização Melhorada do Gateway Unity a partir da página de Pré-visualizações da consola da conta. Ver Gerir as pré-visualizações de Azure Databricks.

Para recomendar um agente e modelo diferente à medida que os gastos aumentam, adicione smart_defaults no topo da configuração existente do seu agente de codificação:

{
  "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 pelo budget_configuration_id do seu orçamento. O valor 0.8 representa 80% do limiar orçamental aplicável. Nesse ponto, este exemplo recomenda Claude Code com Claude Haiku 4.5. Inclua o agente recomendado em enabled_agents e conceda aos programadores acesso ao modelo. Se esse agente usar uma lista estática model_services , inclua o modelo recomendado na lista. Para múltiplos níveis, o limiar mais alto atingido determina a recomendação.

Executar ug inicia o agente e o modelo recomendados. Um comando específico para um agente mantém o agente selecionado e aplica uma recomendação de modelo apenas se essa recomendação se destinar a esse agente. Uma --model explícita sobrepõe-se à recomendação.

As predefinições inteligentes afetam apenas as novas sessões; não mudam as sessões ativas nem restringem o acesso ao modelo. Use bloqueio orçamental para impedir pedidos adicionais e permissões do Catálogo Unity para restringir o acesso.

Utilizar modelos abertos

O Azure Databricks suporta a execução de modelos open source (OSS), como glm-5-2, com agentes de codificação através do Unity Gateway. Modelos OSS podem reduzir substancialmente o custo por token para tarefas rotineiras de codificação. Defina um modelo OSS como padrão de um agente na sua configuração, ou peça aos programadores para selecionar um no lançamento.

Para exemplos de lançamento e configuração manual, veja Select models. Para ver quais os agentes que suportam modelos abertos, veja Agentes de codificação suportados.

Compreenda o Encaminhamento Inteligente

O Smart Routing seleciona automaticamente o modelo de menor custo capaz de lidar com cada tarefa, pelo que os programadores não precisam de escolher um modelo para cada pedido. Utiliza o Claude Code e o Codex e pode selecionar um modelo diferente da recomendação predefinida ou da recomendação predefinida inteligente da equipa.

Para ativar o Roteamento Inteligente por predefinição, adicione smart_routing dentro do objeto config existente de cada agente suportado:

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

Publique a configuração. Quando os programadores lançam com ug claude ou ug codex, a CLI aplica automaticamente o Smart Routeing. Para deixar de ativar o Smart Routing por predefinição, defina enabled para false e publique a atualização.

Para configuração e comportamento do programador, veja Selecionar modelos ou usar Smart Routing.

Limitações do Smart Routing

  • O Smart Routing suporta apenas uma lista estática models.model_services cujas entradas começam com system.ai.. Não pode ativar o Smart Routing com um model_provider_service, um unity_catalog_location, um modelo personalizado, um fornecedor externo ou um serviço de modelos fora de system.ai.
  • Os administradores do espaço de trabalho devem conceder aos programadores acesso a todos os modelos candidatos.
  • A CLI do Unity Gateway encaminha pedidos entre modelos numa estrutura. O roteamento entre cablagens requer Omnigent v0.8.0 ou posterior.
  • As sessões nativas de Code Claude e Codex que não utilizam a CLI do Unity Gateway não suportam o Smart Routing através do Unity Gateway.

Rever os gastos

Analise o consumo e os gastos para ajustar os seus orçamentos e escolhas de modelos. Ver Monitorizar a atividade do agente de codificação.

Recursos adicionais

  • Última atualização a