Seu Primeiro Agente

Uma visão geral do agente: onde ele fica, o que cada aba faz e como salvar, testar e publicar uma alteração.

O que é

O agente é o robô de IA que conversa com os seus clientes. Ele fica dentro de um projeto, e um projeto pode ter mais de um agente.

Quando você cria um projeto, a plataforma já monta o primeiro agente junto com você (veja Projetos). Este guia mostra onde ele fica, o que tem em cada aba e como uma alteração chega até os clientes. O detalhe de cada aba está na seção Configurando o Agente.


1. Quando usar

  • Logo depois de criar o projeto, para conhecer a tela do agente antes de mexer;
  • Quando você vai fazer a primeira alteração e quer entender o caminho até ela valer para os clientes.

2. Onde encontrar

  1. Entre no projeto.
  2. No menu lateral, clique em Robôs Agentes de IA.
    • No celular, abra o menu pelo ícone ☰ no topo da tela.
  3. Na Listagem de Chatbots, clique no agente.

A tela abre na aba Personalidade.


3. As abas do agente

AbaPara que serve
PersonalidadeNome, primeira mensagem, jeito de falar, objetivo, tarefas e o que o agente não deve fazer. É por onde se começa. Veja o guia Personalidade.
FluxosSe o agente responde livremente ou segue um roteiro com etapas, e como ele reage a mensagens diretas e de grupo.
VisualA aparência do chat no site: foto, cores, fonte e idiomas.
UtilidadesAjustes do dia a dia, como o tempo de espera antes de responder, a mensagem de reativação, as avaliações e a transcrição de áudio.
VersõesO histórico das versões publicadas. Dá para comparar versões e restaurar uma anterior.
EventosGatilhos, como o início ou o fim de uma conversa, que disparam fluxos ou webhooks automaticamente.
CanaisOnde o agente é publicado, como o seu site ou o WhatsApp. Os guias estão em Publicação.

Ao lado das abas fica o botão Testar, que abre uma conversa com o agente.


4. Como uma alteração chega aos clientes

┌──────────┐      ┌──────────┐      ┌──────────────────┐
│  Salvar  │ ───▶ │  Testar  │ ───▶ │  Publicar versão │
│ rascunho │      │ rascunho │      │   clientes veem  │
└──────────┘      └──────────┘      └──────────────────┘
  1. Salvar: guarda o que você mudou como rascunho;
  2. Testar: na janela de teste, escolha Rascunho para conversar com a versão que você acabou de salvar;
  3. Publicar versão: coloca o rascunho no ar. Dê um nome e uma descrição para a versão, para encontrar depois em Versões.

Enquanto houver algo salvo e não publicado, a tela mostra o aviso “Existem alterações não publicadas!”.

📌 Primeira publicação: enquanto o agente não tiver nenhuma versão publicada, os canais atendem com o rascunho atual. Depois que você publica a primeira versão, os clientes só veem o que foi publicado.

💡 Dica: teste sempre antes de publicar. Se uma versão publicada não ficou boa, você pode voltar para a anterior pela aba Versões.


5. Configurando cada aba

Agora que você conhece a tela, siga para o guia de cada aba. Comece pela Personalidade, que é a que mais influencia as respostas do agente.

  • Personalidade

    Como definir o nome, a primeira mensagem, o jeito de falar, o objetivo, as tarefas e as restrições do agente, com exemplos de cada campo.

  • Fluxos

    Como escolher entre resposta livre e roteiro guiado, como o agente reage a mensagens diretas e de grupo e como ele retoma conversas paradas.

  • Visual

    Como mudar a foto, as cores, a fonte, os idiomas e as mensagens do chat do agente no site.

  • Utilidades

    Ajustes do dia a dia do agente: avaliações, áudio, anexos, verificação de e-mail, tempo de espera, limite de mensagens e dados pedidos antes da conversa.

  • Versões

    Como acompanhar o rascunho, ver as versões publicadas, comparar o que mudou e voltar para uma versão anterior.

  • Eventos

    Como disparar um fluxo ou enviar os dados da conversa para outro sistema quando uma conversa começa ou termina.


6. Perguntas frequentes

Salvei e o agente não mudou para os clientes. Por quê?

Se o agente já tem uma versão publicada, salvar guarda só o rascunho. A alteração entra no ar depois que você clica em Publicar versão.

Como testo antes de publicar?

Clique em Testar e escolha Rascunho na janela de teste. Para conferir o que os clientes estão vendo agora, escolha Publicado.

Posso ter mais de um agente no mesmo projeto?

Sim. Todos aparecem na Listagem de Chatbots, em Robôs Agentes de IA, e cada um tem as suas próprias abas.

Como coloco o agente no meu site?

Pela aba Canais. O passo a passo de cada forma de publicar está na seção Publicação.