Erstellen von Aufgaben „Content Understanding Standard“ und „Pro“ im Microsoft Foundry (classic) Portal (Vorschau)

Wichtig

Vorschau-API-Versionen 2024-12-01-preview und 2025-05-01-preview werden bis zum 15. Juli 2026 eingestellt. Wenn Sie noch eine Vorschau-API verwenden, aktualisieren Sie Ihren Code so, dass er auf die neueste API-Version ausgerichtet 2025-11-01 (GA)ist.

APIs-Versionen 2024-12-01-preview und 2025-05-01-preview befinden sich in der öffentlichen Vorschau. Diese Vorschauen werden ohne Vereinbarung auf Serviceebene bereitgestellt und werden für Produktionsworkloads nicht empfohlen. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews und das Microsoft Produkt- und Dienstdatenschutz-Zusatz ("DPA").

Angenommen, Sie haben Dateien unterschiedlicher Typen, z. B. Dokumente, Bilder, Audio oder Video, und Sie möchten wichtige Informationen automatisch daraus extrahieren. Mit dem Inhaltsverständnis können Sie eine Aufgabe erstellen, um die Datenverarbeitung zu organisieren, ein Feldschema zu definieren, das die zu extrahierenden oder generierenden Informationen angibt, und dann einen Analyzer erstellen. Die Analyse wird zu einem API-Endpunkt, den Sie in Ihre Anwendungen oder Workflows integrieren können.

In diesem Handbuch erfahren Sie, wie Sie die Modi "Content Understanding Standard" und "Pro" im portal Microsoft Foundry (classic) verwenden, um einen benutzerdefinierten Analyzer zu erstellen und zu testen, der strukturierte Informationen aus Ihren Daten extrahiert.

Hinweis

Das Foundry(klassische) Portal verwendet eine Vorschau-API (2025-05-01-preview).

Auswählen zwischen Standard- und Pro-Modi (Vorschau)

Inhaltsverständnis bietet zwei Modi für unterschiedliche Szenarien:

  • Standardmodus – Ideal für die Verarbeitung einzelner Dateien mit einfacher Feldextraktion. Verwenden Sie den Standardmodus, wenn Sie strukturierte Daten aus einzelnen Dokumenten, Bildern, Audio- oder Videodateien ohne dateiübergreifende Analyse oder komplexe Begründungsanforderungen extrahieren müssen.

  • Pro-Modus – Entwickelt für erweiterte Szenarien, die mehrstufige Begründung und dateiübergreifende Analyse erfordern. Verwenden Sie den Pro-Modus, wenn Sie Folgendes benötigen:

    • Verarbeiten mehrerer Eingabedateien in einer einzigen Anforderung
    • Anwenden von Gründen auf verschiedene Dokumente zum Überprüfen, Anreichern oder Aggregieren von Daten
    • Verwenden von Referenzdaten (Knowledge Base) zur Anleitung der Extraktion und Validierung
    • Durchführen komplexer mehrstufiger Analysen, die über die einfache Feldextraktion hinausgehen

Ausführliche Anleitungen dazu, welcher Modus für Ihr Szenario ausgewählt werden soll, finden Sie unter Azure Content Understanding Standard- und Pro-Modi (Vorschau).

Hinweis

Der Pro-Modus ist ein Vorschaufeature, das nur in dieser Vorschau-API-Version (2025-05-01-preview) verfügbar ist. Für den Standardmodus können Sie mit minimalen Änderungen zur GA-API (2025-11-01) wechseln. Weitere Informationen finden Sie im Ga-Migrationshandbuch.

Voraussetzungen

Stellen Sie zunächst sicher, dass Sie über die folgenden Ressourcen und Berechtigungen verfügen:

  • Ein Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, Create a free account.
  • Ein Foundry-Projekt in einer unterstützten Region. Eine vollständige Liste der unterstützten Regionen finden Sie unter Sprach- und Regionsunterstützung. In den nachstehenden Anweisungen erfahren Sie, wie Sie Ihr erstes Projekt erstellen.

Erstellen Ihres ersten Projekts

Führen Sie die folgenden Schritte aus, um mit dem Inhaltsverständnis im Foundry-Portal zu beginnen, um ein Projekt zu erstellen. Mit einem Projekt können Sie Ihre Arbeit organisieren und den Zustand speichern, während Sie angepasste KI-Apps erstellen. Alle Arbeiten mit Inhaltsverständnis erfolgt in einem Projekt.

  1. Wählen Sie auf der Startseite des Foundry-Portals in der oberen rechten Ecke " Neu erstellen " aus.

  2. Foundry unterstützt zwei Projekttypen: Foundry resource und AI hub resource. Beide Projekttypen funktionieren mit Inhaltsverständnis. Um die aktuellste Erfahrung zu machen, verwenden Sie die Foundry resource. Weitere Informationen zu den Projekttypen finden Sie unter Create a project for Foundry.

    • Wenn Sie ein Foundry-Projekt erstellen, wählen Sie Advanced options eine unterstützte Region aus.

    • Wenn Sie ein hubbasiertes Projekt erstellen, wählen Sie einen Hub aus, oder erstellen Sie einen Hub, um fortzufahren. Stellen Sie sicher, dass sich der Hub in einer unterstützten Region befindet. Wenn Sie keinen Hub haben oder sich Ihr Hub nicht in einer unterstützten Region befindet, wählen Sie oben im Dropdownmenü die Option aus, um einen neuen Hub zu erstellen und die erforderlichen Eingaben auszufüllen.

