Mapa completo, lições saindo em ordem

Pare de copiar template. Monte fluxos que aguentam segunda-feira.

Uma referência em português para montar, operar e governar automações e agentes no n8n, com casos reais de um laboratório em produção.

Atualizado em 22/10/20266 de 46 lições escritasTrilha completa: 46 etapas · 24h15min

Seu progresso …

Só lição escrita conta. As que estão tracejadas no mapa ainda são só o roteiro.

Transparência: o mapa está inteiro, o texto não. Lição com borda cheia está pronta pra ler. Tracejada com Em breve ainda é só o roteiro.

1Orientação eprimeiro fluxo2Os nós queresolvem 80%3Código,credenciais e nós…4Fluxos que nãoquebram em…5IA dentro do fluxo6Agentes emprodução7Operação e escalaBoss final:automatize, meça e…

Toque num território pra ir até ele. Os apagados ainda não têm lição escrita. Card só sai quando o território inteiro estiver escrito e concluído.

Rota

Filtros

Terminou a trilha?

Recebe as próximas no Doug Drops, ou me chama pra aplicar isso no seu contexto.

Doug DropsCrie seu LAB

Eu posto o que testo por aqui:

Ver conteúdo completo da trilha (modo leitura)

n8n

Uma referência em português para montar, operar e governar automações e agentes no n8n, com casos reais de um laboratório em produção.

Mapa completo, lições saindo em ordem

6 de 46 lições escritas até agora. As outras aparecem com o roteiro do que vão cobrir.

Verificado em: 22/10/2026

Rotas de aprendizagem

  • Foco Leader: Para quem decide onde rodar, o que automatizar e como provar o resultado. · 19h estimadas · 37 etapas
  • Foco Builder: Para quem vai construir fluxos e agentes que resolvem dor real. · 23h estimadas · 43 etapas
  • Trilha completa: Todo o mapa, incluindo aprofundamentos e recursos em evolução. · 24h estimadas · 46 etapas
  • Foco Developer: Para quem vai instalar, operar e escalar o n8n com segurança. · 24h estimadas · 45 etapas
  • Rota essencial: O mínimo para colocar um fluxo confiável em produção. · 11h estimadas · 21 etapas

Antes de automatizar o mundo, automatize uma coisa.

Território 1: Orientação e primeiro fluxo

Entenda o que o n8n é, escolha onde rodar e monte o primeiro fluxo sabendo exatamente por onde o dado passa.

6 etapas · 2h 35min

O que é o n8n e onde ele ganha

Essencial20 minLição escrita

Automação visual com código quando precisa e IA nativa. Ganha quando o problema é ligar sistemas com regra clara.

Sem saber onde ele ganha, você usa n8n pra tudo, inclusive pro que uma planilha resolvia.

  • Distinguir workflow, nó, trigger e execução
  • Saber quando o n8n ganha de script, de no-code fechado e de agente
  • Reconhecer o degrau mais baixo que resolve
  • Ler um workflow pronto

Resultado: Ficha de decisão: n8n ou não

Prática

Escolha uma dor real e decida, com critério escrito, se ela é caso de n8n.

Entregável: Ficha de decisão: n8n ou não

✓ Prove que concluiu: Ficha de decisão: n8n ou não

  • O entregável “Ficha de decisão: n8n ou não” existe e pode ser verificado por outra pessoa.

Cloud ou self-hosted: onde rodar sem susto

Essencial25 minLição escrita

Plano, licença e o que conta como execução, antes de a conta ou o jurídico baterem na porta.

A escolha de hospedagem define custo, limite e o que você pode vender. Trocar depois dá trabalho.

  • Diferenciar Cloud, Community e edições pagas
  • Ler o que a licença Sustainable Use permite
  • Saber o que conta como execução
  • Somar o custo escondido do self-hosted

Resultado: Escolha de hospedagem justificada

Prática

Compare Cloud e self-hosted para um caso seu e registre a escolha.

Entregável: Escolha de hospedagem justificada

✓ Prove que concluiu: Escolha de hospedagem justificada

  • O entregável “Escolha de hospedagem justificada” existe e pode ser verificado por outra pessoa.

Seu primeiro workflow em 30 minutos

Essencial30 minLição escrita

Do Manual Trigger a um resultado que você consegue ler, sem copiar template.

Template pronto ensina a clicar. Montar do zero ensina a ler o que cada nó faz.

  • Criar um workflow do zero
  • Chamar uma API com HTTP Request
  • Ajustar campos com Edit Fields
  • Ler a saída de cada nó

Resultado: Primeiro workflow rodando

Prática

Monte um fluxo de três nós que consulta uma API pública e devolve só os campos úteis.

Entregável: Primeiro workflow rodando

✓ Prove que concluiu: Primeiro workflow rodando

  • O entregável “Primeiro workflow rodando” existe e pode ser verificado por outra pessoa.

Como o dado anda: itens, json e binário

