Pular para o conteúdo
cortexia
Newsletter
Agentes

Como usar n8n com IA passo a passo: tutorial 2026

V. Santos 13 jun 2026 · 9 min de leitura
Homem em hoodie rosa fixando pequenos cartões em um quadro de cortiça e ligando com fios coloridos, criando um diagrama de fluxo estilo detetive; ao lado, um notebook aberto com o equivalente digital. Ideal para como usar n8n.

Como Usar n8n com IA Passo a Passo: do Setup ao Primeiro Agente Rodando

Aprender como usar n8n com IA passo a passo em 2026 é o caminho mais barato para ter um agente IA em produção sem virar engenheiro de software. Em 1 hora você sobe o n8n via Docker (local ou na Hostinger por R$ 32/mês), monta o primeiro workflow, adiciona o AI Agent node rodando GPT-4o-mini e dispara via webhook. Aqui o tutorial fim a fim, com comando Docker copiável, JSON do workflow exportável, prompt pronto e custo real em real.

Resposta rápida (Featured Snippet):

1. Instalar: Docker localmente OU VPS Hostinger (R$ 32/mês) com docker run de uma linha.

2. Acessar: abra localhost:5678, crie usuário admin.

3. Primeiro workflow: Trigger Manual → HTTP Request (teste “Hello world”).

4. AI Agent node: adicione, conecte OpenAI Chat Model, configure tools e system prompt.

5. Webhook: troque o trigger por Webhook e copie a URL.

6. Deploy: salve, ative o workflow, teste em produção.

O que é o n8n e por que usar com IA

O n8n é uma plataforma de automação de workflows fundada em 2019 por Jan Oberhauser em Berlim. License fair-code — você pode rodar grátis em servidor próprio para sempre. Em 2024 ganhou o AI Agent node que roda LangChain por baixo, transformou o produto na opção mais barata e flexível para construir agentes IA com canvas visual.

  • License: fair-code (Sustainable Use)
  • Self-host: grátis via Docker
  • Cloud: a partir de €20/mês (≈R$ 116) para 2.500 execuções
  • Catálogo: 500+ nodes nativos + HTTP Request universal
  • IA: AI Agent node aceita OpenAI, Anthropic Claude, Google Gemini, Mistral, Ollama local

Para entender quando faz sentido vs alternativas SaaS, vale ler o comparativo n8n vs Zapier.

Pré-requisitos

Antes de começar a usar o n8n com IA:

  • Local: Docker Desktop instalado (Windows/Mac/Linux).
  • VPS: conta em qualquer provedor (Hostinger, Locaweb, DigitalOcean). KVM 2 com 2GB RAM já roda confortável.
  • Conta OpenAI com US$ 5 de crédito (ou conta Anthropic se preferir Claude).
  • Tempo: ~1 hora do zero até webhook respondendo com IA.
  • Conhecimento: terminal básico, copiar comando, abrir browser. Sem código.

Cotação base: US$ 1 = R$ 5,40 (junho/2026).

Passo 1 — Instalar o n8n

Opção A: Docker local (para testar)

docker volume create n8n_data

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Abre http://localhost:5678 no browser, cria usuário admin (email + senha), pronto. O n8n está rodando local.

Opção B: VPS Hostinger (para produção)

  1. Contrata KVM 2 na Hostinger (R$ 32/mês com Ubuntu 24.04).
  2. SSH na VPS: ssh root@SEU_IP.
  3. Instala Docker: curl -fsSL https://get.docker.com | sh.
  4. Roda o mesmo comando do passo A, mudando porta para 80 se quiser sem porta na URL.
  5. Configura subdomínio (n8n.seudominio.com) apontando para o IP da VPS.
  6. Coloca Caddy ou Nginx na frente com SSL automático (Let’s Encrypt).

Custo total: R$ 32/mês da VPS + R$ 0 do n8n. Comparado a Zapier ou Make em escala, paga sozinho em 2 meses.

Passo 2 — Primeiro workflow (“Hello World”)

Antes de tocar em IA, vale entender o canvas. Dentro do n8n:

  1. Clica Add workflow.
  2. Adiciona node Manual Trigger (ícone “play”).
  3. Conecta a um node HTTP Request — método GET, URL https://api.github.com/zen.
  4. Clica Test workflow. Vê a frase aleatória do GitHub aparecer na saída.
  5. Salva como “Hello World”.

Pronto. Você acabou de usar o n8n. Agora a parte boa.

