Boucles et sous-workflows

L'action Boucle permet de parcourir une liste et d'appeler un sous-workflow pour chaque élément. Elle sert à traiter plusieurs lignes, URLs, fichiers, clients ou résultats sans dupliquer les mêmes actions sur le canevas.

Deux éléments travaillent ensemble :

Action Boucle : placée dans le workflow parent, elle définit la liste à parcourir et le sous-workflow à appeler.
Déclencheur Workflow : placé dans le workflow enfant, il reçoit l'élément courant et le contexte de boucle.

Le déclencheur Workflow est conçu pour être appelé par une action Boucle. Pour un lancement manuel ou externe, utilisez plutôt les déclencheurs Manuel, Webhook, Formulaire, Email ou Projet.

Préparer le sous-workflow

Créez une nouvelle automatisation.

Sélectionnez le nœud de déclencheur.

Choisissez le type Workflow.

Ajoutez les actions à exécuter pour un seul élément.

Dans les champs de configuration, tapez @ pour utiliser item, loop.index ou loop.total.

Le sous-workflow reçoit :

Variable	Description
`item`	Élément courant transmis par la boucle.
`loop.index`	Position de l'élément dans la liste, en commençant à 0.
`loop.total`	Nombre total d'éléments à traiter.

Configurer la boucle

Dans le workflow parent, ajoutez l'action Boucle depuis la catégorie Logique.

Champ	Description
Éléments	Liste à parcourir. Elle peut venir d'un nœud amont ou être saisie directement.
Liste amont	Sélectionne un tableau produit par une étape précédente, par exemple une liste d'URLs.
Liste littérale	Liste saisie dans le champ, au format CSV simple ou JSON.
Sous-workflow	Automatisation appelée pour chaque élément.
Nom de la variable d'élément	Nom sous lequel l'élément est transmis. Par défaut : `item`.
Mode d'entrée des éléments	Envoie l'élément seul ou le fusionne avec l'entrée de la boucle.
En cas d'erreur sur un élément	Arrête la boucle ou continue avec l'élément suivant.
Éléments max	Limite le nombre d'éléments traités.

Les éléments sont traités un par un. Cela rend les résultats plus faciles à suivre et limite les effets de bord sur les services externes.

Choisir la source de la liste

Liste amont

Utilisez ce mode lorsqu'une action précédente produit déjà un tableau :

Recherche Web
  ↓
Boucle (éléments = @Recherche Web.results)
  ↓
Sous-workflow d'analyse

Liste littérale

Utilisez ce mode pour une liste simple :

client-a, client-b, client-c

Ou une liste JSON :

["https://exemple.com/a", "https://exemple.com/b"]

Patterns courants

Analyser plusieurs pages web

Tavily Search
  ↓
Boucle sur les résultats
  ↓
Sous-workflow : Tavily Extract → Générer du texte

Produire un livrable par élément

Webhook ou Formulaire
  ↓
Boucle sur une liste de lignes
  ↓
Sous-workflow : Générer du texte → Créer un document

Continuer malgré certaines erreurs

Si chaque élément est indépendant, choisissez Continuer avec l'élément suivant. Si une erreur rend le résultat global invalide, choisissez Arrêter la boucle.

Bonnes pratiques

Testez d'abord le sous-workflow avec un seul exemple.
Donnez des noms explicites aux nœuds : ils seront plus faciles à retrouver dans les logs.
Limitez le nombre d'éléments pendant la phase de test.
Préférez une liste amont typée quand elle existe : l'autocomplétion @ réduit les erreurs de champ.