Verwalten von Extraktionsknoten

Hinzufügen, Konfigurieren und Entfernen von Extraction-Knoten in UiPath Maestro Flow.

Der Extrahierungsknoten ruft mithilfe eines Intelligente Datenextraktion und Verarbeitung (IXP)-Extraktionsmodells strukturierte Felder aus einem Dokument ab, z. B. eine Rechnung, eine Quittung, ein Formular oder einen Vertrag, und gibt das Ergebnis an nachgelagerte Knoten zurück, damit diese bearbeitet werden können.

Voraussetzungen

Bevor Sie einen Extraktionsknoten hinzufügen, stellen Sie sicher, dass für Ihren Mandanten sowohl der IXP- als auch der Document Understanding -Dienst aktiviert ist. Der Extrahierungsknoten hängt von beiden Diensten ab, auch wenn Sie nur IXP-Modelle verwenden.

Hinzufügen eines Extraktionsknotens zu einem Flow

Um einem Flow einen Extraktionsknoten hinzuzufügen, gehen Sie wie folgt vor:

1. Öffnen Sie Ihren Flow in Maestro Flow.
2. Wählen Sie Knoten hinzufügen, dann Dokument und dann Extrahieren aus.
3. Wählen Sie eine der folgenden Optionen aus der Knotenpalette aus:
   • Dokument extrahieren – Erstellen Sie einen neuen Knoten und implizit ein neues Modell.
   • In dieser Lösung – Wählen Sie einen vorhandenen Knoten aus der Dropdownliste aus.
   • Veröffentlicht – Wählen Sie aus der Dropdownliste ein bereitgestelltes IXP-Modell aus, z. B. ein Modell, das aus Unstrukturierten und komplexen Dokumenten von IXP oder dem Extraktionsknoten eines anderen Flows bereitgestellt wurde. Jedes Modell wird als einzelner Knoten angezeigt.

Ergebnis: Der Knoten wird der Flow-Arbeitsfläche hinzugefügt und an das ausgewählte Modell gebunden. Jetzt können Sie den Extraktionsknoten mit dem vorherigen Knoten in Ihrem Flow verbinden.

Konfigurieren des Extraktionsknotens

Wenn Sie den Mauszeiger über einen Extraktionsknoten auf der Flow-Arbeitsfläche bewegen, wird eine Symbolleiste angezeigt. Sie können eine der folgenden Optionen auswählen, um den Knoten zu konfigurieren:

• Bearbeiten – Öffnet die Knoteneigenschaften, in denen Sie die Eingaben, die Fehlerbehandlung und die erweiterten Einstellungen des Knotens konfigurieren. Weitere Informationen finden Sie unter Konfigurieren des Knotens in Eigenschaften.
• Vollständige Ansicht öffnen – Öffnet die Registerkarte Definition , auf der Sie das Extraktionsmodell und die Taxonomie des Knotens konfigurieren. Weitere Informationen finden Sie unter Konfigurieren des Knotens in Definition.

Konfigurieren des Knotens in den Eigenschaften

Um den Knoten in Eigenschaften zu konfigurieren, gehen Sie wie folgt vor:

1. Zeigen Sie auf der Arbeitsfläche Flow mit dem Mauszeiger auf den Knoten Extrahieren .
2. Wählen Sie in der angezeigten Symbolleiste die Option Bearbeiten aus.

Ergebnis: Die Knoteneigenschaften werden in einem Fenster geöffnet. Der Abschnitt Eigenschaften in der Mitte enthält die Einstellungen zum Konfigurieren des Extraktionsknotens . Der Eingabebereich auf der linken Seite und der Ausgabebereich auf der rechten Seite sind für jeden Knoten im Flow verfügbar. Weitere Informationen finden Sie in den Bereichen Eingabe und Ausgabe.

Eigenschaften

Der Abschnitt Eigenschaften enthält folgende Registerkarten:

• Parameter
• Fehlerbearbeitung
• Erweitert (Advanced)

Parameter

Hinweis:

Bei Validierungsfehlern wird auf der Registerkarte „Parameter“ eine Zahl angezeigt.

Um die Felder auf der Registerkarte Parameter zu konfigurieren, gehen Sie wie folgt vor:

