UiPath Documentation
maestro
latest
false
Benutzerhandbuch zu Maestro Orchestrate
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Analyze Files

Analysieren Sie Dateien, die an einen Agent angehängt sind: Extrahieren, synthetisieren oder beantworten Sie Abfragen zu Inhalten.

Was es tut​

„Dateien analysieren“ ist ein integriertes Tool, das Sie an einen autonomen Agent anhängen. Es übergibt eine oder mehrere Dateien an ein großes Sprachmodell (LLM), um Abfragen zu ihrem Inhalt zu extrahieren, zu synthetisieren oder zu beantworten.

Die Dateien können Dokumente, Bilder oder andere Anhänge sein. Der Agent entscheidet während der Argumentation, wann er das Tool aufruft, wobei er die Dateien und eine Aufgabe übergibt, und das Tool gibt das Ergebnis zur Verwendung durch den Agent zurück.

Einsatzbereich​

Verbinden Sie „Dateien analysieren“, wenn der Agent gemischte Dateitypen oder zwei oder mehr Anhänge gleichzeitig lesen und eine Frage beantworten oder Inhalte aus ihnen extrahieren muss.

Greifen Sie in diesen Fällen vorzugsweise auf „Dateien analysieren“ statt auf die Alternativen zurück:

  • Sie haben eine oder mehrere Dateien verschiedener Typen (Dokumente, Bilder, Scans) und möchten, dass der Agent ihren Inhalt extrahiert oder analysiert.
  • Die Aufgabe wird in natürlicher Sprache beschrieben („Dieses Dokument zusammenfassen“, „Was ist in diesem Bild zu sehen“, „die Schlüsselpunkte extrahieren“) und nicht in einem festen Schema von Feldern.

Für andere Arbeitsformen:

  • Um ein langes Dokument (bis zu 1.000 Seiten) mit Zitaten zu synthetisieren, verwenden Sie das Tool Zusammenfassen.
  • Um strukturierte, typisierte Felder aus einem Dokument mithilfe eines trainierten Modells zu ziehen, verwenden Sie den Knoten Extrahieren.

Hinzufügen des Tools zu einem Agent​

„Dateien analysieren“ wird als Tool an einen autonomen Agent angehängt. Es wird nicht eigenständig ausgeführt.

  1. Fügen Sie der Arbeitsfläche einen autonomen Agent hinzu.
  2. Wählen Sie im Bereich Knoten hinzufügen die Option Dateien analysieren aus. Maestro Orchestrate fügt den Toolknoten zur Arbeitsfläche hinzu.
  3. Verbinden Sie das Tool mit dem Tool-Handle des Agents.
  4. Wählen Sie den Toolknoten aus, um seinen Eigenschaftenbereich zu öffnen.
  5. Konfigurieren Sie das Tool wie unten beschrieben.

Ergebnis: Das Tool „Dateien analysieren“ ist mit dem Agent verbunden. Der Agent kann es jetzt während der Argumentation aufrufen.

Konfigurationsreferenz​

Konfigurieren Sie das Tool im Abschnitt Einstellungen für „Dateien analysieren“ des Eigenschaftenbereichs.

FeldErforderlichStandardBeschreibung
BeschreibungNeinLeerWozu das Tool dient, in einfacher Sprache. Der Agent liest es, um zu entscheiden, wann das Tool aufgerufen werden soll.
Anhänge (Attachments)NeinArray of files, documents, images, or other attachments to processDie zu analysierenden Dateien. Der Agent füllt dies aus, wenn er das Tool aufruft, sodass das Feld in violett angezeigt wird.
Elemente (Datei)NeinLeerOptionale Beschreibung pro Element für eine einzelne Datei im Anhänge-Array. Lassen Sie sie leer, wenn die Beschreibung auf Array-Ebene ausreicht.
AnalyseaufgabeJaThe task, question, or instruction for processing the filesWas mit den Dateien geschehen soll, z. B. summarize this document. Der Agent gibt dies aus, wenn er das Tool aufruft.
SimulationseinstellungenNeinReduziertBeispielaufrufe, die zum Testen des Tools verwendet werden, ohne das Live-Modell aufzurufen. Wählen Sie Beispielaufruf hinzufügen aus, um ein Beispiel zu definieren.

Eingaben und Ausgaben​

Eingaben​

Der Agent liefert die Dateien und die Aufgabe, wenn er das Tool aufruft. Die oben genannte Konfiguration definiert, was der Agent übergeben kann und wie sich das Tool verhält.

Ausgabe​

Das Tool gibt sein Ergebnis an den Agent zurück, der es aufgerufen hat. Wenn Sie die Ausgabe des Tools direkt im Workflow lesen müssen, greifen Sie auf $vars.<nodeName>.output darauf zu, wobei <nodeName> der Name des Knotens „Dateien analysieren“ auf der Arbeitsfläche ist.

$vars.analyzeFiles1.output
$vars.analyzeFiles1.output

In den meisten Workflows lesen Sie die Ausgabe des Tools nicht direkt. Der Agent verwendet das Ergebnis als Teil seiner Argumentation und gibt sein eigenes Ergebnis am $vars.<agentNode>.output zurück. Autonomous Agent beschreibt die Ausgabeform des Agents.

Beispiel​

Ein Agent verarbeitet eine eingehende E-Mail mit gemischten Anhängen (ein gescanntes Belegbild und ein PDF-Kontoauszug) und beantwortet eine Frage dazu.

  1. Fügen Sie der Arbeitsfläche einen autonomen Agent hinzu.
  2. Wählen Sie im Bereich Knoten hinzufügen die Option Dateien analysieren aus.
  3. Verbinden Sie das Tool mit dem Tool-Handle des Agents.
  4. Bearbeiten Sie im Tool „Dateien analysieren“ Anhänge (Array), um zu beschreiben, was der Agent senden soll, z. B. The receipt image and statement PDF attached to the incoming email.
  5. Legen Sie analysisTask (string) auf die Arbeit fest, die Sie erledigen möchten:
Read each attached file. Identify the merchant, the date, and the total amount on
the receipt, and confirm whether the statement lists a matching charge.
Read each attached file. Identify the merchant, the date, and the total amount on
the receipt, and confirm whether the statement lists a matching charge.
  1. Weisen Sie ihn im Benutzer-Prompt des Agents an, das Tool zu verwenden, z. B.: Use the Analyze Files tool to check the attachments and tell me whether the receipt matches a charge on the statement.

Wenn der Agent ausgeführt wird, ruft er „Dateien analysieren“ mit den Anhängen auf, erhält die Analyse und gibt seine Antwort auf $vars.agent1.output.content zurück.

Nächste Schritte​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben