Freigeben über

Studio-Oberfläche für Dokument Intelligenz

  • Artikel

Dieser Inhalt gilt für:Häkchen Version 4.0 (GA) | Vorherige Versionen: Blaues Häkchen Version 3.1 (GA) Blaues Häkchen Version 3.0 (GA)

Das Studio ist ein Onlinetool für das visuelle Erkunden, Verstehen, Trainieren und Integrieren der Features des Diensts „Dokument Intelligence“ in Ihre Anwendungen. Das Studio bietet eine Plattform, auf der Sie mit den verschiedenen Dokument Intelligenz-Modellen experimentieren und die zurückgegebenen Daten auf interaktive Weise testen können, ohne Code schreiben zu müssen. Sie können die Studioumgebung für Folgendes verwenden:

  • Kennenlernen der verschiedenen Funktionen in Dokument Intelligenz
  • Verwenden Ihrer Dokument Intelligenz-Ressource, um Modelle auf Beispieldokumenten zu testen oder eigene Dokumente hochzuladen
  • Experimentieren mit verschiedenen Add-On- und Previewfunktionen, um die Ausgabe an Ihre Anforderungen anzupassen
  • Trainieren von benutzerdefinierten Klassifizierungsmodellen zum Klassifizieren von Dokumenten
  • Trainieren von benutzerdefinierten Extraktionsmodellen zum Extrahieren von Feldern aus Dokumenten
  • Rufen Sie Beispielcode für die sprachspezifische SDKs für die Integration in Ihre Anwendungen ab.

Derzeit migrieren wir die Funktionen von Dokument Intelligenz Studio zum neuen Azure KI Foundry-Portal. Es gibt einige Unterschiede in den Angeboten der beiden Studios, die bestimmen, welches das richtige Studio für Ihren Anwendungsfall ist.

Auswählen der richtigen Studioumgebung

Derzeit gibt es zwei Studios, das Azure KI Foundry-Portal und das Dokument Intelligenz Studio zur Erstellung und Validierung von Dokument Intelligenz-Modellen. Während die Umgebungen in das neue Azure KI Foundry-Portal migriert werden, sind einige Umgebungen in beiden Studios verfügbar, während andere Umgebungen/Modelle nur in einem der Studios verfügbar sind. Nachfolgend finden Sie einige Richtlinien für die Auswahl des Studio-Erlebnisses für Ihre Bedürfnisse. Alle unsere vorgefertigten Modelle und allgemeinen Extraktionsmodelle sind in beiden Studios erhältlich.

Wann Sie Dokument Intelligenz Studio verwenden sollten

Dokument Intelligenz Studio enthält alle Funktionen, die bis November 2024 veröffentlicht wurden. Für alle Funktionen von v2.1, v3.0 und v3.1 verwenden Sie weiterhin das Dokument Intelligenz Studio. Studios bieten eine visuelle Erfahrung für die Bezeichnung, das Training und die Validierung von benutzerdefinierten Modellen. Für benutzerdefinierte Modelle zur Extraktion von Dokumentenfeldern verwenden Sie das Dokument Intelligenz Studio für Vorlagen und neuronale Modelle. Benutzerdefinierte Klassifizierungsmodelle können nur in Dokument Intelligenz Studio trainiert und verwendet werden. Verwenden Sie das Dokument Intelligenz Studio, wenn Sie die GA-Versionen der Modelle aus Version v3.0, v3.1 und v4.0 ausprobieren möchten.

Wann Sie das Azure KI Foundry-Portal verwenden sollten

Beginnen Sie mit dem neuen Azure KI Foundry, und probieren Sie eines der vorgefertigten Dokumentenmodelle aus der Version 2024-02-29-preview aus, einschließlich allgemeiner Extraktionsmodelle wie Lesen oder Layout.

Weitere Informationen zu Dokument Intelligenz Studio

Wählen Sie die Studiooberfläche auf den folgenden Registerkarten aus, um mehr über jedes Studio zu erfahren und wie Sie mit der Nutzung beginnen können.

