> 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/fr/actions/workflow-concepts/liquid-template.md).

# Templating Liquid

Une introduction à notre puissant langage de templating

## Qu’est-ce que Liquid ?

[Liquid](https://shopify.github.io/liquid/basics/introduction/) est un langage de template créé par Shopify et largement utilisé par d’autres pour créer du contenu dynamique. Il est utile pour référencer des variables, modifier du texte (par exemple le tronquer) et créer une logique de base (instructions if, boucles for, etc.).

Liquid peut être utilisé dans la plupart des domaines de notre produit, notamment :

* Champs de saisie dans les workflows
* Prompts LLM
* Étapes de texte
* Étapes de recherche dans la base de connaissances
* Étapes JSON

{% hint style="info" %}
Les étapes de code n’utilisent PAS la syntaxe Liquid
{% endhint %}

## Comment référencer des entrées avec Liquid

Cette section vous expliquera comment référencer vos variables d’entrée prédéfinies.

1. Assurez-vous d’avoir [configuré une étape d’entrée](https://docs.airops.com/docs/fr/actions/workflow-concepts/application-inputs.md)
2. Si vous n’avez pas saisi de nom de variable distinct, utilisez le nom de variable par défaut pour référencer la valeur d’entrée
3. Cliquez sur le sélecteur de variables violet pour voir la liste de vos entrées disponibles et sélectionnez l’entrée souhaitée

Dans l’exemple ci-dessous, nous expliquons comment utiliser la valeur de notre variable d’entrée et la référencer dans notre étape LLM à l’aide de la syntaxe Liquid.

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

## Comment référencer des sorties avec Liquid

Tout comme pour les entrées, vous pouvez référencer les sorties de n’importe quelle étape précédente de votre workflow dans n’importe quelle étape suivante.

Actuellement, les noms d’étape sont définis automatiquement de manière incrémentale, par ex. `step_1` ,`step_2` , `step_3` , etc.

Pour référencer la sortie d’une étape, cliquez simplement sur la pastille `step_number` ou saisissez-la manuellement au format `{{step_12.output}}` . Si cette étape renvoie du JSON, vous pouvez alors référencer n’importe laquelle des sous-clés.

Dans l’exemple ci-dessous, nous expliquons comment afficher la liste complète des variables disponibles et utiliser la syntaxe appropriée pour les appeler dans votre workflow.

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

### Consolider les sorties d’étape avec Liquid

L’une des applications les plus utiles de la syntaxe Liquid consiste à la combiner avec notre étape de texte afin d’effectuer un formatage supplémentaire et de s’assurer que votre sortie ressemble exactement à ce que vous souhaitez.

La capture d’écran ci-dessous montre comment nous référencions la sortie des étapes précédentes (en récupérant même des éléments spécifiques d’un tableau comme variables) pour formater notre « step\_2 » en une sortie plus lisible et mieux organisée.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-83e87e1e0226e601aca3866b172832cd4462e8d0%2Fliquid-01-compile-research.png?alt=media" alt="Compile Research Text step whose Liquid template loops over Google Search results and formats the top competitor and company details"><figcaption><p>Utilisez Liquid pour mettre en forme les sorties des étapes précédentes.</p></figcaption></figure>

### Cas d’utilisation avancés du templating Liquid

Le templating Liquid offre de puissantes capacités pour gérer des structures de données complexes dans vos workflows. Vous trouverez ci-dessous des techniques avancées pour travailler avec des itérateurs, des tableaux et des données structurées.

#### Parcourir les sorties d’un itérateur

Lorsque vous travaillez avec l’étape d’itération, vous pouvez utiliser les boucles de `pour` Liquid pour traiter les éléments du tableau de sortie. Ce modèle est couramment utilisé pour consolider des informations issues de plusieurs itérations en une seule sortie :

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

#### Traitement des résultats de recherche

**Extraction de contenu de base**

Extrayez et mettez en forme du contenu à partir de résultats de recherche ou de recherches dans la base de connaissances :

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

**Gestion des métadonnées**

Accédez aux métadonnées des résultats de recherche dans la base de connaissances et mettez-les en forme :

```
{% for result in step_4.output %}
  Titre : {{ result.metadata.title }}
  Description : {{ result.metadata.description }}
{% endfor %}
```

En maîtrisant ces techniques avancées de templating Liquid, vous pouvez transformer des structures de données complexes en sorties bien formatées, qui servent d’entrées parfaites pour les étapes suivantes de votre workflow.

### Plus d’informations

Pour plus d’informations concernant Liquid, nous vous recommandons de consulter [la documentation 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/fr/actions/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.
