Split List
Diviser une liste en lots plus petits d'une taille donnée
A quoi sert ce node ?
Le node Split List divise une liste en lots plus petits d’une taille donnée. Il renvoie un tableau de tableaux, où chaque tableau interne contient au maximum batch_size éléments.
Usages courants :
- Regrouper des appels API pour respecter les limites de débit
- Découper des données pour un traitement parallèle
- Paginer des résultats pour l’affichage ou les nodes suivants
Configuration rapide
Ajouter le node Split List
Glissez-le sur le canvas depuis le panneau Tools.
Connecter une entrée de type liste
Connectez la sortie d’un node qui produit une liste (par exemple, Create List, Google Sheets) à l’entrée list.
Définir la taille des lots
Configurez batch_size pour contrôler le nombre d’éléments que chaque lot doit contenir.
Utiliser la sortie
Connectez la sortie batches au node suivant de votre workflow (généralement un node Loop).
Configuration
Entrée
list json required La liste à diviser en lots. Accepte tout tableau JSON valide.
Paramètres
batch_size number default: 2 Le nombre d’éléments par lot. Minimum : 1. Maximum : 100.
Le dernier lot peut contenir moins d’éléments si la taille de la liste n’est pas divisible par la taille du lot.
Sortie
Une valeur batches contenant un tableau de tableaux.
{
"batches": [
["apple", "banana"],
["cherry", "date"],
["elderberry"]
]
}
Exemples
Regrouper des appels API pour respecter les limites de débit
graph LR
A[Create List] --> B[Split List]
B --> C[Loop]
C --> D[API Connector]
Configuration :
batch_size:10
Vous avez une liste de 100 URLs à traiter. Split List les divise en lots de 10, et le node Loop envoie chaque lot à l’API un par un, en restant dans les limites de débit.
Découper des données pour un traitement parallèle
graph LR
A[Google Sheets] --> B[Split List]
B --> C[Loop]
C --> D[LLM: Analyser le lot]
D --> E[Merge Lists]
Configuration :
batch_size:5
Un tableur contient 50 lignes. Split List crée 10 lots de 5 lignes chacun. Chaque lot est envoyé à un LLM pour analyse, et les résultats sont fusionnés ensemble.
Bonnes pratiques
- Choisir la taille du lot en fonction des limites en aval. Si votre API autorise 10 éléments par requête, définissez
batch_sizeà 10. Si votre LLM a une limite de tokens, ajustez la taille du lot pour que chaque lot reste dans cette limite. - Combiner avec Loop et Merge Lists. Le schéma typique est : Split List pour créer les lots, Loop pour itérer dessus, puis Merge Lists pour réassembler les résultats.
Problèmes courants
La sortie est un seul lot contenant tous les éléments
Vérifiez que batch_size est inférieur au nombre total d’éléments dans la liste. Si batch_size est supérieur ou égal à la longueur de la liste, la sortie sera un seul lot contenant la liste entière.
L'entrée n'est pas reconnue comme une liste
L’entrée list doit être un tableau JSON valide (par exemple ["a", "b", "c"]). Si vous passez une chaîne de caractères simple ou un objet, le node ne fonctionnera pas correctement. Assurez-vous que le node en amont produit un format de liste correct.