Wichtig

Dokument Intelligenz Studio unterstützt Dokument Intelligenz v3.0 und höhere API-Versionen für die Modellanalyse und benutzerdefiniertes Modelltraining. Zuvor trainierte v2.1-Modelle mit beschrifteten Daten werden unterstützt, v2.1-Modelltraining hingegen nicht. Ausführliche Informationen zum Migrieren von v2.1 zu v3.0 finden Sie im REST-API-Migrationshandbuch.

Verwenden Sie den Dokument Intelligenz Studio-Schnellstart, um mit der Analyse von Dokumenten mit Dokumentanalyse oder vordefinierten Modellen zu beginnen. Erstellen Sie benutzerdefinierte Modelle, und verweisen Sie auf die Modelle in Ihren Anwendungen mithilfe eines der sprachspezifischen SDKs.

Voraussetzungen

Um Dokument Intelligenz-Studio zu verwenden, müssen Sie die folgenden Ressourcen aus dem Azure-Portal erwerben:

  • Ein Azure-Abonnement - Erstellen Sie eines kostenlos.

  • Eine Azure KI Services- oder Dokument Intelligenz-Ressource. Sobald Sie Ihr Azure-Abonnement haben, erstellen Sie im Azure-Portal eine Single-Service- oder Multi-Service-Ressource, um Ihren Schlüssel und Endpunkt zu erhalten. Verwenden Sie den Tarif „Free“ (F0), um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Tipp

Erstellen Sie eine Azure KI Services-Ressource, wenn Sie planen, auf mehrere Azure KI Services unter einem einzelnen Endpunkt/Schlüssel zuzugreifen. Erstellen Sie nur für den Zugriff auf Dokument Intelligenz eine Dokument Intelligenz-Ressource. Beachten Sie, dass Sie eine Einzeldienstressource benötigen, wenn Sie die Microsoft Entra-Authentifizierung verwenden möchten.

Dokument Intelligenz unterstützt jetzt beim Zugriff auf die Ressourcen und die Speicherkonten von Dokument Intelligenz zusätzlich zur lokalen (schlüsselbasierten) Authentifizierung die AAD-Tokenauthentifizierung. Befolgen Sie die folgenden Anweisungen, um die richtigen Zugriffsrollen einzurichten – insbesondere dann, wenn Ihre Ressourcen mit der DisableLocalAuth-Richtlinie angewendet werden.

Es gibt zusätzliche Voraussetzungen für die Verwendung benutzerdefinierter Modelle in Dokument Intelligenz Studio. Eine Schritt-für-Schritt-Anleitung finden Sie in der Dokumentation.

Mit auf Namespace-Ebene konfigurierten Autorisierungsrichtlinien

Ihre Organisation kann die lokale Authentifizierung deaktivieren und die Microsoft Entra-Authentifizierung (früher Azure Active Directory) für Azure KI Dokument Intelligenz-Ressourcen und Azure Blob Storage erzwingen.

  • Microsoft Entra-Authentifizierung erfordert, dass die schlüsselbasierte Autorisierung deaktiviert ist. Nachdem der Schlüsselzugriff deaktiviert wurde, wird Microsoft Entra ID die einzige verfügbare Autorisierungsmethode.

  • Microsoft Entra ermöglicht die Gewährung von Mindestberechtigungen und granularer Kontrolle für Azure-Ressourcen.

Für weitere Informationen siehe die folgenden Anleitungen:

Hinweis

Wenn die lokale (schlüsselbasiert) Authentifizierung für Ihre Dokument Intelligenz-Dienstressource deaktiviert ist, müssen Sie die Rolle Cognitive Services-Benutzer erhalten, und Ihr AAD-Token wird zum Authentifizieren von Anforderungen in Dokument Intelligenz Studio verwendet. Die Rolle Mitwirkender ermöglicht Ihnen lediglich das Auflisten von Schlüsseln. Sie erteilt Ihnen jedoch nicht die Berechtigung, die Ressource zu verwenden, wenn der Schlüsselzugriff deaktiviert ist.

