Como criar um agente autônomo usando n8n e lógica condicional

Os blocos de construção da inteligência: lógica condicional no n8n

Função: este nó é o equivalente ao if/else na programação. Ele avalia uma condição que você define. Se a condição for verdadeira (true), o fluxo de dados segue por uma saída. Se for falsa (false), segue pela outra saída ('false' ou 'output 2').

Exemplo prático: imagine um workflow que monitora menções da sua marca nas redes sociais. Você pode usar um nó IF para verificar o sentimento da menção (obtido por um nó de IA, por exemplo).

• Condição: Sentimento == "negativo"

• Saída true: enviar um alerta urgente para a equipe de suporte via Slack.

• Saída false: adicionar a menção a uma planilha de monitoramento geral.

Configuração: no nó IF, você adiciona uma condição. Pode comparar valores de nós anteriores, verificar se um dado existe, comparar números, etc.

Função: pense no nó Switch como a estrutura switch/case ou uma série de if/else if/else. Ele permite definir múltiplas condições (casos) e roteia o fluxo de dados para a saída correspondente à primeira condição que for avaliada como verdadeira. É ideal quando você tem mais de dois caminhos possíveis baseados no valor de um campo específico.

Exemplo prático: Um workflow que processa pedidos de um e-commerce. O nó Switch pode direcionar o fluxo com base no status do pedido.

• Campo a ser avaliado: Status do Pedido

• Caso 1 (Routing Rule 0): Status == "Pagamento Aprovado" -> Saída 0: Enviar email de confirmação e notificar o estoque.

• Caso 2 (Routing Rule 1): Status == "Enviado" -> Saída 1: Enviar email com código de rastreio.

• Caso 3 (Routing Rule 2): Status == "Cancelado" -> Saída 2: Notificar o financeiro e atualizar o status do cliente.

• (Default/Output fallback): Se nenhum caso for verdadeiro, pode ir para uma saída padrão.

Configuração: no nó Switch, você define o campo cujos dados serão verificados (Field to Route By). Depois, adiciona regras de roteamento (Routing Rules), cada uma com um valor a ser comparado e a saída correspondente.

Mergulhando nos agentes de IA com n8n: mais do que simples chamadas de API

1. Entender um objetivo: receber uma tarefa ou pergunta complexa.

2. Planejar os passos: quebrar a tarefa em etapas menores e lógicas.

3. Utilizar ferramentas (tools): aqui está um conceito chave! As "tools" são outros nós ou funcionalidades que o agente pode decidir invocar para obter informações ou realizar ações necessárias para completar seu objetivo. Pense nelas como as habilidades ou recursos que o agente tem à sua disposição.

• Um nó HTTP Request para buscar informações em tempo real de uma API externa.

• Um nó Web Scraper para extrair dados de uma página web.

• Um nó Google Sheets para ler ou escrever dados em uma planilha.

• Até mesmo outro nó OpenAI para uma sub-tarefa de análise ou geração.

• Conversational agent: focado em manter conversas coerentes, usando memória.

• OpenAI functions agent: utiliza a capacidade nativa de "function calling" da OpenAI para interagir com Tools de forma mais estruturada.

• Plan and execute agent: primeiro cria um plano detalhado, depois executa cada passo.

• ReAct (reasoning and acting): combina raciocínio interno com ações (uso de Tools) de forma iterativa.

Mãos à obra: construindo seu primeiro agente autônomo

• Nó de agendamento (schedule trigger): para que nosso agente acorde e trabalhe para nós automaticamente, todos os dias, como um relógio.

• Nó do Google Agenda (calendar): para conectar e buscar informações de um dos serviços mais usados para organização pessoal e profissional.

• Nó da OpenAI: para dar ao nosso agente um "cérebro" de IA capaz de entender, processar e classificar nossos compromissos de forma inteligente.

• Nó IF (condicional): o coração da tomada de decisão do nosso agente, permitindo que ele siga caminhos diferentes com base na existência de eventos.

• Nó de código (code): onde a mágica do JavaScript nos ajudará a formatar e agregar os dados dos eventos em um resumo coeso e elegante, como verdadeiros artesãos digitais. Spoiler: Todo esse código foi gerado por IA, então fique tranquilo se você não souber programar.

• Nó de envio de email (Google): para que nosso agente nos comunique suas descobertas de forma clara, enviando um relatório personalizado diretamente para nossa caixa de entrada.

