Comment configurer l'étape Modifier la liste ?

À quoi sert-elle ?

« Modifier la liste » modifie une liste et écrit le résultat dans une nouvelle variable. La liste vient généralement de la réponse d'un Appel d'outil ou d'une Action d'intégration ; une réponse à choix multiple est aussi une liste.

Les visiteurs ne voient pas cette étape et l'avatar ne dit rien ; l'agent continue sans attendre le visiteur.

Pour l'ajouter, cliquez sur « Ajouter une étape » dans l'onglet « Éditeur », puis sur « Modifier la liste » dans la catégorie « Logique » ; l'étape est ajoutée au milieu du canevas. Ses réglages sont dans l'onglet « Contenu » du panneau d'étape, qui s'ouvre à droite quand vous cliquez sur l'étape.

Cette étape n'a pas de « Texte à l'écran » ; à la place, il y a une « Note d'étape » en bas du panneau. La note est pour vous seul : les visiteurs ne la voient pas, et elle n'est ni dite ni traduite.

Dans les valeurs, vous utilisez des variables des étapes précédentes, comme {city}. Pour un champ à l'intérieur d'une réponse, ajoutez son nom après un point : {order.status}. Le bouton « Insérer une variable » dans les champs liste les variables utilisables à cet endroit. Une variable pas encore remplie compte comme un texte vide.

Configurer l'étape

1. Dans « Liste », écrivez le chemin vers la liste elle-même, comme {answer.items} ; la réponse entière n'est pas une liste. Si la liste est dans la réponse d'un Appel d'outil, cliquez sur « Récupérer des exemples » pour appeler l'outil une fois : vous choisissez l'une des « Listes dans la réponse » et voyez les « Champs de la première ligne ».
2. Activez les opérations voulues (voir ci-dessous).
3. Saisissez le « Nom de la variable » où le résultat est écrit. {list} donne toute la liste, {list.1.field} un champ du premier élément.

Opérations

Les opérations s'exécutent toujours dans cet ordre, pour que des résultats comme « les 5 moins chers » soient justes :

• « Filtrer » : seuls les éléments qui respectent les règles restent. Les règles fonctionnent comme dans l'étape Condition ; écrivez le champ de l'élément sous la forme {item.field} ({item} si l'élément est une valeur simple). Sans règles, rien n'est filtré.
• « Trier » : tapez dans le champ ouvert le champ de tri (par exemple price) et choisissez « Croissant » ou « Décroissant ». Les nombres sont triés comme des nombres, les dates comme des dates et le reste par ordre alphabétique ; les éléments à valeur vide vont à la fin.
• « Retirer les doublons » : tapez dans le champ ouvert le champ à comparer ; parmi les éléments de même valeur, seul le premier reste. Comme cela s'exécute après le tri, celui du haut reste. Sans champ, l'élément entier est comparé.
• « Garder les N premiers éléments » : seuls restent autant d'éléments que le nombre saisi, à partir du haut de la liste.

Utiliser le résultat

Vous pouvez utiliser le résultat dans les étapes suivantes : l'afficher en options dans une étape Sélection avec « Source des options » › « Depuis une variable », exécuter les mêmes étapes pour chaque élément avec une étape Boucle, ou le compter ou l'additionner avec le « Résumé de liste » de Définir des variables. Si le résultat est très long (environ 16 000 caractères), des éléments sont retirés à la fin.

Exemple

Un Appel d'outil écrit les créneaux disponibles dans {answer}. Dans Modifier la liste : « Liste » {answer.slots} ; « Filtrer » {item.seats} · « Nombre » · « est supérieur à » · 0 ; « Trier » par le champ start, « Croissant » ; « Garder les N premiers éléments » 5 ; « Nom de la variable » next_slots. Une étape Sélection avec la source « Depuis une variable » propose alors les cinq créneaux les plus proches.

Points d'attention

L'éditeur vous avertit quand : aucune liste n'est choisie, le nom de variable est invalide, ou une règle de filtre ne regarde pas le champ de l'élément (une telle règle donne le même résultat pour chaque élément). Si le chemin écrit ne mène pas à une liste, les exemples affichent « Ce chemin ne mène pas à une liste ; le résultat reste vide. » Pour l'étape Appel d'outil, voir Étapes Action d'intégration et Appel d'outil.

Les noms de variables ne peuvent utiliser que les lettres a–z, les chiffres et les tirets bas (_) ; les lettres accentuées et les espaces disparaissent à la saisie. « system » est réservé aux variables système : choisissez un autre nom.

Les problèmes n'empêchent pas d'enregistrer : l'agent est enregistré, mais l'étape incomplète ne fonctionnera pas comme prévu dans la conversation. Corrigez les étapes signalées, puis testez l'agent avec « Aperçu ». Pour trouver les étapes signalées, voir l'éditeur de flux.