Wichtig

  • Stellen Sie sicher, dass Sie über die Rolle „Cognitive Services-Benutzer“ und nicht über die Cognitive Services-Teilnehmerrolle verfügen, wenn Sie die Entra-Authentifizierung einrichten.
  • ✔️ Cognitive Services-Benutzer: Sie benötigen diese Rolle für Dokument Intelligenz- oder Azure KI Services-Ressourcen, um die Analyseseite aufzurufen.
  • ✔️ Mitwirkender: Sie benötigen diese Rolle zum Erstellen einer Ressourcengruppe, eines Dokument Intelligenz-Diensts oder einer Azure KI Services-Ressource.
  • Im Azure-Konzept kann die Teilnehmerrolle nur Aktionen ausführen, um die Ressource selbst zu steuern und zu verwalten, einschließlich der Auflistung der Zugriffsschlüssel.
  • Benutzerkonten mit einem Teilnehmer können nur auf den Dokument Intelligenz-Dienst zugreifen, indem sie mit Zugriffsschlüsseln aufrufen. Wenn Sie jedoch den Zugriff mit Entra ID einrichten, wird der Schlüsselzugriff deaktiviert, und die Rolle Cognitive Service-Benutzer wird für ein Konto erforderlich sein, um die Ressourcen zu nutzen.

Authentifizierung in Studio

Navigieren Sie zu Dokument Intelligenz-Studio. Wenn Sie sich zum ersten Mal anmelden, wird ein Popupfenster angezeigt, in dem Sie auffordert werden, Ihre Dienstressource zu konfigurieren. Gemäß der Richtlinie Ihrer Organisation haben Sie eine oder zwei Optionen:

  • Microsoft Entra-Authentifizierung: Zugriff nach Resource (empfohlen).

    • Wählen Sie Ihr bestehendes Abonnement aus.

    • Wählen Sie eine bestehende Ressourcengruppe innerhalb Ihres Abonnements aus, oder erstellen Sie eine neue Gruppe.

    • Wählen Sie Ihre vorhandene Dokument Intelligenz- oder Azure KI Services-Ressource aus.

      Screenshot der Konfiguration des Dienstressourcenformulars aus dem Dokument Intelligenz Studio.

  • Lokale Authentifizierung: Zugriff nach API-Endpunkt und Schlüssel.

    • Rufen Sie Ihren Endpunkt und Schlüssel im Azure-Portal ab.

    • Wechseln Sie zur Übersichtsseite für Ihre Ressource, und wählen Sie in der linken Navigationsleiste Schlüssel und Endpunkt aus.

    • Geben Sie die Werte in die entsprechenden Felder ein.

      Screenshot der Seite

  • Nachdem Sie das Szenario in Document Intelligence Studio überprüft haben, verwenden Sie die Clientbibliotheken von C#, Java, JavaScript oder Python oder die REST-API, um mit der Integration von Dokument Intelligenz-Modellen in Ihre eigenen Anwendungen zu beginnen.

Unterstützung für Dokument Intelligenz-Modelle

