Manual do painel · AUTOMAÇÕES

Agentes de IA: criar agentes por tipo, organizar em pastas e mover pela lista

Agentes de IA serve para ter vários agentes na mesma conta, cada um com o tipo, as instruções e o canal dele, e organizar a lista em pastas.

Quando aparece: Aparece quando os Agentes de IA são liberados para a conta; até lá, a conta segue com a persona de sempre.

Quem pode usar

PapelO que vê e faz
DonoVê a lista, cria agentes e organiza as pastas.
AdminVê a lista, cria agentes e organiza as pastas, como o dono.
AtendenteVê a lista dos agentes e das pastas, sem criar nem mover.

Telas

Agentes de IA

A tela Agentes de IA serve para ver todos os agentes da conta, criar um novo e organizar a lista em pastas.

Endereço no painel: /app/automacoes/agentes

Como chegar: Pelo menu Agentes de IA › Seus agentes.

Cabeçalho

Botões e ações

Nova pasta
Abre o diálogo para criar uma pasta, com nome de até 40 letras que ainda não exista.
Criar agente
Abre o diálogo Criar agente. O agente nasce como rascunho.

Busca, ordem e pastas

Campos e filtros

Buscar agente
Filtra a lista pelo nome; dentro de uma pasta, busca só nela.
Ordenar
Nome (A a Z), Mais conversas ou Situação.

Botões e ações

Abrir a pasta ‹pasta›
Mostra só os agentes da pasta.
Mais ações da pasta ‹pasta›
Abrir, Renomear ou Excluir a pasta.
Todas as pastas
Volta para a lista de todos os agentes.
Renomear
Troca o nome da pasta no lugar; Enter salva e Esc cancela.
Excluir a pasta
Pede confirmação; os agentes da pasta voltam para Sem pasta.
  • Sem pasta reúne os agentes que não estão em nenhuma pasta.
  • Dentro de uma pasta, Solte aqui para tirar da pasta deixa o agente sem pasta.

Cartão do agente

Botões e ações

Mais ações de ‹agente›
Abre Mover para…, para trocar a pasta pelo teclado.
Mover
Leva o agente para a pasta escolhida.
  • Os canais que o agente atende, ou Só em fluxos.
  • O tipo, a situação (Atendendo, Pausado ou Rascunho), a IA que responde e as conversas dos últimos 7 dias.
  • O cartão pode ser arrastado até uma pasta.

Estados da tela

Carregando
Os cartões aparecem em cinza enquanto a lista carrega.
Sem nada ainda
Nenhum agente ainda, com o botão Criar o primeiro agente.
Se der erro
As instruções dos agentes estão salvas. Tente de novo em instantes.
A conta chega a 45 agentes
Pedir mais, para pedir o aumento do teto de proteção pelo suporte.
A conta chega a 50 agentes
Chegou ao teto de proteção de 50 agentes, com o caminho para pedir mais.

Passo a passo

Como criar um agente de IA

  1. Clique em Criar agente.
  2. Dê o nome do agente e escolha o tipo.
  3. Escolha de onde começar, o canal e a pasta.
  4. Clique em Criar agente. Ele nasce como rascunho e só atende depois de publicado.

Como mover um agente para outra pasta

  1. Arraste o cartão até a pasta, ou clique em Mais ações do cartão.
  2. Escolha a pasta em Mover para… e clique em Mover.

Perguntas frequentes

Existe limite de agentes?

Não há limite por plano nem cobrança por agente. Há só um teto de proteção de 50 por conta, que o suporte aumenta sem custo.

Excluir uma pasta apaga os agentes?

Não. Os agentes voltam para Sem pasta e continuam atendendo como antes.

Guia da Central de ajuda

Agentes de IA

Crie quantos agentes precisar, cada um com o tipo, as instruções e o canal dele, e organize a lista em pastas.

Cada agente tem as instruções, o conhecimento, as ferramentas e o modelo dele, e atende um canal ou entra num fluxo. Antes a conta tinha uma persona só; agora são quantos agentes você precisar.

Criar um agente

  1. Abra o diálogo: Clique em Criar agente, no alto da tela.
  2. Dê um nome: O nome do agente aparece só para a sua equipe. O lead vê o nome da IA, que você define no editor.
  3. Escolha o tipo: O tipo liga os agentes da plataforma certos para o trabalho. Dá para ajustar depois.
  4. Escolha de onde começar: Do modelo do seu segmento, em branco ou de uma cópia do agente principal.
  5. Diga onde ele atende e em qual pasta fica: O canal só passa para o agente quando você publicar. Até lá, o canal continua com quem já atende.
