Criar um agente de IA é o passo mais transformador que você dá no Syncro — passa de "atendimento manual" pra "atendimento automatizado 24/7". O wizard de criação tem 5 passos que cobrem desde a identidade visual (avatar, nome) até follow-up automático e tools avançadas. Esse artigo mostra cada passo em detalhe.
Pré-requisitos
-Permissão de admin ou manager. -Plano com slot de agente IA disponível (Trial=0, Starter=1, Growth = 5, Scale = 999). -Para WhatsApp: pelo menos uma instância conectada. -Para Instagram: conta Business conectada.
Acessar o wizard
1.Acesse IA → Agentes no menu lateral (rota /ia/agentes).
2.Veja a lista de agentes existentes (se houver).
3.Clique em Criar Agente no canto superior direito.
4.O wizard de 5 passos abre em fullpage.
Passo 1 — Identidade e Avatar
Define a aparência do agente.
Avatar
-Escolha um avatar da galeria pré-definida (gerada por IA). -Ou faça upload de imagem própria (PNG/JPG até 2MB). -O avatar aparece nas mensagens como ícone do agente no chat.
Nome do agente (obrigatório)
-Ex: Camila, Victor, Bot de Vendas, Assistente Suporte. -Use placeholder como exemplo: "Ex: Ana, Victor, Bot de Vendas". -Esse nome aparece pro cliente nas mensagens.
Empresa
-Nome da sua empresa (ex: Loja do João). -Usado no system prompt do agente pra ele saber em nome de quem responde.
Idioma
-Português (Brasil) (default) -Inglês -Espanhol
Define o idioma das respostas do agente.
Passo 2 — Objetivo e Personalidade
Define o "para que serve" e o "como fala".
Objetivo (3 cards)
-Vendas — "Captura leads e conduz negociações". Pra fluxos comerciais (qualificação, proposta, fechamento). -Suporte — "Resolve dúvidas e problemas". Pra atendimento técnico, FAQ, troubleshooting. -Geral — "Atendimento sem foco específico". Pra atendimento genérico ou misto.
Estilo de comunicação (3 cards)
-Formal — "Profissional e estruturado". "Prezada Maria, tudo bem?...". -Normal — "Natural e cordial" (default). "Oi Maria! Tudo certo?...". -Informal — "Descontraído e amigável". "Eaê Maria, beleza?...".
Indústria
-Campo livre pra contextualizar (ex: Imobiliária, Saúde, E-commerce, Educação). -Ajuda o agente a usar vocabulário da área.
Personalidade (descrição)
-Texto livre descrevendo a "persona" do agente. -Exemplo: "Você é Ana, uma assistente virtual da Loja do João. É proativa, atenciosa e adora ajudar clientes a encontrar o produto perfeito." -Use isso pra dar alma ao agente — quanto melhor a descrição, mais coerente as respostas.
Comportamento esperado
-Regras específicas que o agente deve seguir. -Exemplo: "Sempre cumprimente pelo nome. Nunca prometa prazos sem antes confirmar com o atendente humano. Se o cliente pedir desconto acima de 10%, transfira pra humano." -Coloca limites operacionais.
Passo 3 — Canal e Atribuição
Onde o agente vai atender.
Canal
-WhatsApp — atende DMs do WhatsApp. -Instagram — atende DMs do Instagram. -Web Chat — atende widget do site.
Instâncias de WhatsApp
Se canal = WhatsApp, aparecem checkboxes das instâncias conectadas. Marque quais números esse agente atende:
-Pode marcar uma ou várias (mesmo agente em múltiplos números). -Pode marcar nenhuma se quer só responder via auto-atribuição de departamento.
Toggles
-Agente ativo — "Quando ativado, o agente responderá automaticamente". Liga/desliga o agente sem deletar. -Auto-atribuir para humano — transfere automaticamente após X mensagens sem resolver.
Passo 4 — Conhecimento e Ferramentas
Onde a magia acontece.
Base de Conhecimento
Textarea com placeholder enorme contendo exemplos. Aqui você descreve:
-Empresa: nome, missão, valores. -Produtos / serviços: lista com preços, características, diferenciais. -Políticas: troca, devolução, formas de pagamento, prazos. -FAQs: perguntas comuns + respostas. -Limites operacionais: o que o agente PODE e NÃO PODE fazer.
Dica: você pode também subir arquivos (PDF, Word, TXT, imagens) que viram parte da base de conhecimento via RAG. Veja Base de conhecimento (RAG).
Etapas da Conversa
Liste etapas que o agente deve seguir:
1.Apresentação — "Cumprimentar e identificar o cliente" 2.Qualificação — "Entender necessidade e perfil" 3.Apresentação de solução — "Sugerir produto/serviço adequado" 4.Fechamento — "Confirmar interesse e agendar próximos passos"
Cada etapa tem nome + descrição (placeholder "Ex: Apresentação" e "Descrição...").
Permite o agente se orientar sobre em que momento da conversa está.
Ferramentas (5 toggles)
Habilite as tools que o agente pode executar:
-Mover leads entre etapas — agente avança lead no funil quando qualifica. -Adicionar tags — agente categoriza leads automaticamente. -Notificar intenção de compra — alerta equipe quando detecta interesse alto. -Agendar reuniões — cria evento no Google Calendar. -Catálogo de produtos — agente consulta e sugere produtos.
Veja Tools do agente pra detalhes técnicos.
Passo 5 — Follow-up e Avançado
Follow-up automático
Mensagens automáticas se o cliente para de responder.
-Follow-up automático (toggle) — ativar/desativar. -Atraso (minutos): tempo entre last msg do cliente e disparo do follow-up. Min 5, max 1440 (24h). Default 40. -Máximo de tentativas: quantos follow-ups consecutivos. Min 1, max 10. Default 3. -Começar em (hora): hora mínima do dia pra disparar follow-up. Default 8h. -Encerrar em (hora): hora máxima. Default 18h.
Veja Follow-up smart/template/off pras estratégias.
Configurações avançadas
-Máximo de caracteres por mensagem: tamanho da resposta. Min 50, max 4000. Default 500. Mensagens longas são quebradas em múltiplas bolhas WhatsApp. -Atraso de resposta (segundos): tempo entre cliente terminar de digitar e agente responder. Default 2. Simula tempo humano. -Tempo máx. para digitar (segundos): quanto tempo o agente "espera" o cliente terminar antes de processar. Default 0.
Finalizar
1.Após o último passo, clique em Criar Agente.
2.Sistema:
-Salva o AiAgent no banco.
-Sincroniza com Agno (microserviço Python) via POST /agents/{id}/configure.
-Cria embeddings da base de conhecimento (chunks via ).
3.Aparece Agente criado! e você é redirecionado pra lista.
4.O agente aparece como card na página principal.
Editar agente (sem wizard)
Após criado, edição não usa wizard — vai pro form completo:
1.Clique no agente na lista.
2.Acessa /ia/agentes/{id}/editar.
3.Form único com todas as seções (não dividido em passos).
4.Edite e salve.
5.Sincronização com Agno automática.
Testar o agente
Antes de ativar pra clientes reais, teste o agente:
1.Na página de edição, há chat de teste lateral. 2.Digite mensagens como cliente. 3.O agente responde usando configuração atual (mesmo que ainda não salva). 4.Ajuste a base de conhecimento, persona, tools até ficar bom. 5.Só depois ative em clientes reais.
Ativar em conversas
Após criar e testar, vincule o agente a conversas:
Forma 1 — Departamento padrão
1.Em Configurações → Departamentos, edite um departamento. 2.Em Agente IA Padrão, selecione esse agente. 3.Conversas que entram nesse departamento ganham o agente automaticamente.
Forma 2 — Atribuição manual
1.Em uma conversa do /chats, painel lateral.
2.Em Agente IA, selecione o agente.
3.IA passa a responder.
Forma 3 — Auto-atribuição da instância
Algumas configurações de instância WhatsApp permitem agente padrão. Veja Gerenciar múltiplos números.
Limites de plano
| Plano | Max agentes IA |
|---|---|
| Trial | 0 |
| Starter | 1 |
| Growth | 5 |
| Scale | 999 |
Acima do limite: erro "Limite atingido". Faça upgrade.
Próximos passos
-Pra subir arquivos de conhecimento, veja Base de conhecimento. -Pra entender as ações que o agente pode executar, veja Tools. -Pra configurar voz, veja Voz com ElevenLabs.
Artigos relacionados
-Base de conhecimento (RAG) -Tools do agente -Follow-up smart/template/off -Quota mensal de tokens