Verwenden Sie den Hilfe-Assistenten, die Benutzeroberfläche für Beschriftungen, den Trainingsschritt und interaktive Visualisierungen, um zu verstehen, wie die einzelnen Features funktionieren.

  • Lesen: Testen Sie das Feature „Studio Lesen“ von Dokument Intelligenz mit Beispieldokumenten oder Ihren eigenen Dokumenten, und extrahieren Sie Textzeilen, Wörter, erkannte Sprachen und handschriftlichen Stil, falls erkannt. Für weitere Informationen siehe Übersicht lesen.

  • Layout: Testen Sie das Feature „Studio Layout“ von Dokument Intelligenz mit Beispieldokumenten oder Ihren eigenen Dokumenten, und extrahieren Sie Text, Tabellen, Auswahlzeichen und Strukturinformationen. Für weitere Informationen siehe Layoutübersicht.

  • Vordefinierte Modelle: Mit den vordefinierten Modellen von Dokument Intelligenz können Sie Ihren Apps und Flows eine intelligente Dokumentverarbeitung hinzufügen, ohne dass Sie Ihre eigenen Modelle trainieren und erstellen müssen. Beginnen Sie beispielsweise mit dem Studio-Rechnungsfeature. Für weitere Informationen siehe Modellübersicht.

  • Benutzerdefinierte Extraktionsmodelle: Das Feature „benutzerdefinierte Studio-Modelle“ von Dokument Intelligenz ermöglichen es Ihnen, Felder und Werte aus Modellen zu extrahieren, die mit Ihren Daten trainiert wurden und auf Ihre Formulare und Dokumente zugeschnitten sind. Zur Extraktion von Daten aus mehreren Formulartypen erstellen Sie eigenständige benutzerdefinierte Modelle oder kombinieren Sie zwei oder mehr benutzerdefinierte Modelle, um ein zusammengesetztes Modell zu erstellen. Testen Sie das benutzerdefinierte Modell mit Ihren Beispieldokumenten, und verbessern Sie es durch Iteration. Für weitere Informationen siehe die Übersicht über benutzerdefinierte Modelle.

  • Benutzerdefinierte Klassifizierungsmodelle: Die Klassifizierung von Dokumenten ist ein neues Szenario, das von Dokument Intelligenz unterstützt wird. Die Dokumentenklassifizierer-API unterstützt Klassifizierungs- und Aufteilungsszenarien. Trainieren Sie ein Klassifizierungsmodell, um die verschiedenen Arten von Dokumenten zu identifizieren, die Ihre Anwendung unterstützt. Die Eingabedatei für das Klassifizierungsmodell kann mehrere Dokumente enthalten und klassifiziert jedes Dokument innerhalb eines zugeordneten Seitenbereichs. Weitere Informationen finden Sie unter Benutzerdefinierte Klassifizierungsmodelle.

  • Add-On-Funktionen: Dokument Intelligenz unterstützt komplexere Analysefunktionen. Diese optionalen Funktionen können in Studio mithilfe der Schaltfläche Analyze Options auf jeder Modellseite aktiviert und deaktiviert werden. Es stehen vier Add-On-Funktionen zur Verfügung: highResolution-, formula-, font- und barcode extraction-Funktionen. Weitere Informationen finden Sie unter Add-On-Funktionen.

Testen eines Dokument Intelligenz-Modells

  • Nachdem Ihre Ressource konfiguriert wurde, können Sie die verschiedenen Modelle ausprobieren, die von Dokument Intelligenz Studio angeboten werden. Wählen Sie auf der Startseite ein beliebiges Dokument Intelligenz-Modell aus, um es ohne Code zu verwenden.

  • Um eines der Dokumentanalyse- oder vordefinierten Modelle zu testen, wählen Sie das Modell aus, und verwenden Sie eines der Beispieldokumente, oder laden Sie Ihr eigenes Dokument hoch, um es zu analysieren. Das Analyseergebnis wird rechts im Inhaltsergebniscodefenster angezeigt.

  • Benutzerdefinierte Modelle müssen mit Ihren Dokumenten trainiert werden. Eine Übersicht über benutzerdefinierte Modelle finden Sie in Übersicht über benutzerdefinierte Modelle.

  • Nachdem Sie das Szenario in Document Intelligence Studio überprüft haben, verwenden Sie die Clientbibliotheken von C#, Java, JavaScript oder Python oder die REST-API, um mit der Integration von Dokument Intelligenz-Modellen in Ihre eigenen Anwendungen zu beginnen.

Anzeigen von Ressourcendetails

Zum Anzeigen von Ressourcendetails wie Name und Tarif klicken Sie auf das Symbol Einstellungen in der oberen rechten Ecke der Startseite von Dokument Intelligenz-Studio und wählen Sie die Registerkarte Ressource aus. Wenn Sie Zugriff auf andere Ressourcen haben, können Sie auch die Ressourcen wechseln.

