Batch-Transformation

Mit dem Batch-Transformationstool können Agents CSV-Dateien in großen Mengen mit Just-in-Time-Datenquellen (JIT) verarbeiten. Sie ist für Szenarien konzipiert, in denen Sie dieselbe Transformationslogik auf jede Zeile oder jeden Datensatz in einer CSV-Datei anwenden möchten, ohne im Voraus Speicher-Buckets oder Indizes einzurichten.

Batch-Transformation nimmt eine Eingabedatei zur ${Runtime} bereitgestellt und wendet eine benutzerdefinierte Transformationsaufgabe darauf an.Das Tool verarbeitet die Datei Zeile für Zeile und erstellt eine oder mehrere Ausgabedateien, die die Originaldaten zusammen mit zusätzlichen Spalten oder Zeilen enthalten, die von der Transformationslogik generiert wurden.

Typische Anwendungsfälle sind:

• Anreichern von CSV-Dateien mit modellgenerierten Bewertungen, Beschriftungen oder Klassifizierungen
• Anwenden von Geschäftsregeln oder Entscheidungslogik auf große Datensätze
• Erstellen von Erklärungen oder Rechtfertigungen neben automatisierten Entscheidungen

Datenquellen

• Batch-Transformation unterstützt nur JIT-Datenquellen.
• Nur CSV-Dateien werden als Eingabe unterstützt.
• Dateien werden direkt über Agent-Eingaben übergeben und zur Runtime automatisch aufgelöst.
• Es ist keine externe Speicherkonfiguration oder Indexerstellung erforderlich.

Weitere Informationen finden Sie unter Best Practices für DeepRAG und Batch-Transformation: JIT vs. indexbasierte Strategien.

Configuring Batch Transform

Add the Batch Transform tool

1. Öffnen Sie Ihren Agent im Designmodus.
2. Fügen Sie dem Agent aus der Liste der integrierten Tools eine Batch Transform hinzu.

Nach dem Hinzufügen wird das Tool „Batch Transform“ als dedizierter Toolknoten angezeigt, den Sie im rechten Bereich konfigurieren können.

Eingaben konfigurieren

Zur Entwurfszeit geben Sie an, wie das Tool seine Eingaben erhalten soll:

• Quelldatei: Die Quelle ist eine Dateieingabe (z. B. input-csv). Zur Runtime wird dies automatisch in die Datei aufgelöst, die bei der Ausführung des Agent bereitgestellt wird.

  Hinweis:

  Sie müssen ein Dateitypargument in Data Manager konfigurieren.

• Batch-Transformationsaufgabe – Die toolspezifische Anweisung, die definiert, wie die Batch-Transformation ausgeführt werden soll. Verwenden Sie dieses Feld, um dem Tool genau mitzuteilen, wie die Eingabedatei verarbeitet werden soll, einschließlich:

  • Welche neuen Spalten oder Zeilen generiert werden sollen.
  • Wie jede Zeile verarbeitet werden sollte
  • Alle anzuwendenden Regeln, Kriterien oder Entscheidungslogik

  Sie können das Tool beispielsweise anweisen, zwei neue Spalten wie eine Punktzahl und ein Empfehlungs-Flag basierend auf dem Inhalt jeder Zeile zu generieren. Dies ist kein Agent-Prompt. Der Agent sollte nur eine übergeordnete Anweisung enthalten, wann die Batch-Transformation aufgerufen werden soll und wie die endgültige Ausgabe aussehen sollte.

  

• Ausgabe – Definieren Sie das Schema für alle neuen Spalten, die durch die Batch Transform generiert werden.Geben Sie für jede Spalte Folgendes an:

  • Der Spaltenname
  • Eine Beschreibung dessen, was die Spalte darstellt und wie ihre Werte interpretiert werden sollten.

  Sie können neue Ausgabe hinzufügen, vorhandene Spaltennamen oder Beschreibungen bearbeiten oder Spalten nach Bedarf entfernen.Die Aufgabe „Batch-Transformation“ sollte die Logik beschreiben, die zum Ausfüllen dieser konfigurierten Spalten verwendet wird.

Websuch-Verankerung aktivieren (optional)

Das Batch-Transformationstool enthält eine optionale Websuch-Verankerungseinstellung, die steuert, ob das Modell Websuchergebnisse beim Generieren von Transformationen verwenden darf.

• Wenn aktiviert, kann das Modell die Eingabedateidaten mit Informationen ergänzen, die während der Verarbeitung jeder Zeile aus dem Web abgerufen werden.
• Wenn diese Option deaktiviert ist, wird die Transformation streng unter Verwendung des Inhalts der Eingabedatei, der in der Aufgabe definierten Anweisungen und jedes Kontexts ausgeführt, der dem Agenten explizit zur Verfügung gestellt wird.

Hinweis:

Batch Transform with Web Search requires an LLM configuration for Gemini models.

Ausführen der Batch-Transformation

Wenn Sie den Agent ausführen oder debuggen, wird das Batch-Transformationstool als Teil der Agent-Ausführung ausgeführt:

• Die Eingabedatei wird zur Laufzeit an das Tool übergeben.
• Das Tool verarbeitet die Datei Zeile für Zeile.
• Eine transformierte Ausgabedatei wird generiert.
• Die Ausgabedatei wird als Teil der Agent-Ausgabe zurückgegeben.

Während der Ausführung wird die Batch Transform in der Execution Trace als dedizierter Toolaufruf angezeigt.Sie können diesen Schritt erweitern, um detaillierte Runtime-Informationen zu überprüfen.

Überprüfung von Ausführungsdetails

In der Execution Trace können Sie Details überprüfen, die in der Ausgabe des Toolaufrufs und gegebenenfalls der Agent-Ausgabe aufgetaucht sind.

• Eingaben – Die vom Tool verwendete Eingabedatei, einschließlich Dateiname, Typ und Metadaten (sichtbar in der Ausgabe des Tool-Aufrufs).
• Ausgaben – Die generierte Ausgabedatei, einschließlich Datei-ID, Dateiname und MIME-Typ (wird in der Ausgabe des Toolaufrufs angezeigt, wenn eine Dateiausgabe definiert ist).
• Prompt-Kontext – Die System- und Benutzer-Prompts, die während der Agent-Ausführung verwendet wurden und die erklären helfen, wie die Transformationsaufgabe ausgeführt wurde.

Sie können sowohl die Eingabe- als auch die Ausgabedateien direkt aus der Execution Trace zur Validierung oder Fehlerbehebung herunterladen.

Wenn eine Dateiausgabe definiert ist, enthält die endgültige Agent-Ausgabe in der Regel eine Bestätigungsnachricht, die angibt, dass die transformierte Datei generiert wurde, und den Namen der Ausgabedatei angibt.