Essencial25 minLição escrita

Tudo que passa entre nós é uma lista de itens. Entender isso evita metade dos bugs.

Quem não entende item acha que o n8n está repetindo coisa à toa. Ele está fazendo exatamente o que você pediu.

  • Ler a estrutura de itens com json e binary
  • Saber que cada nó roda uma vez por item
  • Usar as visões Table, JSON e Schema
  • Rastrear de onde veio cada item

Resultado: Mapa dos itens de um fluxo

Prática

Pegue um fluxo seu e anote quantos itens entram e saem de cada nó.

Entregável: Mapa dos itens de um fluxo

✓ Prove que concluiu: Mapa dos itens de um fluxo

  • O entregável “Mapa dos itens de um fluxo” existe e pode ser verificado por outra pessoa.

Expressões: $json, $(’Nó’) e datas

Essencial30 minLição escrita

O lugar onde o fluxo para de ser fixo e passa a pensar com o dado que chegou.

Sem expressão, cada fluxo vira cópia de outro com um valor trocado na mão.

  • Escrever expressões nos campos
  • Usar $json, $input e $(’Nome do nó’)
  • Formatar e somar datas com Luxon
  • Reconhecer os erros mais comuns

Resultado: Cola de expressões testadas

Prática

Monte cinco expressões úteis no seu fluxo e teste cada uma com dado real.

Entregável: Cola de expressões testadas

✓ Prove que concluiu: Cola de expressões testadas

  • O entregável “Cola de expressões testadas” existe e pode ser verificado por outra pessoa.

Testar com dados fixos e publicar

Essencial25 minLição escrita

Rascunho, pin data e Publish: o caminho entre funcionar no editor e funcionar às 3 da manhã.

Funcionar no editor não prova nada. Produção tem outro gatilho, outro dado e ninguém olhando.

  • Diferenciar execução manual e de produção
  • Fixar dados de teste com pin data
  • Publicar e despublicar na 2.0
  • Restaurar uma versão anterior

Resultado: Checklist de publicação

Prática

Publique o seu primeiro fluxo seguindo um checklist e confira a primeira execução de produção.

Entregável: Checklist de publicação

✓ Prove que concluiu: Checklist de publicação

  • O entregável “Checklist de publicação” existe e pode ser verificado por outra pessoa.

Uma dúzia de nós faz quase tudo. O resto é variação.

Território 2: Os nós que resolvem 80%

Gatilho, API, transformação, decisão e lote: o repertório que aparece em praticamente todo fluxo de verdade.

6 etapas · 2h 55min

Webhook e resposta: receber dados de fora

Essencial30 minEm breve (ainda não escrita; abaixo, o roteiro)

URL de teste, URL de produção e quem responde o quê. O webhook é a porta de entrada da maioria dos fluxos.

Webhook mal configurado responde 200 pra tudo e esconde o erro de quem chamou.

  • Usar a URL de teste e a de produção
  • Escolher quando e como responder
  • Usar o Respond to Webhook
  • Proteger o webhook com autenticação

Resultado: Webhook com resposta testada

Prática

Crie um webhook que recebe um formulário e responde com sucesso ou erro claro.

Entregável: Webhook com resposta testada

✓ Prove que concluiu: Webhook com resposta testada

  • O entregável “Webhook com resposta testada” existe e pode ser verificado por outra pessoa.

Agendar e disparar: Schedule e gatilhos de app

20 minEm breve (ainda não escrita; abaixo, o roteiro)

Rodar todo dia às 8h parece simples até o fuso horário entrar na conversa.

Fluxo agendado no fuso errado roda na hora certa de outro país.

  • Configurar o Schedule Trigger
  • Acertar o fuso do workflow
  • Usar gatilhos de aplicativos
  • Entender o que conta como execução

Resultado: Fluxo agendado no fuso certo

Prática

Agende um relatório diário e confirme o horário da primeira execução.

Entregável: Fluxo agendado no fuso certo

✓ Prove que concluiu: Fluxo agendado no fuso certo

  • O entregável “Fluxo agendado no fuso certo” existe e pode ser verificado por outra pessoa.

HTTP Request: falar com qualquer API

Essencial35 minEm breve (ainda não escrita; abaixo, o roteiro)

Se tem API, o n8n conversa. Importar cURL, autenticar e paginar é o que separa o teste do uso real.

Metade das integrações que você precisa não tem nó pronto. O HTTP Request é o nó coringa.

  • Importar uma chamada de cURL
  • Autenticar com credencial
  • Paginar resultados
  • Controlar lote e intervalo

Resultado: Integração com API paginada

Prática

Busque todos os registros de uma API paginada sem estourar limite.

Entregável: Integração com API paginada

✓ Prove que concluiu: Integração com API paginada

  • O entregável “Integração com API paginada” existe e pode ser verificado por outra pessoa.

Recursos

Transformar dados: Edit Fields, Split Out, Aggregate e Merge

