Como criar um agente autônomo usando n8n e lógica condicional
Rocketseat
5 min de leitura
Conheça o Rocketseat Para Empresas
Oferecemos soluções personalizadas para empresas de todos os portes.
No nosso artigo anterior, ficamos por dentro do n8n, explorando como sua abordagem low-code facilita a criação de automações visuais e a integração com ferramentas de inteligência artificial como as da OpenAI. Vimos como gerar texto e conectar diferentes serviços de forma prática. Mas prometemos ir além, certo? Chegou a hora de cumprir essa promessa e mergulhar em um dos conceitos mais fascinantes da automação moderna: os agentes autônomos.
Mas o que é, exatamente, um agente autônomo no contexto do n8n? Pense nele não como um simples executor de tarefas sequenciais, mas como um workflow com capacidade de raciocínio e decisão. Um agente autônomo utiliza um modelo de linguagem grande (LLM) como seu "cérebro" para entender um objetivo, planejar os passos necessários, e – aqui está o pulo do gato – usar lógica condicional para tomar decisões e escolher as ferramentas (outros nós ou APIs) mais adequadas para executar a tarefa em questão. Ele interage de forma mais dinâmica e adaptativa, aproximando-se de um assistente digital inteligente. A própria documentação do n8n possui seções dedicadas a "Advanced AI" e "AI Agent", mostrando que essa é uma capacidade central da plataforma.
Neste artigo, nosso objetivo é ambicioso e empolgante: vamos guiar você, passo a passo, na construção do seu primeiro agente autônomo simples, mas funcional, usando o n8n. Para isso, vamos dominar os nós de lógica condicional e explorar como combiná-los com os recursos avançados de IA do n8n. Preparado para dar vida e inteligência real às suas automações? Então, bora construir!
Os blocos de construção da inteligência: lógica condicional no n8n
Para que um agente seja considerado "autônomo", ele precisa ser capaz de tomar decisões. Assim como no código usamos if/else ou switch/case para controlar o fluxo de execução, no n8n temos nós específicos que permitem implementar essa inteligência decisória de forma visual. Sem lógica condicional, nossos workflows seriam apenas sequências lineares e previsíveis. Com ela, eles ganham a capacidade de se adaptar a diferentes inputs e resultados intermediários.
Vamos conhecer os dois principais nós de lógica condicional do n8n:
Nó IF: o tomador de decisões binárias
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').
Ilustração de dois caminhos de saída condicionais em um nó IF: verdadeiro (output 1) e falso (output 2), com ícones visuais.
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.
Nó Switch: o roteador inteligente
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.
Representação visual de múltiplas saídas possíveis em um nó Switch no n8n, destacando a seleção de um caso 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.
A implementação visual desses conceitos de programação torna a criação de fluxos complexos muito mais acessível, sem sacrificar o poder lógico necessário para a autonomia.
Para ver como esses nós funcionam na prática, confira este vídeo:
Dominar esses nós é o primeiro passo fundamental para construir agentes que realmente pensam e reagem.
Mergulhando nos agentes de IA com n8n: mais do que simples chamadas de API
Agora que entendemos como dar capacidade de decisão aos nossos workflows com a lógica condicional, vamos revisitar o conceito de agente de IA com mais profundidade. Como mencionamos, no n8n, a construção de um agente geralmente envolve usar um LLM (como os modelos da OpenAI acessados pelo nó OpenAI ) como o "cérebro" orquestrador.
Embora neste artigo foquemos no uso dos LLMs da OpenAI, é importante ressaltar que o n8n oferece uma vasta gama de integrações para que você possa utilizar o modelo de linguagem que melhor se adapte às suas necessidades.
Este "cérebro" não serve apenas para gerar texto ou analisar dados isoladamente. Em um agente, ele é instruído a:
Entender um objetivo: receber uma tarefa ou pergunta complexa.
Planejar os passos: quebrar a tarefa em etapas menores e lógicas.
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.
O que pode ser uma "tool" no n8n? Praticamente qualquer outro nó!
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.
A capacidade de definir e conectar essas ferramentas é o que permite ao agente ir além do conhecimento intrínseco do LLM e interagir com o mundo externo ou com sistemas específicos. O nó OpenAI do n8n, em operações como "Message an Assistant" e "Message a Model", possui suporte explícito para conectar essas Tools, transformando o nó de IA em um verdadeiro orquestrador. Quando você conecta uma tool, o nó OpenAI se torna um "nó raiz" de um "cluster", visualmente agrupando o agente e suas ferramentas.
A documentação do n8n explora diferentes arquiteturas e tipos de agentes, inspirados em conceitos do framework LangChain, como:
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.
Não precisamos implementar todas essas arquiteturas complexas agora, mas conhecer esses conceitos mostra o potencial e a profundidade que o n8n oferece para a criação de agentes. Ele se alinha com frameworks modernos de desenvolvimento de IA, posicionando-se não apenas como um executor de tarefas, mas como uma plataforma robusta para orquestrar inteligência.
Mãos à obra: construindo seu primeiro agente autônomo
Chegou a hora de arregaçar as mangas e transformar teoria em prática! Depois de entendermos os superpoderes da lógica condicional e o conceito de agentes de IA, que tal construirmos juntos nosso primeiro assistente digital inteligente no n8n?
Vamos criar juntos, o agente gerenciador de agenda inteligente. Por que este exemplo? Porque ele é útil para o dia a dia, nos permite explorar uma variedade fantástica de nós do n8n e demonstra de forma clara como a automação pode simplificar tarefas complexas, combinando organização pessoal com o poder da inteligência artificial.
Ele é um ótimo exemplo para que você entenda o básico da criação de agentes e tem um potencial enorme para que você o desenvolva e ajuste para que se torne algo muito útil em sua rotina.
Vamos trabalhar com:
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.
O que este agente fará, em detalhes:
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.
Visão geral do workflow completo no n8n combinando Schedule Trigger, Google Calendar, OpenAI, lógica IF e envio de e-mails.
Pronto para construir essa maravilha e ver o n8n em ação? Vamos ao passo a passo!
Nó gatilho (schedule trigger):
Este nó iniciará o workflow automaticamente no horário definido.
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.
Exibição do nó Schedule Trigger configurado para disparar o fluxo diariamente às 7h com fuso horário de São Paulo.
Nó fonte de dados (Google Calendar):
Este nó buscará os eventos do seu calendário.
Adicione o nó: clique no + ao lado do nó "schedule trigger" e procure por "Google Calendar".
Configuração:
Credential to connect with: crie ou selecione sua credencial do Google Calendar.
Resource: selecione Event.
Operation: selecione Get Many.
Calendar: escolha o calendário do qual deseja buscar os eventos.
Return All: deixe marcado.
Options > After: Use a expressão {{ $now.startOf('day') }}.
Options > Before: Use a expressão {{ $now.endOf('day') }}.
Teste: Execute este nó ("Test step") para garantir que está buscando os eventos.
Nó de inteligência artificial:
Este nó processará cada evento do calendário usando IA. O n8n enviará cada evento da lista do Google Calendar, um por vez, para este nó.
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.
Nó de decisão:
Este nó verificará se há alguma atividade processada pela IA.
Adicione o nó: conecte o nó "OpenAI" a um nó "IF".
Conditions:
Value 1:{{ $items.length }} (conta quantos itens/eventos foram processados pelo OpenAI).
No nosso artigo anterior, ficamos por dentro do n8n, explorando como sua abordagem low-code facilita a criação de automações visuais e a integração com ferramentas de inteligência artificial como as da OpenAI. Vimos como gerar texto e conectar diferentes serviços de forma prática. Mas prometemos ir além, certo? Chegou a hora de cumprir essa promessa e mergulhar em um dos conceitos mais fascinantes da automação moderna: os agentes autônomos.
Mas o que é, exatamente, um agente autônomo no contexto do n8n? Pense nele não como um simples executor de tarefas sequenciais, mas como um workflow com capacidade de raciocínio e decisão. Um agente autônomo utiliza um modelo de linguagem grande (LLM) como seu "cérebro" para entender um objetivo, planejar os passos necessários, e – aqui está o pulo do gato – usar lógica condicional para tomar decisões e escolher as ferramentas (outros nós ou APIs) mais adequadas para executar a tarefa em questão. Ele interage de forma mais dinâmica e adaptativa, aproximando-se de um assistente digital inteligente. A própria documentação do n8n possui seções dedicadas a "Advanced AI" e "AI Agent", mostrando que essa é uma capacidade central da plataforma.
Neste artigo, nosso objetivo é ambicioso e empolgante: vamos guiar você, passo a passo, na construção do seu primeiro agente autônomo simples, mas funcional, usando o n8n. Para isso, vamos dominar os nós de lógica condicional e explorar como combiná-los com os recursos avançados de IA do n8n. Preparado para dar vida e inteligência real às suas automações? Então, bora construir!
Os blocos de construção da inteligência: lógica condicional no n8n
Para que um agente seja considerado "autônomo", ele precisa ser capaz de tomar decisões. Assim como no código usamos if/else ou switch/case para controlar o fluxo de execução, no n8n temos nós específicos que permitem implementar essa inteligência decisória de forma visual. Sem lógica condicional, nossos workflows seriam apenas sequências lineares e previsíveis. Com ela, eles ganham a capacidade de se adaptar a diferentes inputs e resultados intermediários.
Vamos conhecer os dois principais nós de lógica condicional do n8n:
Nó IF: o tomador de decisões binárias
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').
Ilustração de dois caminhos de saída condicionais em um nó IF: verdadeiro (output 1) e falso (output 2), com ícones visuais.
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.
Nó Switch: o roteador inteligente
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.
Representação visual de múltiplas saídas possíveis em um nó Switch no n8n, destacando a seleção de um caso 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.
A implementação visual desses conceitos de programação torna a criação de fluxos complexos muito mais acessível, sem sacrificar o poder lógico necessário para a autonomia.
Para ver como esses nós funcionam na prática, confira este vídeo:
Dominar esses nós é o primeiro passo fundamental para construir agentes que realmente pensam e reagem.
Mergulhando nos agentes de IA com n8n: mais do que simples chamadas de API
Agora que entendemos como dar capacidade de decisão aos nossos workflows com a lógica condicional, vamos revisitar o conceito de agente de IA com mais profundidade. Como mencionamos, no n8n, a construção de um agente geralmente envolve usar um LLM (como os modelos da OpenAI acessados pelo nó OpenAI ) como o "cérebro" orquestrador.
Embora neste artigo foquemos no uso dos LLMs da OpenAI, é importante ressaltar que o n8n oferece uma vasta gama de integrações para que você possa utilizar o modelo de linguagem que melhor se adapte às suas necessidades.
Este "cérebro" não serve apenas para gerar texto ou analisar dados isoladamente. Em um agente, ele é instruído a:
Entender um objetivo: receber uma tarefa ou pergunta complexa.
Planejar os passos: quebrar a tarefa em etapas menores e lógicas.
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.
O que pode ser uma "tool" no n8n? Praticamente qualquer outro nó!
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.
A capacidade de definir e conectar essas ferramentas é o que permite ao agente ir além do conhecimento intrínseco do LLM e interagir com o mundo externo ou com sistemas específicos. O nó OpenAI do n8n, em operações como "Message an Assistant" e "Message a Model", possui suporte explícito para conectar essas Tools, transformando o nó de IA em um verdadeiro orquestrador. Quando você conecta uma tool, o nó OpenAI se torna um "nó raiz" de um "cluster", visualmente agrupando o agente e suas ferramentas.
A documentação do n8n explora diferentes arquiteturas e tipos de agentes, inspirados em conceitos do framework LangChain, como:
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.
Não precisamos implementar todas essas arquiteturas complexas agora, mas conhecer esses conceitos mostra o potencial e a profundidade que o n8n oferece para a criação de agentes. Ele se alinha com frameworks modernos de desenvolvimento de IA, posicionando-se não apenas como um executor de tarefas, mas como uma plataforma robusta para orquestrar inteligência.
Mãos à obra: construindo seu primeiro agente autônomo
Chegou a hora de arregaçar as mangas e transformar teoria em prática! Depois de entendermos os superpoderes da lógica condicional e o conceito de agentes de IA, que tal construirmos juntos nosso primeiro assistente digital inteligente no n8n?
Vamos criar juntos, o agente gerenciador de agenda inteligente. Por que este exemplo? Porque ele é útil para o dia a dia, nos permite explorar uma variedade fantástica de nós do n8n e demonstra de forma clara como a automação pode simplificar tarefas complexas, combinando organização pessoal com o poder da inteligência artificial.
Ele é um ótimo exemplo para que você entenda o básico da criação de agentes e tem um potencial enorme para que você o desenvolva e ajuste para que se torne algo muito útil em sua rotina.
Vamos trabalhar com:
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.
O que este agente fará, em detalhes:
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.
Visão geral do workflow completo no n8n combinando Schedule Trigger, Google Calendar, OpenAI, lógica IF e envio de e-mails.
Pronto para construir essa maravilha e ver o n8n em ação? Vamos ao passo a passo!
Nó gatilho (schedule trigger):
Este nó iniciará o workflow automaticamente no horário definido.
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.
Exibição do nó Schedule Trigger configurado para disparar o fluxo diariamente às 7h com fuso horário de São Paulo.
Nó fonte de dados (Google Calendar):
Este nó buscará os eventos do seu calendário.
Adicione o nó: clique no + ao lado do nó "schedule trigger" e procure por "Google Calendar".
Configuração:
Credential to connect with: crie ou selecione sua credencial do Google Calendar.
Resource: selecione Event.
Operation: selecione Get Many.
Calendar: escolha o calendário do qual deseja buscar os eventos.
Return All: deixe marcado.
Options > After: Use a expressão {{ $now.startOf('day') }}.
Options > Before: Use a expressão {{ $now.endOf('day') }}.
Teste: Execute este nó ("Test step") para garantir que está buscando os eventos.
Nó de inteligência artificial:
Este nó processará cada evento do calendário usando IA. O n8n enviará cada evento da lista do Google Calendar, um por vez, para este nó.
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.
Nó de decisão:
Este nó verificará se há alguma atividade processada pela IA.
Adicione o nó: conecte o nó "OpenAI" a um nó "IF".
Conditions:
Value 1:{{ $items.length }} (conta quantos itens/eventos foram processados pelo OpenAI).
No nosso artigo anterior, ficamos por dentro do n8n, explorando como sua abordagem low-code facilita a criação de automações visuais e a integração com ferramentas de inteligência artificial como as da OpenAI. Vimos como gerar texto e conectar diferentes serviços de forma prática. Mas prometemos ir além, certo? Chegou a hora de cumprir essa promessa e mergulhar em um dos conceitos mais fascinantes da automação moderna: os agentes autônomos.
Mas o que é, exatamente, um agente autônomo no contexto do n8n? Pense nele não como um simples executor de tarefas sequenciais, mas como um workflow com capacidade de raciocínio e decisão. Um agente autônomo utiliza um modelo de linguagem grande (LLM) como seu "cérebro" para entender um objetivo, planejar os passos necessários, e – aqui está o pulo do gato – usar lógica condicional para tomar decisões e escolher as ferramentas (outros nós ou APIs) mais adequadas para executar a tarefa em questão. Ele interage de forma mais dinâmica e adaptativa, aproximando-se de um assistente digital inteligente. A própria documentação do n8n possui seções dedicadas a "Advanced AI" e "AI Agent", mostrando que essa é uma capacidade central da plataforma.
Neste artigo, nosso objetivo é ambicioso e empolgante: vamos guiar você, passo a passo, na construção do seu primeiro agente autônomo simples, mas funcional, usando o n8n. Para isso, vamos dominar os nós de lógica condicional e explorar como combiná-los com os recursos avançados de IA do n8n. Preparado para dar vida e inteligência real às suas automações? Então, bora construir!
Os blocos de construção da inteligência: lógica condicional no n8n
Para que um agente seja considerado "autônomo", ele precisa ser capaz de tomar decisões. Assim como no código usamos if/else ou switch/case para controlar o fluxo de execução, no n8n temos nós específicos que permitem implementar essa inteligência decisória de forma visual. Sem lógica condicional, nossos workflows seriam apenas sequências lineares e previsíveis. Com ela, eles ganham a capacidade de se adaptar a diferentes inputs e resultados intermediários.
Vamos conhecer os dois principais nós de lógica condicional do n8n:
Nó IF: o tomador de decisões binárias
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').
Ilustração de dois caminhos de saída condicionais em um nó IF: verdadeiro (output 1) e falso (output 2), com ícones visuais.
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.
Nó Switch: o roteador inteligente
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.
Representação visual de múltiplas saídas possíveis em um nó Switch no n8n, destacando a seleção de um caso 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.
A implementação visual desses conceitos de programação torna a criação de fluxos complexos muito mais acessível, sem sacrificar o poder lógico necessário para a autonomia.
Para ver como esses nós funcionam na prática, confira este vídeo:
Dominar esses nós é o primeiro passo fundamental para construir agentes que realmente pensam e reagem.
Mergulhando nos agentes de IA com n8n: mais do que simples chamadas de API
Agora que entendemos como dar capacidade de decisão aos nossos workflows com a lógica condicional, vamos revisitar o conceito de agente de IA com mais profundidade. Como mencionamos, no n8n, a construção de um agente geralmente envolve usar um LLM (como os modelos da OpenAI acessados pelo nó OpenAI ) como o "cérebro" orquestrador.
Embora neste artigo foquemos no uso dos LLMs da OpenAI, é importante ressaltar que o n8n oferece uma vasta gama de integrações para que você possa utilizar o modelo de linguagem que melhor se adapte às suas necessidades.
Este "cérebro" não serve apenas para gerar texto ou analisar dados isoladamente. Em um agente, ele é instruído a:
Entender um objetivo: receber uma tarefa ou pergunta complexa.
Planejar os passos: quebrar a tarefa em etapas menores e lógicas.
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.
O que pode ser uma "tool" no n8n? Praticamente qualquer outro nó!
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.
A capacidade de definir e conectar essas ferramentas é o que permite ao agente ir além do conhecimento intrínseco do LLM e interagir com o mundo externo ou com sistemas específicos. O nó OpenAI do n8n, em operações como "Message an Assistant" e "Message a Model", possui suporte explícito para conectar essas Tools, transformando o nó de IA em um verdadeiro orquestrador. Quando você conecta uma tool, o nó OpenAI se torna um "nó raiz" de um "cluster", visualmente agrupando o agente e suas ferramentas.
A documentação do n8n explora diferentes arquiteturas e tipos de agentes, inspirados em conceitos do framework LangChain, como:
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.
Não precisamos implementar todas essas arquiteturas complexas agora, mas conhecer esses conceitos mostra o potencial e a profundidade que o n8n oferece para a criação de agentes. Ele se alinha com frameworks modernos de desenvolvimento de IA, posicionando-se não apenas como um executor de tarefas, mas como uma plataforma robusta para orquestrar inteligência.
Mãos à obra: construindo seu primeiro agente autônomo
Chegou a hora de arregaçar as mangas e transformar teoria em prática! Depois de entendermos os superpoderes da lógica condicional e o conceito de agentes de IA, que tal construirmos juntos nosso primeiro assistente digital inteligente no n8n?
Vamos criar juntos, o agente gerenciador de agenda inteligente. Por que este exemplo? Porque ele é útil para o dia a dia, nos permite explorar uma variedade fantástica de nós do n8n e demonstra de forma clara como a automação pode simplificar tarefas complexas, combinando organização pessoal com o poder da inteligência artificial.
Ele é um ótimo exemplo para que você entenda o básico da criação de agentes e tem um potencial enorme para que você o desenvolva e ajuste para que se torne algo muito útil em sua rotina.
Vamos trabalhar com:
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.
O que este agente fará, em detalhes:
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.
Visão geral do workflow completo no n8n combinando Schedule Trigger, Google Calendar, OpenAI, lógica IF e envio de e-mails.
Pronto para construir essa maravilha e ver o n8n em ação? Vamos ao passo a passo!
Nó gatilho (schedule trigger):
Este nó iniciará o workflow automaticamente no horário definido.
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.
Exibição do nó Schedule Trigger configurado para disparar o fluxo diariamente às 7h com fuso horário de São Paulo.
Nó fonte de dados (Google Calendar):
Este nó buscará os eventos do seu calendário.
Adicione o nó: clique no + ao lado do nó "schedule trigger" e procure por "Google Calendar".
Configuração:
Credential to connect with: crie ou selecione sua credencial do Google Calendar.
Resource: selecione Event.
Operation: selecione Get Many.
Calendar: escolha o calendário do qual deseja buscar os eventos.
Return All: deixe marcado.
Options > After: Use a expressão {{ $now.startOf('day') }}.
Options > Before: Use a expressão {{ $now.endOf('day') }}.
Teste: Execute este nó ("Test step") para garantir que está buscando os eventos.
Nó de inteligência artificial:
Este nó processará cada evento do calendário usando IA. O n8n enviará cada evento da lista do Google Calendar, um por vez, para este nó.
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.
Nó de decisão:
Este nó verificará se há alguma atividade processada pela IA.
Adicione o nó: conecte o nó "OpenAI" a um nó "IF".
Conditions:
Value 1:{{ $items.length }} (conta quantos itens/eventos foram processados pelo OpenAI).
Conheça o Rocketseat Para Empresas
Oferecemos soluções personalizadas para empresas de todos os portes.
Rocketseat
Ecossistema de educação contínua referência em programação e Inteligência Artificial.
Artigos_
Explore conteúdos relacionados
Descubra mais artigos que complementam seu aprendizado e expandem seu conhecimento.
NewsletterReceba conteúdos inéditos e novidades gratuitamente
