Schnellstart: Analysieren eines Dokuments mit agentischem Modus

In dieser Schnellstartanleitung verwenden Sie die REST-API Azure Inhaltsverständnis in Foundry Tools, um eine Dokumentanalyse mit agentischem Modus zu erstellen, ein Dokument zu analysieren und strukturierte Ergebnisse abzurufen. Der agentische Modus ist nützlich, wenn eine Antwort anhand von Nachweisen erstellt werden muss, anstatt aus einem einzigen Speicherort extrahiert zu werden.

Der agentische Modus kann Informationen in einem Dokument verbinden, Berechnungen durchführen, Ergebnisse überprüfen, komplexe Tabellen oder Abbildungen interpretieren und Felder zurückgeben, die Ihrem Schema entsprechen.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen.

Voraussetzungen

• Ein aktives Azure-Abonnement.
• Eine Microsoft Foundry-Ressource in einer unterstützten Region. Um die Ressource zu erstellen, benötigen Sie die Rolle "Mitwirkender " oder höher für das Zielabonnement oder die Ressourcengruppe.
• Eine unterstützte Bereitstellung des Vervollständigungsmodells für Foundry-Chats, die als Standardabschlussmodell für Ihre Inhaltsverständnisressource konfiguriert ist. Konfigurieren Sie mindestens 400.000 Token pro Minute (TPM)-Kapazität für die Bereitstellung, um 429 Fehler bei einer agentischen Analyse zu vermeiden. Anweisungen zum Einrichten finden Sie unter Verbinden Ihrer Inhaltsverständnisressource mit Foundry-Modellen.
• Ihr Ressourcenendpunkt und Schlüssel aus dem Azure Portal.
• cURL.

Erstellen eines agentischen Analyzers

Das Analyseschema definiert die strukturierten Felder, die der agentische Modus zurückgibt. In diesem Beispiel wird eine Rechnung ausgewertet, indem die Summe des Postens berechnet und dieser Wert mit der gemeldeten Summe verglichen wird.

Erstellen Sie eine Datei namens agentic-invoice.json mit folgendem Inhalt:

{
  "description": "Calculate and validate totals in an invoice",
  "baseAnalyzerId": "prebuilt-document",
  "models": {
    "completion": "{your-completion-model}"
  },
  "config": {
    "workflow": "agentic"
  },
  "fieldSchema": {
    "fields": {
      "CalculatedLineItemTotal": {
        "type": "number",
        "method": "generate",
        "description": "Calculate the sum of all line-item amounts in the invoice."
      },
      "ReportedInvoiceTotal": {
        "type": "number",
        "method": "generate",
        "description": "Return the final total reported by the invoice."
      },
      "TotalsMatch": {
        "type": "boolean",
        "method": "generate",
        "description": "Return true when the calculated line-item total equals the reported invoice total. Otherwise, return false."
      },
      "ValidationSummary": {
        "type": "string",
        "method": "generate",
        "description": "Briefly explain whether the totals match and identify any discrepancy."
      }
    }
  }
}

Der "agentic" Anforderungswert aktiviert den agentischen Modus. Verwenden Oder "default"weglassen workflow, damit der Dienst basierend auf der Analysekonfiguration einen Standardworkflow auswählen kann.

Ersetzen Sie {endpoint}, {key}, und {analyzerId} in der folgenden Anforderung. Erstellen Sie dann den Analyzer:

curl -i -X PUT \
  "{endpoint}/contentunderstanding/analyzers/{analyzerId}?api-version=2026-06-01-preview" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d @agentic-invoice.json

Die 201 Created Antwort enthält einen Operation-Location Header. Kopieren Sie die URL, und verwenden Sie sie, um den Erstellungsstatus der Analyse zu überprüfen:

curl -i -X GET "{operation-location}" \
  -H "Ocp-Apim-Subscription-Key: {key}"

Wiederholen Sie die Anforderung, bis die Antwort zurückgegeben wird "status": "Succeeded". Warten Sie mindestens eine Sekunde zwischen Anfragen.

Wenn Sie die erstellte Analyse abrufen, lautet dies config.workflow"agentic.2026-06-01-preview". Der Dienst löst den Erstellungszeitmarkierer in diesen versionsbasierten Workflowfamilienwert auf. Die agentic Familie verwendet die erweiterte Kontextisierungsrate.

Analysieren eines Dokuments

Übermitteln Sie ein Dokument an die Analyse. In diesem Beispiel wird eine Beispielrechnung verwendet:

curl -i -X POST \
  "{endpoint}/contentunderstanding/analyzers/{analyzerId}:analyze?api-version=2026-06-01-preview" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "url": "https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf"
      }
    ]
  }'

Um Ihr eigenes Dokument zu analysieren, ersetzen Sie die Beispiel-URL durch eine öffentlich zugängliche URL. Verwenden Sie beispielsweise eine Azure Storage BLOB-URL mit einer Signatur für gemeinsam genutzten Zugriff.

Die 202 Accepted Antwort enthält einen Operation-Location Header. Kopieren Sie die URL, und verwenden Sie sie, um das Analyseergebnis abzurufen:

curl -i -X GET "{operation-location}" \
  -H "Ocp-Apim-Subscription-Key: {key}"

Wenn die zurückgegebene status Ist Running oder NotStarted, wiederholen Sie die Anforderung nach mindestens zwei Sekunden. Wenn der Status lautet Succeeded, suchen Sie die schemaförmige Ausgabe unter result.contents[].fields. Das Ergebnis enthält die berechnete Summe, die gemeldete Summe, den Vergleich und die Validierungszusammenfassung, die im Analyseschema definiert ist.

Überprüfen Sie agentische Ergebnisse, bevor Sie sie in workflows mit hohem Einfluss verwenden. Agentic mode isn't a replacement for human review.

Einschränkungen bei der Vorschau

Die anfängliche Vorschau hat folgende Einschränkungen:

• Jede Analyseanforderung unterstützt eine Eingabedatei.
• Der agentische Modus unterstützt nur Dokumentanalysatoren.
• Felder, die die extract Methode verwenden, werden nicht unterstützt.
• Die Verwendung von beschrifteten Beispielen zur Verbesserung der Analyse wird nicht unterstützt.

Weitere Eingabebeschränkungen finden Sie unter Dienstkontingente und Grenzwerte.

Bereinigen von Ressourcen

Löschen Sie den benutzerdefinierten Analyzer, wenn Sie ihn nicht mehr benötigen:

curl -i -X DELETE \
  "{endpoint}/contentunderstanding/analyzers/{analyzerId}?api-version=2026-06-01-preview" \
  -H "Ocp-Apim-Subscription-Key: {key}"

Durch das Löschen der Analyse werden die Foundry-Ressource oder die zugehörige Modellbereitstellung nicht gelöscht.

Verwandte Inhalte

• Übersicht über den agentischen Modus
• Was ist eine Inhaltsverständnisanalyse?
• Inhaltsverständnis preise