Model Selection

Na Zaia Endless, cada Agente pode ser executado por um Provider e Model específicos.
Essa configuração define:

Qual LLM é usado para o raciocínio
Como a cobrança e o consumo de créditos são tratados

A seleção do modelo faz parte do fluxo de configuração do Agente e é definida depois do Prompt, garantindo que as instruções do Agente estejam claras antes de escolher como ele vai raciocinar.

Onde selecionar o modelo

O seletor de Provider e Model fica localizado abaixo do campo principal de Prompt na tela de configuração do Agente.

Esse posicionamento reflete o fluxo de trabalho recomendado:

Definir o Role do Agente
Escrever o Prompt
Selecionar o Provider e Model
Ajustar as configurações comportamentais (Temperature, Effort, Planning, Reasoning)

Como os providers funcionam

Existem duas formas de conectar LLMs aos seus Agentes.

Opção 1 — Usando o Zaia Provider

Ao selecionar Zaia como provider, seu Agente usa modelos nativamente disponíveis na plataforma (como Claude Sonnet 4.5, GPT-4o mini ou Grok 4.5).

Nesse modo:

Você consome créditos da plataforma Zaia por execução
A autenticação e a cobrança são totalmente gerenciadas pela Zaia
Nenhuma configuração de chave de API é necessária

Esta é a opção recomendada para a maioria dos usuários que desejam uma experiência totalmente gerenciada, com acesso instantâneo a múltiplos LLMs.

Opção 2 — Adicionando um provider personalizado

Você também pode conectar seu próprio provider de LLM, contornando os créditos gerenciados da Zaia.

O Console precisa ter pelo menos 10 slots. Abaixo disso, continue no provider Zaia e compre créditos extras de LLM em Console → Créditos de LLM (Adicionar créditos → Comprar créditos). A tela Provedores explica essa exigência ao salvar. Veja Providers.

Para configurar um provider personalizado, acesse:

Plataforma → Configurações → Provedores → Configurar provedor

Neste painel, você pode:

Definir um nome de provider (ex.: “OpenAI Personal”, “Anthropic Enterprise”)
Selecionar o tipo de provider (Anthropic, OpenAI ou Google AI)
Colar sua API key
Opcionalmente adicionar uma descrição interna para identificação

Depois de salvo, o provider fica disponível no menu suspenso Provider dentro da configuração do Agente.

Quando um Agente usa um provider personalizado:

Ele consome seus próprios créditos de API
A cobrança acontece diretamente com o provider externo
A Zaia não cobra créditos pela execução do modelo

Se essa chave falhar (créditos, autenticação ou erro do provedor), a lista em Provedores mostra Com falha e o owner recebe o e-mail Falha do provedor LLM externo. Veja Providers e Notifications.

🔒 Nota de segurança: os tokens de API são armazenados de forma criptografada e usados apenas ao invocar o modelo selecionado para o seu Agente.

Trocando modelos por Agente

A seleção de modelo é específica por Agente.
Isso permite:

Usar modelos leves para FAQs ou Agentes simples
Atribuir modelos mais potentes a Agentes complexos e com uso intenso de raciocínio
Otimizar custo, latência e precisão em todo o seu workspace

Você pode trocar o modelo a qualquer momento sem modificar o Prompt ou a lógica do Agente.

Enquanto o seletor mostra Carregando modelos…, ele fica indisponível. Editar o Prompt nesse intervalo continua sendo salvo automaticamente com o modelo já escolhido no Agente. Veja Salvando alterações.

Custo relativo no seletor de Model

Ao abrir o seletor de Model, cada opção lista um indicador de custo relativo no formato $ × N, em que N é um nível inteiro de 1 a 5.

Esse indicador compara o consumo de créditos entre os modelos disponíveis na lista aberta:

O modelo de menor consumo na lista recebe $ × 1
O modelo de maior consumo na lista recebe $ × 5
Os demais ficam em níveis intermediários, na proporção do consumo
Se todos os modelos listados tiverem o mesmo consumo, todos exibem $ × 1

Ao passar o mouse (ou focar) no indicador, a interface mostra o tooltip Custo relativo.

Com o seletor fechado, o campo exibe apenas o nome do modelo — o indicador $ × N aparece só na lista aberta.

A opção selecionada fica marcada com um contorno em toda a linha. O seletor de Model não usa ícone de check.

ℹ️ Custo relativo ≠ preço em dólar. O $ × N não é cobrança monetária nem o número bruto de créditos. É uma escala visual para comparar modelos na lista. Estimativas em USD no Inspection Panel (providers personalizados) são outro recurso — veja Custos Estimados de LLM.

O mesmo indicador de custo relativo aparece ao escolher o modelo no node LLM de um Workflow.

Boas práticas

Sempre defina o Prompt primeiro, depois selecione o modelo
Use o Zaia Provider para uma configuração mais rápida e cobrança previsível
Use providers personalizados quando precisar de:
- Otimização de custo em escala
- Contratos corporativos
- Recursos específicos do provider

👉 Escolher o modelo certo garante que seu Agente equilibre desempenho, custo e qualidade de raciocínio de acordo com o seu propósito.