Transformation par lots

Add the Batch transform tool to an agent, configure its task and output columns, and read its result, with an example.

Ce qu’il fait

La transformation par lots est un nœud 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 pouvez associer 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.

Dans le panneau Ajouter un nœud , la transformation par lots se trouve sous Données.

Quand l’utiliser

Utilisez la transformation par lots lorsqu'un agent doit enrichir ou classifier les lignes d'un CSV en bloc 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.
• Noter, résumer ou baliser chaque ligne en fonction de ses colonnes existantes.

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

Ajout de l'outil

Ajoutez le nœud au canevas, puis connectez-le à un agent.

1. Sélectionnez un nœud d’agent autonome ou ajoutez-en un si votre workflow n’en dispose pas encore.
2. Ouvrez le panneau Ajouter un nœud et sélectionnez la catégorie Données .
3. Sélectionnez Transformation par lots. Maestro Automate ajoute le nœud au canevas.
4. Dessinez une arête à partir du nœud Transformation par lots vers le gestionnaire d'outils 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 tout en raisonnant.

Référence de la configuration

Configurez ces champs dans la section Paramètres de la 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 workflow ou fourni par l’agent lorsqu’il appelle l’outil.
Tâche de transformation par lots	Oui (Yes)	Aucun (None)	Instructions que l'outil 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)	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 pour 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 quoi écrire pour chaque ligne, alors soyez spécifique quant au format attendu.
Ancrage avec recherche sur le Web	Non (No)	Activé (Enabled)	Si l'outil peut utiliser la recherche Web pour ancrer ou enrichir ses résultats. Sélectionnez Désactivé pour utiliser uniquement le fichier source et la tâche.

Entrées et sorties

Entrée

La transformation par lots prend son entrée des champs que vous configurez : le 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 comme un outil, l'agent appelant fournit ces valeurs lorsqu'il invoque l'outil pendant une exécution.

Sortie

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

$vars.batchTransform1.output

Si l’outil échoue, le nœud remplit un objet error à la place. La gestion des erreurs décrit la forme de l'erreur et la façon de l'acheminer vers celle-ci.

{
  "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 CSV de tickets d'assistance

Un agent reçoit un CSV de tickets d'assistance et doit classer chaque ticket par catégorie et par ordre de priorité 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 workflow.

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 : la facturation, les questions techniques ou la gestion des comptes, en fonction de l'objet et du corps du ticket.
• Priority: un niveau (élevé, moyen ou faible), qui reflète le degré d'urgence du ticket.

Lorsque l'agent appelle l'outil, la transformation par lots renvoie le CSV d'origine avec une colonne Category et Priority ajoutées pour chaque ligne. L'agent utilise ensuite ce fichier enrichi, disponible à l'adresse $vars.batchTransform1.output, dans le reste de sa tâche.

Prochaines étapes

• Agent autonome: l’agent qui appelle la transformation par lots comme outil.
• Extraction de documents: extraire des données structurées d’un même document.
• Gestion des erreurs: acheminer sur l'objet error lorsque l'outil échoue.
• Community (Communauté): posez des questions et partagez des workflows avec d'autres développeurs sur le forum UiPath.