• Disparo agendado: será acionado automaticamente todos os dias às 7h da manhã.

• Busca de eventos: consultará seu Google Agenda para obter os eventos do dia.

• Análise com IA: utilizará um modelo de linguagem da OpenAI para processar cada evento individualmente.

• Agregação de dados: consolidará as informações de todos os eventos processados em um único resumo.

• Comunicação inteligente: se houver eventos na agenda, enviará um único email com o resumo das atividades diárias, se não houver eventos, enviará um email informando que a agenda está livre e sugerindo um tempo para estudar n8n.

• Adicione o nó: Procure por "Schedule" e adicione o nó "Schedule Trigger" ao seu canvas.

• Configuração:
• Trigger interval: selecione Days.
• Days between triggers: digite 1 (para rodar todos os dias).
• Trigger at hour: selecione 7am (para 7h da manhã).
• Trigger at minute: digite 0.
• Timezone: Essa opção não aparece nas configurações, mas basta você testar o nó após as definições acima que você vai obter o output, onde será possível ver o valor do timezone. Certifique-se de que está configurado para o seu fuso horário.

• Adicione o nó: clique no + ao lado do nó "schedule trigger" e procure por "Google Calendar".

• Teste: Execute este nó ("Test step") para garantir que está buscando os eventos.

• Adicione o nó: conecte o nó "Google Calendar" a um nó "OpenAI".

• Configuração: É importante ressaltar que para executar essas ações, você deve ter crédito na OpenAI e uma chave de api válida. O gasto é baixo, menos de 1 centavo de dólar por solicitação, a depender de quantos eventos você tem em sua agenda no dia. Você pode acompanhar o uso de seus tokens aqui.

• Credential for OpenAI API: crie ou selecione sua credencial da OpenAI.
> Resource: selecione text.
> 2 Operation: selecione Message a Model.
> Model: escolha um modelo (ex: gpt-4o-latest).
> Messages:
> Role: User
Prompt 👇

Para o seguinte evento do calendário:
Título: {{ $json.summary }}
Início: {{ $json.start.dateTime }}

Organize esta informação no seguinte formato JSON, classificando a tarefa como 'Pessoal', 'Trabalho' ou 'Outro':
{
  "titulo": "SEU_TITULO_AQUI",
  "horario_inicio": "SEU_HORARIO_AQUI",
  "classificacao": "SUA_CLASSIFICACAO_AQUI"
}

Simplify Output: marcado como verdadeiro.
Output Content as JSON: marcado como verdadeiro.



O n8n executará este nó para cada evento encontrado, resultando em uma lista desses outputs.

• Adicione o nó: conecte o nó "OpenAI" a um nó "IF".

• Value 1: {{ $items.length }} (conta quantos itens/eventos foram processados pelo OpenAI).

• Operation: is greater than

• Value 2: 0

• Saídas: true (se houver eventos) e false (se não houver).

• Adicione o nó: conecte a saída true do nó "IF" a um nó "code".

• Configuração (JavaScript): cole o seguinte código:

let resumoHtml = "Olá!<br><br>Aqui estão suas atividades para hoje:<br><br>";
const items = $input.all(); // Pega todos os itens da entrada (saída do nó OpenAI)

if (items.length === 0) {
  resumoHtml += "Nenhuma atividade encontrada.";
} else {
  for (const item of items) {
    // Acessa o conteúdo DENTRO da estrutura 'message.content'
    const evento = item.json.message.content;

    // Formata a data e hora de forma mais amigável
    const dataHora = new Date(evento.horario_inicio);
    const horarioFormatado = dataHora.toLocaleTimeString('pt-BR', {
      hour: '2-digit',
      minute: '2-digit',
      timeZone: 'America/Sao_Paulo' // Ajuste para seu fuso horário se necessário
    });

    resumoHtml += `<strong>Tarefa:</strong> ${evento.titulo}<br>`;
    resumoHtml += `<strong>Horário:</strong> ${horarioFormatado}<br>`;
    resumoHtml += `<strong>Classificação:</strong> ${evento.classificacao}<br><br>`;
  }
}

resumoHtml += "Tenha um ótimo dia!";

// Retorna um único item com o HTML agregado, pronto para o nó de Email
return [{ json: { corpoEmail: resumoHtml } }];

