Get the FREE Ultimate OpenClaw Setup Guide →

n8n-workflow-generator

Scanned
npx machina-cli add skill fbmoulin/lex-intelligentia-skills/n8n-workflow-generator --openclaw
Files (1)
SKILL.md
4.3 KB

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

ModeUso
appendConcatenar resultados de branches paralelas
combineBySqlJOIN complexo com AlaSQL
combineByFieldsCorrelacionar por campo comum
combineByPositionMerge por índice
chooseBranchSelecionar 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 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 para:

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

Limites n8n Cloud

PlanoExecuções/mêsConcorrência
Starter2,5005
Pro10,00020
Business40,000Higher

Timeout de webhooks: 100 segundos

Source

git clone https://github.com/fbmoulin/lex-intelligentia-skills/blob/main/skills/automacao/n8n-workflow-generator/SKILL.mdView on GitHub

Overview

Converte descrições em linguagem natural em blueprints JSON completos para workflows n8n Cloud. Garante schema de nodes e connections, padrões de execução paralela e estratégias de manutenção de contexto. Oferece templates modulares para AI workflows, pipelines RAG e automações jurídicas.

How This Skill Works

Interpreta a descrição fornecida e monta o JSON com campos name, nodes, connections e settings. Aplica convenções de type e IDs únicos, além de validações obrigatórias para manter a integridade do blueprint. Suporta templates modulares e arquiteturas multi-agent para AI workflows e RAG pipelines.

When to Use It

  • Quando Claude precisa criar um novo workflow n8n a partir de uma descrição em linguagem natural.
  • Ao modificar ou compor fluxos existentes programaticamente.
  • Para projetar pipelines AI e RAG com memória e controles de contexto.
  • Ao desenvolver automações jurídicas com templates modulares.
  • Para aplicar padrões de processamento paralelo e facilitar manutenção entre execuções.

Quick Start

  1. Step 1: Forneça uma descrição clara do objetivo do workflow em linguagem natural.
  2. Step 2: Use o n8n-workflow-generator para criar o blueprint JSON correspondente.
  3. Step 3: Importe o JSON no n8n Cloud, valide as connections e execute um teste.

Best Practices

  • Assegure IDs únicos para cada node.
  • Garanta que nomes de nodes usados nas connections correspondam exatamente.
  • Mantenha o array de nodes não vazio antes de exportar.
  • Utilize padrões de split e merge para processamento paralelo.
  • Reutilize templates modulares para AI workflows, RAG pipelines e automações jurídicas.

Example Use Cases

  • Workflow que gera um AI Agent com memory e tools a partir de uma descrição.
  • RAG pipeline com Vector Store para consultas contextuais mantendo o contexto entre etapas.
  • Webhook -> Process -> Response com tratamento de erros centralizado.
  • Automação jurídica com templates modulares para consultas legais e geração de documentos.
  • Arquitetura multi-agent com branches IF e integração de ferramentas AI.

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers ↗