Extract Document Data

UiPath.IntelligentOCR.StudioWeb.Activities.ExtractDocumentDataWithDocumentData<UiPath.IntelligentOCR.StudioWeb.Activities.DataExtraction.ExtendedExtractionResultForDocumentData>

Beschreibung

Extrahiert Daten aus einer Eingabedatei oder einem Dokumentdatenobjekt und speichert die Ergebnisse in einem Dokumentdatenobjekt.

Bevor Sie beginnen

Voraussetzungen

Die Aktivität „Extract Document Data“ erfordert eine ihr vorangehende Aktivität, die ein Dokumentdatenobjekt bereitstellen kann (erzeugt als Ausgabe von anderen Document Understanding-Aktivitäten, z. B. Classify Document).

Eingabeoptionen

Die Aktivität „Extract Document Data“ erhält als Eingabe eine der folgenden Auswahlmöglichkeiten:

• Dokumentdaten – aus der Aktivität „Classify Document“
• Datei – aus den Aktivitäten „Get File/Folder“ oder „Get Newest Email“

Unterstützte Sprachen für generative Modelle

Die unterstützten Sprachen für die generativen Modelle sind die gleichen wie die verwendete OCR-Engine, die vom Projekt abhängt. Für vordefinierte Projekte wird das OCR-Modul UiPath Document OCR verwendet. Weitere Informationen finden Sie auf der Seite OCR unterstützte Sprachen.

Von der Aktivität verwendete Modelle

Die Aktivität „Extract Document Data“ verwendet Folgendes:

• Öffentliche Endpunkte für vorgefertigte Modelle.
• Benutzerdefinierte ML-Modelle, die in Document Understanding-App-Projekten bereitgestellt werden.
• Generatives Extraktionsmodell.

Projektkompatibilität

Plattformübergreifend

Konfiguration

Designer-Panel

• Projekt – Erfordert, dass Sie Ihr Document Understanding-Projekt aus dem Dropdownmenü auswählen. Die verfügbaren Optionen sind:
  • Vordefiniert – Das Standardprojekt
  • Sie können ein benutzerdefiniertes Projekt erstellen, indem Sie Document Understanding aufrufen.

• Extraktor – Erfordert, dass Sie den Extraktor aus dem ausgewählten Projekt auswählen. Für das vordefinierte Projekt stehen die folgenden Optionen zur Verfügung:
  • Entweder eines der ML-Pakete, die Sie hierfinden
    Hinweis: Die Aktivität „Extract Document Data“ überschreibt den Dokumenttyp mit dem ausgewählten Extraktor. Dies gilt nicht für generative Modelle.
  • Generativ
    Hinweis: Die an den Generative Extractor gesendeten Daten werden an eine LLM-Modellinstanz gesendet, die nicht öffentlich verfügbar ist, werden nicht außerhalb von ihr verwendet und nach der Verarbeitung nicht gespeichert oder für Training verwendet.
• Eingabeaufforderung – Dieses Feld wird angezeigt, wenn Sie die Option Generativ auswählen. Aufforderung zur Identifizierung der zu extrahierenden Felder, die als Schlüssel-Wert-Paare bereitgestellt werden, wobei der Schlüssel den Namen des Felds und der Wert eine Beschreibung des Felds darstellt, die dem Extraktor hilft, den entsprechenden Wert zu identifizieren. Klicken Sie auf das Feld, und Sie erhalten eine Eingabeaufforderung mit den folgenden Optionen, die paarweise bereitgestellt werden:
  • Feldname – Erfordert die Eingabe des zu extrahierenden Feldnamens (z. B. Fälligkeitsdatum) (maximal 30 Zeichen)
  • Generative Eingabeaufforderung – Erfordert, dass Sie die Eingabeaufforderung als Eingabe für den generativen Extraktor bereitstellen. Die maximale Anzahl der zulässigen Zeichen ist 1000. Die Antwort, das Extraktionsergebnis, auch als Vervollständigung bezeichnet, hat ein Wortlimit von 700. Dies ist auf 700 Wörter begrenzt. Das bedeutet, dass Sie höchstens 700 Wörter aus einer einzelnen Eingabeaufforderung extrahieren können. Wenn Ihre Extraktionsanforderungen diesen Grenzwert überschreiten, können Sie das Dokument auf mehrere Seiten verteilen, sie einzeln verarbeiten und die Ergebnisse anschließend zusammenführen.
  Tipp: Bewährte Methoden zur Verwendung von generativen Eingabeaufforderungen finden Sie auf der Seite Generativer Extraktor – Bewährte Methoden .
