Aktionsknoten

Nicht-LLM-programmatische Knoten für deterministische Workflow-Operationen. Aktionsknoten ergänzen LLM-Agenten, indem sie Datenumwandlung, API-Integrationen, Kontrollfluss und Automatisierungslogik handhaben.

Übersicht

Aktionsknoten unterscheiden sich visuell von LLM-Agentenknoten — sie verwenden einzigartige Farben und Symbole, um Workflows leicht scannbar zu machen. Jeder Knotentyp handhabt eine spezifische Kategorie von Operationen, von HTTP-Anfragen über Datenbankabfragen bis hin zu bedingten Verzweigungen.

Alle Aktionsknoten teilen eine Reihe von Standardeigenschaften für Fehlerbehandlung, Tracing, Ausführungssteuerung und I/O-Mapping. Sie unterstützen {{variable}} Interpolation in String-Feldern und empfangen automatisch die Ausgaben von Vorgängerknoten.

Verfügbare Knoten

Standardeigenschaften

Jeder Aktionsknoten erbt diese gemeinsamen Eigenschaften:

Identität

Fehlerbehandlung

Tracing

Ausführungssteuerung

Eingabe-/Ausgabe-Zuordnung

Knotenreferenz

Trigger-Knoten 🎯

Einstiegspunkt des Workflows. Jeder Workflow beginnt mit einem Trigger-Knoten. Siehe den dedizierten Trigger-Leitfaden für weitere Details.

HTTP-Knoten 🌐

Führt HTTP-Anfragen an externe APIs mit vollständiger Authentifizierung, Header-, Body- und Antwortverarbeitung durch.

Konfiguration:

Beispiel:

{
  "type": "http",
  "name": "Fetch User Data",
  "method": "GET",
  "url": "https://api.example.com/users/{{userId}}",
  "auth": {
    "type": "bearer",
    "bearer": { "token": "{{API_TOKEN}}" }
  },
  "headers": { "Accept": "application/json" },
  "body": { "type": "none" },
  "response": { "type": "json", "jsonPath": "$.data" },
  "errorHandling": { "mode": "retry", "retryCount": 3, "retryDelay": 1000 },
  "mapping": { "outputKey": "userData" }
}

Setzen-Knoten 📝

Definiert und manipuliert Workflow-Zustandsvariablen. Unterstützt literale Werte, Ausdrücke und Geheimnisse.

Konfiguration:

Variablentypen: string, number, boolean, json, expression

Variablen, die mit isSecret: true gekennzeichnet sind, werden in Protokollen und der Benutzeroberfläche maskiert.

Transformationsknoten ⚙️

Transformiert Daten mithilfe von Ausdrücken oder integrierten Operationen.

Transformationstypen:

Eingebaute Operationen: pick, omit, rename, flatten, sort, unique

Typumwandlungsziele: string, number, boolean, array, object

Switch-Knoten 🔀

Bedingte Verzweigung mit mehreren Ausgabeports. Jede Bedingung wird einem separaten Ausgabeport am Knoten zugeordnet.

Konfiguration:

Bedingungsoperatoren: eq, neq, gt, lt, gte, lte, contains, startsWith, endsWith, matches, in, empty, exists

Beispiel:

{
  "type": "switch",
  "evaluationMode": "first_match",
  "conditions": [
    { "id": "ok", "name": "Success", "field": "status", "operator": "eq", "value": "success", "outputPort": "success" },
    { "id": "err", "name": "Error", "field": "status", "operator": "eq", "value": "error", "outputPort": "error" }
  ],
  "defaultBranch": "unknown"
}

Schleifen-Knoten 🔄

Iteriert über Arrays, wiederholt eine feste Anzahl von Malen oder läuft in einer Schleife, solange eine Bedingung erfüllt ist.

Schleifentypen:

Parallele Ausführung: Aktivieren Sie parallel.enabled mit optionalem batchSize und delayBetween für gleichzeitige Iteration.

Ergebnisaggregation: Wenn results.collect wahr ist, werden die Iterationsergebnisse in einem Array unter results.aggregationKey gesammelt.

Merge-Knoten 🔗

Führt mehrere parallele Zweige wieder zu einem einzigen Fluss zusammen. Hat mehrere Eingangsports.

Merge-Modi:

Strategien kombinieren: array, object, first, last

Optionales Timeout mit continue oder error Verhalten.

Warteknoten ⏱️

Pausiert die Workflow-Ausführung.

Wartetypen:

Code-Knoten 💻