Passo 3 — Adicionar o AI Agent node

Cria novo workflow. Esse vai ser um agente que responde perguntas usando busca web.

Arquitetura do fluxo

[Manual Trigger]
       ↓
[AI Agent]
   ├─ Chat Model: OpenAI GPT-4o-mini
   └─ Tool: SerpAPI (busca web)
       ↓
[Output: resposta]

Configurar

  1. Adiciona node AI Agent (busca por “AI Agent” no painel lateral).
  2. Em Chat Model (conexão azul lateral), adiciona OpenAI Chat Model e cola sua API key. Modelo: gpt-4o-mini.
  3. Em Tool (conexão azul lateral), adiciona SerpAPI e cola key da Serper.dev (free 2.500 buscas/mês). Configura gl: br, hl: pt-br.
  4. No node AI Agent, em System Message, cola:
Você é um assistente de pesquisa. Sempre que precisar de informação atual ou específica, use a ferramenta de busca. Responda em português brasileiro, com no máximo 200 palavras, citando 2-3 fontes (URLs) ao final.
  1. Em Input, marca “Take from previous node” e usa expressão ={{ $json.pergunta || "Quais as tendências de IA em 2026?" }}.

Testar

Clica Test workflow. Em ~15 segundos vê a resposta com fontes citadas. Custo da execução: ≈US$ 0,003 (R$ 0,016).

Passo 4 — Disparar via Webhook