Erstellen einer Einzeldatei-Aufgabe, die durch den Standardmodus "Content Understanding" unterstützt wird

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Aufgabe im Foundry zu erstellen. Verwenden Sie diese Aufgabe, um Ihren ersten Analyzer zu erstellen.

  1. Wechseln Sie zur Startseite vonFoundry.
  2. Wählen Sie Ihr Projekt aus. Möglicherweise müssen Sie "Alle Ressourcen anzeigen" auswählen, um Ihr Projekt anzuzeigen.
  3. Wählen Sie im linken Navigationsbereich die Option "Inhaltsverständnis " aus.
  4. Wählen Sie +Erstellen aus.
  5. Wählen Sie diese Option aus, um ein Single-file task-Element zu erstellen, das den Content Understanding-Standardmodus verwendet. Weitere Informationen dazu, welcher Modus für Ihr Szenario geeignet ist, finden Sie unter Azure Content Understanding in Foundry Tools pro und Standardmodi (Vorschau).
  6. Geben Sie einen Namen für Ihre Aufgabe ein. Geben Sie optional eine Beschreibung ein, und ändern Sie andere Einstellungen.
  7. Wählen Sie "Erstellen" aus.

Erstellen Sie Ihren ersten Analyzer

Nachdem alles konfiguriert ist, können Sie Ihren ersten Analyzer erstellen.

Wenn Sie eine Einzeldatei-Inhaltsverständnisaufgabe erstellen, laden Sie zunächst ein Beispiel Ihrer Daten hoch und erstellen Ihr Feldschema. Das Schema ist das anpassbare Framework, mit dem die Analyse Einblicke aus Ihren Daten extrahieren kann. In diesem Beispiel erstellen Sie das Schema, um Schlüsseldaten aus einem Rechnungsdokument zu extrahieren, aber Sie können jeden Datentyp einbeziehen, und die Schritte bleiben gleich. Eine vollständige Liste der unterstützten Dateitypen finden Sie unter "Eingabedateibeschränkungen".

  1. Laden Sie eine Sample-Datei eines Rechnungsdokuments oder andere für Ihr Szenario relevante Daten hoch.

    Screenshot des Uploadschritts in der Benutzeroberfläche.

  2. Als Nächstes schlägt der Inhaltsverständnisdienst Analysevorlagen basierend auf Ihrem Inhaltstyp vor. Schauen Sie sich die im Inhaltsverständnis enthaltenen Analyservorlagen an, um eine vollständige Liste aller Vorlagen zu sehen, die für jede Modalität verfügbar sind. Wählen Sie in diesem Beispiel die Dokumentanalyse aus, um Ihr eigenes Schema zu erstellen, das auf das Rechnungsszenario zugeschnitten ist. Wenn Sie Ihre eigenen Daten verwenden, wählen Sie die Analysevorlage aus, die Ihren Anforderungen am besten entspricht, oder erstellen Sie Eigene. Eine vollständige Liste der verfügbaren Vorlagen finden Sie unter Analyzer-Vorlagen .

  3. Wählen Sie "Erstellen" aus.

    Screenshot der Analyservorlagen.

  4. Fügen Sie dem Schema als Nächstes Felder hinzu, um alle Ausgaben widerzuspiegeln, die Sie generieren möchten.

    • Geben Sie klare und einfache Feldnamen an. Einige Beispielfelder können "vendorName", "items", "price" enthalten.

    • Geben Sie den Werttyp für jedes Feld an (Zeichenfolgen, Datumsangaben, Zahlen, Listen, Gruppen). Weitere Informationen finden Sie unterunterstützten Feldtypen.

    • [Optional] Geben Sie Feldbeschreibungen an, um das gewünschte Verhalten zu erläutern, einschließlich aller Ausnahmen oder Regeln.

    • Geben Sie die Methode an, mit der der Wert für jedes Feld generiert werden soll.

      Bewährte Methoden zum Definieren ihres Feldschemas finden Sie unter bewährte Methoden für das Inhaltsverständnis. Es kann einige Minuten dauern, bis Sie Ihr Schema erstellen.

  5. Wenn Ihr Schema zum Testen bereit ist, wählen Sie "Speichern" aus. Sie können jederzeit zurückkehren und bei Bedarf Änderungen vornehmen.

    Screenshot des abgeschlossenen Schemas.

  6. Mit dem fertigen Schema generiert Content Understanding nun die Ausgabe Ihrer Stichprobendaten. In diesem Schritt können Sie weitere Daten hinzufügen, um die Genauigkeit des Analyzers zu testen oder bei Bedarf Änderungen am Schema vorzunehmen.

    Screenshot des Schematestschritts.

  7. Wenn Sie mit der Qualität Ihrer Ausgabe zufrieden sind, wählen Sie Build Analyzer aus. Diese Aktion erstellt eine Analyse-ID, die Sie in Ihre eigenen Anwendungen integrieren können, sodass Sie den Analyzer aus Ihrem Code aufrufen können.

    Screenshot des erstellten Analysetools.

Sie haben erfolgreich Ihre erste Inhaltsverständnisanalyse erstellt und können mit dem Extrahieren von Erkenntnissen aus Ihren Daten beginnen. Siehe Schnellstart: Inhaltsverständnis-REST-APIs, um Ihren Analysator mithilfe der REST-API aufzurufen.

Freigeben Ihres Projekts

Um das von Ihnen erstellte Projekt zu teilen und den Zugriff zu verwalten, wechseln Sie zum Management Center. Sie finden ihn am unteren Rand des Navigationsbereichs für Ihr Projekt:

Screenshot, wo man das Verwaltungscenter findet.

Im Management Center können Sie Benutzer verwalten und einzelne Rollen zuweisen:

Screenshot des Abschnitts Projektbenutzer im Verwaltungszentrum.

Nächste Schritte

  • Last updated on