Vendas (SDR)
Qualifica, dá a faixa quente, morna ou fria, negocia e transfere quando o lead quer comprar.
Suporte
Responde pela Base de conhecimento, abre e atualiza Ticket e transfere por frustração ou pedido de pessoa.
Pós-venda / CS
Confirma a entrega, faz a pesquisa de satisfação, cuida da retenção e pede indicação.
Cobrança
Lembra o vencimento, manda a 2ª via e negocia dentro dos limites que você definiu.
Agendamento
Agenda, confirma na véspera e remarca quando o lead pede.
Recepção (triagem)
Atende o número geral, entende o assunto e passa para o agente certo.
Personalizado
Você escolhe quais agentes da plataforma entram.

Organizar em pastas

As pastas só organizam a lista: não mudam o que os agentes fazem. Clique em Nova pasta, dê um nome de até 40 letras que ainda não exista e confirme.

  • Para mover, arraste o cartão do agente até a pasta, ou use o menu ⋮ do cartão e escolha a pasta em Mover para…. O menu funciona pelo teclado.
  • Dentro de uma pasta, solte o cartão em Solte aqui para tirar da pasta para deixá-lo sem pasta.
  • Para renomear, use Renomear no menu ⋮ da pasta ou dentro dela. Enter salva e Esc cancela.
  • A busca e a ordem valem para a pasta aberta.

Editar um agente

Clique no nome do agente para abrir o editor. Na coluna da esquerda ficam a identidade, onde ele atende, o comportamento e o tipo; à direita, as abas Treinamento, Sub-agentes, Follow-up, Conhecimento, Ferramentas, Teste e Uso.

Nome que o lead vê
O nome da IA na conversa. Na transferência, o lead passa a ver o nome do atendente, nunca este.
Comportamento
Ritmo de conversa humana, leitura das imagens que o lead envia, horário de atendimento e silêncio quando a equipe responde. A regra de mostrar o nome do atendente na transferência fica sempre ligada.
Este agente usa
A prévia do tipo: os agentes da plataforma que entram nas conversas deste agente. O que você mudar aparece como ajustado, e Voltar ao padrão do tipo desfaz.
Conhecimento
Todas as fontes da Base de conhecimento ou só as escolhidas, e a Memória da empresa.
Ferramentas
Cada ferramenta ligada é uma permissão: Agenda, ações que consultam o seu sistema, transferir para a equipe, CRM e formulários.

Variáveis nas instruções

Use as fichas acima das instruções para inserir uma variável no ponto do cursor. Em cada conversa, ela é trocada pelo dado do lead. A prévia Como o agente lê mostra o texto com valores de exemplo.

`{{nome_lead}}`
O nome do lead.
`{{telefone}}`
O telefone do lead.
`{{empresa}}`
O nome da sua empresa.
`{{etapa}}`
A etapa do lead no Funil.
`{{produto}}`
O produto de interesse.
`{{link_agenda}}`
O link da sua agenda, que você informa na ferramenta Agenda.
`{{nome_ia}}`
O nome que o lead vê.
`{{data_atual}}`
A data de hoje.

Salvar rascunho e publicar

  • Salvar rascunho guarda as mudanças sem mexer no que os leads veem: as conversas continuam com a versão publicada.
  • Quando há mudança guardada que ainda não foi publicada, o editor mostra Alterações não publicadas.
  • Publicar passa a usar a versão nova nas conversas novas. Um rascunho começa a atender na primeira publicação.

Onde o agente atende

Cada canal ou número tem um agente só. Sem canal, o agente entra apenas pelos fluxos. Marcar um canal que hoje é de outro agente mostra um aviso, e a troca só vale na publicação.

Como a conversa chega ao agente certo

  • Por canal ou número (o padrão): cada canal tem um agente. Canal sem agente fica com o agente principal.
  • Por triagem no mesmo número: um agente do tipo Recepção atende o número geral, entende o assunto e passa ao agente certo.
  • Por fluxo: o nó Agente de IA chama um agente num ponto do fluxo; Vincular agente fixa o agente na conversa.

A lista Seus agentes mostra, no bloco Como a conversa chega ao agente certo, o agente de cada canal e os primeiros assuntos da Recepção.