Essencial35 minEm breve (ainda não escrita; abaixo, o roteiro)

Separar, juntar e renomear. O trabalho braçal de todo fluxo, feito sem uma linha de código.

Código para mudar nome de campo é o começo de um fluxo que só uma pessoa entende.

  • Montar a saída com Edit Fields
  • Quebrar e juntar listas
  • Combinar duas fontes com Merge
  • Evitar duplicar itens sem querer

Resultado: Saída limpa de duas fontes

Prática

Combine dados de duas origens num único resultado sem duplicidade.

Entregável: Saída limpa de duas fontes

✓ Prove que concluiu: Saída limpa de duas fontes

  • O entregável “Saída limpa de duas fontes” existe e pode ser verificado por outra pessoa.

Decidir o caminho: If, Switch e Filter

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Regra explícita no fluxo, em vez de regra escondida na cabeça de quem opera.

Toda automação útil tem uma regra de quando não fazer. Ela mora aqui.

  • Usar o If com condições tipadas
  • Rotear com o Switch
  • Ter uma saída para o caso imprevisto
  • Filtrar itens sem quebrar o fluxo

Resultado: Fluxo com regra de escalonamento

Prática

Escreva uma regra que manda casos fora do padrão para revisão humana.

Entregável: Fluxo com regra de escalonamento

✓ Prove que concluiu: Fluxo com regra de escalonamento

  • O entregável “Fluxo com regra de escalonamento” existe e pode ser verificado por outra pessoa.

Recursos

Listas, lotes e espera

30 minEm breve (ainda não escrita; abaixo, o roteiro)

Quando processar item a item, quando em lote e como esperar sem travar o servidor.

API externa tem limite. Fluxo que ignora isso funciona no teste e é bloqueado na primeira segunda-feira.

  • Saber quando o Loop Over Items é necessário
  • Processar em lotes
  • Esperar com o Wait
  • Respeitar limite de API

Resultado: Processamento em lote sem bloqueio

Prática

Processe uma lista grande respeitando o limite da API de destino.

Entregável: Processamento em lote sem bloqueio

✓ Prove que concluiu: Processamento em lote sem bloqueio

  • O entregável “Processamento em lote sem bloqueio” existe e pode ser verificado por outra pessoa.

Recursos

O visual resolve quase tudo. O quase mora aqui.

Território 3: Código, credenciais e nós da comunidade

Código quando o visual não alcança, credenciais guardadas do jeito certo e nós da comunidade sem abrir a porta do servidor.

5 etapas · 2h 50min

Code node em JavaScript

35 minEm breve (ainda não escrita; abaixo, o roteiro)

Os dois modos do Code node, o formato que ele espera de volta e quando vale escrever código.

Código bom no n8n é curto, testado e substituível. Código longo vira o sistema legado do fluxo.

  • Escolher entre rodar uma vez ou por item
  • Devolver itens no formato certo
  • Saber o que o Code node não acessa
  • Decidir entre código e nó pronto

Resultado: Transformação em código testada

Prática

Resolva uma transformação que o Edit Fields não alcança e compare com a versão visual.

Entregável: Transformação em código testada

✓ Prove que concluiu: Transformação em código testada

  • O entregável “Transformação em código testada” existe e pode ser verificado por outra pessoa.

Code node em Python com task runners

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Desde a 2.0, Python roda nativo em task runner. Muda a sintaxe, muda a instalação.

Tutorial antigo de Python no n8n ensina uma sintaxe que não existe mais.

  • Entender o Python nativo da 2.0
  • Configurar o task runner externo
  • Ler os itens com a sintaxe atual
  • Saber os limites de bibliotecas

Resultado: Script Python rodando no runner

Prática

Rode uma transformação em Python no runner externo.

Entregável: Script Python rodando no runner

✓ Prove que concluiu: Script Python rodando no runner

  • O entregável “Script Python rodando no runner” existe e pode ser verificado por outra pessoa.

Credenciais e OAuth sem vazar segredo

Essencial25 minEm breve (ainda não escrita; abaixo, o roteiro)

Onde a credencial mora, quem pode usar e por que a chave de criptografia é o item mais importante do backup.

Credencial colada em campo de texto vira segredo no histórico de execução.

  • Criar e compartilhar credenciais
  • Entender a N8N_ENCRYPTION_KEY
  • Usar OAuth sem susto
  • Não colocar segredo em expressão

Resultado: Inventário de credenciais

Prática

Liste as credenciais de uma instância com dono, escopo e onde são usadas.

Entregável: Inventário de credenciais

✓ Prove que concluiu: Inventário de credenciais

  • O entregável “Inventário de credenciais” existe e pode ser verificado por outra pessoa.

Nós da comunidade: instalar e avaliar o risco

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Verificado, não verificado e o que significa dar acesso total à máquina para um pacote de terceiro.