• Dateieingabe:

  • Datei – Die Datei, aus der Daten extrahiert werden sollen. Binden Sie es an eine Datei, die zuvor im Flow erstellt wurde, z. B. die Ausgabe eines Triggers oder eines vorherigen Knotens. Verwenden Sie Einfügen , um die Variablenauswahl zu öffnen, in der Sie nach Variablen suchen können. Die Auswahl listet die Ausgaben der vorherigen Knoten unter $vars und die Flow-Metadaten wie FolderKey, InstanceId und ProcessKey unter $metadata auf.

  • Seitenbereich – Fügen Sie optional die zu verarbeitenden Seiten hinzu, z. B. 1-5. Lassen Sie ihn leer, um das gesamte Dokument zu verarbeiten. Verwenden Sie das Werttypsymbol T im Feld, um zu wählen zwischen:

    • Fester Wert – Geben Sie direkt einen Wert ein.
    • Ausdruck – Geben Sie einen JavaScript-Ausdruck mit IntelliSense ein.

    Sie können auch Einfügen verwenden, um eine Variable hinzuzufügen.

• Definition – Eine Zusammenfassung des Extraktionsmodells des Knotens:
  • Das Extraktionsmodell und seine Version sowie die Auswertungsmetriken. Ein Knoten, der keine Auswertungsausführung hat, zeigt Noch nicht ausgewertet an.
  • Dokumente mit Anmerkungen – Die Anzahl der Dokumente mit Anmerkungen aus der Gesamtzahl der Dokumente.
  • Hochladen – Laden Sie Dokumente hoch, die Sie mit Anmerkungen versehen möchten.
  • Anmerkung hinzufügen – Öffnen Sie die Anmerkungsansicht. Diese Option ist erst verfügbar, wenn Sie der Taxonomie Felder hinzufügen.
  • Bewertung durchführen – Führen Sie eine Bewertung des Extraktionsmodells durch.
  • Bearbeiten – Öffnen Sie die Registerkarte Definition des Bereichs Dokument extrahieren . Weitere Informationen finden Sie unter Konfigurieren des Knotens in Definition.
  • Modellkonfiguration – Eine schreibgeschützte Zusammenfassung der Modellkonfiguration: Extraktionsmodell, Extraktionsstrategie, Sprachunterstützung, Layout-Analyse und Zuordnung.
  • Taxonomie – Die Anzahl der Felder in der Taxonomie. Wenn die Taxonomie keine Felder hat, wählen Sie Felder hinzufügen , um die Registerkarte Definition mit einer neuen Feldgruppe zu öffnen.

Fehlerbearbeitung

Die Registerkarte Fehlerbehandlung enthält die Option Fehlerbehandlung aktivieren . Wenn Sie ihn aktivieren, erhält der Knoten ein Fehlerausgabe-Handle, das Fehler erkennt und behandelt, und die Knotenausgabe enthält ein error -Objekt mit den Optionen code, message, detail, category und status Schlüssel.

Erweitert (Advanced)

Die Registerkarte Erweitert enthält die folgenden Einstellungen:

• ID – Die ID des Knotens, z. B. extractDocument2. Um sie zu ändern, wählen Sie das Bearbeitungssymbol.
• Symbolfarbe – Die Farbe des Knotensymbols auf der Arbeitsfläche.
• Variable aktualisieren – Weist Variablen Werte zu, wenn der Knoten ausgeführt wird. Wählen Sie Variablenaktualisierung hinzufügen aus und konfigurieren Sie dann die folgenden Einstellungen:
  • Variable – Die zu aktualisierende Variable. Wählen Sie eine vorhandene Variable oder eine neue Variable erstellen aus.
  • Ausdruck – Der zuzuweisende Wert. Verwenden Sie Einfügen , um eine Variable hinzuzufügen. Um auf eine Variable in einem Ausdruck zu verweisen, verwenden Sie $vars.{name}.

Eingabe- und Ausgabebereiche

Die Bereiche Eingabe und Ausgabe sind für jeden Knoten im Flow verfügbar. Sie zeigen Daten aus dem Flow an und Sie konfigurieren den Extraktionsknoten darin nicht.

Eingabe

Im Bereich Eingabe werden die vorherigen Knoten im Flow aufgelistet. Sie können die Eingabe in den folgenden Formaten anzeigen:

• Schema – Die Ausgabeschlüssel jedes vorherigen Knotens und deren Typen. Für einen neuen Knoten haben die Schlüssel keine Werte.
• JSON – Die Eingabe im JSON-Format. Für einen neuen Knoten ist diese Ansicht leer.

