Transformation par lots

Outil d'agent intégré qui traite un fichier CSV ligne par ligne et ajoute des colonnes générées par l'IA en fonction d'une tâche que vous définissez.

Ce qu’il fait

La transformation par lots est un outil intégré qui traite un fichier CSV ligne par ligne et y ajoute des colonnes générées par l’IA. Vous lui donnez un fichier CSV source, une tâche qui décrit ce qu'il faut faire pour chaque ligne et les colonnes que vous souhaitez ajouter. Elle renvoie un nouveau fichier avec ces colonnes renseignées.

Vous associez la transformation par lots à un Agent autonome en tant qu’outil. L'agent appelle l'outil pendant son raisonnement, lui transmet le fichier source et la tâche, et utilise le fichier transformé dans le reste de son travail.

Le nœud est intitulé Transformation par lots dans la palette, dans la catégorie des outils intégrés.

Quand l’utiliser

Utilisez la transformation par lots lorsqu’un agent doit enrichir ou classifier en bloc les lignes d’un fichier CSV et que chaque ligne a besoin du même traitement piloté par l’IA.

Tâches typiques:

• Classer chaque ligne dans une catégorie et écrire le libellé dans une nouvelle colonne.
• Extraire une valeur d'un champ de texte libre dans sa propre colonne.
• Notez, résumez ou balisez chaque ligne en fonction de ses colonnes existantes.

Pour extraire des données structurées d’un même document plutôt que de transformer des lignes tabulaires, connectez plutôt une ressource d’extraction de documents . Pour analyser le contenu des fichiers qui ne sont pas des fichiers CSV orientés ligne, utilisez l’outil intégré Analyser les fichiers .

Ajouter l’outil

Ajoutez l’outil au canevas, puis connectez-le à un agent.

1. Sélectionnez un nœud d'agent autonome ou ajoutez-en un si votre flux ne l'a pas encore.
2. Ouvrez la palette de nœuds et sélectionnez la catégorie Outils intégrés .
3. Sélectionnez Transformation par lots. Flow ajoute le nœud à la zone de dessin.
4. Dessinez un bord depuis le nœud Transformation par lots vers la poignée de l’outil de l’agent.
5. Sélectionnez le nœud Transformation par lots pour ouvrir son panneau Propriétés et le configurer.

Résultat: l’outil de transformation par lots est connecté à l’agent. L'agent peut désormais l'appeler pendant son raisonnement.

Référence de la configuration

Configurez ces champs dans la section Paramètres de transformation par lots du panneau Propriétés.

Champ	Requis	Default	Description
Source (fichier)	Oui (Yes)	Aucun (None)	Fichier CSV à transformer. Référencez un fichier produit en amont dans le flux ou fourni par l’agent lorsqu’il appelle l’outil.
Tâche de transformation par lots	Oui (Yes)	Aucun (None)	Instructions que l’outil s’applique à chaque ligne. Décrivez ce qu’il faut analyser, ce qu’il faut extraire et comment remplir les colonnes de sortie.
Colonnes de sortie	Oui (Yes)	Aucun (None)	Les colonnes que l’outil ajoute au fichier. Définissez au moins une colonne avec un nom et une description, et ajoutez jusqu’à 10 colonnes.
Nom de la colonne	Oui (Yes)	Aucun (None)	En-tête de la nouvelle colonne dans le fichier de sortie.
Description	Oui (Yes)	Aucun (None)	Contenu que la colonne doit contenir. L’outil utilise cette valeur pour décider ce qu’il faut écrire pour chaque ligne, alors spécifiez le format attendu.
Ancrage avec recherche sur le Web	Non (No)	Activé (Enabled)	Indique si l'outil peut utiliser la recherche Web pour ancrer ou enrichir ses résultats. Sélectionnez Désactivé pour utiliser uniquement le fichier et la tâche sources.

Entrées et sorties

Entrée

La transformation par lots prend son entrée à partir des champs que vous configurez: le fichier CSV source, la tâche, les colonnes de sortie et le paramètre d’ancrage de la recherche Web. Étant donné qu'il s'exécute en tant qu'outil, l'agent appelant fournit ces valeurs lorsqu'il invoque l'outil lors d'une exécution.

Sortie

La transformation par lots renvoie un fichier: le fichier CSV source avec les colonnes de sortie ajoutées et renseignées. Accédez-y à l' $vars.<nodeName>.output, où <nodeName> est le nom du nœud de la transformation par lots.

$vars.batchTransform1.output

Si l’outil échoue, le nœud remplit un objet error à la place. Reportez-vous à la section Gestion des erreurs pour connaître la forme de l'erreur et la façon de procéder.

{
  "output": "file. The source CSV with the configured output columns added and populated.",
  "error": "object. Populated only on failure. See Error handling."
}

Exemple

Trier un fichier CSV de tickets d'assistance

Un agent reçoit un fichier CSV de tickets de support et a besoin que chaque ticket soit catégorisé et hiérarchisé avant de les acheminer.

Connectez un outil de transformation par lots à l’agent et configurez-le comme suit.

Source: le fichier CSV des tickets, par exemple un fichier transmis depuis le début du flux.

Tâche de transformation par lots:

For each ticket, read the Subject and Body columns. Classify the ticket into exactly one category: billing, technical, or account. Then assign a priority of high, medium, or low based on the urgency expressed in the text.

Colonnes de sortie:

• Category: une de facturation, technique ou compte, en fonction de l'objet et du corps du ticket.
• Priority: une valeur supérieure, moyenne ou faible, reflétant l'urgence du ticket.

Lorsque l’agent appelle l’outil, la transformation par lots renvoie le fichier CSV d’origine avec une colonne Category et Priority ajoutée pour chaque ligne. L'agent utilise ensuite ce fichier enrichi, disponible au niveau du chemin d'accès $vars.batchTransform1.output, dans le reste de sa tâche.

Pages liées

• Agent (Agent)
• Extraction des documents
• Gestion des erreurs