Anfügen einer Cognitive Services-Ressource an ein Skillset in der kognitiven Azure-Suche

Wenn Sie in Azure Cognitive Search eine optionale KI-Anreicherungspipeline konfigurieren, können Sie eine begrenzte Anzahl von Dokumenten kostenlos anreichern. Für umfangreichere und häufigere Workloads sollten Sie eine abrechenbare Cognitive Services-Ressource für mehrere Dienste anfügen.

Eine Ressource für mehrere Dienste bietet „Cognitive Services“ statt einzelner Dienste, und der Zugriff wird über einen einzelnen API-Schlüssel gewährt. Dieser Schlüssel wird in einem Skillset angegeben und ermöglicht es Microsoft, Ihnen die Nutzung dieser APIs in Rechnung zu stellen:

  • Maschinelles Sehen für die Bildanalyse und optische Zeichenerkennung (Optical Character Recognition, OCR)
  • Sprachdienst für Spracherkennung, Entitätserkennung, Stimmungsanalyse und Schlüsselbegriffserkennung
  • Übersetzer für die maschinelle Textübersetzung

Tipp

Azure bietet Ihnen eine Infrastruktur zur Überwachung von Abrechnungen und Budgets. Weitere Informationen zur Überwachung Cognitive Services finden Sie unter Planen und Verwalten von Kosten für Azure Cognitive Services.

Festlegen des Ressourcenschlüssels

Sie können das Azure-Portal, die REST-API oder ein Azure SDK verwenden, um eine abrechenbare Ressource an ein Skillset anzufügen.

Wenn Sie die Eigenschaft nicht angegeben lassen, wird die Ausführung abrechenbarer Skills bei 20 Transaktionen pro Indexeraufruf beendet, und im Ausführungsverlauf des Indexers wird eine Time Out-Meldung angezeigt.

  1. Melden Sie sich beim Azure-Portal an.

  2. Erstellen Sie eine Cognitive Services-Ressource für mehrere Dienste in derselben Region wie Ihr Azure Cognitive Search-Dienst.

  3. Fügen Sie den Schlüssel einer Skillsetdefinition hinzu:

    • Falls Sie den Datenimportassistenten verwenden, geben Sie den Schlüssel im zweiten Schritt, „KI-Anreicherungen hinzufügen“, ein.

    • Wenn Sie einen Schlüssel zu einem neuen oder vorhandenen Skillset hinzufügen, stellen Sie den Schlüssel in der Registerkarte Cognitive Services bereit.

    Screenshot of the key page.

Verwendung des Schlüssels

Die schlüsselbasierte Abrechnung gilt, wenn API-Aufrufe an Cognitive Services-Ressourcen 20 API-Aufrufe pro Indexer und Tag überschreiten.

Der Schlüssel wird für die Abrechnung verwendet, aber nicht für Verbindungen. Ein Suchdienst stellt über das interne Netzwerk eine Verbindung mit einer Cognitive Services-Ressource her, die sich in derselben physischen Region befindet. Die meisten Regionen, die Cognitive Search bieten, bieten auch Cognitive Services.

Wenn Sie in einer Region, die nicht über beide Dienste verfügt, KI-Anreicherung auszuführen versuchen, wird die folgende Meldung angezeigt: „Provided key is not a valid CognitiveServices type key for the region of your search service.“ (Der angegebene Schlüssel ist kein gültiger CognitiveServices-Schlüssel für die Region des Suchdiensts.).

Hinweis

Einige integrierte Qualifikationen basieren auf nicht regionalen Cognitive Services (etwa die Qualifikation „Textübersetzung“). Die Verwendung einer nicht regionalen Qualifikation bedeutet, dass Ihre Anforderung in einer anderen Region als der Azure Cognitive Search-Region verarbeitet werden kann. Weitere Informationen zu nicht regionalen Diensten finden Sie auf der Seite für Cognitive Services-Produkte nach Region.

Wichtige Anforderungen in Sonderfällen

Die benutzerdefinierte Entitätssuche wird von Azure Cognitive Search und nicht Cognitive Services berechnet, erfordert jedoch einen Cognitive Services-Ressourcenschlüssel, um Transaktionen über 20 pro Indexer und Tag hinaus zu entsperren. Nur für diesen Skill entsperrt der Ressourcenschlüssel die Anzahl von Transaktionen, hat jedoch keinen Bezug zur Abrechnung.

Freigeben von Anreicherungen

Die KI-Anreicherung bietet eine geringe Menge an kostenloser Verarbeitung von abrechenbaren Anreicherungen, sodass Sie kurze Übungen durchführen können, ohne eine Cognitive Services-Ressource anfügen zu müssen. Anreicherungen sind für 20 Dokumente pro Tag und Indexer kostenlos. Sie können den Indexer zurücksetzen, um den Zähler zurückzusetzen und die Übung zu wiederholen.

Einige Anreicherungen sind immer kostenlos:

Abrechenbare Anreicherungen

Während der KI-Anreicherung ruft Cognitive Search die Cognitive Services-APIs für integrierte Qualifikationen auf, die auf maschinelles Sehen, Übersetzer und Azure Cognitive Services für Sprachen basieren.

Zu den abrechenbaren, integrierten Skills, die Back-End-Aufrufe an Cognitive Services machen, gehören Entitätsverknüpfung, Entitätserkennung, Bildanalyse, Schlüsselbegriffserkennung, Sprachenerkennung, OCR, PII-Erkennung, Stimmung und Textübersetzung.

Die Bildextraktion ist ein Azure Cognitive Search-Vorgang, der ausgeführt wird, wenn Dokumente vor der Anreicherung entschlüsselt werden. Die Bildextraktion ist in allen Ebenen gebührenpflichtig, mit Ausnahme von 20 kostenlosen täglichen Extraktionen im Tarif „Free“. Die Kosten für die Bildextraktion gelten für Bilddateien in Blobs, eingebettete Bilder in anderen Dateien (PDF- und andere App-Dateien) und für mit Dokumentextraktion extrahierte Bilder. Die Preise für die Bildextraktion finden Sie in der Preisübersicht für die kognitive Azure-Suche.

Tipp

Um die Kosten für die Skillsetverarbeitung zu senken, aktivieren Sie die inkrementelle Anreicherung (Vorschau), um Anreicherungen zwischenzuspeichern und wiederzuverwenden, die von Änderungen an einem Skillset nicht betroffen sind. Die Zwischenspeicherung erfordert Azure Storage (siehe Preise, aber die kumulativen Kosten für die Ausführung von Skillsets sind niedriger, wenn vorhandene Anreicherungen wiederverwendet werden können, insbesondere für Skillsets, die Bildextraktion und -analyse verwenden).

Beispiel: Schätzen der Kosten

Zum Schätzen der Kosten für die Cognitive Search-Indizierung gehen Sie von einem durchschnittlichen Dokument aus, damit einige Zahlen zur Verfügung stehen. Beispielsweise kann Folgendes angenommen werden:

  • 1.000 PDFs
  • Jeweils sechs Seiten
  • Ein Bild pro Seite (6.000 Bilder)
  • 3.000 Zeichen pro Seite

Als Beispiel dient eine Pipeline, die Dokumententschlüsselung jeder PDF-Datei, Bild- und Textextraktion, optische Zeichenerkennung (OCR) von Bildern und die Erkennung von Entitäten für Organisationen umfasst.

Die in diesem Artikel angegebenen Preise sind hypothetisch. Sie dienen der Veranschaulichung des Schätzungsprozesses. Ihre Kosten können niedriger ausfallen. Die tatsächlichen Preise von Transaktionen finden Sie unter Cognitive Services – Preise.

  1. Im Fall der Dokumententschlüsselung mit Text- und Bildinhalten ist die Textextraktion derzeit kostenlos. Bei 6.000 Bildern und einem angenommenen Preis von 1 € für jeweils 1.000 extrahierte Bilder belaufen sich die Kosten auf 6,00 € für diesen Schritt.

  2. Für die optische Zeichenerkennung (OCR) von 6.000 Bildern in Englisch verwendet die kognitive Qualifikation „OCR“ den besten Algorithmus (DescribeText). Angenommen, jeweils 1.000 zu analysierende Bilder kosten 2,50 €, dann würden für diesen Schritt 15,00 € anfallen.

  3. Für die Extraktion von Entitäten würden insgesamt 3 Textdatensätze pro Seite entstehen. Jeder Datensatz umfasst 1.000 Zeichen. Drei Textdatensätze pro Seite multipliziert mit 6.000 Seiten ergibt 18.000 Textdatensätze. Angenommen, die Kosten betragen 2,00 €/1.000 Textdatensätze, dann würde dieser Schritt 36,00 € kosten.

Insgesamt würden Sie also etwa 57,00 € zahlen, um 1.000 PDF-Dokumente dieser Art mit der beschriebenen Qualifikationsgruppe zu erfassen.

Nächste Schritte