n8n 2.0: alles wat nieuw is en hoe je upgradet

n8n 2.0 is de grootste release in de geschiedenis van het populaire open-source automatiseringsplatform. Na jaren van iteratieve verbeteringen heeft het n8n-team met versie 2.0 een compleet nieuwe laag aan het platform toegevoegd: native AI-agent orchestratie, voice interfaces, Python-ondersteuning, multi-model routing en een herschreven execution engine. In deze uitgebreide handleiding lees je precies wat er nieuw is, hoe het werkt, en hoe je als self-hosted gebruiker veilig en snel upgradet.

Of je nu een MKB-eigenaar bent die eenvoudige koppelingen automatiseert, of een technisch team dat complexe AI-agent pipelines bouwt: n8n 2.0 voegt voor iedereen waarde toe. De upgrade is voor bestaande Docker-installaties goed te doen in minder dan een uur, maar vraagt wel de nodige voorbereiding. Lees deze handleiding van begin tot eind voor je begint.

Wat is er nieuw in n8n 2.0?

n8n 2.0 bundelt tien grote nieuwe features die de afgelopen maanden in bèta waren. Hieronder behandelen we ze stuk voor stuk.

1. n8n AI Workflow Builder

De meest spraakmakende nieuwe feature: je typt in gewone taal wat je wilt automatiseren, en n8n genereert een workflow-draft voor je. Stel je voor: 'Stuur me elke ochtend om 8:00 een samenvatting van mijn ongelezen Gmail-mails via Telegram.' n8n 2.0 bouwt de workflow-structuur inclusief nodes, triggers en verbindingen. Jij hoeft alleen credentials toe te voegen en te verfijnen.

De AI Workflow Builder gebruikt een combinatie van jouw instructie, de n8n node-documentatie en een grote bibliotheek van workflow-patronen om een zo accuraat mogelijke draft te genereren. Het is geen vervanging voor handmatig bouwen, maar een enorme tijdsbesparing bij het opzetten van nieuwe workflows.

• Ondersteunt meer dan 400 n8n nodes in de generatie
• Genereert subworkflows voor complexe logica
• Bevat een 'Explain this workflow' knop voor uitleg van bestaande flows
• Werkt met Nederlandse en Engelse instructies

2. Voice Agents

n8n 2.0 introduceert een native Voice Agent node. Hiermee bouw je een AI-agent die via audio communiceert: spraak in, spraak uit. De integratie werkt standaard met ElevenLabs voor tekst-naar-spraak en Whisper (via OpenAI of local) voor spraak-naar-tekst.

Een praktisch gebruik: een telefonische klantenservice-agent die orders opzoekt in je systeem en antwoord geeft via spraak. Of een intern spraakcommando-systeem dat workflow-taken triggert op je kantoor.

{
  "trigger": "webhook",
  "path": "voice-agent",
  "responseMode": "responseNode",
  "responseData": "audio/mpeg",
  "agentType": "conversational",
  "voiceModel": "elevenlabs",
  "voiceId": "21m00Tcm4TlvDq8ikWAM"
}

De webhook ontvangt audio-input (WAV of MP3), transcribeert deze via Whisper, stuurt de tekst naar het AI-model, en geeft een audio-response terug. Alles in één n8n workflow, zonder extra middleware.

3. Native Python Code Tool

Een van de meest gevraagde features door de community: Python-ondersteuning in de Code node en de AI Agent Tool node. Tot versie 1.x was JavaScript de enige optie. n8n 2.0 introduceert een volwaardige Python runtime via task runners (zie hieronder).

# Python Code Tool voorbeeld in AI agent node
# Voorheen alleen JS, nu ook Python:
def calculate_roi(investment, monthly_savings, months):
    total_savings = monthly_savings * months
    roi = ((total_savings - investment) / investment) * 100
    return {
        "total_savings": total_savings,
        "roi_percentage": round(roi, 2),
        "payback_months": round(investment / monthly_savings, 1)
    }

result = calculate_roi(5000, 800, 12)
return result

Python-bibliotheken zijn beschikbaar via pip-installatie in de n8n omgeving. Standaard beschikbaar: pandas, numpy, requests en json. Extra packages installeer je via de N8N_PYTHON_PACKAGES environment variable.

• Gebruik pandas voor dataverwerking rechtstreeks in de workflow
• Roep bestaande Python-scripts aan vanuit je n8n agent
• Combineer Python en JavaScript nodes in dezelfde workflow

4. Multi-model Orchestratie

n8n 2.0 introduceert een unified AI model interface waarmee je Claude, Gemini, Groq, Vertex AI en OpenAI in dezelfde workflow kunt combineren. Je kunt per taak het beste model kiezen, of een fallback-model instellen als de primaire provider onbeschikbaar is.