Führt benutzerdefiniertes JavaScript in einer Sandboxed boa_engine runtime aus. Der Graph-Zustand wird als globales input Objekt injiziert.

Konfiguration:

Sandbox-Standardeinstellungen:

Datenbank-Knoten 🗄️

Führt Datenbankoperationen mit Verbindungspooling und parametrisierten Abfragen aus.

Unterstützte Datenbanken:

Verbindungszeichenfolgen werden als Geheimnisse behandelt und in Protokollen maskiert.

E-Mail-Knoten 📧

Senden Sie E-Mails über SMTP oder überwachen Sie eingehende E-Mails über IMAP.

Sendemodus (SMTP):

• TLS/SSL-Unterstützung
• Authentifizierung
• An/CC/BCC-Empfänger
• HTML- oder Nur-Text-Nachrichtentext
• {{variable}}-Interpolation in Betreff und Nachrichtentext
• Dateianhänge aus dem Zustand

Überwachungsmodus (IMAP):

• Ordnerauswahl (Standard: INBOX)
• Filter: Absender, Betreff, Datumsbereich, nur ungelesen
• Nach der Verarbeitung als gelesen markieren

Benachrichtigungsknoten 🔔

Sendet Benachrichtigungen an Messaging-Plattformen.

Kanäle: Slack, Discord, Microsoft Teams, benutzerdefinierter Webhook

Nachrichtenformate: Nur-Text, Markdown, plattformspezifische Blöcke (Block Kit, Embeds, Adaptive Cards)

RSS-Knoten 📡

Überwacht RSS/Atom-Feeds auf neue Einträge.

• Konfigurierbares Abfrageintervall
• Filter nach Stichwort, Autor, Kategorie und Datum
• Verfolgung bereits gesehener Elemente zur Vermeidung von Duplikaten
• Optional vollständiger Inhalt oder nur Zusammenfassung

Dateiknoten 📁

Dateioperationen auf lokalem oder Cloud-Speicher.

Operationen: lesen, schreiben, löschen, auflisten

Cloud-Anbieter: Amazon S3, Google Cloud Storage, Azure Blob Storage

Dateiformate: JSON, CSV, XML, Text, Binär (mit CSV-Parsing-Optionen für Trennzeichen, Header, Anführungszeichen)

---

Variableninterpolation

Alle String-Felder in Aktionsknoten unterstützen die {{variable}}-Syntax für dynamische Werte:

https://api.example.com/users/{{userId}}
Bearer {{API_TOKEN}}
Hello {{user.name}}, your order {{orderId}} is ready.

Variablen werden zur Ausführungszeit aus dem Workflow-Zustand aufgelöst. Die Punktnotation (user.name) greift auf verschachtelte Werte zu.

Multi-Port-Knoten

Zwei Knotentypen haben dynamische Port-Anzahlen:

• Switch — ein Ausgangsport pro Bedingung, plus ein optionaler Standardport
• Merge — mehrere Eingangsports, einer pro eingehendem Zweig

Diese Ports werden visuell auf dem Knoten dargestellt und verbinden sich mit verschiedenen nachgeschalteten/vorgeschalteten Knoten.

---

Codegenerierung

Aktionsknoten kompilieren zu Produktions-Rust-Code neben LLM-Agents. Abhängigkeiten werden automatisch erkannt und dem generierten Cargo.toml hinzugefügt.

Alle generierten Codes verwenden adk-graph FunctionNode closures mit GraphError::NodeExecutionFailed zur Fehlerbehandlung.

Beispiel für generierten Code (HTTP-Knoten):

let http_node = FunctionNode::new("fetch_data", |ctx| async move {
    let client = reqwest::Client::new();
    let resp = client.get("https://api.example.com/data")
        .bearer_auth(&ctx.get("API_TOKEN").unwrap_or_default())
        .send().await
        .map_err(|e| GraphError::NodeExecutionFailed {
            node: "fetch_data".into(),
            message: e.to_string(),
        })?;
    let body: serde_json::Value = resp.json().await?;
    Ok(NodeOutput::new().with_update("apiData", body))
});

Beispiel für generierten Code (Code-Knoten):

let code_node = FunctionNode::new("process", |ctx| async move {
    let mut js_ctx = boa_engine::Context::default();
    // Graph state injected as global `input` object
    // User code executed in thread-isolated sandbox
    Ok(NodeOutput::new().with_update("result", output))
});

---

Zurück: ← Studio | Weiter: Triggers →