> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/acciones/workflow-concepts/liquid-template.md).

# Plantillas Liquid

Una introducción a nuestro potente lenguaje de plantillas

## ¿Qué es Liquid?

[Liquid](https://shopify.github.io/liquid/basics/introduction/) es un lenguaje de plantillas creado por Shopify y utilizado ampliamente por otros para crear contenido dinámico. Es útil para referenciar variables, modificar texto (por ejemplo, truncarlo) y para crear lógica básica (sentencias if, bucles for, etc.).

Liquid se puede usar en la mayoría de las áreas de nuestro producto, incluidas:

* Campos de entrada en los flujos de trabajo
* Prompts de LLM
* Pasos de texto
* Pasos de búsqueda en la base de conocimientos
* Pasos de JSON

{% hint style="info" %}
Los pasos de código NO usan la sintaxis de Liquid
{% endhint %}

## Cómo referenciar entradas con Liquid

Esta sección explicará cómo referenciar sus variables de entrada predefinidas.

1. Asegúrate de tener [configurado un paso de entrada](/docs/es/acciones/workflow-concepts/application-inputs.md)
2. Si no ingresaste un nombre de variable separado, usa el nombre de variable predeterminado para referenciar el valor de entrada
3. Haz clic en el selector de variables morado para ver una lista de tus entradas disponibles y seleccionar la entrada deseada

En el ejemplo a continuación, repasamos cómo usar el valor de nuestra variable de entrada y referenciarlo en nuestro paso de LLM usando la sintaxis de Liquid.

{% @arcade/embed url="<https://app.arcade.software/share/OMkzzu6SdRcxNWMEWIBm>" flowId="OMkzzu6SdRcxNWMEWIBm" %}

## Cómo referenciar salidas con Liquid

Al igual que con las entradas, puedes referenciar las salidas de cualquier paso anterior de tu flujo de trabajo en cualquier paso posterior.

Actualmente, los nombres de los pasos se definen automáticamente de forma incremental, por ejemplo `step_1` ,`step_2` , `step_3` , etc.

Para referenciar la salida de un paso, simplemente haz clic en la `step_number` pastilla o escríbelo manualmente en el formato `{{step_12.output}}` . Si ese paso devuelve JSON, entonces puedes referenciar cualquiera de las subclaves.

En el ejemplo a continuación, repasamos cómo puedes ver la lista completa de variables disponibles y usar la sintaxis adecuada para llamarlas dentro de tu flujo de trabajo.

{% @arcade/embed url="<https://app.arcade.software/share/OMkzzu6SdRcxNWMEWIBm>" flowId="OMkzzu6SdRcxNWMEWIBm" %}

### Consolidación de salidas de pasos usando Liquid

Una de las aplicaciones más útiles de la sintaxis de Liquid es combinarla con nuestro paso de texto para realizar formato adicional y asegurarte de que tu salida se vea exactamente como deseas.

La captura de pantalla a continuación muestra cómo referenciamos la salida de pasos anteriores (incluso extrayendo elementos específicos de un arreglo como variables) para formatear nuestro "step\_2" en una salida más legible y organizada.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-685d5c894435024bb69ec29446a5b82aa67fdbbe%2FCleanShot%202025-03-04%20at%2007.12.15%402x.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### Casos de uso avanzados de plantillas Liquid

Las plantillas Liquid ofrecen potentes capacidades para manejar estructuras de datos complejas en tus flujos de trabajo. A continuación, se presentan técnicas avanzadas para trabajar con iteradores, arreglos y datos estructurados.

#### Recorrer las salidas del iterador

Cuando trabajas con el paso de iteración, puedes usar los `for` bucles para procesar los elementos del arreglo de salida. Este patrón se usa comúnmente para consolidar información de múltiples iteraciones en una sola salida:

```
{% for chunk in step_12.output %}
  {{ chunk }}
{% endfor %}
```

#### Procesamiento de resultados de búsqueda

**Extracción básica de contenido**

Extrae y formatea contenido de resultados de búsqueda o búsquedas en la base de conocimientos:

```
{% for result in step_3.output %}
  {{ result.content }}
{% endfor %}
```

**Manejo de metadatos**

Accede y formatea metadatos de resultados de búsqueda en la base de conocimientos:

```
{% for result in step_4.output %}
  Título: {{ result.metadata.title }}
  Descripción: {{ result.metadata.description }}
{% endfor %}
```

Al dominar estas técnicas avanzadas de plantillas Liquid, puedes transformar estructuras de datos complejas en salidas bien formateadas que sirven como entradas perfectas para los pasos posteriores de tu flujo de trabajo.

### Más información

Para obtener información adicional sobre Liquid, te recomendamos revisar [Documentación de Shopify](https://shopify.github.io/liquid/).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/acciones/workflow-concepts/liquid-template.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
