n8n: construa fluxos de trabalho e agentes de IA com tela visual e código personalizado

Para quem é

• Para equipes que querem construir automação de fluxos de trabalho e agentes de IA em ambiente self-hosted: orquestrar processos em uma tela visual, escrever JavaScript ou Python nos nós quando necessário, importar pacotes npm e conectar modelos da OpenAI, Anthropic, Google ou de código aberto.
• Para usuários que desejam manter ao mesmo tempo a construção gráfica e a flexibilidade do código; segundo a descrição oficial, há mais de 400 integrações.
• Quando não é adequado: o n8n é distribuído como fair-code, sob a Sustainable Use License e a n8n Enterprise License, o que não é uma licença totalmente open source no sentido tradicional; se o seu caso de uso tem requisitos rígidos de licenciamento, verifique antes se os termos permitem.
• A recomendação oficial é executar via Docker; sem um ambiente Docker, a primeira tentativa será bloqueada. Os pré-requisitos oficiais de outras formas de execução não foram especificados nas evidências desta análise.

Primeira tentativa em 3 minutos

O caminho principal recomendado é o script de instalação do README oficial (requer Docker já instalado na máquina):

curl -fsSL https://get.n8n.io | sh

1. Pré-requisito: confirme que o Docker está instalado e funcionando.
2. Execute o script de instalação oficial acima.
3. Se quiser controlar manualmente a localização dos dados, a documentação oficial também descreve o método manual com Docker: primeiro crie o volume com docker volume create n8n_data, depois execute a imagem docker.n8n.io/n8nio/n8n conforme as instruções oficiais, mapeando a porta 5678, e abra http://localhost:5678 no navegador para acessar o editor. Atenção: isso é uma configuração de implantação local, que envolve criar um volume e executar um contêiner localmente, não é uma operação somente leitura; os parâmetros exatos e completos do docker run devem ser conferidos no README oficial.
4. Ver a interface do editor é o sinal de que a primeira tentativa foi bem-sucedida.

Na primeira vez, recomenda-se fazer apenas operações de baixo risco no editor: explorar a interface e ver as integrações e tipos de nós disponíveis. Antes de executar de fato ações que conectem serviços externos ou gravem dados, confirme o comportamento de cada nó, pois as evidências não incluem uma descrição da natureza de leitura/escrita dos nós.

Casos de uso

Caso 1: construir um fluxo de trabalho de IA. Crie um fluxo de trabalho na tela visual em http://localhost:5678, insira nós de código com JavaScript ou Python e conecte modelos da OpenAI, Anthropic, Google ou de código aberto. Resultado esperado: segundo a descrição oficial, a combinação de "construção visual + código personalizado" é suportada; a configuração de parâmetros de um nó de modelo específico não foi detalhada nas evidências desta análise — o limite que se pode confirmar é que a plataforma possui nativamente capacidades de IA e de conexão com esses modelos.

Caso 2: validação de implantação self-hosted. Crie o volume de dados com docker volume create n8n_data, execute a imagem seguindo os passos manuais de Docker do README oficial e acesse http://localhost:5678 para verificar que o editor funciona. Resultado esperado: o n8n roda no Docker local e o volume de dados n8n_data foi criado; a execução de fluxos de trabalho gera escritas de estado local, e os efeitos de remover o volume ou o contêiner não foram descritos nas evidências — confirme por conta própria antes de operar.

Limites de uso

• Natureza de leitura/escrita: o editor do n8n e a execução de fluxos de trabalho disparam chamadas a serviços externos e escritas de dados locais (como o volume de dados); a primeira tentativa deve ficar no nível de navegação e visualização, e antes de qualquer execução real deixe claro o que cada nó fará.
• Requisitos de credenciais: as evidências oficiais não indicam se a primeira inicialização exige registro de conta ou e-mail; não presuma informações desconhecidas.
• Restrições de licença: fair-code, Sustainable Use License + n8n Enterprise License; verifique os termos da licença antes de uso comercial ou redistribuição.
• Ainda não confirmado: o comportamento de leitura/escrita de cada nó específico, os caminhos de desfazer, os limites de privacidade de dados e os pré-requisitos oficiais de métodos de instalação diferentes do Docker — nada disso foi descrito nas evidências desta análise, o que não significa ausência de riscos.