Agentes de IA: criar, ensinar e usar nos fluxos

#Antes de começar

• O item Agentes aparece para quem tem acesso a Automações.
• O agente usa a chave de IA do projeto, de OpenAI, Gemini ou OpenRouter, cadastrada em Configurações > IA. Sem ela, o agente não responde e a tela avisa Falta a chave de IA. A chave da Anthropic não serve para os agentes. Veja IA nos fluxos.
• O consumo de IA é cobrado pelo provedor, na sua conta lá.

#Criar um agente

1. 1

   Comece de um modelo

   Em Agentes, clique em Novo agente (ou Criar meu primeiro agente). Escolha:

   • Suporte: tira as dúvidas dos clientes com base na sua base de conhecimento.
   • Qualificar lead: conversa com quem chegou, entende o que a pessoa precisa e anota no contato.
   • Agendar: ajuda a pessoa a marcar um horário e manda o link de agendamento.
   • Em branco: você escreve tudo.
2. 2

   Dê um nome

   Escreva o Nome do agente e clique em Criar agente. O editor abre.

3. 3

   Ajuste as abas

   Passe pelas abas do editor (detalhes abaixo). Ao mexer, aparece a barra Alterações não salvas: clique em Salvar. As mudanças valem na hora para todos os fluxos que usam o agente.

4. 4

   Ligue o agente

   Use o interruptor Ligado / Desligado no topo do editor. Agente desligado não responde.

#As abas do editor

#Instruções

• Nome e Papel do agente.
• Instruções: quem ele é, o que faz, o tom e quando passar para uma pessoa. Até 20.000 caracteres.
• Modelo de IA: Provedor (OpenAI, Gemini ou OpenRouter) e Modelo.
• Áudio e imagem: ligue Ouvir áudios e Ver imagens para o agente entender o que o contato manda além de texto.
• Ajuste fino: Criatividade (de 0 a 1,5, padrão 0,7) e Tamanho máximo da resposta.

#Base de conhecimento

É o que o agente consulta para responder: seu site, seus PDFs, suas perguntas frequentes. Clique em Adicionar fonte:

As fontes valem para o projeto todo. Em cada agente, ligue as que ele usa. Cada fonte mostra o status (Pronta, Sincronizando, Na fila, Erro) e tem Sincronizar agora, Ver o que entrou e Remover fonte. Use Perguntar à base para testar uma busca.

#Contexto: o que o agente lê antes de responder

• Mensagens anteriores da conversa: Nenhuma, 10, 20 (o padrão), 50 ou 100. Ligue Ler as mídias dessas mensagens para ele considerar também os áudios e vídeos (transcritos), as imagens (descritas) e um trecho de cada documento.
• Ficha do lead: nome, tags, etapa do Kanban, campos preenchidos, negócios, notas recentes e responsável (ligado por padrão).
• Mensagens de todas as linhas: se o contato fala com mais de um número do projeto, o agente lê todas e sabe por qual linha veio cada mensagem (ligado por padrão). Desligado, lê só a linha desta conversa.

#Ações

Em O que o agente pode fazer no OrbynFlow, ligue o que ele pode fazer sozinho (por exemplo, adicionar tag, mover no Kanban, atribuir atendente). Em Integrações com outros sistemas, cadastre ações que chamam um webhook seu, com Nome da ação, Endereço (webhook), Quando usar e Parâmetros (JSON Schema).

#Limites e transferência

• Passar para uma pessoa: ligue Quando não souber responder e Quando o contato pedir uma pessoa, escreva a Mensagem de transferência e escolha Quem assume.
• Horário de atendimento: fora dele, o agente manda a Mensagem fora do horário (no máximo uma vez a cada 12 horas). O Fuso horário padrão é o do projeto.
• Limite de respostas: o máximo de respostas ao mesmo contato em 24 horas.

#Testar

Converse com o agente sem enviar nada a ninguém. Escreva em Mensagem do cliente e veja a resposta. Nova conversa recomeça. O teste usa as alterações ainda não salvas. Em Com um contato de verdade, clique em Escolher um contato para testar com a ficha e a conversa de um lead real (nada é enviado a ele). O teste gasta a chave de IA do projeto.

#Desempenho

Escolha 7, 30 ou 90 dias e veja Respostas, Conversas, Passou para uma pessoa e Erros, com o gráfico Por dia. As conversas do teste não contam. Embaixo, Perguntas sem resposta lista o que o agente não soube responder: complete a base de conhecimento e use Marcar como resolvida.

#Usar o agente num fluxo

1. 1

   Adicione o bloco

   No editor do fluxo, em modo Editar, adicione Agente AI (aba Ações da barra de blocos).

2. 2

   Escolha o agente

   No painel, em De onde vem a configuração, escolha Usar um agente e selecione o agente em Escolha um agente. A outra opção, Configurar aqui, monta a IA só naquele bloco.

3. 3

   Ajuste e salve

   Em Juntar mensagens, defina quantos segundos (até 60) o bloco espera sem mensagem nova antes de responder, para juntar mensagens seguidas do contato. Salve o fluxo.

O mesmo agente pode estar em vários fluxos. A lista de agentes mostra em quais fluxos cada um é usado.

#Responder quem menciona a linha no grupo

Num grupo de WhatsApp (linha QR), o agente pode responder quem marca a linha:

1. Crie um fluxo com o gatilho Mensagem em Grupo e, em Tipo de Correspondência, escolha Quando mencionarem a linha.
2. Ligue a saída ao bloco Agente AI com o agente escolhido.
3. Cada menção (ou resposta a uma mensagem da linha) recebe uma resposta que cita a pergunta e marca quem perguntou.

Use o cooldown Por pessoa para a mesma pessoa não receber respostas demais. Veja Todos os gatilhos.

#Se algo der errado

#Perguntas frequentes