For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Les étapes de code n’utilisent PAS la syntaxe Liquid

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

  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.

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.

Compile Research Text step whose Liquid template loops over Google Search results and formats the top competitor and company details
Utilisez Liquid pour mettre en forme les sorties des étapes précédentes.

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 ?