Criar um agente

O agente é criado num assistente de 7 passos. Os 4 primeiros são obrigatórios: Identidade, Modelo de IA, Comportamento e Atendimento. Os outros 3 são opcionais e você pode preencher depois: Transferência, Ações no CRM e Conhecimento.

#Antes de começar

• Um token de IA ativo. Veja Provedores e modelos.
• Para o agente atender sozinho: pelo menos uma conta conectada em Conexões › Integrações, na aba Canais.
• A quantidade de agentes depende do seu plano. Veja os planos.

#Criar o agente

#Passo 1: Identidade

#Passo 2: Modelo de IA

Escolha o Token de IA e depois o Modelo. Só aparecem os tokens ativos.

Em Ajustes avançados ficam dois controles:

• Criatividade: de 0 a 1. Perto de 0, o agente segue as instruções mais ao pé da letra. O padrão é 0,7.
• Máx. tokens: o tamanho máximo de cada resposta, de 50 a 4.000. O padrão é 500, o que dá respostas curtas. Aumente só se as respostas chegarem cortadas.

#Passo 3: Comportamento

Aqui você escreve as instruções, também chamadas de prompt. É o passo que mais pesa no resultado.

O campo principal é Instruções base (system prompt). Você pode escrever tudo nele. Os campos de Prompts do agente são opcionais e servem para organizar o texto por assunto:

Para salvar, preencha pelo menos as Instruções base ou a Persona.

#Variáveis

O botão Variáveis insere dados do contato, como {{name}} (primeiro nome) e os seus campos personalizados. A variável é trocada pelo dado do contato quando aparece na resposta do agente. Um uso comum é o link com o telefone: https://exemplo.com/cadastro?tel={{phone}}.

#Variações de abordagem

Variações são textos alternativos de abertura ou de tom. Você pode criar até 20, cada uma com um nome (até 80 caracteres) e um texto (até 1.500). O agente alterna entre elas de uma conversa para outra, para não repetir sempre a mesma abertura.

Para encaixar uma variação num ponto exato das instruções, escreva [[VAR:nome]] com o nome da variação.

#Quando o texto colado é cortado

Se você colar um texto maior que o limite do campo, o Leadz corta o que sobrou e avisa: «O texto colado não coube inteiro: ficaram de fora os últimos X de Y caracteres.» O que ficou de fora não é salvo. Resuma o texto ou divida entre os campos.

#Passo 4: Atendimento

#Quando a IA responde

No modo Personalizado, marque os dias da semana e informe Início e Fim. Para ter mais de uma janela no mesmo dia (manhã e tarde, por exemplo), marque Múltiplos horários por dia e use Adicionar horário. Os horários seguem o horário de Brasília.

#Contas de atendimento

Nos modos Sempre (24/7) e Personalizado, marque em quais contas o agente atende: os números de WhatsApp, as contas de Instagram e Messenger e o Chatbot do site. É obrigatório marcar pelo menos uma.

#Tempo de resposta

O agente espera um tempo sorteado entre o Mínimo e o Máximo, em segundos, antes de responder. Cada valor vai de 0 a 600. As mensagens que o contato enviar nesse intervalo são respondidas juntas, numa resposta só. Com 0 e 0, o agente responde na hora.

#Tempo sem resposta do lead

Depois que o agente responde, ele espera o contato. Se o contato não escrever dentro do tempo definido em Tempo sem resposta (minutos), o atendimento do agente é encerrado. O valor vai de 1 a 10.080 minutos (7 dias). Para agir nesse momento, crie um funil com o gatilho Agente IA encerrou atendimento.

#Períodos de ausência

Use em recesso ou feriado. Durante o período, o agente atende sozinho mesmo fora do horário e avisa o contato que a equipe não está disponível. Informe Início, Fim e, se quiser, um Aviso ao lead de até 500 caracteres. Você pode cadastrar até 20 períodos.

#Passo 5: Transferência

Define quando o agente para e passa a conversa para a equipe.

Mesmo com as três opções desligadas, o agente pede um humano quando o contato reclama a sério ou pede algo que ele não pode resolver.

Outros campos do passo:

• Palavras-chave de transferência: separadas por vírgula, até 400 caracteres. Se ficar vazio, valem «humano, atendente, pessoa, falar com alguém».
• Mensagem ao transferir: o texto enviado no pedido explícito e fora do horário. Até 500 caracteres.
• Quando um humano responder a conversa, a IA fica calada por: o tempo de pausa, em minutos ou horas. Com 0, o agente não pausa. Vazio, a pausa é de 12 horas. O máximo é 30 dias.

#O que acontece na transferência

1. O agente envia a mensagem de transferência ao contato.
2. O atendimento do agente é encerrado naquela conversa.
3. O agente fica calado nessa conversa pelo tempo de pausa, para não atropelar a equipe.
4. O gatilho Agente IA encerrou atendimento dispara os funis que usam esse gatilho.

#Passo 6: Ações no CRM

Libera o que o agente pode alterar além de conversar: campos, tags, etapa do card, tarefas e eventos. Veja Ações no CRM.

#Passo 7: Conhecimento

Marca quais materiais este agente pode consultar e enviar. Veja Materiais e base de conhecimento.

#Depois de criar

O agente aparece como um cartão na aba Agentes.

• O interruptor do cartão pausa e ativa o agente.
• Editar reabre o assistente.
• Testar abre a conversa simulada. Veja Testar o agente.

O selo do cartão mostra o estado do agente:

#Como funciona

• Resposta em várias mensagens. O agente decide se responde numa mensagem só ou em várias mensagens curtas e seguidas, até 10 por resposta. Botões e link vão sempre na última. Para mudar esse comportamento, escreva nas instruções: «responda sempre em uma mensagem só» ou «divida a resposta em mensagens curtas».
• Memória. A cada resposta, o agente lê as últimas 40 mensagens da conversa e a ficha do contato.
• Mensagens em sequência. Se o contato manda várias mensagens antes da resposta, o agente lê todas e responde uma vez.

#Problemas comuns

O botão de salvar leva para outro passo e mostra um aviso

Falta um campo obrigatório. O aviso diz qual: «Dê um nome ao agente.», «Escolha o token de IA.», «Escreva as instruções base ou a persona do agente.», «Escolha quando a IA responde.», «Informe o tempo de resposta (mínimo e máximo).», «Informe o tempo sem resposta do lead.» ou «Selecione pelo menos uma conta de atendimento (WhatsApp, Instagram, etc.).».

«Nenhum provedor com token ativo.»

Não há token de IA ativo no workspace. Adicione ou ative um token na aba Tokens de IA.

O agente está ativo, mas não responde no Chat

Confira, nesta ordem: o modo não pode ser Quando um fluxo chamar; a conta da conversa precisa estar marcada em Contas de atendimento; ninguém da equipe pode ter respondido a conversa dentro do tempo de pausa; o contato não pode estar num funil em andamento. A lista completa está em Visão geral.

As respostas chegam cortadas no meio

O limite de Máx. tokens está baixo para o tamanho da resposta. Aumente o valor em Ajustes avançados, no passo Modelo de IA, ou peça respostas mais curtas nas instruções.

#Veja também

• Ações no CRM
• Boas práticas de prompt
• Testar o agente