Prezentare generală a variabilelor

Cum circulă datele prin workflow-urile dumneavoastră.

Ce sunt variabilele?

Variabilele sunt containere care stochează date pe măsură ce acestea traversează workflow-ul. Fiecare node poate citi și scrie variabile, creând un pipeline de date care transformă și îmbogățește informațiile la fiecare pas.

Template Engine

Ubex folosește Pongo2, un motor de template-uri puternic, în stilul Django/Jinja2. Aceasta înseamnă că aveți la dispoziție mult mai mult decât o simplă substituție de variabile – puteți folosi condiții, bucle și filtre direct în prompt-uri și configurații.

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

Consultați Template Syntax pentru referința completă.

Tipuri de variabile

Cum circulă variabilele

1. Trigger – Datele inițiale intră în workflow (payload API, mesaj de chat etc.)
2. Nodes – Fiecare node poate citi variabile de intrare și produce variabile de ieșire
3. Output – Variabilele finale sunt returnate sau stocate

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

Accesarea variabilelor

Folosiți acolade duble pentru a referenția variabile:

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

Variabile integrate

Aceste variabile sunt disponibile automat în fiecare workflow:

Variabile de ieșire

Fiecare node își stochează rezultatul într-o variabilă de ieșire. Numele variabilei se definește în configurația node-ului:

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

Sfaturi

• Folosiți nume descriptive pentru variabile: customer_data în loc de data1
• Verificați ieșirea node-urilor anterioare în jurnalul de execuție
• Folosiți {{ variable | default:"fallback" }} pentru a gestiona valorile lipsă
• Array-urile din interogări de baze de date pot fi parcurse cu {% for row in results %}