Entender e criar um agente
Saiba o que um agente faz, crie o primeiro, ligue-o a um gatilho e acompanhe as execuções.
- Atualizado em
Recurso opcional
Um agente é uma "pessoa de IA" com um papel definido — qualificar leads, agendar retornos, responder a um evento do CRM. Ele trabalha dentro de um workflow (a sequência de passos) que é disparado por um trigger (o gatilho). Ao final, você tem automações que rodam sozinhas e um histórico de cada execução para auditar.
Antes de começar
- O recurso Agentes precisa estar ativado no seu workspace (o grupo Agentes aparece no menu lateral).
- Permissão para gerenciar agentes, workflows e triggers no seu papel (o Administrador já tem).
- Cerca de 20 minutos para a primeira automação.
Passo a passo
Conheça o hub
No menu lateral, abra Agentes. As seções são Painel (indicadores do dia), Agentes (as personas), Workflows (os fluxos), Execuções (o histórico), Triggers (os gatilhos), Ferramentas (o que os agentes podem acionar) e Templates (fluxos prontos).
Crie o agente
Em Agentes → Agentes, clique em Novo agent. Preencha Nome (por exemplo, "Triagem Inbound"), Papel, escolha o Workspace AI e escreva o System prompt: a persona, o objetivo, as restrições e os critérios de decisão. Deixe Iterações máximas no valor sugerido e Ativo ligado. Clique em Salvar.
Monte o workflow
O caminho mais curto é Templates → Usar template: o fluxo pronto abre no editor com o seu nome. Para começar do zero, use Workflows → Novo workflow. No editor, arraste os passos, ligue o passo de IA ao agente criado e clique em Salvar rascunho. Quando estiver pronto, clique em Publicar — só workflows Publicados rodam.
Defina o gatilho
Em Triggers, clique em Novo trigger. Dê um Nome, escolha o Tipo — Evento interno (por exemplo, Lead criado), Agendado (Todo dia às 8h, Toda segunda às 9h…), Manual ou Webhook — e selecione o Workflow. O trigger nasce Ativo; Desativar pausa o disparo sem apagar nada.
Teste com uma execução manual
Em Workflows, clique em Executar no fluxo publicado. Vá em Execuções: a lista mostra Step atual, Status, Duração e Iniciada em. Os status vão de Pendente e Executando a Concluída, Falhou, Aguardando aprovação ou Aguardando resposta (fluxos que conversam com um contato).
Audite uma execução
Clique numa execução. A aba Técnico traz cada passo, o que o agente recebeu e decidiu e as ferramentas acionadas; a aba Conversa aparece quando o fluxo trocou mensagens com alguém. Uma execução com falha pode ser refeita do início com Reprocessar; uma execução em Aguardando aprovação espera o seu Aprovar ou Rejeitar na própria linha do tempo.
Cada execução consome a cota de IA do workspace
Um agente com Iterações máximas alto ou um trigger Agendado muito frequente multiplica o consumo. Comece com poucas iterações e um gatilho de evento; quando a execução atinge o limite, ela encerra com o status Limite atingido.
Dúvidas comuns
Qual a diferença entre agente e workflow?
O agente é quem decide (a persona de IA); o workflow é o roteiro em que ele atua, com condições, notificações, esperas e outros passos. Um mesmo agente pode participar de vários workflows.
O trigger não dispara quando o evento acontece. O que conferir?
Três coisas, nesta ordem: o trigger está Ativo; o workflow ligado a ele está Publicado; o evento escolhido é o certo (o catálogo em Triggers mostra os eventos disponíveis e quantas execuções cada trigger gerou nos últimos 7 dias).
Posso exigir que uma pessoa aprove antes de o agente agir?
Sim, com o passo de aprovação no workflow. A execução para em Aguardando aprovação até alguém aprovar ou rejeitar em Execuções; rejeitada, ela segue a rota de falha do fluxo, se existir.
Como paro tudo rapidamente?
Desativar o trigger interrompe novos disparos. Para tirar o fluxo de circulação, despublique o workflow em Workflows; para pausar só um agente, use Desativar na lista de agentes.