Nó da comunidade roda com acesso à máquina inteira. Instalar é decisão de segurança, não de conveniência.

  • Instalar pelo painel ou por npm
  • Diferenciar verificado e não verificado
  • Avaliar um pacote antes de instalar
  • Desligar pacotes por política

Resultado: Avaliação de um nó da comunidade

Prática

Avalie um nó da comunidade com critério antes de instalar.

Entregável: Avaliação de um nó da comunidade

✓ Prove que concluiu: Avaliação de um nó da comunidade

  • O entregável “Avaliação de um nó da comunidade” existe e pode ser verificado por outra pessoa.

Do problema ao npm: criar o seu nó

60 minEm breve (ainda não escrita; abaixo, o roteiro)

Quando o mesmo HTTP Request aparece em dez fluxos, é hora de virar nó. O CNPJ Hub nasceu assim.

Nó próprio padroniza o que hoje cada fluxo faz de um jeito diferente.

  • Reconhecer quando vale criar um nó
  • Estruturar um pacote de nó
  • Publicar no npm
  • Manter e versionar

Resultado: Nó publicado ou plano de nó

Prática

Desenhe o nó que resolveria uma repetição sua, com entradas e saídas.

Entregável: Nó publicado ou plano de nó

✓ Prove que concluiu: Nó publicado ou plano de nó

  • O entregável “Nó publicado ou plano de nó” existe e pode ser verificado por outra pessoa.

Erro que derruba é barato. Caro é o que não derruba nada.

Território 4: Fluxos que não quebram em silêncio

Tratamento de erro, retentativa, duplicidade, sub-workflows e trilha de auditoria: o que separa automação de gambiarra com agenda.

6 etapas · 2h 45min

Error workflow: saber antes do usuário

Essencial30 minEm breve (ainda não escrita; abaixo, o roteiro)

Um fluxo de erro que avisa no canal certo, com o link da execução, antes de alguém reclamar.

Sem error workflow, a primeira notícia do erro é o usuário perguntando por que não chegou.

  • Criar um error workflow
  • Ligar o error workflow em cada fluxo
  • Montar um alerta útil
  • Entender quando ele não dispara

Resultado: Alerta de erro funcionando

Prática

Force um erro em produção e confirme que o alerta chega com o link da execução.

Entregável: Alerta de erro funcionando

✓ Prove que concluiu: Alerta de erro funcionando

  • O entregável “Alerta de erro funcionando” existe e pode ser verificado por outra pessoa.

Recursos

Retentar, continuar ou parar

Essencial25 minEm breve (ainda não escrita; abaixo, o roteiro)

Retry On Fail, saída de erro e Stop and Error: cada falha pede uma reação diferente.

Retentar tudo esconde problema. Parar tudo derruba o que dava para salvar.

  • Configurar Retry On Fail
  • Usar a saída de erro do nó
  • Forçar falha com Stop and Error
  • Escolher a reação por tipo de falha

Resultado: Tabela de reação a falhas

Prática

Classifique as falhas possíveis de um fluxo e configure a reação de cada uma.

Entregável: Tabela de reação a falhas

✓ Prove que concluiu: Tabela de reação a falhas

  • O entregável “Tabela de reação a falhas” existe e pode ser verificado por outra pessoa.

Recursos

Duplicidade: rodar duas vezes sem estrago

30 minEm breve (ainda não escrita; abaixo, o roteiro)

Webhook chega duas vezes, alguém reprocessa à mão, o agendamento atrasa. O fluxo precisa aguentar.

Mensagem duplicada para cliente é o erro que mais rápido vira print no grupo.

  • Identificar onde duplicidade acontece
  • Usar uma chave única por evento
  • Registrar o que já foi processado
  • Reprocessar com segurança

Resultado: Fluxo que aguenta reprocessamento

Prática

Rode o mesmo evento duas vezes e prove que só um efeito aconteceu.

Entregável: Fluxo que aguenta reprocessamento

✓ Prove que concluiu: Fluxo que aguenta reprocessamento

  • O entregável “Fluxo que aguenta reprocessamento” existe e pode ser verificado por outra pessoa.

Sub-workflows: um motor, vários fluxos

30 minEm breve (ainda não escrita; abaixo, o roteiro)

O padrão do agente de avaliações do laboratório: um fluxo por canal e um motor compartilhado.

Sem sub-workflow, a mesma regra vive copiada em cinco lugares e cada cópia envelhece de um jeito.

  • Criar um sub-workflow com entrada definida
  • Chamar e esperar o resultado
  • Separar canal e motor
  • Saber o que mudou na 2.0

Resultado: Motor compartilhado em uso

Prática

Extraia a lógica comum de dois fluxos para um sub-workflow.

Entregável: Motor compartilhado em uso

✓ Prove que concluiu: Motor compartilhado em uso

  • O entregável “Motor compartilhado em uso” existe e pode ser verificado por outra pessoa.

Clonar sem dívida