{
  "model": "claude-sonnet-4-6",
  "fallbackModel": "gemini-2.5-flash",
  "temperature": 0.3,
  "maxTokens": 4096,
  "tools": ["calculator", "httpRequest", "pythonCode"]
}

Een typisch patroon: gebruik Claude Sonnet voor reasoning-intensieve taken, Gemini Flash als goedkope fallback voor eenvoudige classificatie, en Groq voor snelle inference waarbij lage latency prioriteit heeft. De routing logica bouw je zelf in de workflow, of je laat de nieuwe Router node het automatisch doen.

5. Advanced Memory & Context

AI agents in n8n 2.0 houden nu state bij over meerdere workflow-runs. Dit was een van de grootste beperkingen van n8n 1.x: agents begonnen elke run opnieuw zonder geheugen van vorige interacties. Met Advanced Memory kun je kiezen tussen: in-memory (tijdelijk, snel), SQLite (lokaal persistent), of externe vector stores zoals Pinecone of Qdrant.

• Window Memory: onthoudt de laatste N berichten in een conversatie
• Summary Memory: condenseert lange conversaties automatisch
• Entity Memory: slaat specifieke entiteiten op (namen, bedrijven, voorkeuren)
• Vector Memory: semantisch zoeken in eerdere interacties via embeddings

6. Autosave + Publish Paradigm

n8n 2.0 introduceert een bewust onderscheid tussen 'opslaan' en 'publiceren'. Elke wijziging wordt automatisch opgeslagen (autosave) maar raakt de productie-workflow niet totdat je expliciet op 'Publish' klikt. Dit is vergelijkbaar met hoe moderne CMS-systemen werken en voorkomt dat een half-afgebouwde workflow per ongeluk live gaat.

• Draft-versies zijn altijd veilig opgeslagen
• Publiceer-geschiedenis bijgehouden per workflow
• Rollback naar vorige versie met één klik
• Team members kunnen simultaan aan dezelfde workflow werken

7. Task Runners

Task runners zijn geïsoleerde processen die workflow-executies afhandelen los van het hoofd-n8n proces. Dit verbetert zowel de security (code-executie vindt geïsoleerd plaats) als de performance (parallelle executie zonder bottlenecks op het hoofd-proces).

# Environment variables n8n 2.0 (nieuw)
N8N_RUNNERS_ENABLED=true
N8N_RUNNERS_MODE=internal
OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true
N8N_METRICS=true
N8N_METRICS_PREFIX=n8n_

In 'internal' mode draaien de runners als child-processen van n8n. Voor grotere installaties is er de 'external' mode waarbij runners als aparte containers draaien, wat horizontale schaling mogelijk maakt.

8. 10x Snellere SQLite

n8n gebruikt SQLite als standaard database voor kleinere installaties. In n8n 2.0 is de SQLite-integratie herschreven met een verbeterde connection pooling driver (better-sqlite3 vervangen door een async pooling implementatie). In benchmarks zijn execution-logs en workflow-reads tot 10x sneller bij gelijktijdige requests.

• Lees- en schrijfoperaties zijn asynchroon en non-blocking
• WAL (Write-Ahead Logging) standaard ingeschakeld
• Automatische VACUUM-scheduling voor database maintenance

Voor grotere productie-installaties blijft PostgreSQL de aanbevolen database. De SQLite-verbeteringen maken n8n echter een stuk capabeler voor self-hosted MKB-gebruik zonder externe database.

9. Production Checklist

n8n 2.0 introduceert een ingebouwde audit-tool die je workflows en configuratie controleert op productie-gereedheid. De checklist kijkt naar error handling, credential security, execution timeouts, en webhook beveiligingsinstellingen.

# Production checklist via n8n CLI
n8n audit
# Controleert: error handling, credentials security, execution timeouts

• Controleert of alle workflows een error-handler hebben
• Signaleert niet-versleutelde credentials of standaard wachtwoorden
• Waarschuwt voor workflows zonder execution timeout
• Geeft aanbevelingen voor webhook-authenticatie

10. Pre-built AI Agents

n8n 2.0 bevat een bibliotheek van kant-en-klare AI agent templates. Denk aan: een customer support chat agent, een voice agent voor afspraakplanning, een research agent die het web doorzoekt, en een data-extractie agent voor documenten. Deze templates zijn volledig functioneel en vragen alleen om credentials en eventuele aanpassingen aan jouw use case.

De templates zijn ook een uitstekende leerresource: door te bekijken hoe een kant-en-klare agent is gebouwd, leer je snel de patronen voor eigen agent-ontwikkeling.

Hoe upgradet je naar n8n 2.0?

De upgrade van n8n 1.x naar 2.0 vergt voorbereiding. Volg de stappen hieronder zorgvuldig. Plan de upgrade buiten kantooruren als n8n in productie draait.