• Eingabe – Erfordert, dass Sie die Datei selbst oder Dokumentdaten angeben, falls Sie in Ihrem Workflow bereits andere Document Understanding-Aktivitäten verwendet haben (z. B. Classify Document).
  Wichtig: Die maximale Anzahl von Seiten, die eine Datei haben kann, beträgt 500. Dateien, die diesen Grenzwert überschreiten, können nicht extrahiert werden.

Eigenschaften-Panel

Eingabe

• Timeout (Sekunden) – Maximale Ausführungszeit (in Sekunden) für den Aufruf des generativen Modells. Wenn der Vorgang dieses Timeout überschreitet, wird er automatisch beendet, um Verzögerungen oder Hängen zu vermeiden. Diese Eigenschaft wird nur angezeigt, wenn der Generative Extractor als Extraktor ausgewählt wird.
• Automatische Validierung – Verwenden Sie diese Option, um die automatische Validierung zu aktivieren, eine Funktion, die hilft, die Ergebnisse für die Datenextraktion anhand eines generativen Modells zu validieren. Der Standardwert für das Feld Automatische Validierung ist False.
  • Konfidenz -Schwellenwert – Dieses Feld wird angezeigt, sobald Sie die Automatische Validierung aktivieren. Extraktionsergebnisse, die unter den Schwellenwert fallen, werden mit dem generativen Extraktionsmodell verglichen. Wenn sie übereinstimmen, passt das System die Extraktionskonfidenz an, um den Schwellenwert zu erreichen. Mögliche Schwellenwerte reichen von 0 bis 100.

    Wenn der Wert auf 0 festgelegt ist, wird keine Validierung angewendet. Wenn Sie jedoch einen bestimmten Wert festlegen (von 0 bis 100), prüft das System alle Extraktionsergebnisse unter diesem Wert. Wenn Sie z. B. einen Konfidenzschwellenwert von 80 % festlegen, wendet das System die generative Validierung für Felder mit einer Konfidenz unter 80 % an.

    Hinweis: Die automatische Validierung ist nur für spezielle Extraktionsmodelle verfügbar.
• Datentyp generieren (Vorschau) – Wenn diese Option auf True festgelegt ist, wird angegeben, dass die Ausgabe basierend auf dem ausgewählten Extraktor generiert werden soll, was zu einem IDocumentData<ExtractorType> -Objekt führt. Wenn diese Eigenschaft auf False festgelegt ist, wird alternativ angegeben, dass die Datengenerierung übersprungen werden soll, was zu einem generischen IDocumentData<DictionaryData> -Objekt führt.

  Weitere Informationen und Einschränkungen für die beiden Objekttypen finden Sie unter Dokumentdaten .

Ausgabe

• Dokumentdaten – Alle extrahierten Felddaten aus der Datei. Informationen können auch von Classify Document empfangen werden.

  Unter Dokumentdaten erfahren Sie, wie Dokumentdaten funktionieren und wie die extrahierten Ergebnisse für Felder mit einem oder mehreren Werten verwendet werden.

Verwendung des generativen Extraktors

Um schnell mit den generativen Funktionen der Aktivität Extract Document Data zu beginnen, führen Sie die folgenden Schritte aus:

1. Fügen Sie eine Aktivität Extract Document Data hinzu.
2. Wählen Sie in der Dropdownliste Projekt die Option Vordefiniert aus.
3. Wählen Sie für Extraktor die Option Generative Extractor aus.

   Die Eigenschaft Eingabeaufforderung wird im Textkörper der Aktivität angezeigt.

4. Geben Sie Ihre Anweisungen im Feld Eingabeaufforderung als Schlüssel-Wert-Paare des Wörterbuchs an, wobei:
   • Schlüssel stellt den Feldnamen dar (Beispiel: E-Mail-Adresse).
   • Wert stellt die generative Eingabeaufforderung dar: Die Beschreibung, die vom generativen Extraktor verwendet wird, um den entsprechenden Wert zu identifizieren.

     Ein Beispiel für Schlüssel-Wert-Paare finden Sie beispielsweise in der folgenden Tabelle:

   Tabelle 1. Eingabeaufforderung für Schlüssel-Wert-Paare für den generativen Extraktor

   Name des Felds	Generative Aufforderung
   Name	„Wie lautet der Name des Kandidaten?“
   Aktueller Auftrag	„In welcher Funktion ist der Kandidat derzeit tätig?“
   Arbeitgeber	„Was ist der aktuelle Arbeitgeber des Kandidaten?“

   Abbildung 1. Aufforderung für Schlüssel-Wert-Paare für den generativen Extraktor