Templating Liquid
Une introduction à notre puissant langage de templating
Qu’est-ce que Liquid ?
Liquid 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
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.
Assurez-vous d’avoir configuré une étape d’entrée
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
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.
Unexpected error with integration arcade: Integration is not installed on this space
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.
Unexpected error with integration arcade: Integration is not installed on this space
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.

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 :
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 :
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 :
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.
Mis à jour
Ce contenu vous a-t-il été utile ?