Ausgabe

Der Ausgabebereich zeigt die Ausgabe der vorherigen Ausführung des Knotens mit den Schlüsseln version, type, result, taxonomy und metadata an. Wenn der Knoten noch nicht ausgeführt wurde, haben die Schlüssel keine Werte. Sie können die Ausgabe im Format Schema, JSON oder Extraktionsergebnis anzeigen.

Die Dropdownliste wählt aus, welche Antwort der Knoten zurückgibt:

• Live – Die echte Antwort vom Knoten.
• Statischer Pseudo-Objekt – Ein von Ihnen definierter Wert, der jedes Mal zurückgegeben wird.
• Generiert – Eine Antwort, die ein LLM dynamisch generiert.

Konfigurieren des Knotens in der Definition

Um den Knoten auf der Registerkarte Definition zu konfigurieren, gehen Sie wie folgt vor:

1. Zeigen Sie auf der Arbeitsfläche Flow mit dem Mauszeiger auf den Knoten Extrahieren .
2. Wählen Sie in der angezeigten Symbolleiste die Option Vollständige Ansicht öffnen aus.

Ergebnis: Im Bereich Dokument extrahieren wird die Registerkarte Definition geöffnet.

Die Registerkarte Definition enthält folgende Abschnitte:

• Auswertungszusammenfassung – Das Extraktionsmodell, seine Version und Auswertungsmetriken. Ein Knoten, der keine Auswertungsausführung hat, zeigt Noch nicht ausgewertet an. Weitere Informationen finden Sie unter Knotenzustandsbewertung. Der Abschnitt enthält auch die folgenden Optionen:

  • Dokumente mit Anmerkungen – Die Anzahl der Dokumente mit Anmerkungen aus der Gesamtzahl der Dokumente.
  • Hochladen – Lädt Dokumente zum Anmerken hoch.
  • Anmerkung zu Dokument hinzufügen – Öffnet die Anmerkungsansicht. Diese Option ist erst verfügbar, wenn Sie der Taxonomie Felder hinzufügen.

• Modellkonfiguration – Das Extraktionsmodell und seine erweiterten Einstellungen. Weitere Informationen dazu finden Sie unter Modellkonfiguration.

• Taxonomie – Die Felder, die der Knoten aus jedem Dokument extrahiert:

  • Allgemeine Extraktionsanweisungen – Fügen Sie einen Kontext hinzu, der für die gesamte Taxonomie relevant ist.
  • Registerkarte Taxonomie – Hinzufügen und Verwalten von Feldgruppen und Feldern. Wählen Sie für einen neuen Knoten die Option Feldgruppe aus, um die erste Feldgruppe hinzuzufügen.
  • Registerkarte „Feldtypen“ – Hinzufügen und Verwalten der vorkonfigurierten und benutzerdefinierten Feldtypen.
  • Vorschau auf Dokumente – Öffnen Sie eine Dokumentvorschau neben der Taxonomie.
  • Importieren/Exportieren – Importieren oder Exportieren der Taxonomie. Weitere Informationen finden Sie unter Importieren und Exportieren von Taxonomien.

  Weitere Informationen finden Sie unter Verwalten der Taxonomie.

Wenn Sie die Taxonomie ändern, stellen Sie sicher, dass Sie Speichern auswählen.

Entfernen eines Extraktionsknotens

Um einen Extraktionsknoten aus einem Flow zu entfernen, gehen Sie wie folgt vor:

1. Zeigen Sie auf der Arbeitsfläche Flow mit dem Mauszeiger auf den Knoten Extrahieren .
2. Wählen Sie in der angezeigten Symbolleiste das Drei-Punkte-Symbol aus.
3. Wählen Sie Löschen aus. Alternativ können Sie den Knoten Extrahieren auf der Flow-Arbeitsfläche auswählen und die Rücktaste drücken.

Ergebnis: Der Extrahierungsknoten wird von der Flow-Arbeitsfläche entfernt.

Zugehörige Dokumentation zu Maestro Flow

• Extrahieren – Die Knotenreferenz, einschließlich wie das Extraktionsergebnis gelesen werden kann, fehlende Felder, Konfidenzbewertungen und Tabellenfelder.
• Dokumentverarbeitung – Die auf der Flow-Arbeitsfläche verfügbaren Dokumentverarbeitungsknoten.