Pra deixar o agente útil de verdade, ele precisa ser disparado por outra coisa (formulário, API, automação externa). Troca o trigger:

  1. Apaga o Manual Trigger.
  2. Adiciona Webhook (HTTP Method: POST, Path: pergunta-ia).
  3. Salva. Copia a Production URL que aparece (formato: https://seu-n8n.com/webhook/pergunta-ia).
  4. Ativa o workflow no toggle do topo direito.
  5. Testa de fora:
curl -X POST https://seu-n8n.com/webhook/pergunta-ia \
  -H "Content-Type: application/json" \
  -d '{"pergunta": "Como criar um agente de IA do zero?"}'

Recebe JSON com a resposta. Pronto: você tem uma API de agente IA.

JSON exportável do workflow completo (importe via Workflows → Import from File):

{
  "name": "Agente Pesquisador via Webhook",
  "nodes": [
    {"name": "Webhook", "type": "n8n-nodes-base.webhook",
     "parameters": {"path": "pergunta-ia", "httpMethod": "POST"},
     "position": [200, 300]},
    {"name": "AI Agent", "type": "@n8n/n8n-nodes-langchain.agent",
     "parameters": {
       "agent": "openAiFunctionsAgent",
       "text": "={{ $json.body.pergunta }}",
       "options": {"systemMessage": "Você é um assistente de pesquisa. Use busca web, responda em PT-BR com até 200 palavras e cite 2-3 fontes."}
     },
     "position": [450, 300]},
    {"name": "OpenAI", "type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
     "parameters": {"model": "gpt-4o-mini"},
     "position": [400, 500]},
    {"name": "Serper", "type": "@n8n/n8n-nodes-langchain.toolSerpApi",
     "parameters": {"options": {"gl": "br", "hl": "pt-br"}},
     "position": [550, 500]}
  ],
  "connections": {
    "Webhook": {"main": [[{"node": "AI Agent", "type": "main", "index": 0}]]},
    "OpenAI": {"ai_languageModel": [[{"node": "AI Agent", "type": "ai_languageModel", "index": 0}]]},
    "Serper": {"ai_tool": [[{"node": "AI Agent", "type": "ai_tool", "index": 0}]]}
  }
}

Passo 5 — Deploy em produção

Checklist mínimo para o agente sobreviver no ar:

  • Variáveis de ambiente: mova as API keys do nó para Settings → Variables (não exponha em JSON exportado).
  • Auth no Webhook: adicione header X-Webhook-Token no Webhook node e valide com IF antes do AI Agent. Sem isso, qualquer um descobre a URL e queima seus tokens.
  • Rate limit: adicione node Wait ou use Cloudflare na frente para limitar 60 req/min.
  • Logging: habilita Save Successful Production Executions em Settings → Workflow.
  • Backup: exporta workflow como JSON e versiona no Git.
  • Monitoramento: configura Error Workflow que envia Slack quando o agente falha.

Custo real mensal

Para esse agente rodando 1.000 chamadas/mês:

Item Custo
VPS Hostinger KVM 2 R$ 32/mês
OpenAI GPT-4o-mini (~1.500 tokens/exec) ≈US$ 0,30 → R$ 1,62
Serper.dev (busca web) Free até 2.500
Total ≈R$ 34/mês

Comparativo: o mesmo no Zapier sairia ≈R$ 200/mês. No Make, ≈R$ 70/mês. Detalhe completo no comparativo Make vs n8n.

Erros comuns e como resolver

1. n8n não abre em localhost:5678 Porta 5678 ocupada. Troque para -p 8080:5678 e abra localhost:8080.

2. AI Agent dá “credential not found” Não conectou o Chat Model OU não colou a API key. Volte em Credentials e teste a conexão.

3. Agent retorna “Tool not found” ou ignora tool A tool não está conectada como tipo ai_tool no node. No canvas, a conexão precisa partir da bola azul “Tool” do node externo até a entrada “Tool” do AI Agent.

4. Custo da OpenAI estourando Verifique se o agente entrou em loop. Adicione Max Iterations: 5 nas opções do AI Agent.

5. Webhook retorna 404 mesmo com workflow ativo Você está usando a “Test URL” em vez da “Production URL”. Pegue a de produção (aparece após ativar).

6. n8n para de responder após algumas horas (em VPS) RAM da VPS pequena demais. Suba para KVM 4 (4GB RAM, R$ 65/mês) se você roda 5+ workflows simultâneos.

Próximos passos

Depois desse primeiro agente:

  1. Memória persistente: adicione node Postgres Chat Memory para o agente lembrar de conversas.
  2. Multi-agente: combine vários AI Agents num mesmo workflow (pesquisador → redator → revisor).
  3. Integrações reais: conecte com WhatsApp Business API (via Twilio ou Evolution), CRM (HubSpot, Pipedrive), Notion, Google Sheets.
  4. Schedule: troque webhook por Cron node para o agente rodar sozinho a cada X horas.

Veredicto do V. Santos

Rodo todos os agentes do CortexIA (este blog) no n8n self-hostado na Hostinger. R$ 32/mês de VPS + ≈R$ 10 de OpenAI cobrem 100% do que precisa para produzir, monitorar e atualizar artigos com IA. Já testei Make e Zapier para os mesmos cases — ficaram 5–10× mais caros em volume.

A única coisa que pode trancar quem está aprendendo como usar n8n com IA passo a passo é a curva inicial — entender que cada node tem entradas/saídas tipadas (main, ai_languageModel, ai_tool) leva umas 2 horas. Depois do quarto workflow, fica natural.

Recomendação direta: comece local com Docker. Quando entender o canvas e tiver um workflow rodando que importa para você, sobe pra VPS Hostinger. Não inverta a ordem — debugar n8n em VPS sem nunca ter rodado local é dor desnecessária.

FAQ

O que é n8n AI Agent? Node nativo do n8n (lançado em 2024) que roda LangChain por baixo. Permite criar agentes que decidem qual tool chamar entre os outros nodes do workflow.

n8n funciona com ChatGPT? Sim. Tem node nativo OpenAI Chat Model com suporte a GPT-4o, GPT-4o-mini, GPT-5 e modelos via API custom.

Como instalar n8n no Windows? Via Docker Desktop com o comando docker run -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n.

n8n self-host é grátis? Sim, para sempre. Você paga só a infra onde roda (VPS ≈R$ 32/mês ou Docker no seu PC).

Como integrar Claude no n8n? Em vez de adicionar OpenAI Chat Model como Chat Model do AI Agent, adicione Anthropic Chat Model e cole sua API key da Anthropic. Resto igual.

Quanto custa rodar n8n? Self-host: R$ 32/mês de VPS + custo da API de IA usada. Cloud: a partir de €20/mês (≈R$ 116) para 2.500 execuções.

Posso usar n8n no celular? A interface web funciona em mobile, mas não é otimizada. Use para checar execuções e logs — para editar workflow, use desktop.

Próximo passo: roda o docker run agora local, importa o JSON acima, cria conta na OpenAI e vê o agente respondendo em 30 minutos. Quando estiver pronto pra produção, contrata VPS na Hostinger e migra. Para aprofundar em frameworks de agente, veja o comparativo LangChain vs CrewAI vs AutoGen. Para integrar com WhatsApp depois, o artigo “Como criar agente de IA para WhatsApp” cobre o passo a passo (em breve).

Status: Entregue. Próximo: /revisor.

Leia também