Batch-Transformation

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

Was es tut

Batch Transform ist ein Knoten, der eine CSV-Datei Zeile für Zeile verarbeitet und ihr KI-generierte Spalten hinzufügt. Sie geben eine Quell-CSV-Datei, eine Aufgabe, die beschreibt, was für jede Zeile zu tun ist, und die Spalten an, die Sie hinzufügen möchten. Es gibt eine neue Datei mit diesen Spalten zurück.

Sie können Batch Transform als Tool an einen autonomen Agent anhängen. Der Agent ruft das Tool während der Argumentation auf, übergibt ihm die Quelldatei und die Aufgabe und verwendet die transformierte Datei für den Rest seiner Arbeit.

Im Bereich „ Knoten hinzufügen“ befindet sich die Batch-Transformation unter „Daten“.

Einsatzbereich

Verwenden Sie Batch Transform, wenn ein Agent die Zeilen einer CSV-Datei massenweise anreichern oder klassifizieren muss und jede Zeile dieselbe KI-gesteuerte Behandlung erfordert.

Typische Aufgaben:

• Klassifizieren Sie jede Zeile in eine Kategorie und schreiben Sie die Beschriftung in eine neue Spalte.
• Extrahieren Sie einen Wert aus einem Freitextfeld in seine eigene Spalte.
• Bewerten Sie jede Zeile, fassen Sie sie basierend auf ihren vorhandenen Spalten zusammen oder versehen Sie sie mit einem Tag.

Um strukturierte Daten aus einem einzigen Dokument zu extrahieren, anstatt tabellarische Zeilen zu transformieren, verbinden Sie stattdessen eine Dokumentextraktionsressource. Um den Inhalt von Dateien zu analysieren, die keine zeilenorientierten CSV-Dateien sind, verwenden Sie das integrierte Tool Dateien analysieren.

Hinzufügen des Tools

Fügen Sie den Knoten zur Arbeitsfläche hinzu und verbinden Sie ihn dann mit einem Agent.

1. Wählen Sie einen Autonomous Agent- Knoten aus oder fügen Sie einen hinzu, wenn Ihr Workflow ihn noch nicht hat.
2. Öffnen Sie den Bereich Knoten hinzufügen und wählen Sie die Kategorie Daten aus.
3. Wählen Sie Batch-Transformation aus. Maestro Automate fügt den Knoten zur Arbeitsfläche hinzu.
4. Zeichnen Sie eine Kante vom Knoten „Batch-Transformation“ zum Tool-Handle des Agents.
5. Wählen Sie den Knoten Batch-Transformation aus, um den Eigenschaftenbereich zu öffnen und zu konfigurieren.

Ergebnis: Das Batch-Transformationstool ist mit dem Agent verbunden. Der Agent kann es jetzt während der Argumentation aufrufen.

Konfigurationsreferenz

Konfigurieren Sie diese Felder im Abschnitt Batch-Transformationseinstellungen des Eigenschaftenbereichs.

Feld	Erforderlich	Standard	Beschreibung
Quelle (Datei)	Ja	Keine	Zu transformierende CSV-Datei. Verweisen Sie auf eine Datei, die vorgelagert im Workflow erstellt wurde, oder auf eine, die der Agent beim Aufrufen des Tools bereitstellt.
Batch-Transformationsaufgabe	Ja	Keine	Anweisungen, die das Tool auf jede Zeile anwendet. Beschreiben Sie, was analysiert und was extrahiert werden soll und wie die Ausgabespalten ausgefüllt werden sollen.
Ausgabespalten	Ja	Keine	Spalten, die das Tool der Datei hinzufügt. Definieren Sie mindestens eine Spalte mit einem Namen und einer Beschreibung und fügen Sie bis zu 10 Spalten hinzu.
Spaltenname	Ja	Keine	Header für die neue Spalte in der Ausgabedatei.
Beschreibung	Ja	Keine	Inhalt, den die Spalte enthalten soll. Das Tool verwendet diesen Wert, um zu entscheiden, was für jede Zeile geschrieben werden soll, also seien Sie spezifisch hinsichtlich des erwarteten Formats.
Grundlage für Websuche	Nein	Aktiviert	Ob das Tool die Websuche verwenden kann, um seine Ergebnisse zu fundieren oder zu ergänzen. Wählen Sie Deaktiviert aus, um nur die Quelldatei und die Aufgabe zu verwenden.

Eingaben und Ausgaben

Eingabe

Batch-Transformation nimmt ihre Eingabe aus den Feldern auf, die Sie konfigurieren: die Quell-CSV, die Aufgabe, die Ausgabespalten und die Einstellung für die Grundlage der Websuche.Da sie als Tool ausgeführt wird, liefert der aufrufende Agent diese Werte, wenn er das Tool während einer Ausführung aufruft.

Ausgabe

Batch-Transformation gibt eine Datei zurück: das Quell-CSV mit den angehängten und ausgefüllten Ausgabespalten. Greifen Sie unter $vars.<nodeName>.output darauf zu, wobei <nodeName> für den Namen des Batch-Transformationsknotens steht.

$vars.batchTransform1.output

Wenn das Tool fehlschlägt, füllt der Knoten stattdessen ein error -Objekt aus. Die Fehlerbehandlung beschreibt die Fehlerform und wie sie weitergeleitet wird.

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

Beispiel

Priorisieren Sie eine CSV-Datei mit Support-Tickets

Ein Agent erhält eine CSV-Datei mit Support-Tickets und muss jedes Ticket kategorisieren und priorisieren, bevor er diese weiterleitet.

Verbinden Sie ein Batch-Transformations-Tool mit dem Agent und konfigurieren Sie es wie folgt.

Quelle (Datei): Die CSV-Datei der Tickets, z. B. eine Datei, die vom Beginn des Workflows übergeben wird.

Batch-Transformationsaufgabe:

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.

Ausgabespalten:

• Category: einer der Werte „Abrechnung“, „technisch“ oder „Konto“, basierend auf dem Betreff und dem Text des Tickets.
• Priority: einer der Werte „hoch“, „mittel“ oder „niedrig“, um die Dringlichkeit des Tickets widerzuspiegeln.

Wenn der Agent das Tool aufruft, gibt Batch-Transformation die ursprüngliche CSV-Datei zurück, der für jede Zeile eine Category und eine Spalte Priority hinzugefügt wurde.Der Agent verwendet dann diese angereicherte Datei, die unter $vars.batchTransform1.output verfügbar ist, im Rest seiner Aufgabe.

Nächste Schritte

• Autonomous Agent: Der Agent, der Batch Transform als Tool aufruft.
• Dokumentextraktion: Extrahieren Sie strukturierte Daten aus einem einzelnen Dokument.
• Fehlerbehandlung: Weiterleitung zum error -Objekt, wenn das Tool fehlschlägt.
• Community: Stellen Sie Fragen und teilen Sie Workflows mit anderen Buildern im UiPath Forum.