n8n als Orchestrierungsplattform für KI-Agenten

Wie Sie mit n8n komplexe KI-Agenten-Workflows aufbauen: Von der Tool-Integration über Error Handling bis zur Skalierung. Mit praktischen Beispielen aus echten Projekten.

Warum n8n für KI-Agenten?

Bei der Auswahl einer Orchestrierungsplattform für KI-Agenten stehen viele Optionen zur Verfügung: LangChain, AutoGen, CrewAI oder klassische Workflow-Tools wie Make und Zapier. Nach zahlreichen Projekten hat sich n8n als unsere bevorzugte Plattform etabliert – und das aus guten Gründen.

🔧 Visual + Code

Visuelle Workflows für schnelle Iteration, JavaScript/Python für komplexe Logik – das Beste aus beiden Welten.

🏠 Self-Hosting

Volle Kontrolle über Ihre Daten. Läuft auf Ihrem Server, in Ihrer Cloud oder on-premise.

🤖 Native AI Nodes

AI Agent Node mit Tool-Calling, Memory und Conversation History out-of-the-box.

🔌 400+ Integrationen

CRM, E-Mail, Datenbanken, APIs – die meisten Systeme sind bereits als Node verfügbar.

Für Entscheider: n8n ist Open Source mit optionaler Enterprise-Lizenz. Sie können klein starten (Self-Hosted, kostenlos) und bei Bedarf auf n8n Cloud oder Enterprise skalieren – ohne Vendor Lock-in.

Der AI Agent Node im Detail

Mit Version 1.19 hat n8n den AI Agent Node eingeführt – ein Game-Changer für die KI-Automatisierung. Dieser Node ermöglicht es, LLM-basierte Agenten zu erstellen, die:

  • Selbstständig entscheiden, welche Tools sie nutzen (Tool-Calling)
  • Mehrstufige Aufgaben durch iteratives Reasoning lösen
  • Kontext über mehrere Interaktionen hinweg behalten (Memory)
  • Strukturierte Outputs liefern (JSON, Listen, etc.)

Aufbau eines AI Agent Workflows

Webhook
AI Agent
Tools
Response

Grundstruktur: Trigger → Agent → Tools → Output

Ein typischer AI Agent Workflow in n8n besteht aus:

  1. Trigger: Webhook, Schedule, E-Mail-Eingang oder anderer Auslöser
  2. AI Agent Node: Das "Gehirn" mit System Prompt und Tool-Definitionen
  3. Tool Sub-Workflows: Spezialisierte Workflows, die der Agent aufrufen kann
  4. Output: Strukturierte Antwort an das aufrufende System

Konfiguration des AI Agent Node

// System Prompt für einen Lead-Qualifizierungs-Agent System Prompt: Du bist ein Lead-Qualifizierungs-Agent für ein B2B-Softwareunternehmen. Deine Aufgaben: 1. Analysiere eingehende Leads anhand der Firmendaten 2. Nutze das Tool "company_lookup" für zusätzliche Recherche 3. Bewerte den Lead nach den Kriterien: Budget, Authority, Need, Timeline 4. Erstelle einen Score von 1-100 Output-Format: { "company": "Firmenname", "score": 75, "reasoning": "Kurze Begründung", "next_action": "follow_up" | "nurture" | "discard" }

Tools als Erweiterung der Agent-Fähigkeiten

Die wahre Stärke von KI-Agenten liegt nicht im LLM selbst, sondern in den Tools, die sie nutzen können. In n8n definieren Sie Tools als separate Sub-Workflows, die der Agent bei Bedarf aufruft.

Beispiel: Tool für Firmenrecherche

// Tool-Definition für den AI Agent Name: company_lookup Description: Recherchiert Informationen zu einem Unternehmen anhand des Firmennamens oder der Domain. Parameters: - company_name (string, required): Name des Unternehmens - domain (string, optional): Website-Domain // Der Sub-Workflow führt dann aus: 1. Google Search API → Firmenprofil finden 2. Website Scraping → Impressum auslesen 3. LinkedIn API → Mitarbeiterzahl, Branche 4. Return → Strukturierte Firmendaten an Agent

Typische Tools für Business-Agenten

  • CRM-Tools: Lead anlegen, Kontakt aktualisieren, Deal erstellen (HubSpot, Salesforce, Pipedrive)
  • Recherche-Tools: Google Search, Website Scraping, LinkedIn Lookup
  • Kommunikations-Tools: E-Mail senden, Slack-Nachricht, SMS versenden
  • Kalender-Tools: Verfügbarkeit prüfen, Termin buchen (Google Calendar, Cal.com)
  • Datenbank-Tools: Abfragen, Speichern, Aktualisieren (PostgreSQL, Airtable, Notion)

Best Practice: Definieren Sie Tools granular und mit klaren Beschreibungen. Der Agent entscheidet basierend auf der Tool-Description, wann er welches Tool nutzt. Je präziser die Beschreibung, desto besser die Entscheidungen.

Robustes Error Handling

In Produktionsumgebungen ist zuverlässiges Error Handling entscheidend. n8n bietet mehrere Mechanismen:

1. Error Workflow

Ein separater Workflow, der bei Fehlern im Haupt-Workflow ausgeführt wird. Ideal für Alerting und Logging.