25 minEm breve (ainda não escrita; abaixo, o roteiro)

O post-mortem do clone que postou no canal errado e a lista de revisão que todo clone passou a ter.

Clonar é rápido. O que não muda no clone é o que vai dar errado em silêncio.

  • Listar o que muda de um clone para o outro
  • Usar variáveis em vez de valor fixo
  • Revisar a borda do fluxo
  • Auditar clones antigos

Resultado: Lista de revisão de clone

Prática

Monte a lista de revisão para clonar um fluxo seu e aplique num clone.

Entregável: Lista de revisão de clone

✓ Prove que concluiu: Lista de revisão de clone

  • O entregável “Lista de revisão de clone” existe e pode ser verificado por outra pessoa.

Trilha de auditoria: quem fez o quê e quando

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Registro por execução que responde a pergunta do jurídico sem arqueologia.

Fluxo que toca dado de pessoa sem registro é passivo esperando acontecer.

  • Decidir o que registrar
  • Gravar o registro em data table ou banco
  • Não guardar dado sensível sem motivo
  • Consultar o registro depois

Resultado: Registro de auditoria consultável

Prática

Adicione registro de auditoria a um fluxo e responda uma pergunta com ele.

Entregável: Registro de auditoria consultável

✓ Prove que concluiu: Registro de auditoria consultável

  • O entregável “Registro de auditoria consultável” existe e pode ser verificado por outra pessoa.

Nem todo fluxo precisa de agente. Quase todo fluxo aguenta um LLM bem colocado.

Território 5: IA dentro do fluxo

Do LLM com saída estruturada ao agente com tools, passando por RAG e guardrails, sempre no degrau mais baixo que resolve.

7 etapas · 3h 30min

O degrau certo: fluxo, IA pontual ou agente

Essencial20 minEm breve (ainda não escrita; abaixo, o roteiro)

A consulta de candidato é fluxo com IA pontual, o agente de avaliações é agente. A diferença está no problema.

Agente onde regra resolve é imprevisibilidade cara. Regra onde só texto livre resolve é retrabalho.

  • Usar a escada de autonomia
  • Separar regra de julgamento
  • Saber o custo de cada degrau
  • Defender a escolha

Resultado: Ficha de degrau

Prática

Classifique três dores suas na escada e justifique o degrau de cada uma.

Entregável: Ficha de degrau

✓ Prove que concluiu: Ficha de degrau

  • O entregável “Ficha de degrau” existe e pode ser verificado por outra pessoa.

LLM com saída estruturada

Essencial30 minEm breve (ainda não escrita; abaixo, o roteiro)

Basic LLM Chain com Structured Output Parser: texto livre entra, JSON confiável sai.

Resposta em texto solto não alimenta o próximo nó. JSON com esquema alimenta.

  • Usar uma chain básica
  • Definir um esquema de saída
  • Tratar resposta fora do esquema
  • Escolher o modelo pelo custo

Resultado: Extração estruturada testada

Prática

Extraia campos de um texto real com esquema e teste com dez exemplos.

Entregável: Extração estruturada testada

✓ Prove que concluiu: Extração estruturada testada

  • O entregável “Extração estruturada testada” existe e pode ser verificado por outra pessoa.

Classificar e rotear com IA

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Sentimento, intenção e confiança decidem o caminho. Com baixa confiança, quem decide é gente.

Classificação sem limite de confiança manda o caso estranho para o caminho errado com toda a convicção.

  • Classificar texto em categorias fixas
  • Usar confiança como critério
  • Rotear para humano no caso duvidoso
  • Medir acerto da classificação

Resultado: Classificador com rota de escape

Prática

Classifique um lote real e mande os de baixa confiança para revisão.

Entregável: Classificador com rota de escape

✓ Prove que concluiu: Classificador com rota de escape

  • O entregável “Classificador com rota de escape” existe e pode ser verificado por outra pessoa.

O nó AI Agent

Essencial35 minEm breve (ainda não escrita; abaixo, o roteiro)

Modelo, tools, memória e instruções: o que cada peça faz e quando o agente vale o custo.

Agente sem limite de iteração e sem tool bem descrita gasta token decidindo o que fazer.

  • Montar um agente com modelo e tools
  • Escrever instruções que limitam
  • Descrever bem cada tool
  • Ler o log do agente

Resultado: Agente com duas tools

Prática

Monte um agente com duas tools e analise o log de três conversas.

Entregável: Agente com duas tools

✓ Prove que concluiu: Agente com duas tools

  • O entregável “Agente com duas tools” existe e pode ser verificado por outra pessoa.

Memória e tools sem bagunça

30 minEm breve (ainda não escrita; abaixo, o roteiro)

Memória simples, Redis ou Postgres, e tools que são workflows. O agente lembra só do que precisa.

Memória demais vira contexto caro. Memória de menos vira usuário repetindo tudo.

  • Escolher o tipo de memória
  • Usar um workflow como tool
  • Preencher parâmetros com $fromAI
  • Limitar o que a tool pode fazer

