Variablen – Übersicht

So fließen Daten durch Ihre Workflows.

Was sind Variablen?

Variablen sind Behälter, die Daten aufnehmen, während diese durch Ihren Workflow fließen. Jeder Node kann Variablen lesen und schreiben und so eine Datenpipeline erzeugen, die Informationen bei jedem Schritt transformiert und anreichert.

Template Engine

Ubex verwendet Pongo2, eine leistungsstarke Template Engine im Django/Jinja2-Stil. Das bedeutet, dass Sie weit mehr als einfache Variablenersetzung nutzen können – Bedingungen, Schleifen und Filter lassen sich direkt in Ihren Prompts und Konfigurationen verwenden.

{% for item in items %}
  {{ item.name | upper }}: {{ item.value }}
{% endfor %}

Siehe Template Syntax für die vollständige Referenz.

Variablentypen

Wie Variablen fließen

1. Trigger – Initiale Daten gelangen in den Workflow (API-Payload, Chat-Nachricht usw.)
2. Nodes – Jeder Node kann Eingabevariablen lesen und Ausgabevariablen erzeugen
3. Output – Die endgültigen Variablen werden zurückgegeben oder gespeichert

[Trigger] → input_data
    ↓
[Model Node] → reads input_data, outputs llm_response
    ↓
[HTTP Node] → reads llm_response, outputs api_result
    ↓
[Output] → returns api_result

Zugriff auf Variablen

Verwenden Sie doppelte geschweifte Klammern, um Variablen zu referenzieren:

{{ variable_name }}
{{ user.profile.name }}
{{ items[0].title }}

Integrierte Variablen

Diese Variablen stehen in jedem Workflow automatisch zur Verfügung:

Ausgabevariablen

Jeder Node speichert sein Ergebnis in einer Ausgabevariable. Den Variablennamen legen Sie in der Node-Konfiguration fest:

• Model Node → {{ llm_response }}
• HTTP Node → {{ api_response }}
• Database Node → {{ query_result }}
• Code Node → {{ code_output }}

Tipps

• Verwenden Sie aussagekräftige Variablennamen: customer_data statt data1
• Prüfen Sie die Ausgabe vorheriger Nodes im Ausführungsprotokoll
• Nutzen Sie {{ variable | default:"fallback" }}, um fehlende Werte abzufangen
• Arrays aus Datenbankabfragen lassen sich mit {% for row in results %} durchlaufen