// Error Workflow Actions 1. Slack Notification → #alerts Channel 2. Error Log → PostgreSQL/Notion Datenbank 3. Retry Logic → Bei temporären Fehlern erneut versuchen 4. Fallback → Alternative Aktion oder menschliche Eskalation

2. Try/Catch Pattern

Mit dem "Error Trigger" Node können Sie Fehler innerhalb eines Workflows abfangen und behandeln, ohne den gesamten Workflow abzubrechen.

3. Retry on Fail

Viele n8n Nodes unterstützen automatische Retries bei Fehlern – besonders wichtig für API-Aufrufe, die gelegentlich fehlschlagen (Rate Limits, Timeouts).

Wichtig bei AI Agents: LLM-Aufrufe können fehlschlagen oder unerwartete Outputs liefern. Implementieren Sie immer Output-Validierung und Fallback-Logik für den Fall, dass der Agent keine sinnvolle Antwort liefert.

Memory und Kontext

Für Agenten, die über mehrere Interaktionen hinweg konsistent arbeiten sollen, ist Memory entscheidend. n8n unterstützt verschiedene Memory-Typen:

Buffer Memory

Speichert die letzten N Nachrichten im Kontext. Einfach, aber begrenzt durch das Context Window des LLMs.

Window Memory

Kombiniert Buffer Memory mit einem Sliding Window – ältere Nachrichten werden zusammengefasst, um Kontext zu erhalten ohne das Token-Limit zu sprengen.

Externe Memory (PostgreSQL, Redis)

Für produktive Anwendungen empfehlen wir externes Memory: Die Conversation History wird in einer Datenbank gespeichert und bei Bedarf geladen. Das ermöglicht:

  • Persistenz über Workflow-Ausführungen hinweg
  • Skalierung auf mehrere Instanzen
  • Analyse und Audit der Agent-Interaktionen

Praxisbeispiel: Lead-Qualifizierungs-Workflow

Ein vollständiger Workflow, wie wir ihn für Kunden implementiert haben:

Webhook
Neuer Lead
AI Agent
Qualifizierung
Switch
Score-basiert
HubSpot
Hot Lead
Mailchimp
Nurture
Archive
Discard

Lead-Qualifizierung mit automatischer Routing-Logik

Workflow-Schritte:

  1. Webhook empfängt Lead: Name, E-Mail, Firma, Nachricht aus Kontaktformular
  2. AI Agent analysiert:
    • Ruft Tool "company_lookup" auf → Firmengröße, Branche, Website
    • Ruft Tool "linkedin_search" auf → Ansprechpartner, Rolle
    • Bewertet nach BANT-Kriterien
    • Gibt Score und Empfehlung zurück
  3. Switch Node routet:
    • Score ≥ 70 → HubSpot: Deal anlegen, Sales benachrichtigen
    • Score 40-69 → Mailchimp: In Nurture-Sequenz aufnehmen
    • Score < 40 → Archivieren, keine weitere Aktion
// Beispiel-Output des AI Agents { "company": "Mustermann GmbH", "score": 78, "analysis": { "budget": "high - Enterprise-Segment, 50+ Mitarbeiter", "authority": "medium - Kontakt ist Marketing Manager", "need": "high - Explizite Anfrage zu Automatisierung", "timeline": "medium - Q1 Budget-Planung erwähnt" }, "reasoning": "Mittelständisches Unternehmen mit konkretem Automatisierungsbedarf. Kontakt nicht Entscheider, aber wahrscheinlich Influencer.", "next_action": "follow_up", "recommended_approach": "Telefonisches Follow-up innerhalb von 24h, Demo-Termin anbieten" }

Skalierung und Performance

Wenn Ihre Agenten-Workflows wachsen, werden Performance und Skalierung relevant:

Queue Mode

n8n unterstützt einen Queue Mode mit Redis/BullMQ. Workflows werden in einer Queue verarbeitet, was bei hohem Volumen für gleichmäßige Last sorgt.

Worker-Architektur

Trennen Sie n8n in Main Instance (UI, Webhook-Empfang) und Worker Instances (Workflow-Ausführung). So können Sie horizontal skalieren.

Workflow-Optimierung

  • Caching: Häufige API-Aufrufe (z.B. Company Lookup) cachen
  • Batching: Mehrere Items in einem LLM-Aufruf verarbeiten
  • Async Processing: Lange Workflows asynchron ausführen, Status per Webhook zurückmelden

Unser Setup: Für die meisten Mittelstands-Anwendungen reicht eine einzelne n8n-Instanz auf einem 4-Core/8GB Server. Erst bei > 10.000 Workflow-Ausführungen pro Tag empfehlen wir das Queue-Setup.

Fazit: n8n als Fundament für KI-Automatisierung

n8n hat sich in unseren Projekten als ideale Plattform für KI-Agenten-Orchestrierung bewährt. Die Kombination aus visueller Entwicklung, Code-Flexibilität und nativer AI-Unterstützung ermöglicht schnelle Iteration bei gleichzeitiger Produktionsreife.

Der größte Vorteil: Sie behalten die Kontrolle. Self-Hosting, Open Source, keine Abhängigkeit von einer einzelnen AI-Plattform. Wenn morgen ein besseres LLM erscheint, tauschen Sie den Model-Provider – der Rest bleibt gleich.

NK

NetSys KI

Wir setzen n8n in allen unseren KI-Agenten-Projekten ein – von Lead-Generierung bis Dokumentenverarbeitung. Self-Hosted, DSGVO-konform, skalierbar.