Selecione modelos ou use o Roteamento Inteligente

O Unity Gateway permite-te usar diferentes modelos no teu agente de programação. Escolha um modelo ao começar, mude enquanto trabalha, ou deixe o Smart Routing selecionar um para a sua tarefa.

Escolha um modelo

ug descobre os modelos disponíveis no seu espaço de trabalho. O que pode escolher depende do suporte ao modelo do agente, da configuração da sua organização e do acesso concedido a si.

Escolha um modelo no lançamento

Adicione --model ao comando de lançamento do seu agente, usando o nome completo de um modelo disponível para si:

ug claude --model system.ai.claude-sonnet-4-6
ug codex --model system.ai.gpt-5-5

O agente começa com esse modelo, pronto para o seu fluxo de trabalho habitual. Sem --model, começa com o seu padrão configurado.

Para reduzir o custo por token para trabalhos rotineiros, inicie um modelo open source, como system.ai.glm-5-2:

ug codex --model system.ai.glm-5-2

Com o OpenCode, execute ug opencode e selecione um modelo open source como system.ai.glm-5-2. Para ver quais os agentes que suportam modelos abertos, veja Agentes de codificação suportados. Para a justificação dos custos, veja Controlo dos gastos.

Para passar pela conta de fornecedor registada da sua organização, passe o nome do Catálogo Unity para --provider. Consulte Traga os seus próprios fornecedores de modelos.

Mudar de modelo durante uma sessão

Na maioria dos agentes de codificação, introduz:

/model

Selecione um modelo no seletor e continue a trabalhar. Pode usar um modelo mais rápido para edições rotineiras e mudar para um modelo mais capaz para tarefas complexas.

O comando varia consoante o agente. Se /model não estiver disponível, consulte o menu de ajuda do seu agente para encontrar o seletor de modelos.

Usar Roteamento Inteligente

Importante

O Smart Routing está em 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.

O Smart Routing seleciona o modelo de menor custo capaz de gerir a sua tarefa, para que não escolha um modelo para cada pedido. Funciona com Claude Code e Codex.

Requisitos

  • A pré-visualização do Unity Gateway Avançado está ativada para a sua conta. Um administrador de conta ativa-o na página Pré-visualizações da consola da conta. Ver Gerir as pré-visualizações de Azure Databricks. Espere 1–2 minutos após a ativação para que propague para o seu espaço de trabalho.
  • EXECUTE acesso a todos os modelos candidatos que o Smart Routing pode selecionar. O Encaminhamento inteligente escolhe apenas entre serviços de modelo com o prefixo system.ai. Se não houver acesso, o roteamento falha com um erro que identifica os modelos necessários.

Use o encaminhamento inteligente com a CLI do Unity Gateway

Se o seu administrador ativar o Smart Routing na configuração do workspace do seu agente, ug aplica-o automaticamente. Lance o seu agente como habitualmente:

ug claude
ug codex

Para ativar manualmente o Smart Routing num lançamento, adicione --enable-smart-routing:

ug claude --enable-smart-routing
ug codex --enable-smart-routing

Para desligar novamente, inicie com --disable-smart-routing.

Depois de submeteres o teu primeiro prompt, o Smart Routing seleciona um modelo para a sessão. Um aviso no agente mostra o modelo selecionado e, quando disponível, a razão da escolha:

Using Unity Gateway Smart Router.
Selected Model : <model name>
Reason : <reason for the selection>

O agente continua com o modelo selecionado. Se delegar trabalho a subagentes, a tarefa de cada subagente é encaminhada de forma independente e pode usar um modelo diferente.

Para escolher o modelo por si próprio, inicie com --model. A seleção explícita do modelo tem prioridade sobre o Smart Routing nesse lançamento.

Use o encaminhamento inteligente no Omnigent

O Omnigent pode selecionar tanto o harness de codificação como o modelo para uma tarefa, incluindo trabalho delegado a subagentes. Use a versão v0.8.0 ou posterior.

Configure o Claude Code e o Codex para o seu espaço de trabalho no Azure Databricks:

omni setup

Ligue o seu computador ao servidor Omnigent:

omni host --server <workspace-url>

Substitua <workspace-url> pelo URL do seu Azure Databricks espaço de trabalho.

Na interface Omnigent, selecione Smart Routing como chicote para que ele escolha tanto o chicote como o modelo:

Selecionar o Smart Routing como chicote no Omnigent

Para manter o Claude Code ou Codex, selecione esse chicote, abra o menu de engrenagens e escolha Smart Routing para o modelo:

Selecionar o Encaminhamento Inteligente como modelo no Omnigent

Também pode ativar o encaminhamento de modelos a partir da CLI para um harness escolhido:

omni claude --smart-routing --server <workspace-url>
omni codex --smart-routing --server <workspace-url>

A CLI do Gateway Unity encaminha entre modelos dentro do harness suportado selecionado. O Omnigent também seleciona entre arnês; os omni claude exemplos e omni codex escolhem explicitamente um arnês.

Passos seguintes