Stap 1: Lees de release notes en breaking changes

Voordat je iets doet: lees de officiële n8n 2.0 release notes op https://blog.n8n.io/introducing-n8n-2-0/ en de changelog op https://n8n.io/changelog/. n8n 2.0 heeft een aantal breaking changes ten opzichte van 1.x. De meest impactvolle zijn:

• De structuur van sommige node-outputs is gewijzigd (met name de HTTP Request node)
• Verouderde credentials-types zijn niet meer ondersteund — je moet ze migreren
• Sommige community-nodes zijn nog niet compatibel met 2.0
• De database-migratie wordt automatisch uitgevoerd maar is onomkeerbaar zonder backup

Stap 2: Controleer community nodes op compatibiliteit

Ga in je huidige n8n-installatie naar Settings > Community Nodes. Noteer alle geïnstalleerde community nodes en controleer op de n8n community forums of hun npm-pagina of ze n8n 2.0 ondersteunen. Verwijder incompatibele nodes voor de upgrade om conflicten te voorkomen.

Stap 3: Maak een volledige backup

Dit is de meest kritieke stap. Exporteer alle workflows en maak een backup van je data-directory.

# Backup voor upgrade
docker exec n8n n8n export:workflow --backup --output=/home/node/.n8n/backup-$(date +%Y%m%d).json

Kopieer daarna ook de complete .n8n directory naar een veilige locatie buiten de container:

# Kopieer de volledige data directory
cp -r ~/.n8n ~/.n8n-backup-$(date +%Y%m%d)

# Verifieer de backup
ls -la ~/.n8n-backup-$(date +%Y%m%d)/

Stap 4: Update je docker-compose.yml

Als je docker-compose gebruikt (aanbevolen), update dan je configuratie met de nieuwe environment variables voor n8n 2.0. Hieronder een complete, productie-klare docker-compose.yml:

# docker-compose.yml voor n8n 2.0
version: '3.8'
services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=changeme
      - N8N_ENCRYPTION_KEY=your-encryption-key
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=336
    volumes:
      - n8n_data:/home/node/.n8n
volumes:
  n8n_data:

Vervang 'changeme' door een sterk wachtwoord en genereer een unieke encryption key met: openssl rand -hex 32

Stap 5: Voeg de nieuwe n8n 2.0 environment variables toe

n8n 2.0 introduceert nieuwe environment variables voor de task runners en metrics. Voeg deze toe aan je configuratie:

# Environment variables n8n 2.0 (nieuw)
N8N_RUNNERS_ENABLED=true
N8N_RUNNERS_MODE=internal
OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true
N8N_METRICS=true
N8N_METRICS_PREFIX=n8n_

Raadpleeg de volledige lijst van environment variables op https://docs.n8n.io/hosting/configuration/environment-variables/ voor alle beschikbare opties.

Stap 6: Pull de nieuwe image en herstart de container

Nu de voorbereiding klaar is, is het tijd voor de daadwerkelijke upgrade:

# Docker upgrade commando
docker pull n8nio/n8n:latest
docker stop n8n
docker rm n8n
docker run -d --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n:latest

Als je docker-compose gebruikt, is het eenvoudiger:

# Met docker-compose
docker compose pull
docker compose up -d

Stap 7: Controleer de database-migratie

Bij de eerste start van n8n 2.0 worden automatisch database-migraties uitgevoerd. Bekijk de logs om te controleren dat dit succesvol is verlopen:

# Bekijk de opstartlogs
docker logs n8n -f

# Je zou iets moeten zien als:
# [n8n] Running migrations...
# [n8n] Migrations completed successfully
# [n8n] n8n ready on 0.0.0.0, port 5678

Stap 8: Test je kritieke workflows

Log in op je n8n-instantie en test je meest kritieke workflows handmatig. Let extra op:

• HTTP Request nodes (output-structuur kan gewijzigd zijn)
• Workflows die gebruik maken van community nodes
• Workflows met credential-afhankelijkheden
• Webhook-triggers (controleer of ze nog correct authenticeren)

Stap 9: Voer de ingebouwde audit uit

Nu n8n 2.0 draait, gebruik je de nieuwe production checklist om je installatie te valideren:

# Production checklist via n8n CLI
n8n audit
# Controleert: error handling, credentials security, execution timeouts

Los eventuele waarschuwingen op voor je de installatie als 'productie-klaar' beschouwt.

Stap 10: Verken de nieuwe AI features

Met de upgrade achter de rug is het tijd om de nieuwe mogelijkheden te ontdekken. Begin met de AI Workflow Builder: klik op het nieuwe AI-icoon in de toolbar en typ een workflow-beschrijving. Experimenteer met de pre-built agent templates via Templates > AI Agents.

