Einen n8n-Workflow importieren — ein KI-Agent, der Chat-Nachrichten beantwortet
Ein n8n-Workflow — ein Chat-Trigger, ein AI Agent, ein OpenAI Chat Model und ein Simple Memory — von aggrega import in ein Aggregate, ein Release und ein Manifest importiert, die sich so, wie sie geschrieben sind, für Docker Compose bauen lassen.
Einen n8n-Workflow importieren führt Schritt für Schritt hindurch: der Befehl, die Dateien, die er schreibt, der Build und ein Lauf dessen, was er baut. Dieser Ordner enthält jede Stufe dieser Anleitung:
| Ordner | was er enthält |
|---|---|
source/ | der Workflow, support-agent.json; die .aggrega-config.yaml, die den Ordner zu einem Workspace macht; und import-answers.yaml, die Antwort auf das, was kein Workflow enthalten kann und wonach ein Import für Kubernetes fragt |
draft/ | die Dateien, die aggrega import support-agent.json --target compose geschrieben hat, unverändert, und was der Befehl ausgegeben hat: stdout.txt auf der Standardausgabe, import.txt auf der Standardfehlerausgabe |
source/support-agent.json ist für dieses Beispiel geschrieben, in der Form, in der n8n einen Workflow exportiert.
In einem Checkout des Dokumentations-Repositorys führt check.sh den Import erneut aus, vergleicht, was er schreibt und ausgibt, mit draft/, vergleicht die Blöcke, die die Anleitung zitiert, mit diesen Dateien und validiert und baut, was der Import geschrieben hat. Es benötigt den Katalog der Standardbibliothek (woher Sie einen bekommen), neben diesem Repository ausgecheckt, oder dessen Verzeichnis in AGGREGA_CATALOG_DIRS angegeben.
Das Beispiel generieren
Sie können den Import dieses Beispiels mit den folgenden Befehlen ausführen oder ihn von Ihrem KI-Assistenten für Sie ausführen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example import-n8nDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd import-n8nBuild
Der Import entwirft die Aggrega-Dateien neben dem Projekt, in source/, und ruft ab, was der Build benötigt. Er gleicht das Projekt mit dem Katalog der Standardbibliothek ab, den die Standard-Registry des Workspace als signierten Snapshot veröffentlicht: Der erste Import ruft ihn ab, verifiziert ihn, legt ihn im Inhalts-Cache des Workspace ab und nennt ihn über seinen Digest in der Aufzeichnung, die er neben die Entwürfe schreibt. Ein Workspace, der eigene Katalogordner nennt — in AGGREGA_CATALOG_DIRS oder unter workspace.catalog_dirs —, importiert stattdessen gegen diese:
cd sourceaggrega import support-agent.json --target composeaggrega validate --release release.yamlaggrega build --release release.yamlWie Sie ausführen, was der Build schreibt, steht in der oben verlinkten Anleitung.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `import-n8n` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `import-n8n` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `import-n8n`, dessen Ordner `source` enthält, was dieses Beispiel importiert. Rufen Sie anschließend das Tool `import` mit `workspace_root` auf `import-n8n/source`, `source` auf `support-agent.json` und `target` auf `compose` gesetzt auf: Es liest die Antworten, die es benötigt, aus `import-answers.yaml` neben `support-agent.json`, schreibt seine Entwürfe nach `import-n8n/source` und lädt herunter, was sie benötigen. Rufen Sie danach das Tool `validate` mit `workspace_root` auf `import-n8n/source` und `release` auf `release.yaml` gesetzt auf sowie das Tool `build` mit `workspace_root` auf `import-n8n/source`, `release` auf `release.yaml` und `write` auf true gesetzt. Nennen Sie mir, welche Dateien der Build geschrieben hat; sie liegen unter `import-n8n/source/dist/`.Testen
Wenn der Stack so läuft, wie die Schritt-für-Schritt-Anleitung ihn ausführt — die Zugangsdaten gespeichert und der Workflow aktiv —, öffnen Sie http://127.0.0.1:5678 für den Editor von n8n und senden Sie dem Chat-Trigger eine Nachricht mit dem Benutzer und dem Passwort, die er speichert, gelesen aus CHAT_USER und CHAT_PASSWORD über die Standardeingabe von curl:
printf 'user = "%s:%s"\n' "$CHAT_USER" "$CHAT_PASSWORD" | curl --config - -sS -i -X POST \ http://127.0.0.1:5678/webhook/a3c9e1f2-4b5d-4e6f-8a7b-9c0d1e2f3a04/chat -H 'Content-Type: application/json' \ -d '{"action": "sendMessage", "sessionId": "s1", "chatInput": "In one short sentence: what does a support plan cover?"}'HTTP/1.1 500 Internal Server Error[… omitted: the response's other headers]
{"message":"Error in workflow"}Der Lauf hat einen Platzhalter für den OpenAI-Schlüssel gespeichert, daher hat der Workflow bei seinem Aufruf des Modells angehalten, und seine Ausführung im Editor zeigt die Ablehnung von OpenAI: Incorrect API key provided: sk-place*****************-key.
Mit --target helm importiert und auf Kubernetes angewendet, nimmt n8n dieselbe Nachricht unter derselben Adresse entgegen, sobald die Zugangsdaten gespeichert sind und der Workflow auf der laufenden Instanz aktiviert ist, wie die Schritt-für-Schritt-Anleitung zeigt, und ein lokaler Port an seinen Service weitergeleitet wird; der Lauf erhielt dort dieselbe Antwort:
kubectl port-forward -n <namespace> svc/n8n-default 5678:5678