EINFACH MACHEN · DIE PRAXISREIHE

Werkstatt: Eine Anfrage sicher bearbeiten

Zum Agentenband, Werkstatt W1 bis W10. Ausschließlich erfundene Übungsdaten.

Lernabschnitte

Zuerst baust du W1 bis W9 nach Anleitung und mit Kontrollpunkten auf. Danach folgen im Buch sieben selbstständige Übungen (W2, W4, W5, W6, W7, W8 und W9). Die Kennung verweist auf den jeweiligen Bauschritt. Notiere jeweils zuerst deine Erwartung; Musterergebnisse und Auswertung stehen im Lösungsteil hinten.

Testfaelle.csv und RAG_Testfragen.csv enthalten auch Erwartungen. Nutze diese Spalten erst zum anschließenden Vergleichen. Für die Agententests W4 und W5 benötigst du den eingerichteten Modellzugang.

Reihenfolge beim Nachbauen

  1. 01_Trockenlauf.n8n.json importieren und unverändert manuell starten.
  2. Jeden Node-Ausgang prüfen. Erwartet: wartet_auf_freigabe, ausgabe null.
  3. Die angeleiteten Gegenproben aus W3 ausführen. Die vollständige feste Testreihe folgt nach den selbstständigen Übungen; maschinenlesbare Eingaben stehen in Testfaelle.json.
  4. Nach W4 und W5 die FAQ laden, die Suche allein prüfen und den echten FAQ-Agenten aufbauen. Systemprompt.txt verwenden und zunächst die bekannte Vorbereitungsfrage prüfen. Die vollständige Reihe aus RAG_Testfragen.csv gehört zu Übung W5.
  5. Einen festen Entwurf mit 03_Freigabetest.n8n.json prüfen. freigegebener_entwurf muss genau zum Objekt entwurf passen. Erst dann freigabe auf ja setzen.
  6. Nach W6 eine echte Warteposition mit Human review im eigenen n8n-Lernchat ausprobieren. Dieser separate Ablauf sendet nichts nach außen.
  7. Mit 02_Pruefung_Subworkflow.n8n.json den Prüfbaustein auslagern und die Resultate vergleichen.
  8. Versionen, Beobachtungen und Grenzen im Testprotokoll.csv festhalten. Anschließend die selbstständigen Übungen und den Selbstcheck im Buch bearbeiten, mit dem Lösungsteil vergleichen und die 20 festen Testfälle prüfen.

Feste Regeln dieser Übung

Was vorhanden ist und was du selbst verbindest

Die drei Importdateien bilden den Trockenlauf, die feste Entwurfsprüfung und die Freigabesimulation ab. Der Code ist vollständig in den JSON-Dateien enthalten und liegt zusätzlich als JavaScript vor. Sie benötigen keine Credentials. Code-Nodes arbeiten mit Run Once for All Items. Der Sub-Workflow-Trigger ist vom Typ executeWorkflowTrigger, Version 1, und übernimmt die Daten ohne eigenes Feldschema.

Die echten Modell-, Embedding- und Freigabe-Verbindungen richtest du nach der Buchanleitung in deiner Instanz ein. Dafür enthält das Paket keine vorgeblich fertig getestete KI-Importdatei. Nutze einen vorhandenen Modellzugang und ausschließlich die erfundene FAQ. Die Artikel der n8n-Dokumentation stehen in Quellen.md.

Grenzen

Die Freigabe im Eingabeobjekt ist eine Lernsimulation, kein sicherer Benutzerkanal. Der Chat-Versuch ist ein eigener Lernablauf, nicht der fertig integrierte Versandprozess. Der Simple Vector Store ist flüchtig und innerhalb der Instanz nicht privat. Die Ausgabeliste wird nicht automatisch über mehrere manuelle Läufe gespeichert. Kopiere sie für den Wiederanlauftest zurück in die Eingabe.

Die Prüfung einer Quellenkennung beweist nicht die inhaltliche Richtigkeit. T20 macht diese Grenze sichtbar: Der feste Prüfer lässt den Entwurf zur menschlichen Prüfung durch, die Person muss den erfundenen Preis ablehnen.

Vor echtem Betrieb sind dauerhafte Speicherung, geschützte Eingänge, Freigabeberechtigungen, atomare Vermeidung doppelter Aktionen, ein aktueller Notaus und der konkrete Zielsystemanschluss erforderlich.

Nachgewiesener Prüfstand

Am 5. November 2026 wurden die drei Original-Importdateien auf n8n 2.34.5 live geprüft. Trockenlauf und Freigabesimulation liefern die erwarteten Ergebnisse. Die 20 festen Fälle bestehen sowohl mit eingebauter Prüfung als auch mit dem importierten Unterworkflow (je 20/20). Der absichtliche Node-Abbruch stoppt die nachfolgenden Nodes. Der automatische Error Trigger wurde separat mit und ohne veröffentlichte Melder-Version geprüft.

Auch Wissenssuche und FAQ-Aktualisierung, die 18 echten Agentenläufe mit überarbeitetem Systemprompt, Human review mit Zustimmung und Ablehnung sowie der vollständige SMTP-Mailweg wurden live geprüft. Die Nutzerin bestätigte den Empfang mit allen drei geforderten Angaben. Alle Test-Workflows sind wieder unveröffentlicht.

Die erste Modellreihe bestand nur 13 von 18 strengen Ausgabeprüfungen. Nach zwei Promptkorrekturen bestand die Abschlussreihe 18 von 18. Verwendet wurden gpt-4.1-mini (Temperatur 0, maximal vier Durchläufe) und text-embedding-3-small. Das ist ein Nachweis für diese Testfälle, keine allgemeine Zuverlässigkeitsgarantie.

Die Ergebnisse gelten für den beschriebenen Prüfstand. Trage deinen eigenen geprüften Versionsstand im Testprotokoll ein. Die technische Anleitung wurde am 1. November 2026 mit offizieller Dokumentation abgeglichen und am 5. November nach dem Live-Test präzisiert.