Aktions-Nodes
Integrierte Aktions-Nodes für HTTP-Anfragen, Websuche, Code-Ausführung, Bildgenerierung und Ablaufsteuerung
Aktions-Nodes führen einzelne Operationen durch: Daten abrufen, Code ausführen, Bilder generieren, auf Bedingungen verzweigen und über Arrays iterieren. Jeder Node hat typisierte Eingaben (von vorherigen Nodes verdrahtet oder direkt eingegeben) und benannte Ausgaben (verfügbar für nachgelagerte Nodes).
HTTP-Anfrage
Sendet eine HTTP-Anfrage an eine beliebige URL und gibt die Antwort zurück.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| URL | Ja | Die vollständige URL, an die die Anfrage gesendet werden soll |
| Methode | Ja | HTTP-Methode: GET, POST, PUT, PATCH, DELETE |
| Header | Nein | Schlüssel-Wert-Paare, die als Anfrage-Header hinzugefügt werden |
| Body | Nein | Anfrage-Body (JSON, Formulardaten oder Rohtext) |
| Antworttyp | Nein | Wie die Antwort geparst werden soll: json (Standard), text oder file |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
response | any | Geparster Antwort-Body |
statusCode | number | HTTP-Statuscode |
file | WorkflowFile | Die heruntergeladene Datei, nur wenn Antworttyp file ist |
Websuche
Durchsucht das Web und gibt eine Liste von Ergebnissen zurück.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Abfrage | Ja | Die Suchabfrage |
| Max. Ergebnisse | Nein | Anzahl der zurückzugebenden Ergebnisse (1-100, Standard 10) |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
results | array | Array von Ergebnisobjekten, jeweils mit title, url, snippet |
resultCount | number | Anzahl der zurückgegebenen Ergebnisse |
RSS-Feed
Ruft einen RSS- oder Atom-Feed ab und parst ihn.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| URL | Ja | Die RSS/Atom-Feed-URL |
| Max. Elemente | Nein | Maximale Anzahl zurückzugebender Feed-Elemente (1-100, Standard 20) |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
items | array | Array von Feed-Elementen, jeweils mit title, link, description, pubDate, author |
feedTitle | string | Der Titel des Feeds |
feedDescription | string | Die Beschreibung des Feeds |
itemCount | number | Anzahl der zurückgegebenen Elemente |
Benutzerdefinierter Code
Führt ein JavaScript-Snippet aus. Verwenden Sie dies für Datentransformation, String-Manipulation, Berechnungen oder deterministische Logik, die keinen KI-Aufruf erfordert.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Code | Ja | Auszuführender JavaScript-Code. Ausgaben vorheriger Nodes sind als globale Variablen nach dem Node benannt verfügbar (z. B. trigger.outputs.formData). Verwenden Sie dg.log(), dg.warn(), dg.error() für Debug-Ausgaben, die im Ausführungsprotokoll sichtbar sind. |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
result | any | Der Wert, der durch den letzten Ausdruck in Ihrem Code zurückgegeben wird, oder der Wert von return |
Benutzerdefinierte Code-Nodes laufen in einer isolierten Node.js-Umgebung. Sie haben keinen Zugriff auf das Dateisystem, das Netzwerk (verwenden Sie dafür HTTP-Anfrage) oder externe Module. Die Ausführung ist synchron und hat ein Zeitlimit.
Beispiel:
const items = trigger.outputs.formData.items;
return items.filter((i) => i.status === 'open').map((i) => i.title);
Bildgenerierung
Generiert ein Bild aus einer Textbeschreibung mithilfe eines KI-Bildmodells.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Modell | Ja | Das zu verwendende Bildgenerierungsmodell |
| Prompt | Ja | Textbeschreibung des zu generierenden Bildes |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
image | WorkflowFile | Das generierte Bild als Workflow-Datei |
revisedPrompt | string | Der Prompt, wie er vom Modell interpretiert wurde (manche Modelle schreiben Prompts um) |
Datentabellen-Nodes
Datentabellen-Nodes lesen aus und schreiben in persistente Datentabellen. Im Gegensatz zu Node-Ausgaben bleiben Datentabelleninhalte über Workflow-Läufe hinweg erhalten.
Zeilen abrufen
Ruft Zeilen ab, die optionalen Filterbedingungen entsprechen.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Tabelle | Ja | Die Datentabelle, aus der gelesen werden soll |
| Filter | Nein | Spaltenbedingungen zum Filtern von Zeilen |
| Sortieren nach | Nein | Spalte, nach der Ergebnisse sortiert werden |
| Sortierrichtung | Nein | asc oder desc |
| Limit | Nein | Maximale Anzahl zurückzugebender Zeilen |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
rows | array | Übereinstimmende Zeilen als Objekte |
rowCount | number | Anzahl der zurückgegebenen Zeilen |
Zeile einfügen
Fügt eine neue Zeile zu einer Datentabelle hinzu.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Tabelle | Ja | Die Ziel-Datentabelle |
| Zeilendaten | Ja | Spalte → Wert-Zuordnung für die neue Zeile |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
rowId | string | ID der neu eingefügten Zeile |
row | object | Die vollständig eingefügte Zeile |
Zeilen aktualisieren
Aktualisiert alle Zeilen, die einem Filter entsprechen.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Tabelle | Ja | Die Ziel-Datentabelle |
| Filter | Ja | Bedingungen, die zu aktualisierende Zeilen identifizieren |
| Aktualisierungen | Ja | Auf übereinstimmenden Zeilen zu setzende Spaltenwerte |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
updatedCount | number | Anzahl der geänderten Zeilen |
Zeilen löschen
Entfernt alle Zeilen, die einem Filter entsprechen.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Tabelle | Ja | Die Ziel-Datentabelle |
| Filter | Ja | Bedingungen, die zu löschende Zeilen identifizieren |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
deletedCount | number | Anzahl der entfernten Zeilen |
Ablaufsteuerungs-Nodes
Bedingung
Wertet einen JavaScript-Ausdruck aus und leitet die Ausführung je nach Ergebnis an einen von mehreren Zweigen weiter.
Jeder Zweig hat einen Namen und einen Bedingungsausdruck. Der erste Zweig, dessen Ausdruck zu true ausgewertet wird, wird gewählt. Ein optionaler Standard-Zweig wird ausgeführt, wenn kein anderer Zweig übereinstimmt.
Beispielbedingungen:
// Zweig "Hohe Priorität"
trigger.outputs.priority === 'high';
// Zweig "Überprüfung erforderlich"
agent1.outputs.score < 0.7;
Schleifenanfang / Schleifenende
Iteriert über ein Array und führt die eingeschlossenen Nodes einmal für jedes Element aus.
Eingaben von Schleifenanfang:
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Array | Ja | Das zu iterierende Array. Referenzieren Sie eine vorherige Node-Ausgabe, die ein Array ist. |
Innerhalb des Schleifenkörpers stellt der Schleifenanfang-Node Folgendes bereit:
item: der Wert der aktuellen Iterationindex: nullbasierter Index des aktuellen Elements
Verbinden Sie den letzten Node im Schleifenkörper mit Schleifenende, um die Schleife zu schließen.
Ausgaben von Schleifenende:
| Ausgabe | Typ | Beschreibung |
|---|---|---|
results | array | Array der Ausgabe jeder Iteration (gesammelt vom Node, der mit Schleifenende verbunden ist) |
iterationCount | number | Gesamtanzahl der Iterationen |
Subworkflow-Aufruf
Ruft einen anderen Workflow (der einen Subworkflow-Trigger hat) auf, als wäre er eine Funktion. Die Ausführung pausiert, bis der Subworkflow abgeschlossen ist, und wird dann mit dessen Ausgaben fortgesetzt.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Workflow | Ja | Der aufzurufende Subworkflow |
| Parameter | Je nach Fall | Eingabewerte, die der Trigger des Subworkflows erwartet |
Ausgaben sind das, was der Trigger des Subworkflows als Rückgabewerte definiert.