Introdução aos Agentes de IA com N8N
Os agentes de IA representam uma das melhores abordagens para aproveitar o poder da inteligência artificial, automatizando uma vasta gama de tarefas. Uma das ferramentas mais notáveis para construir essas automações de IA é o **N8N**.
O N8N é uma ferramenta de fluxo de trabalho (workflow) *open-source* e nativa de IA que ganhou muita popularidade recentemente. Seu apelo reside na capacidade de criar automações complexas de IA sem a necessidade de escrever código, graças a uma interface visual de arrastar e soltar (drag and drop) muito intuitiva.
Neste artigo, construiremos um agente de IA completamente do zero. Se você é iniciante na criação desses agentes ou precisa de uma revisão, este guia passo a passo detalhado é ideal. Nosso objetivo será criar um agente específico para lidar com e-mails de entrada, automatizando o processo de resposta usando IA.
O que é N8N?
O N8N é uma alternativa de código aberto para ferramentas de automação como Zapier e Make.com. A principal diferença é que o N8N foi construído com a IA em mente desde o início, enquanto as outras ferramentas tiveram que implementar recursos de IA posteriormente.
Uma característica chave do N8N é a possibilidade de **auto-hospedagem (self-host)**, o que proporciona maior controle sobre seus dados. Alternativamente, você pode usar o serviço hospedado em seu site oficial, `n8n.io`.
Esta plataforma pode automatizar diversos fluxos de trabalho em áreas como vendas, marketing, suporte e design, permitindo a implementação de IA em cada etapa. Além disso, o N8N oferece mais de mil fluxos de trabalho pré-fabricados, facilitando o início para quem não deseja construir do zero.
Configurando o Ambiente N8N: Opções de Hospedagem
Existem duas opções principais para configurar seu ambiente N8N:
1. **N8N.io (Plataforma Hospedada):** Usar o site oficial, onde os planos começam em $20 por mês.
2. **Auto-Hospedagem (Self-Hosting):** Por ser *open-source*, você pode hospedar você mesmo. Isso geralmente requer um bom conhecimento técnico.
Para uma solução privada e mais econômica, utiliza-se um **VPS (Virtual Private Server)**. A Hostinger é recomendada neste contexto por simplificar o processo de instalação com seu VPS, sendo uma maneira eficaz de rodar o N8N sem os custos da versão hospedada, mantendo total controle e privacidade dos dados.
Ao usar o VPS da Hostinger, há uma instalação do N8N com um clique, permitindo lançar sua própria instância em poucos minutos. Isso garante controle total sobre a configuração e, crucialmente, mantém seus dados privados.
Benefícios da Hospedagem com VPS
* **Custo-Benefício:** Rodar o N8N via Hostinger Air pode ser até 70% mais barato que usar o site oficial do N8N.
* **Controle Total:** Você configura tudo exatamente como deseja.
* **Privacidade:** Seus dados permanecem privados.
No momento, existe uma promoção de *early Black Friday* oferecendo 64% de desconto no N8N auto-hospedado via Hostinger. Adicionalmente, um código de cupom pode oferecer um desconto extra de 10% sobre este valor (o cupom mencionado é `HalfinityN8N`). Recomenda-se verificar a descrição para links e o cupom mais atualizado.
Instalação do N8N via Hostinger VPS
Para configurar sua conta N8N na Hostinger VPS:
1. Após configurar sua conta de hospedagem e fazer login, localize a aba **VPS** no menu lateral.
2. Compre o plano VPS e siga os passos de configuração. O plano recomendado para a instalação do N8N é o **KVM2**, pois é robusto o suficiente para lidar com múltiplos fluxos de trabalho simultâneos sem problemas.
3. Selecione o plano KVM2 (o exemplo utiliza o plano de 2 anos).
4. No campo de cupom, insira o código de desconto para obter o abatimento adicional.
5. Em seguida, inicie a configuração do N8N no seu VPS.
6. Na interface da Hostinger, navegue até a aba **VPS** e encontre o servidor recém-adquirido e clique em **Gerenciar Aplicativo**.
7. Você será direcionado para a instalação do N8N. Defina uma senha de acesso para o seu servidor privado virtual.
8. Após a conclusão da instalação (que leva alguns minutos), clique em **Gerenciar Aplicativo** novamente para acessar sua instância N8N auto-hospedada.
9. Siga os passos de customização do N8N e obtenha uma **chave de ativação gratuita** para desbloquear todos os recursos. Cole essa chave na página indicada.
Construindo um Fluxo de Trabalho (Workflow) Básico
Com tudo configurado, o próximo passo é criar os **workflows** (fluxos de trabalho), que são as automações. Quando estas automações incorporam componentes de IA, elas se tornam agentes de IA autônomos.
Para começar, crie um novo workflow na página inicial. Você verá uma tela vazia, a menos que use um template. Construir do zero ajuda a entender o funcionamento de cada parte.
Nós (Nodes) e o Nó de Início
Os elementos de automação são chamados de **nodes**. Toda automação precisa de um nó inicial que define o que a dispara.
1. Clique para adicionar o primeiro nó. As opções de gatilho (trigger) incluem:
* **Manual:** Acionado ao pressionar um botão.
* **Schedule (Agendamento):** Executa a cada X horas ou dias.
* **Chat:** Inicia a partir de uma mensagem inicial de chatbot.
2. Para o nosso objetivo de automação de e-mails, escolhemos **Gmail** como o nó inicial (trigger).
3. O *trigger* do Gmail será: **”When I receive a message to my Gmail”** (Quando eu receber uma mensagem no meu Gmail).
4. Em seguida, você deve autenticar suas credenciais do Gmail. Para a versão auto-hospedada, pode ser necessário seguir um guia de autenticação do Google, que envolve configurar a autenticação OAuth (algo que só precisa ser feito uma vez). Após a autenticação e teste de conexão, o nó de gatilho estará funcionando.
Adicionando Inteligência Artificial ao Workflow
Após o gatilho (receber um e-mail), adicionamos o segundo nó, que é onde a IA entra em ação.
1. Clique no sinal de mais (+) para adicionar um novo nó.
2. Para integrar a inteligência artificial, adicionamos o nó **OpenAI**. OpenAI é a empresa por trás do ChatGPT.
3. Para usar este nó, é necessário configurar as credenciais. Você deve obter uma **API Key** no site `platform.openai.com` (que é diferente da sua conta regular de ChatGPT). Crie uma nova chave secreta no painel da plataforma OpenAI e adicione-a ao N8N.
* *Nota:* O uso da API da OpenAI requer que um cartão de crédito esteja associado à sua conta OpenAI para cobrança baseada no uso (geralmente em centavos por dia para casos de uso simples).
4. Após salvar a conexão, você define a operação como **”Message a Model”** (Enviar uma mensagem a um modelo).
5. Escolha o modelo de IA. Recomenda-se modelos como o **GPT-4 Mini** por ser rápido e custo-efetivo, ou o **GPT-4 Chat Latest** para maior precisão, embora seja mais caro.
Definindo o Prompt (Instrução)
É crucial informar ao modelo o que ele deve analisar:
* Você verá as opções **Fixed** (Fixo) e **Expression** (Expressão).
* Para usar dados dinâmicos do e-mail de entrada (como o corpo da mensagem, que muda a cada vez), use **Expression**.
* Arraste o **Snippet** (trecho) que representa o **Body** (corpo) do e-mail recebido do nó Gmail para a caixa de prompt.
* Defina o **Role** (Papel) do modelo como **User** (Usuário).
Você também pode adicionar um **System Prompt** (instrução de sistema) para definir o comportamento da IA. Por exemplo, você pode pedir à IA para analisar o corpo do e-mail e retornar se ele é urgente para o atendimento ao cliente.
Após testar este passo, a IA analisará o conteúdo do e-mail e fornecerá uma resposta baseada nas instruções fornecidas.
Transformando o Workflow em um Agente de IA
Um simples workflow de IA automatiza uma ação após um gatilho. Um **Agente de IA** é mais robusto, pois inclui **Memória** e **Ferramentas (Tools)**.
1. No N8N, adicione um nó **AI Agent** em vez do nó simples de IA.
2. Este nó permite configurar:
* **Chat Model:** O mesmo modelo OpenAI configurado anteriormente.
* **Memory (Memória):** Isso permite que o agente se lembre de interações passadas (conversas anteriores). Recomenda-se definir um *context window length* (janela de contexto) maior, como 20, para suportar mais histórico de conversas, embora 5 possa ser suficiente em alguns casos.
* **Tools (Ferramentas):** Permite que o agente execute ações externas.
Exemplo de Uso de Ferramentas
Para demonstrar o poder do agente, adicionamos uma ferramenta para gerenciar o e-mail recebido:
1. Adicione o nó **Gmail** como uma ferramenta.
2. Em vez de *Send Email* (Enviar E-mail), escolhemos a operação **Add Label** (Adicionar Etiqueta).
3. Usamos a informação do *trigger* (Gmail) para obter o **Message ID** do e-mail recebido e definir um **Label Name** (Nome da Etiqueta) fixo, como “URGENT SUPPORT”, que será aplicado ao e-mail.
4. Para que a mensagem enviada ao agente contenha o resultado da análise, usamos o output do nó anterior (o resultado da análise de urgência) como a mensagem para o agente, configurado via *Expression*.
Ao testar o agente com um e-mail urgente (“I need to cancel my accounts ASAP”), o agente avalia a mensagem com base no *System Prompt*, determina que é urgente e executa a ferramenta para adicionar o rótulo “URGENT SUPPORT” ao e-mail original.
Finalizando e Ativando o Agente
* **Salve o Workflow:** É fundamental salvar o workflow periodicamente, pois o N8N oferece um histórico de revisões.
* **Ativação:** Enquanto você testa, o workflow deve estar em modo **Inactive**. Quando estiver satisfeito, mude o status para **Active**. O workflow passará a checar regularmente por novos e-mails e executar a sequência de automação.
Exemplo de Workflow com Chat
Se você quisesse integrar este agente em um chatbot no seu site:
1. O nó inicial seria um **Chat Node** (acionado por uma mensagem de chat).
2. O próximo nó seria o **AI Agent**.
3. O *User Prompt* do agente seria configurado como **Expression**, puxando o corpo da mensagem do nó de Chat.
4. O *System Prompt* é definido para instruir o agente sobre como se comportar (ex: verificar urgência).
Dessa forma, você combina o gatilho de um chat com a inteligência, memória e capacidade de ação de um agente de IA.
Explorando Templates
Na plataforma N8N (hospedada), a seção de templates de IA oferece diversos casos de uso para inspiração. Ao explorar qualquer template, você pode ver como ele foi construído, com os nós interconectados, modelos de IA utilizados e notas explicativas. Isso é excelente para entender a complexidade que pode ser alcançada, desde fluxos simples até automações avançadas.
A combinação do N8N com um VPS acessível, como o da Hostinger, permite criar um sistema de automação poderoso e privado, dando-lhe controle total sobre suas operações baseadas em agentes de IA.