Resultado: Agente com memória e tool própria

Prática

Dê memória ao seu agente e uma tool que é um sub-workflow seu.

Entregável: Agente com memória e tool própria

✓ Prove que concluiu: Agente com memória e tool própria

  • O entregável “Agente com memória e tool própria” existe e pode ser verificado por outra pessoa.

RAG: responder com os seus documentos

40 minEm breve (ainda não escrita; abaixo, o roteiro)

Carregar, quebrar, gerar embedding e buscar. E por que o Simple Vector Store é só para teste.

RAG mal montado responde com confiança usando o trecho errado do documento certo.

  • Montar ingestão de documentos
  • Escolher o vector store
  • Ligar a busca ao agente
  • Testar com perguntas difíceis

Resultado: Base de conhecimento consultável

Prática

Monte um RAG com documentos reais e teste com dez perguntas.

Entregável: Base de conhecimento consultável

✓ Prove que concluiu: Base de conhecimento consultável

  • O entregável “Base de conhecimento consultável” existe e pode ser verificado por outra pessoa.

Recursos

Guardrails e prompt injection

Essencial30 minEm breve (ainda não escrita; abaixo, o roteiro)

Texto que vem de fora é dado não confiável. O nó Guardrails e a regra de desviar para humano.

Agente que publica sem guardrail é um megafone para quem souber escrever a frase certa.

  • Tratar entrada externa como não confiável
  • Usar o nó Guardrails
  • Desviar violação para humano
  • Testar ataques conhecidos

Resultado: Guardrail testado com ataques

Prática

Coloque guardrails num fluxo de IA e teste com cinco tentativas de ataque.

Entregável: Guardrail testado com ataques

✓ Prove que concluiu: Guardrail testado com ataques

  • O entregável “Guardrail testado com ataques” existe e pode ser verificado por outra pessoa.

O agente funcionou na demo. Agora ele precisa funcionar na terça.

Território 6: Agentes em produção

Orquestração, aprovação humana, MCP, avaliação e custo por execução: o que um agente precisa para ganhar autonomia.

6 etapas · 3h 5min

Multiagente com orquestrador e revisor

40 minEm breve (ainda não escrita; abaixo, o roteiro)

Guardrails, orquestrador, especialistas e revisor: a anatomia do agente de avaliações do laboratório.

Um agente que faz tudo erra de jeitos difíceis de achar. Vários pequenos erram de jeitos que dá para medir.

  • Separar orquestrador e especialistas
  • Colocar um revisor antes da saída
  • Definir a fronteira da autonomia
  • Medir cada etapa

Resultado: Desenho de multiagente

Prática

Desenhe um sistema multiagente para uma dor sua, com pontos de controle.

Entregável: Desenho de multiagente

✓ Prove que concluiu: Desenho de multiagente

  • O entregável “Desenho de multiagente” existe e pode ser verificado por outra pessoa.

Aprovação humana antes da ação

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Pausar a tool até alguém aprovar no Slack, no Teams ou no chat. Autonomia com freio de mão.

Ação irreversível para fora sem confirmação humana é aposta, não automação.

  • Configurar aprovação humana em tools
  • Escolher o canal de aprovação
  • Tratar a negativa
  • Decidir o que exige aprovação

Resultado: Tool com aprovação humana

Prática

Coloque aprovação humana numa tool de efeito externo e teste aprovar e negar.

Entregável: Tool com aprovação humana

✓ Prove que concluiu: Tool com aprovação humana

  • O entregável “Tool com aprovação humana” existe e pode ser verificado por outra pessoa.

MCP: o n8n como servidor e como cliente

35 minEm breve (ainda não escrita; abaixo, o roteiro)

Expor workflows como tools para outros agentes e usar servidores MCP dentro do seu agente.

MCP transforma fluxo pronto em ferramenta reutilizável por qualquer agente compatível.

  • Expor tools com o MCP Server Trigger
  • Usar o MCP Client Tool
  • Conectar o MCP server da instância
  • Proteger o acesso

Resultado: Workflow exposto via MCP

Prática

Exponha um workflow como tool MCP e chame de um cliente externo.

Entregável: Workflow exposto via MCP

✓ Prove que concluiu: Workflow exposto via MCP

  • O entregável “Workflow exposto via MCP” existe e pode ser verificado por outra pessoa.

Avaliar antes de confiar

35 minEm breve (ainda não escrita; abaixo, o roteiro)

Evaluations no n8n: conjunto de casos, métricas e comparação antes de trocar prompt ou modelo.

Trocar o prompt sem avaliação é melhorar um caso e quebrar outros três sem saber.

  • Montar um conjunto de casos de teste
  • Usar o Evaluation Trigger
  • Escolher métricas
  • Comparar versões

Resultado: Avaliação com conjunto de casos

