Ouvrir le Studio

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.

Nodes associés