N8n Workflow Generator

n8n Workflow Generator - Criação Programática de Workflows

Schema Base do Workflow JSON

{
  "name": "Nome do Workflow",
  "nodes": [],
  "connections": {},
  "settings": {
    "executionOrder": "v1",
    "saveDataErrorExecution": "all"
  },
  "active": false
}

Estrutura de Nodes

Campos obrigatórios: id, name, type, position

{
  "id": "uuid-unico",
  "name": "Nome Exibido",
  "type": "n8n-nodes-base.httpRequest",
  "typeVersion": 4.1,
  "position": [250, 300],
  "parameters": {},
  "credentials": {
    "httpHeaderAuth": {
      "id": "cred-id",
      "name": "API Key"
    }
  }
}

Convenções de type:

• Core: n8n-nodes-base.{nodeName}
• Triggers: n8n-nodes-base.{service}Trigger
• AI/LangChain: @n8n/n8n-nodes-langchain.{nodeName}

Estrutura de Connections

Conexões básicas (main)

"connections": {
  "Node Origem": {
    "main": [[{ "node": "Node Destino", "type": "main", "index": 0 }]]
  }
}

Conexões para AI nodes

"connections": {
  "AI Agent": {
    "ai_languageModel": [[{ "node": "OpenAI Chat", "type": "ai_languageModel", "index": 0 }]],
    "ai_memory": [[{ "node": "Buffer Memory", "type": "ai_memory", "index": 0 }]],
    "ai_tool": [
      [{ "node": "Calculator", "type": "ai_tool", "index": 0 }],
      [{ "node": "Vector Store Tool", "type": "ai_tool", "index": 1 }]
    ]
  }
}

Branches múltiplas (IF node)

"IF Node": {
  "main": [
    [{ "node": "True Branch", "type": "main", "index": 0 }],
    [{ "node": "False Branch", "type": "main", "index": 0 }]
  ]
}

Padrões de Processamento Paralelo

Split In Batches + Merge

Para manter contexto em processamento paralelo:

{
  "nodes": [
    {
      "id": "split",
      "name": "Loop Over Items",
      "type": "n8n-nodes-base.splitInBatches",
      "parameters": { "batchSize": 1, "options": { "reset": false } }
    },
    {
      "id": "process",
      "name": "Process Item",
      "type": "n8n-nodes-base.code",
      "parameters": {
        "jsCode": "// Acesso ao contexto do loop\nconst index = $('Loop Over Items').context['currentRunIndex'];\nconst done = $('Loop Over Items').context['noItemsLeft'];\nreturn [{ json: { ...item.json, index } }];"
      }
    },
    {
      "id": "merge",
      "name": "Aggregate Results",
      "type": "n8n-nodes-base.merge",
      "parameters": { "mode": "append" }
    }
  ]
}

Merge Modes

| Mode | Uso | |------|-----| | append | Concatenar resultados de branches paralelas | | combineBySql | JOIN complexo com AlaSQL | | combineByFields | Correlacionar por campo comum | | combineByPosition | Merge por índice | | chooseBranch | Selecionar uma branch |

Geração de IDs Únicos

function generateNodeId() {
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
    const r = Math.random() * 16 | 0;
    return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
  });
}

Validações Obrigatórias

1. IDs únicos para cada node
2. Nomes de nodes nas connections devem corresponder exatamente
3. Array de nodes não vazio
4. Estrutura de connections com arrays aninhados corretos

Importante: Credential IDs são específicos por instância - reconfigurar após import.

Templates Modulares

Ver [references/templates.md](references/templates.md) para:

• AI Agent básico com tools
• RAG Pipeline com Vector Store
• Webhook → Process → Response
• Error handling centralizado
• Paginação de APIs

Arquiteturas Multi-Agent

Ver [references/multi-agent.md](references/multi-agent.md) para:

• Pattern Gatekeeper (agente principal + sub-agentes)
• Chained Requests
• Agentic RAG com seleção dinâmica de fontes

Limites n8n Cloud

| Plano | Execuções/mês | Concorrência | |-------|---------------|--------------| | Starter | 2,500 | 5 | | Pro | 10,000 | 20 | | Business | 40,000 | Higher |

Timeout de webhooks: 100 segundos

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ma-serra
• Source: ma-serra/lex-intelligentia-skills
• License: MIT

Install and usage instructions live in the source repository linked above.