Prática

Monte uma avaliação com vinte casos e compare duas versões de prompt.

Entregável: Avaliação com conjunto de casos

✓ Prove que concluiu: Avaliação com conjunto de casos

  • O entregável “Avaliação com conjunto de casos” existe e pode ser verificado por outra pessoa.

Custo por execução

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Tokens, modelo, cache e volume. O agente de avaliações custa cerca de US$ 0,15 por dia porque alguém mediu.

Custo de IA não medido vira surpresa no fim do mês ou desculpa para desligar o que funcionava.

  • Estimar tokens por execução
  • Escolher modelo pelo trabalho
  • Usar cache quando cabe
  • Registrar custo por solução

Resultado: Planilha de custo por execução

Prática

Meça o custo de cem execuções de um fluxo de IA.

Entregável: Planilha de custo por execução

✓ Prove que concluiu: Planilha de custo por execução

  • O entregável “Planilha de custo por execução” existe e pode ser verificado por outra pessoa.

Construir com o Assistant e o Workflow Builder

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Pedir o fluxo em linguagem natural ajuda a começar. Revisar o que ele montou continua sendo seu trabalho.

Fluxo gerado que ninguém leu é fluxo que ninguém sabe consertar.

  • Gerar um fluxo em linguagem natural
  • Revisar o que foi gerado
  • Saber o custo em créditos
  • Construir com agente de código via MCP

Resultado: Fluxo gerado e revisado

Prática

Gere um fluxo com o Assistant e documente o que você precisou corrigir.

Entregável: Fluxo gerado e revisado

✓ Prove que concluiu: Fluxo gerado e revisado

  • O entregável “Fluxo gerado e revisado” existe e pode ser verificado por outra pessoa.

Self-hosted é grátis do mesmo jeito que cachorro é grátis.

Território 7: Operação e escala

Instalação de produção, fila com workers, retenção, segurança, ambientes e a métrica que a diretoria entende.

6 etapas · 3h 20min

Self-hosted de produção: Docker e Postgres

45 minEm breve (ainda não escrita; abaixo, o roteiro)

Docker Compose, Postgres, chave de criptografia persistida e URL pública certa. O mínimo para dormir tranquilo.

Instância sem backup da chave de criptografia perde todas as credenciais na primeira reinstalação.

  • Subir com Docker Compose
  • Usar Postgres no lugar do SQLite
  • Persistir a pasta .n8n e a chave
  • Configurar URL e proxy

Resultado: Instância de produção documentada

Prática

Suba uma instância com Postgres e escreva o runbook de restauração.

Entregável: Instância de produção documentada

✓ Prove que concluiu: Instância de produção documentada

  • O entregável “Instância de produção documentada” existe e pode ser verificado por outra pessoa.

Queue mode e workers

40 minEm breve (ainda não escrita; abaixo, o roteiro)

Redis, workers e webhook processors: quando uma instância só não dá mais conta.

Escalar cedo demais é custo. Tarde demais é fila de execução travada em dia de pico.

  • Entender main, worker e Redis
  • Configurar o queue mode
  • Dimensionar a concorrência
  • Saber os limites do modo

Resultado: Instância em queue mode

Prática

Suba uma instância com dois workers e prove a distribuição.

Entregável: Instância em queue mode

✓ Prove que concluiu: Instância em queue mode

  • O entregável “Instância em queue mode” existe e pode ser verificado por outra pessoa.

Execuções, retenção e logs

25 minEm breve (ainda não escrita; abaixo, o roteiro)

Quanto guardar, por quanto tempo e onde olhar quando algo deu errado ontem às 3h.

Sem política de retenção, o banco cresce até o dia em que a instância para.

  • Configurar a retenção de execuções
  • Escolher o que salvar
  • Ler os logs da instância
  • Achar uma execução antiga

Resultado: Política de retenção escrita

Prática

Defina e aplique a política de retenção da sua instância.

Entregável: Política de retenção escrita

✓ Prove que concluiu: Política de retenção escrita

  • O entregável “Política de retenção escrita” existe e pode ser verificado por outra pessoa.

Segurança e atualizações

Essencial35 minEm breve (ainda não escrita; abaixo, o roteiro)

Hardening, auditoria de segurança e atualização em dia. Teve falha crítica explorada de verdade em 2026.

Instância exposta e desatualizada é servidor de outra pessoa.

  • Aplicar o hardening recomendado
  • Rodar a auditoria de segurança
  • Acompanhar avisos de segurança
  • Atualizar sem quebrar

Resultado: Checklist de segurança aplicado

Prática

Rode a auditoria na sua instância e corrija os achados.

Entregável: Checklist de segurança aplicado

✓ Prove que concluiu: Checklist de segurança aplicado

  • O entregável “Checklist de segurança aplicado” existe e pode ser verificado por outra pessoa.

Ambientes, projetos e controle de versão

30 minEm breve (ainda não escrita; abaixo, o roteiro)

