- Erste Schritte
- Beispiele mit dem Document Understanding™ Cloud-API v1
- Lizenzierung
- Fehlersuche und ‑behebung
API-Leitfaden Understanding
Document UnderstandingTM Cloud-APIs können eine Alternative zum RPA-Ansatz sein. Durch Initiieren eines API-Aufrufs können Sie Folgendes:
- Erhalten Sie Informationen über das Projekt, die Extraktoren oder Klassifizierer, die im Projekt verwendet werden.
- Verwenden Sie die Digitalisierungs-APIs.
- Klassifizieren Sie Dokumente mithilfe von spezialisierten (Beispiel für das Klassifizieren eines Dokuments ) und generativen (Beispiel für einen generativen Klassifizierer ) Modellen.
- Extrahieren Sie Dokumentdaten mithilfe von spezialisierten (Beispiel zum Starten der Extraktionsfelder ) und generativen Modellen (Beispiel für einen generativen Extraktor ).
- Validieren Sie Informationen, die zuvor digitalisiert, klassifiziert und/oder extrahiert wurden.
Je nach Anwendungsfall können Sie zwischen der Verwendung von asynchronen oder synchronen APIs wählen.
Verwenden Sie asynchrone APIs in folgenden Fällen:
- Sie müssen mehrseitige Dokumente verarbeiten.
- Sie müssen mehrere Vorgänge gleichzeitig ausführen. Asynchrone APIs ermöglichen die gleichzeitige Verarbeitung und vermeiden Leerlaufzeiten, was zu einem höheren Systemdurchsatz führt. Das bedeutet, dass Sie ein Dokument senden und zu einer anderen Aufgabe übergehen können, anstatt auf die Antwort zu warten.
- Sie haben ein großes Dataset, das verarbeitet werden muss, was viel Zeit in Anspruch nimmt.
Verwenden Sie synchrone APIs in folgenden Fällen:
- Sie müssen nur einseitige Bilder verarbeiten.
- Sie benötigen Echtzeit-Interaktion auf Basis von Anforderung und Antwort, und Multitasking ist nicht erforderlich. Eine synchrone API kann andere Vorgänge blockieren, während auf eine Antwort gewartet wird.
- Sie haben ein kleineres Dataset, das verarbeitet werden muss.
Die folgenden Status gelten für asynchrone APIs:
- NotStarted: Der Auftrag wurde erstellt und wartet auf die Verarbeitung.
- Wird ausgeführt: Der Auftrag wurde erstellt, aufgenommen und wird derzeit bearbeitet.
- Fehlgeschlagen: Der Auftrag wurde fertiggestellt, ist aber fehlgeschlagen.
- Erfolgreich: Der Auftrag wurde fertiggestellt und war erfolgreich.
Klassifizierungs- und Extraktions-APIs sind sowohl für die synchrone als auch die asynchrone Nutzung verfügbar. Die synchrone Nutzung unterstützt mehrseitige Dokumente mit bis zu fünf Seiten, während die asynchrone Nutzung die Anforderung über eine Start-Methode veröffentlicht und das Ergebnis über eine Abfrage abruft.
Verwenden Sie Document Understanding Cloud-APIs, um auf die Funktionen genauso zuzugreifen wie über RPA. Für die Nutzung der APIs können Sie jede Programmier-/Skriptsprache verwenden (da die Aufrufe mit HTTP erfolgen), einschließlich RPA.
Sie können über Swagger auf die APIs zugreifen: Suchen Sie in der Symbolleiste des Document UnderstandingTM- Diensts nach dem Dropdown-Menü Rest-API und wählen Sie „Framework“ aus.

Um die Funktionen auszuprobieren, verwenden Sie Swagger als Ihre Sandbox.
Sie können mit einem vordefinierten oder einem benutzerdefinierten Buildmodell arbeiten. Bei den benutzerdefinierten Modellen handelt es sich um die Modelle, die Sie mit Document Understanding erstellt haben. Ein vordefiniertes Modell ist bereits verfügbar und enthält vordefinierte, vorgefertigte Modelle.
Die beim Aufruf des Digitalisierungs-Endpunkts empfangen Daten werden sieben Tage lang gespeichert. In diesem Zeitrahmen ist das Ergebnis über die empfangene Dokument-ID verfügbar. Danach müssten Sie eine neue Digitalisierungsanforderung einreichen.
Die durch den Aufruf der asynchronen Klassifizierungs- und Extraktionsendpunkte erhaltenen Daten werden einen Tag (24 Stunden) lang gepeichert.
Je nach Vorgang verwenden Document Understanding Cloud-API-Aufrufe die folgenden Klassen:
- Dokumentenklasse für digitalisierte Dokumente.
- Extraktionsergebnis für Extraktionsergebnisse.
- Klassifizierungsergebnis für Klassifizierungsergebnisse.