Modelo de IA
Todo agent pensa com um modelo de IA. Por padrão, todos usam o modelo da plataforma — você não precisa escolher nada para o agent funcionar.
Escolher vale quando você quer algo específico: um modelo mais barato para um agent que só responde perguntas simples, um modelo mais forte para o que negocia, ou um modelo que você já paga em outra conta.
Onde se escolhe
Em dois lugares, e o de baixo vence o de cima:
| Onde | Vale para | Quando o campo está vazio |
|---|---|---|
| Organização (página da empresa) | Todos os agents dela | Usa o modelo da plataforma |
| Agent (aba do perfil) | Só aquele agent | Herda o da organização |
Cada campo é independente. Você pode deixar a chave na organização (é ela que paga) e escolher um modelo diferente em um agent só — o agent usa o modelo dele com a chave da empresa.
A lista de modelos
O campo tem uma lista com os modelos disponíveis. Comece a digitar e ela filtra.
A lista mostra só modelos que sabem usar ferramentas. Isso não é detalhe técnico: é o que permite ao agent consultar a agenda, registrar uma proposta, olhar o cadastro do cliente. Um modelo sem isso responderia bonito e não faria nada — por isso ele nem aparece.
Ao escolher, a tela mostra:
- o preço de entrada e de saída, por milhão de tokens;
- “aceita foto” ou “não lê imagens”;
- o tamanho da janela, que é quanto de conversa o modelo consegue considerar de uma vez.
O preço é referência do catálogo, para você comparar modelos. Ele não é a sua fatura, e o relatório de uso e limites continua calculando o custo pela tabela da plataforma.
Cuidado com foto
Se o seu agent atende no WhatsApp, é quase certo que ele recebe fotos: um documento, um print, a foto do produto. Um modelo marcado como “não lê imagens” simplesmente ignora a foto — o cliente manda, o agent responde como se nada tivesse chegado, e ninguém avisa.
A plataforma não impede a escolha, porque um agent que só trabalha com texto é um caso legítimo. Mas se o agent fala com cliente pelo WhatsApp, escolha um modelo que aceita foto.
Chave própria do OpenRouter (opcional)
Por padrão, a inferência é paga pela plataforma. Se você preferir pagar direto, cole a sua chave do OpenRouter no campo “Chave do OpenRouter”.
A partir daí, as conversas daquele escopo são cobradas na sua conta do OpenRouter.
Três coisas importam:
- A chave nunca volta. Depois de salva, a tela mostra só os quatro últimos caracteres. Para trocar, cole a nova por cima.
- Sem crédito, o agent para. Se a chave estiver errada ou a conta sem saldo, o OpenRouter recusa e o agent deixa de responder.
- “Remover chave” é o primeiro socorro. Ele não apaga nada importante: o agent volta na hora a usar a chave da plataforma.
Se as respostas pararem logo depois de você cadastrar uma chave, remova a chave. O agent volta a usar a da plataforma e você investiga o saldo com calma.
O que acontece quando o modelo escolhido falha
Se o provedor recusar o modelo que você escolheu (fora do ar, sobrecarregado, sem crédito naquele modelo), o turno cai automaticamente para o modelo da plataforma em vez de morrer. A conversa continua; a resposta pode sair com um jeito um pouco diferente.
Isso vale para o modelo. Não vale para a chave: se a chave é que está errada, a tentativa seguinte usa a mesma chave errada.
Trocar de modelo
A troca vale para as próximas mensagens, em até 15 segundos. Nada do que já foi conversado muda, e o histórico continua o mesmo.
Trocar não exige parar o agent nem avisar ninguém. Se o resultado piorar, volte o campo ao anterior — ou apague o conteúdo dele, que é o mesmo que dizer “use o que a empresa usa”.
Quando algo não bate
- O agent parou de responder logo depois da troca: o modelo pode estar recusando a conta. Volte o campo ao anterior, ou remova a chave própria.
- O agent parou de “ver” fotos: o modelo escolhido não lê imagens. Troque por um com o selo aceita foto.
- O agent parece esquecer o começo da conversa: o modelo tem janela menor que o anterior. Escolha um com janela maior.
- “Modelo desconhecido” ao salvar: o id foi digitado errado. Escolha pela lista em vez de digitar.
Mais em Quando algo dá errado e Uso e limites.