Recepção: a triagem

  1. Crie um agente do tipo Recepção: Ponha nele o número geral, em Onde atende.
  2. Escolha para quem cada assunto vai: Em Para quem a Recepção passa, cada assunto tem o agente que o atende. A Recepção já vem com os assuntos mais comuns, cada um no agente do tipo certo.
  3. Escolha o nome que o lead vê: O mesmo nome do começo ao fim ou O nome do agente que assumiu.
  4. Publique: A partir da próxima conversa, a Recepção faz a triagem e a conversa fica com o agente escolhido até acabar.

Passagem para outro agente

Quando o assunto muda no meio da conversa, o agente pode passar para outro. No editor, em Passagem para outro agente, marque em Pode passar para os agentes que podem assumir e escolha o que O lead vê: o mesmo nome (ele não percebe a troca) ou o nome do novo agente.

  • O contexto vai junto: o novo agente lê o histórico e os dados já coletados.
  • Na dúvida, a conversa fica com o agente de agora.
  • No Inbox, o cabeçalho da conversa mostra o agente que atende e muda na hora da troca. A equipe vê a nota Passou para…; o lead não vê nota nenhuma.
  • Na aba Teste, a passagem aparece na conversa de teste e em Por que respondeu assim?.

Duplicar e pausar

  • No menu ⋮ do cartão, Duplicar cria uma cópia como rascunho, sem canal até você escolher um.
  • Pausar tira o agente do atendimento: as conversas dos canais dele passam para o agente principal até você clicar em Ligar.
  • O agente principal não pode ser pausado: ele atende o que nenhum outro atende.

Sub-agentes

Um sub-agente faz uma tarefa só, dentro do agente: identificar ações na mensagem, classificar o assunto, guardar um dado. Na aba Sub-agentes, clique em Adicionar sub-agente e preencha o nome, quando ele roda (toda mensagem ou só quando algo acontece), as instruções próprias e as ações permitidas.

  • Ele só faz o que estiver marcado: marcar etiqueta, mover de etapa no Funil, chamar webhook de saída, chamar uma Ação "Consultar na hora", salvar variável e transferir para a equipe.
  • Na conta que usa a sua própria IA, cada sub-agente pode usar um modelo menor; sem escolher, ele herda o do agente.
  • O interruptor do cartão liga e desliga o sub-agente sem apagar nada.

Follow-up do agente

Na aba Follow-up ficam as mensagens que o agente manda quando o lead para de responder, só nas conversas deste agente. As cadências da conta continuam na tela de Follow-up.

Mensagem fixa
Sai exatamente como você escreveu. Use {{nome_lead}} e {{nome_ia}} para o nome do lead e o da IA.
Gerada pela IA
A IA escreve uma retomada com base no que já foi conversado, seguindo a orientação que você der.
Frequência
Uma vez por lead, toda vez que ele ficar sem responder, ou no máximo uma vez por dia.
Esperar sem resposta
Quantas horas ou dias sem resposta antes de mandar. O envio respeita o horário de atendimento da conta.

Um follow-up novo passa a valer na próxima publicação do agente. Excluir vale na hora: os leads que esperavam por ele não recebem mais. Com o agente pausado, nenhum follow-up dele sai.

Testar antes de publicar

Na aba Teste, escreva como se fosse um lead, ou clique numa das sugestões. O teste usa o rascunho salvo, com o mesmo modelo e as mesmas ferramentas do atendimento, e nada é enviado a leads de verdade. Se houver mudança sem salvar, o editor salva o rascunho antes de testar.

  • Abaixo da última resposta, Por que respondeu assim? mostra a intenção que a IA entendeu, a fonte da Base de conhecimento, a ferramenta usada e o caminho pelos agentes da plataforma.
  • Quando o teste pede uma pessoa, a conversa mostra a transferência e o seu nome entrando na conversa: na transferência, o lead vê o nome do atendente, nunca o nome da IA.
  • Limpar apaga a conversa de teste e começa de novo.

Quanto o agente usa

A aba Uso mostra, em 7, 30 ou 90 dias, as conversas que o agente atendeu, as mensagens da IA, os tokens e as chamadas à IA, as mensagens por dia e quanto cada tarefa consome. O que veio da aba Teste aparece como Teste.

Quantos agentes dá para ter

Não há limite por plano nem cobrança por agente. Existe só um teto de proteção de 50 agentes por conta. A partir de 45, a tela mostra Pedir mais: abra um chamado de suporte pedindo o aumento, sem custo.

O que acontece com o agente principal?
Ele atende o que nenhum outro agente atende. Para tirá-lo, escolha outro principal antes.
Mover um agente de pasta muda alguma conversa?
Não. A pasta é só a organização da lista.