Projetos, permissões, variáveis e Git. O que é grátis, o que exige licença e quando vale pagar.

Editar direto em produção funciona até o dia em que alguém salva a versão errada.

  • Organizar workflows em projetos
  • Definir papéis e permissões
  • Usar source control e ambientes
  • Saber o que cada plano libera

Resultado: Desenho de ambientes e acesso

Prática

Desenhe como o seu time vai separar desenvolvimento e produção.

Entregável: Desenho de ambientes e acesso

✓ Prove que concluiu: Desenho de ambientes e acesso

  • O entregável “Desenho de ambientes e acesso” existe e pode ser verificado por outra pessoa.

Insights e horas economizadas

25 minEm breve (ainda não escrita; abaixo, o roteiro)

O n8n conta tempo economizado se você disser quanto cada execução economiza. A conta honesta é sua.

Número de horas sem método é o primeiro a cair na reunião de diretoria.

  • Configurar o tempo economizado por fluxo
  • Ler o painel de Insights
  • Fazer a conta conservadora
  • Conferir o número fora da ferramenta

Resultado: Painel de horas com método

Prática

Configure o tempo economizado de três fluxos e confira a conta por fora.

Entregável: Painel de horas com método

✓ Prove que concluiu: Painel de horas com método

  • O entregável “Painel de horas com método” existe e pode ser verificado por outra pessoa.

A trilha termina quando uma dor real deixa de existir.

Boss final: automatize, meça e prove

Um fluxo em produção resolvendo uma dor de verdade, com número antes e depois, post-mortem e pacote de evidências.

4 etapas · 3h 15min

Automatize uma dor real

Essencial90 minEm breve (ainda não escrita; abaixo, o roteiro)

Escolha uma dor com dono, número e frequência. Construa no degrau mais baixo que resolve e coloque em produção.

Fluxo de exemplo ensina. Fluxo que alguém usa na segunda-feira prova.

  • Escolher uma dor com dono e número
  • Construir no degrau certo
  • Colocar em produção com error workflow
  • Acompanhar as primeiras semanas

Resultado: Fluxo em produção

Prática

Coloque em produção um fluxo que resolve uma dor real com dono.

Entregável: Fluxo em produção

✓ Prove que concluiu: Fluxo em produção

  • O entregável “Fluxo em produção” existe e pode ser verificado por outra pessoa.

Meça o ROI com a conta conservadora

Essencial45 minEm breve (ainda não escrita; abaixo, o roteiro)

Volume, tempo por item, custo completo e corte de 50%. O número que aguenta qualquer reunião.

ROI otimista descoberto uma vez contamina todos os números seguintes.

  • Medir antes e depois
  • Somar o custo completo
  • Aplicar o corte conservador
  • Apresentar em uma página

Resultado: Argumento de ROI em uma página

Prática

Calcule o ROI do seu fluxo com o Kit ROI.

Entregável: Argumento de ROI em uma página

✓ Prove que concluiu: Argumento de ROI em uma página

  • O entregável “Argumento de ROI em uma página” existe e pode ser verificado por outra pessoa.

Escreva o post-mortem

Essencial30 minEm breve (ainda não escrita; abaixo, o roteiro)

O que deu errado, por que demorou para perceber e o que muda. Sem culpa, com dono e data.

Caso que só mostra o lado bonito não ajuda quem vai errar amanhã.

  • Montar a linha do tempo
  • Achar a causa de processo
  • Registrar por que demorou para perceber
  • Definir ações com dono e data

Resultado: Post-mortem publicado

Prática

Escreva o post-mortem do primeiro problema do seu fluxo.

Entregável: Post-mortem publicado

✓ Prove que concluiu: Post-mortem publicado

  • O entregável “Post-mortem publicado” existe e pode ser verificado por outra pessoa.

Pacote de evidências

Essencial30 minEm breve (ainda não escrita; abaixo, o roteiro)

Fluxo, números, post-mortem e decisões num pacote que outra pessoa consegue conferir.

Sem evidência, a automação vira opinião de quem construiu.

  • Juntar fluxo, números e decisões
  • Documentar como operar
  • Registrar o critério de morte
  • Entregar para outra pessoa conferir

Resultado: Evidence pack

Prática

Monte o pacote de evidências e peça para alguém de fora conferir.

Entregável: Evidence pack

✓ Prove que concluiu: Evidence pack

  • O entregável “Evidence pack” existe e pode ser verificado por outra pessoa.

Etapas finais

1 etapas · 0 min

Quer levar automação para um time inteiro?

A trilha cria repertório. A implantação adapta dor, degrau, segurança, governança e métrica ao ambiente real.

O mesmo fluxo não serve para toda empresa, risco ou estágio de adoção.

Resultado: Próximo passo

Prática

Conheça as formas de trabalhar comigo.

Entregável: Próximo passo

Recursos

Todos os recursos da trilha