Screenshot: Registerkarte „Ressourcen“ der Studio-Einstellungen

Mit Dokument Intelligenz können Sie Ihre Datenverarbeitung in Anwendungen und Workflows schnell automatisieren, datengesteuerte Strategien leicht verbessern und die Möglichkeiten der Dokumentensuche gekonnt erweitern.

Problembehandlung

Szenario Ursache Lösung
Sie erhalten die Fehlermeldung
Form Recognizer Not Found, wenn Sie ein benutzerdefiniertes Projekt öffnen.		 Ihre an das benutzerdefinierte Projekt gebundene Dokument Intelligenz-Ressource wurde gelöscht oder in eine andere Ressourcengruppe verschoben. Es gibt zwei Möglichkeiten, dieses Problem zu beheben:
• Erstellen Sie die Dokument Intelligenz-Ressource unter demselben Abonnement und derselben Ressourcengruppe mit demselben Namen erneut.
• Erstellen Sie erneut ein benutzerdefiniertes Projekt mit der migrierten Dokument Intelligenz-Ressource, und geben Sie dasselbe Speicherkonto an.
Sie erhalten die Fehlermeldung
PermissionDenied, wenn Sie vordefinierte Apps verwenden oder ein benutzerdefiniertes Projekt öffnen.		 Der Prinzipal hat keinen Zugriff auf API/Vorgang", wenn er gegen vordefinierte Modelle analysiert oder ein benutzerdefiniertes Projekt öffnet. Es ist wahrscheinlich, dass die lokale (schlüsselbasierte) Authentifizierung für Ihre Dokument Intelligenz-Ressource nicht über ausreichende Berechtigungen für den Zugriff auf die Ressource verfügt. Verweisen Sie auf Azure-Rollenzuweisungen, um Ihre Zugriffsrollen zu konfigurieren.
Sie erhalten die Fehlermeldung
AuthorizationPermissionMismatch, wenn Sie ein benutzerdefiniertes Projekt öffnen.		 Die Anforderung ist nicht berechtigt, den Vorgang mithilfe der angegebenen Berechtigung auszuführen. Wahrscheinlich ist die lokale (schlüsselbasierte) Authentifizierung für Ihr Speicherkonto deaktiviert, und Sie verfügen nicht über die erteilte Berechtigung für den Zugriff auf die Blob-Daten. Verweisen Sie auf Azure-Rollenzuweisungen, um Ihre Zugriffsrollen zu konfigurieren.
Sie können sich nicht bei Dokument Intelligenz-Studio anmelden und erhalten die Fehlermeldung
InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in		 Es ist wahrscheinlich, dass Ihr Browser Cookies von Drittanbietern blockiert, weshalb Sie sich nicht erfolgreich anmelden können. Informationen zum Beheben finden Sie unter Verwalten der Einstellungen von Drittanbietern für Ihren Browser.

Verwalten von Einstellungen von Drittanbietern für den Studio-Zugriff

Edge:

  • Gehen Sie zu Einstellungen für Microsoft Edge
  • Suchen Sie nach „Drittanbieter“
  • Wechseln Sie zu Verwalten und Löschen von Cookies und Websitedaten
  • Deaktivieren der Einstellung für Cookies von Drittanbietern blockieren

Chrome:

  • Wechseln sie zu Einstellungen für Chrome
  • Suchen Sie nach „Drittanbieter“
  • Wählen Sie unter Standardverhalten die Option Cookies von Drittanbietern zulassen aus

Firefox:

  • Wechseln Sie zu Einstellungen für Firefox
  • Suchen Sie nach „Cookies“
  • Wählen Sie unter Erweiterter Tracking-Schutz die Option Ausnahmen verwalten aus
  • Fügen Sie eine Ausnahme für https://documentintelligence.ai.azure.com oder die Dokument Intelligenz-Studio-URL Ihrer Umgebung hinzu

Safari:

  • Wählen Sie Safari>Einstellungen aus
  • Wählen Sie Datenschutz aus
  • Deaktivieren Sie Alle Cookies blockieren