Batch-Transformation

Integriertes Agent-Tool, das eine CSV-Datei Zeile für Zeile verarbeitet und KI-generierte Spalten basierend auf einer von Ihnen definierten Aufgabe hinzufügt.

Was es tut

Batch-Transformation ist ein integriertes Tool, das eine CSV-Datei Zeile für Zeile verarbeitet und KI-generierte Spalten hinzufügt.Sie geben ihm ein Quell-CSV, eine Aufgabe, die beschreibt, was für jede Zeile getan werden soll, und die Spalten, die Sie hinzufügen möchten. Es gibt eine neue Datei mit diesen Spalten zurück.

Sie fügen die Batch-Transformation an einen autonomen Agent als Tool an. 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.

Der Knoten ist in der Palette in der Kategorie integrierte Tools als Batch Transform bezeichnet.

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 das Tool der Arbeitsfläche hinzu und verbinden Sie es dann mit einem Agent.

1. Wählen Sie einen autonomen Agent-Knoten aus oder fügen Sie einen hinzu, wenn Ihr Flow ihn noch nicht enthält.
2. Öffnen Sie die Knotenpalette und wählen Sie die Kategorie Integrierte Tools aus.
3. Wählen Sie Batch-Transformation aus. Flow fügt den Knoten der 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 vorab im Ablauf erstellt wurde, oder auf eine, die der Agent bereitstellt, wenn er das Tool aufruft.
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-Object aus. Informationen zur Fehlerform und zum Weiterleiten finden Sie unter Error-Behandlung.

{
  "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 Ticket-CSV-Datei, z. B. eine Datei, die vom Start des Ablaufs ü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.

Zugehörige Seiten

• Mitarbeiter
• Dokumentextrahierung
• Fehlerbearbeitung