Configurações do Agente

Após criar um agente, você pode ajustar suas configurações a qualquer momento pela página de detalhes.

Informações básicas

• Nome — identificador exibido no dashboard
• Descrição — resumo do propósito do agente
• Instruções (system prompt) — define personalidade, comportamento, conhecimento e limites

Modelo de IA

Provider

O provider que fornece o modelo. Opções disponíveis:

• Anthropic — Claude 3.5 Sonnet, Claude 3 Haiku
• OpenAI — GPT-4o, GPT-4o-mini
• OpenRouter — acesso a dezenas de modelos

Temperatura

Controla a aleatoriedade das respostas: de 0 (determinístico) a 1 (criativo).

Tokens

• Max tokens — limite máximo de tokens por resposta
• Prompt caching — ativa cache do system prompt para economia de tokens

Modelo principal e modelos de fallback

Modelo principal

O modelo que será utilizado por padrão em todas as interações do agente.

Modelos de fallback

Modelos alternativos que o agente usa automaticamente quando o modelo principal falha. Casos comuns de acionamento:

• Limite de contexto excedido — o histórico da conversa ultrapassa a janela de tokens do modelo
• Falha em gerar saída estruturada — o modelo não consegue produzir o JSON esperado, nem depois das novas tentativas que o atendimento faz
• Rate limit ou indisponibilidade — o provedor retorna erro temporário ou a cota do plano acabou. Nesse caso o agente passa na hora para o próximo modelo, sem insistir no que falhou

Como configurar: na seção "Modelos de fallback" da página do agente, adicione um ou mais modelos em ordem de preferência. O sistema tentará cada modelo na sequência até obter uma resposta válida.

Faturamento: quando um fallback é acionado, os tokens consumidos por cada modelo (inclusive o primário que falhou) são contabilizados separadamente, refletindo os preços individuais de cada provedor.

Formato da resposta (Schema JSON)

No WhatsApp, o agente responde num formato fixo que você monta em "Construir Schema JSON": cada mensagem tem um tipo (texto, arquivo ou lista) e alguns campos, como texto, link do arquivo ou botões.

• Campos marcados como Obrigatório sempre vêm na resposta.
• Campos não obrigatórios só aparecem quando fazem sentido. Uma mensagem de texto, por exemplo, não precisa de link de arquivo.
• Alguns modelos (como os da OpenAI) preenchem todos os campos e deixam vazios os que não usam. Outros (como os do MiniMax) escrevem só os campos que usam. Para o cliente, o resultado é o mesmo: os campos vazios não são enviados.

O agente escreve a resposta uma vez só por mensagem do cliente. Ele só tenta de novo quando a resposta veio fora do formato.

Canais conectados

Gerencie quais canais o agente atende: WhatsApp e Webchat.

Skills

Skills são capacidades adicionais do agente. Veja Skills.

Proteção contra ações repetidas

Enquanto prepara uma resposta, o agente pode consultar as mesmas informações várias vezes — por exemplo, checar o mesmo código de rastreio dez vezes seguidas. A plataforma reconhece esse padrão e executa a ação apenas uma vez: as repetições recebem o resultado que já havia sido obtido.

Na prática, isso significa que:

• o cliente não recebe e-mails, mensagens ou notificações duplicados;
• registros como nota de avaliação e mudança de etapa não são gravados duas vezes;
• a resposta chega mais rápido, porque a consulta repetida não é refeita.

A proteção vale dentro de uma mesma resposta. Na mensagem seguinte, o agente consulta tudo de novo — afinal, um status de entrega ou de pagamento pode ter mudado nesse intervalo.

Se uma consulta falhar (por exemplo, um sistema externo fora do ar), o agente ainda tem novas tentativas antes de a proteção assumir.