Como renomear um agente, alterar sua chave ou mudar seu modelo
Atualizado em
No SyBox, isso é feito em Definições > IA e automação > Agentes de IA.
- Abra a página do agente.
- Clique no lápis (Editar) ao lado do nome do agente.

- Altere o "Nome", se desejar.
- "API key": deixe em branco para manter a chave atual ou cole uma nova.
- "Modelo": escolha outro modelo na lista.
- "Pensamento": escolha o nível de raciocínio do modelo antes de responder (veja "Como definir o nível de pensamento do agente" abaixo).
- Clique em Salvar. A nova chave ou modelo será validado com o provedor primeiro.
Observação: para agentes Gemini e ChatGPT, uma nova chave inicia com a base de conhecimento vazia. Carregue seu material novamente em seguida.
Perguntas
Quais provedores de IA posso utilizar?
A lista "Tipo" ao cadastrar um "Novo agente de IA" traz as opções: Gemini, ChatGPT, Claude, DeepSeek e OpenRouter (uma chave para múltiplos modelos). É necessário ter sua própria chave de API emitida pelo provedor.
Quem paga pelo consumo da IA?
Você paga diretamente ao seu provedor, através da sua chave de API. O SyBox exibe o volume de tokens consumidos no cartão do agente e na tabela de Uso, mas não apresenta valores monetários.
Criei um agente, mas ele não responde aos clientes. O que pode ser?
Um agente só envia respostas se estiver integrado a uma automação. Vá em Definições > IA e automação > Automações e crie uma automação contendo a ação "Responder com IA" apontada para o seu agente. Verifique se o Estado da automação é "Ligada" e se a chave principal "As automações estão ativas" no topo da página está ligada. Verifique também se:
- a conversa não está marcada com "Parar respostas de IA"
- o contato não está bloqueado, marcado como spam ou arquivado (arquivamentos temporários não impedem o envio)
- ninguém da sua equipe respondeu manualmente a essa conversa (o agente silencia até que ela seja Concluída, até que passem as horas de "Voltar a responder após" ou até que alguém clique em "Passar para a IA" na barra inferior ao nome do cliente).
O agente pode combinar retorno de ligação, prometer descontos ou prazos de entrega?
Não por iniciativa própria. O agente só promete ações em nome da sua equipe se você autorizar isso expressamente nas instruções dele.
Recebo a mensagem "[Provedor] recusou a chave: …"
O provedor rejeitou a chave de API inserida. Confira se você copiou o código completo, se a chave continua ativa e se a sua conta no provedor possui saldo ou plano de faturamento configurado. Depois tente salvar novamente.
Aparece "Esta chave do [provedor] não oferece nenhum dos modelos suportados por este agente."
A chave utilizada não tem permissão para acessar os modelos compatíveis com o SyBox. Revise o plano e os privilégios da sua conta no provedor ou utilize outra chave.
O cartão do agente exibe "Último erro". O que significa?
Trata-se da última falha reportada pelo provedor, como chave expirada ou cota esgotada. Corrija a pendência diretamente no painel do provedor ou clique em Editar para atualizar a chave.
Posso ter agentes separados para números ou canais diferentes?
Sim. Crie um agente para cada finalidade. Depois, crie uma automação para cada um deles usando a condição "Canal" para filtrar os números ou páginas desejados.
Enviar um novo arquivo adiciona o conteúdo ao que já estava salvo?
Não. Cada envio ou colagem de texto substitui completamente a base de conhecimento do agente. Reúna todo o conteúdo daquele agente em um único arquivo ou envio.
O agente falou algo indevido ou respondeu errado. Como consertar?
Atualize os dados na base de conhecimento ou inclua uma instrução corretiva em "Suas instruções". Em seguida, abra a aba "Chat" do agente para testar a nova resposta.
O agente consegue atribuir conversas ou marcar etiquetas?
Sim, através de regras em suas instruções. Mencione os identificadores exibidos logo abaixo de "Suas instruções", como "atribua ao usuário 3" ou "adicione o rótulo 1".
Mais sobre Agentes de IA.