Descripción general de las variables

Cómo fluyen los datos a través de sus workflows.

¿Qué son las variables?

Las variables son contenedores que almacenan datos a medida que estos se mueven por su workflow. Cada node puede leer y escribir variables, creando un pipeline de datos que transforma y enriquece la información en cada paso.

Template Engine

Ubex utiliza Pongo2, un potente motor de plantillas al estilo Django/Jinja2. Esto significa que dispone de mucho más que una simple sustitución de variables: puede usar condicionales, bucles y filtros directamente en sus prompts y configuraciones.

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

Consulte Template Syntax para la referencia completa.

Tipos de variables

Cómo fluyen las variables

1. Trigger – Los datos iniciales ingresan al workflow (payload de API, mensaje de chat, etc.)
2. Nodes – Cada node puede leer variables de entrada y producir variables de salida
3. Output – Las variables finales se devuelven o se almacenan

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

Acceso a las variables

Use llaves dobles para referenciar variables:

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

Variables integradas

Estas variables están disponibles automáticamente en cada workflow:

Variables de salida

Cada node almacena su resultado en una variable de salida. El nombre de la variable se define en la configuración del node:

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

Consejos

• Use nombres de variables descriptivos: customer_data en lugar de data1
• Revise la salida de los nodes anteriores en el registro de ejecución
• Use {{ variable | default:"fallback" }} para manejar valores faltantes
• Los arrays de consultas a bases de datos se pueden recorrer con {% for row in results %}