Stap 11: Migreer verouderde node-configuraties

Sommige nodes hebben in 2.0 een gewijzigde configuratiestructuur. De meest voorkomende aanpassingen:

• HTTP Request node: de 'Response' sectie heeft nieuwe velden voor response mapping
• Function node: vervangen door de Code node met Python of JS keuze
• Split In Batches: hernoemd naar 'Loop Over Items' met extra opties

n8n toont een deprecation-waarschuwing bij nodes die de verouderde API gebruiken. Klik op de waarschuwing voor migratie-instructies per node.

Stap 12: Configureer Advanced Memory voor bestaande agents

Als je al AI agents had in n8n 1.x, profiteer dan van de nieuwe memory-opties. Open elke agent-workflow en voeg een Memory node toe. Kies voor SQLite Memory als je een eenvoudige, persistente oplossing wilt zonder externe services.

Upgraden op n8n Cloud

Gebruik je n8n Cloud (het managed SaaS aanbod)? Dan is de upgrade een stuk eenvoudiger. n8n Cloud-instanties worden automatisch bijgewerkt door het n8n-team. Je hoeft zelf niets te doen, maar check wel:

• Je inbox voor aankondigingen over de upgrade-planning
• Of je community nodes compatibel zijn via de Upgrade Compatibility Check in het dashboard
• Of je workflows de nieuwe Autosave + Publish flow begrijpt (eerste keer kun je verward zijn)

Praktijkscenario: een MKB-klantenservice agent bouwen in n8n 2.0

Stel je hebt een webshop met regelmatig terugkerende vragen over bestellingen, retouren en levertijden. Met n8n 2.0 bouw je een volledige klantenservice-agent die deze vragen afhandelt via chat en optioneel via spraak.

De workflow bestaat uit de volgende componenten:

• Webhook trigger: ontvangt berichten van je website-chatwidget
• AI Agent node: verwerkt de vraag met Claude Sonnet als primair model
• SQLite Memory: onthoudt de conversatiegeschiedenis per klant-ID
• HTTP Request Tool: haalt bestelstatus op uit je WooCommerce of Shopify API
• Python Code Tool: berekent levertijden en retourtermijnen
• Fallback naar menselijke agent: als de AI de vraag niet kan beantwoorden

De hele opzet vraagt ongeveer 2-3 uur bouwtijd met de pre-built templates als startpunt. Gebruik de AI Workflow Builder met de prompt: 'Bouw een klantenservice chat agent die WooCommerce bestellingen opzoekt en vragen beantwoordt via een webhook, met geheugen per klant-ID en escalatie naar Slack als het te complex wordt.'

Tips en aanbevelingen

• Begin met de pre-built templates: ze geven je een vliegende start en zijn een leerresource
• Gebruik de AI Workflow Builder voor de structuur, verfijn daarna handmatig
• Stel altijd een fallback-model in bij AI Agent nodes voor robuustheid
• Activeer N8N_METRICS voor inzicht in workflow-performance via Grafana of Prometheus
• Gebruik het Autosave + Publish systeem bewust: test in Draft, publiceer pas als het goed werkt
• Voer n8n audit maandelijks uit als onderdeel van je technisch onderhoud
• Overweeg external task runners als je meer dan 50 gelijktijdige executions verwacht

Meer leren over n8n en AI automatisering

n8n 2.0 is een enorme stap vooruit, maar de echte waarde zit in combinatie met andere tools en kennis. Verdiep je in de volgende handleidingen op workflows.nl:

• Je eerste AI agent bouwen met Flowise
• MCP + n8n + Google Workspace + Claude
• n8n vs Make vergelijking 2026

Voor de officiële n8n-documentatie over Docker-installatie, zie: https://docs.n8n.io/hosting/installation/docker/ — en voor alle beschikbare environment variables: https://docs.n8n.io/hosting/configuration/environment-variables/

Conclusie

n8n 2.0 is een volwassen, krachtig platform geworden dat AI-agent orchestratie naar het hart van automatisering brengt. De tien nieuwe features — van de AI Workflow Builder tot native Python, van Voice Agents tot Advanced Memory — maken het mogelijk om in korte tijd geavanceerde automatiseringen te bouwen die eerder maanden codeerwerk vereisten.

De upgrade van n8n 1.x naar 2.0 vraagt voorbereiding maar is goed te doen in minder dan een uur. Zorg voor een goede backup, controleer breaking changes, update je environment variables, en test je workflows na de upgrade. Gebruik daarna de ingebouwde audit-tool om de installatie te valideren.

Voor MKB-eigenaren die nog niet met n8n werken: n8n 2.0 is het ideale moment om te starten. De AI Workflow Builder verlaagt de drempel enorm, en de pre-built agent templates geven je direct bruikbare automatiseringen zonder van nul te beginnen.