• Teste: a saída deste nó deve ser um único item contendo um JSON com a chave corpoEmail e o valor sendo todo o HTML do resumo.

• Credential: suas credenciais de email.

• To: seu endereço de email.

• Subject: Resumo da sua agenda para hoje!

• Body Type: HTML.Body/Text: Use a saída do nó "code": {{ $json.corpoEmail }}

• Credential: suas credenciais de email.

• To: seu endereço de email.

• Subject: Sua agenda está livre hoje!

• Body Type: HTML (ou Text).

• Body/Text:

Olá!

Parece que sua agenda está livre hoje. Que tal aproveitar para estudar um pouco mais sobre n8n e automações?

Tenha um dia produtivo!

Expandindo horizontes: o universo de possibilidades com agentes n8n

• Chatbots inteligentes: crie chatbots que não apenas respondem perguntas frequentes, mas que podem consultar bases de dados internas (SQL, Google Sheets), verificar o status de pedidos em tempo real, ou até mesmo abrir tickets de suporte, usando Tools para interagir com esses sistemas.

• Agentes de monitoramento e ação: configure workflows que monitoram a performance de sistemas (logs, métricas), usam IA para identificar anomalias e, com base na análise, tomam ações corretivas automaticamente, como reiniciar um serviço ou notificar a equipe de DevOps.

• Assistentes de vendas e marketing: desenvolva agentes que analisam leads, buscam informações adicionais sobre eles na web (usando scraping ou APIs), personalizam emails de follow-up com base no perfil do lead e atualizam o CRM automaticamente.

• Agentes de pesquisa e sumarização: crie automações que monitoram fontes de notícias ou artigos científicos, usam IA para resumir os conteúdos mais relevantes para sua área de interesse e enviam um digest diário por email ou Slack.

• Memória: dar ao agente a capacidade de lembrar interações passadas em uma conversa, tornando chatbots mais fluidos e contextuais.

• Chains: criar sequências mais complexas onde a saída de um passo de IA alimenta o próximo, permitindo raciocínios mais elaborados.

• Avaliação e escolha de tools: em cenários mais complexos, o agente pode ter várias Tools à disposição e usar o LLM para decidir qual é a melhor ferramenta para cada etapa do plano.

• Modelos self-hosted: para controle total ou uso de modelos específicos, você pode integrar LLMs que você mesmo hospeda.

• Templates n8n: a plataforma oferece uma galeria crescente de templates, muitos deles focados em IA e agentes. Explore-os para ver exemplos prontos e adaptá-los às suas necessidades.

• Documentação de advanced AI: mergulhe na documentação oficial para entender os conceitos de agents, tools e chains em mais detalhes.

• Redes sociais da Rocketseat: possuímos diversos conteúdos ricos e gratuitos sobre n8n.

• Mentoria de automações com IA: A Rocketseat oferece mentoria de automação, com um de nossos instrutores mais aficionados por automação, Mayk Brito! Com sua didática incrível, você absolutamente vai chegar ao próximo nível.

Conclusão: você agora é um criador de agentes autônomos!

• Entendemos a importância da lógica condicional (nós IF e Switch) para dar capacidade de decisão aos workflows.

• Aprofundamos o conceito de agentes de IA no n8n, compreendendo o papel do LLM como "cérebro" (mesmo que opcional para a lógica principal do nosso exemplo) e a importância das "Tools" (como o Google Calendar).

• Colocamos a mão na massa e construímos passo a passo um "agente gerenciador de agenda inteligente", vendo na prática como combinar gatilhos, ferramentas, IA, lógica condicional e ações para criar um fluxo inteligente e adaptativo.

• Automação visual intuitiva

• Flexibilidade para código customizado

• Lógica condicional robusta

• Integração profunda e facilitada com IA e outras ferramentas

• Compartilhe: mostre o agente que você criou! Compartilhe suas ideias e projetos com a comunidade.

• Explore mais: continue explorando na plataforma, experimente diferentes nós, integrações (como a do Google Calendar) e conceitos de IA.

• Aplique: pense nos desafios do seu dia a dia ou da sua empresa. Onde um agente autônomo poderia fazer a diferença, economizando tempo, otimizando processos ou gerando insights?

• Continue aprendendo: o campo da automação e IA está em constante evolução. Mantenha-se curioso e continue explorando as novidades que o n8n e o ecossistema de IA oferecem.