Loop
Le bloc Loop est un bloc conteneur dans Ekinox qui vous permet de créer des flux de travail itératifs en exécutant un groupe de blocs de façon répétée. Les boucles permettent un traitement itératif dans vos flux de travail.
Le bloc Loop prend en charge deux types d'itération :
Les blocs Loop sont des nœuds conteneurs qui peuvent contenir d'autres blocs. Les blocs à l'intérieur d'une boucle s'exécuteront plusieurs fois selon votre configuration.
Aperçu
Le bloc Loop vous permet de :
Itérer sur des collections : traiter des tableaux ou des objets un élément à la fois
Répéter des opérations : exécuter des blocs un nombre fixe de fois
Traitement séquentiel : gérer la transformation des données dans des itérations ordonnées
Agréger les résultats : collecter les sorties de toutes les itérations de la boucle
Comment ça fonctionne
Le bloc Loop exécute les blocs contenus par itération séquentielle :
- Initialisation de la boucle - Configuration des paramètres d'itération (compteur ou collection)
- Exécution de l'itération - Exécution des blocs contenus pour l'itération actuelle
- Collecte des résultats - Stockage de la sortie de chaque itération
- Continuer ou terminer - Passer à l'itération suivante ou terminer la boucle
Options de configuration
Type de boucle
Choisissez entre deux types de boucles :
For Loop (Itérations) - Une boucle numérique qui s'exécute un nombre fixe de fois :
Utilisez cette option lorsque vous devez répéter une opération un nombre spécifique de fois.
Example: Run 5 times
- Iteration 1
- Iteration 2
- Iteration 3
- Iteration 4
- Iteration 5Boucle ForEach (Collection) - Une boucle basée sur une collection qui itère sur chaque élément d'un tableau ou d'un objet :
Utilisez cette option lorsque vous devez traiter une collection d'éléments.
Example: Process ["apple", "banana", "orange"]
- Iteration 1: Process "apple"
- Iteration 2: Process "banana"
- Iteration 3: Process "orange"Comment utiliser les boucles
Création d'une boucle
- Faites glisser un bloc Boucle depuis la barre d'outils vers votre canevas
- Configurez le type de boucle et les paramètres
- Faites glisser d'autres blocs à l'intérieur du conteneur de boucle
- Connectez les blocs selon vos besoins
Accès aux résultats
Une fois qu'une boucle est terminée, vous pouvez accéder aux résultats agrégés :
<loop.results>: tableau des résultats de toutes les itérations de la boucle
Exemples de cas d'utilisation
Traitement des résultats d'API
Scénario : traiter plusieurs enregistrements clients
- Le bloc API récupère la liste des clients
- La boucle ForEach itère sur chaque client
- À l'intérieur de la boucle : l'agent analyse les données client
- À l'intérieur de la boucle : la fonction stocke les résultats d'analyse
Génération itérative de contenu
Scénario : générer plusieurs variations
- Définir une boucle For à 5 itérations
- À l'intérieur de la boucle : l'agent génère une variation de contenu
- À l'intérieur de la boucle : l'évaluateur note le contenu
- Après la boucle : la fonction sélectionne la meilleure variation
Fonctionnalités avancées
Limitations
Les blocs conteneurs (Boucles et Parallèles) ne peuvent pas être imbriqués les uns dans les autres. Cela signifie :
- Vous ne pouvez pas placer un bloc Boucle à l'intérieur d'un autre bloc Boucle
- Vous ne pouvez pas placer un bloc Parallèle à l'intérieur d'un bloc Boucle
- Vous ne pouvez pas placer un bloc conteneur à l'intérieur d'un autre bloc conteneur
Si vous avez besoin d'une itération multidimensionnelle, envisagez de restructurer votre flux de travail pour utiliser des boucles séquentielles ou traiter les données par étapes.
Les boucles s'exécutent séquentiellement, pas en parallèle. Si vous avez besoin d'une exécution simultanée, utilisez plutôt le bloc Parallèle.
Entrées et sorties
Type de boucle : choisissez entre 'for' ou 'forEach'
Itérations : nombre de fois à exécuter (pour les boucles for)
Collection : tableau ou objet à parcourir (pour les boucles forEach)
loop.currentItem : élément en cours de traitement
loop.index : numéro d'itération actuel (base 0)
loop.items : collection complète (boucles forEach)
loop.results : tableau de tous les résultats d'itération
Structure : les résultats conservent l'ordre d'itération
Accès : disponible dans les blocs après la boucle
Bonnes pratiques
- Définir des limites raisonnables : gardez un nombre d'itérations raisonnable pour éviter des temps d'exécution longs
- Utiliser ForEach pour les collections : lors du traitement de tableaux ou d'objets, utilisez les boucles ForEach plutôt que les boucles For
- Gérer les erreurs avec élégance : envisagez d'ajouter une gestion des erreurs à l'intérieur des boucles pour des flux de travail robustes