Ouvrir le Studio

Pick List Item

Sélectionner un élément d'une liste par sa position

A quoi sert ce node ?

Le node Pick List Item sélectionne un seul élément d’une liste en fonction de sa position. Vous pouvez choisir le premier, le dernier, un élément aléatoire, ou un élément spécifique par index.

Usages courants :

  • Récupérer le premier résultat d’une réponse API
  • Choisir un élément aléatoire pour du test A/B
  • Sélectionner un élément spécifique par index dans une liste connue

Configuration rapide

Ajouter le node Pick List Item

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, Filter List) à l’entrée list.

Choisir un mode de sélection

Sélectionnez comment vous souhaitez choisir l’élément : first, last, random ou custom_index.

Utiliser la sortie

Connectez la sortie selected_item au node suivant de votre workflow.

Configuration

Entrée

list json required

La liste dans laquelle sélectionner un élément. Accepte tout tableau JSON valide.

Paramètres

pick_mode select default: first

Comment sélectionner l’élément dans la liste.

  • first — Sélectionner le premier élément
  • last — Sélectionner le dernier élément
  • random — Sélectionner un élément aléatoire
  • custom_index — Sélectionner un élément à un index spécifique
index number

L’index (base zéro) de l’élément à sélectionner. Utilisé uniquement lorsque pick_mode est défini sur custom_index.

Sortie

Une seule valeur selected_item contenant l’élément sélectionné.

{
  "selected_item": "banana"
}

Exemples

Récupérer le premier résultat d’une API

graph LR
    A[API Connector] --> B[Pick List Item]
    B --> C[LLM: Traiter le résultat]

Configuration :

  • pick_mode : first

L’API renvoie une liste de résultats. Pick List Item extrait le premier résultat pour que le LLM puisse le traiter directement sans gérer le tableau complet.

Sélection aléatoire pour du test A/B

graph LR
    A[Create List] --> B[Pick List Item]
    B --> C[LLM: Générer du contenu]

Configuration :

  • pick_mode : random

Créez une liste de variations de prompts, puis choisissez-en un aléatoirement à chaque exécution du workflow pour tester différentes approches.

Bonnes pratiques

  • Utiliser first pour des résultats déterministes. Lorsque vous souhaitez toujours le même élément d’une même liste, utilisez le mode first ou last pour garder votre workflow prévisible.
  • Combiner avec Filter List. Filtrez d’abord votre liste, puis sélectionnez le premier élément des résultats filtrés pour obtenir la meilleure correspondance.

Problèmes courants

Index hors limites

Lorsque vous utilisez custom_index, l’index doit être dans les limites de la liste (0 à longueur - 1). Si l’index dépasse la taille de la liste, le node échouera. Utilisez Count List Items au préalable pour valider la longueur de la liste.

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