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:

1. Definir o Role do Agente
2. Escrever o Prompt
3. Selecionar o Provider e Model
4. 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.

Para configurar um provider personalizado, acesse:

Platform → Settings → Providers → Configure Provider

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

🔒 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.

---

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.