Anfügen einer Cognitive Services-Ressource an eine Qualifikationsgruppe in Azure SearchAttach a Cognitive Services resource with a skillset in Azure Search

KI-Algorithmen steuern die Pipelines für die kognitive Indizierung, die für die Dokumentanreicherung in Azure Search verwendet werden.AI algorithms drive the cognitive indexing pipelines used for document enrichment in Azure Search. Diese Algorithmen basieren auf Azure Cognitive Services-Ressourcen, einschließlich Maschinelles Sehen für Bildanalyse und optische Zeichenerkennung (OCR) und Textanalyse für Entitätserkennung, Schlüsselbegriffserkennung und andere Anreicherungen.These algorithms are based on Azure Cognitive Services resources, including Computer Vision for image analysis and optical character recognition (OCR) and Text Analytics for entity recognition, key phrase extraction, and other enrichments. Bei Verwendung in Azure Search zu Dokumentanreicherungszwecken werden die Algorithmen in einer Qualifikation umschlossen, in einer Qualifikationsgruppe platziert und bei der Indizierung durch einen Indexer referenziert.As used by Azure Search for document enrichment purposes, the algorithms are wrapped inside a skill, placed in a skillset, and referenced by an indexer during indexing.

Sie können eine begrenzte Anzahl von Dokumenten kostenlos anreichern.You can enrich a limited number of documents for free. Oder Sie können eine abrechenbare Cognitive Services-Ressource an ein Skillset für größere und häufigere Workloads anfügen.Or, you can attach a billable Cognitive Services resource to a skillset for larger and more frequent workloads. In diesem Artikel erfahren Sie, wie Sie eine abrechenbare Cognitive Services-Ressource anfügen, um Dokumente während der Azure Search-Indizierung anzureichern.In this article, you'll learn how to attach a billable Cognitive Services resource to enrich documents during Azure Search indexing.

Hinweis

Abrechenbare Ereignisse umfassen Aufrufe von Cognitive Services-APIs und die Bildextraktion als Teil der Dokumententschlüsselungsphase in Azure Search.Billable events include calls to Cognitive Services APIs and image extraction as part of the document-cracking stage in Azure Search. Für die Textextraktion aus Dokumenten oder für Qualifikationen, über die keine Cognitive Services aufgerufen werden, fallen keine Gebühren an.There is no charge for text extraction from documents or for skills that do not call Cognitive Services.

Die Ausführung abrechenbarer Qualifikationen erfolgt nach dem nutzungsbasierten Preis für Cognitive Services.Execution of billable skills is at the Cognitive Services pay-as-you go price. Die Preise für die Bildextraktion finden Sie auf der Preisseite von Azure Search.For image extraction pricing, see the Azure Search pricing page.

Anforderung derselben RegionSame-region requirement

Azure Search und Azure Cognitive Services müssen in derselben Region vorhanden sein.We require that Azure Search and Azure Cognitive Services exist within the same region. Andernfalls wird zur Laufzeit die folgende Meldung angezeigt: "Provided key is not a valid CognitiveServices type key for the region of your search service."Otherwise, you will get this message at run time: "Provided key is not a valid CognitiveServices type key for the region of your search service."

Es gibt keine Möglichkeit, einen Dienst zwischen Regionen zu verschieben.There is no way to move a service across regions. Wenn Sie diesen Fehler erhalten, sollten Sie eine neue Cognitive Services-Ressource in der gleichen Region wie Azure Search erstellen.If you get this error, you should create a new Cognitive Services resource in the same region as Azure Search.

Verwenden kostenloser RessourcenUse Free resources

Sie können eine eingeschränkte, kostenlose Verarbeitungsoption verwenden, um das Cognitive Search-Tutorial und die Schnellstartübungen abzuschließen.You can use a limited, free processing option to complete the cognitive search tutorial and quickstart exercises.

Kostenlose Ressourcen (begrenzte Anreicherung) sind auf 20 Dokumente pro Tag pro Abonnement begrenzt.Free (Limited enrichments) resources are restricted to 20 documents per day, per subscription.

  1. Öffnen Sie den Assistenten „Daten importieren“:Open the Import data wizard:

    Öffnen des Assistenten „Daten importieren“Open the Import data wizard

  2. Wählen Sie eine Datenquelle aus, und fahren Sie mit Kognitive Suche hinzufügen (optional) fort.Choose a data source and continue to Add cognitive search (Optional). Eine ausführliche Anleitung für diesen Assistenten finden Sie unter Importieren, Indizieren und Abfragen mithilfe von Portaltools.For a step-by-step walkthrough of this wizard, see Import, index, and query by using portal tools.

  3. Erweitern Sie Cognitive Services-Instanz anfügen, und wählen Sie dann Free (begrenzte Anreicherung) aus:Expand Attach Cognitive Services and then select Free (Limited enrichments):

    Erweiterter Abschnitt „Cognitive Services-Instanz anfügen“Expanded Attach Cognitive Services section

  4. Fahren Sie mit dem nächsten Schritt Anreicherungen hinzufügen fort.Continue to the next step, Add Enrichments. Eine Beschreibung der im Portal verfügbaren Qualifikationen finden Sie unter Schritt 2: Hinzufügen von kognitiven Qualifikationen im Schnellstart zur kognitiven Suche.For a description of skills available in the portal, see Step 2: Add cognitive skills in the cognitive search quickstart.

Verwenden abrechenbarer RessourcenUse billable resources

Für Workloads, bei denen täglich mehr als 20 Anreicherungen erstellt werden, müssen Sie eine abrechenbare Cognitive Services-Ressource anfügen.For workloads that create more than 20 enrichments per day, make sure to attach a billable Cognitive Services resource. Es wird empfohlen, immer eine abrechenbare Cognitive Services-Ressource anzufügen, auch wenn Sie keine Cognitive Services-APIs aufrufen möchten.We recommend that you always attach a billable Cognitive Services resource, even if you never intend to call Cognitive Services APIs. Durch Anfügen einer Ressource wird das tägliche Limit außer Kraft gesetzt.Attaching a resource overrides the daily limit.

Ihnen werden nur Qualifikationen in Rechnung gestellt, mit denen die Cognitive Services-APIs aufgerufen werden.You're charged only for skills that call the Cognitive Services APIs. Benutzerdefinierte Qualifikationen oder Qualifikationen wie Textzusammenführung, Textteilung und Shaper, die nicht API-basiert sind, werden Ihnen nicht in Rechnung gestellt.You're not billed for custom skills, or skills like text merger, text splitter, and shaper, which aren't API-based.

  1. Öffnen Sie den Assistenten „Daten importieren“, wählen Sie eine Datenquelle aus, und fahren Sie mit Kognitive Suche hinzufügen (optional) fort.Open the Import data wizard, choose a data source, and continue to Add cognitive search (Optional).

  2. Erweitern Sie Cognitive Services-Instanz anfügen, und wählen Sie dann Neue Cognitive Services-Ressource erstellen aus.Expand Attach Cognitive Services and then select Create new Cognitive Services resource. Eine neue Registerkarte wird geöffnet, sodass Sie die Ressource erstellen können:A new tab opens so that you can create the resource:

    Erstellen einer Cognitive Services-RessourceCreate a Cognitive Services resource

  3. Wählen Sie in der Liste Standort die Region aus, in der sich Ihr Azure Search-Dienst befindet.In the Location list, select the region where your Azure Search service is located. Achten Sie darauf, diese Region aus Gründen der Leistungsoptimierung zu verwenden.Make sure to use this region for performance reasons. Durch Verwendung dieser Region entfallen auch die Gebühren für regionsübergreifende ausgehende Bandbreite.Using this region also voids outbound bandwidth charges across regions.

  4. Wählen Sie in der Liste Tarif den Tarif S0 aus, um die gesamte Sammlung der Cognitive Services-Funktionen einschließlich der Funktionen für Bildanalyse und Sprache zu erhalten, die die in Azure Search verwendeten vordefinierten Qualifikationen unterstützen.In the Pricing tier list, select S0 to get the all-in-one collection of Cognitive Services features, including the Vision and Language features that back the predefined skills used by Azure Search.

    Für den Tarif „S0“ finden Sie Sätze für bestimmte Arbeitsauslastungen auf der Seite Cognitive Services – Preise.For the S0 tier, you can find rates for specific workloads on the Cognitive Services pricing page.

    • Stellen Sie sicher, dass in der Liste Wählen Sie ein Angebot aus die Option Cognitive Services ausgewählt ist.In the Select Offer list, make sure Cognitive Services is selected.
    • Die Preise für Textanalysen Standard unter den Funktionen für Sprache gelten für die KI-Indizierung.Under Language features, the rates for Text Analytics Standard apply to AI indexing.
    • Die Preise für Maschinelles Sehen S1 sind unter den Funktionen für Bildanalyse aufgeführt.Under Vision features, the rates for Computer Vision S1 apply.
  5. Wählen Sie Erstellen aus, um die neue Cognitive Services-Ressource bereitzustellen.Select Create to provision the new Cognitive Services resource.

  6. Kehren Sie zur vorherigen Registerkarte mit dem Assistenten „Daten importieren“ zurück.Return to the previous tab, which contains the Import data wizard. Wählen Sie Aktualisieren aus, um die Cognitive Services-Ressource anzuzeigen, und wählen Sie dann die Ressource aus:Select Refresh to show the Cognitive Services resource, and then select the resource:

    Auswählen der Cognitive Services-RessourceSelect the Cognitive Services resource

  7. Erweitern Sie den Abschnitt Anreicherungen hinzufügen, um die spezifischen kognitiven Qualifikationen auszuwählen, die Sie für Ihre Daten ausführen möchten.Expand the Add Enrichments section to select the specific cognitive skills that you want to run on your data. Führen Sie dann die restlichen Schritte des Assistenten aus.Complete the rest of the wizard. Eine Beschreibung der im Portal verfügbaren Qualifikationen finden Sie unter Schritt 2: Hinzufügen von kognitiven Qualifikationen im Schnellstart zur kognitiven Suche.For a description of skills available in the portal, see Step 2: Add cognitive skills in the cognitive search quickstart.

Anfügen einer vorhandenen Qualifikationsgruppe an eine Cognitive Services-RessourceAttach an existing skillset to a Cognitive Services resource

Wenn Sie bereits über eine Qualifikationsgruppe verfügen, können Sie diese an eine neue oder andere Cognitive Services-Ressource anfügen.If you have an existing skillset, you can attach it to a new or different Cognitive Services resource.

  1. Wählen Sie auf der Seite Dienstübersicht die Registerkarte Qualifikationsgruppen aus:On the Service overview page, select Skillsets:

    Registerkarte „Qualifikationsgruppen“Skillsets tab

  2. Wählen Sie den Namen der Qualifikationsgruppe und dann eine vorhandene Ressource aus, oder erstellen Sie eine neue Ressource.Select the name of the skillset, and then select an existing resource or create a new one. Wählen Sie zum Bestätigen Ihrer Änderungen OK aus.Select OK to confirm your changes.

    Ressourcenliste „Qualifikationsgruppe“Skillset resource list

    Denken Sie daran, dass die Option Free (begrenzte Anreicherung) auf 20 Dokumente täglich beschränkt ist und dass Sie Neue Cognitive Services-Ressource erstellen zum Bereitstellen einer neuen abrechenbaren Ressource verwenden können.Remember that the Free (Limited enrichments) option limits you to 20 documents daily, and that you can use Create new Cognitive Services resource to provision a new billable resource. Wenn Sie eine neue Ressource erstellen, wählen Sie Aktualisieren aus, um die Liste der Cognitive Services-Ressourcen zu aktualisieren, und wählen Sie dann die Ressource aus.If you create a new resource, select Refresh to refresh the list of Cognitive Services resources, and then select the resource.

Programmgesteuertes Anfügen von Cognitive ServicesAttach Cognitive Services programmatically

Wenn Sie die Qualifikationsgruppe programmgesteuert definieren, fügen Sie einen cognitiveServices-Abschnitt zur Qualifikationsgruppe hinzu.When you're defining the skillset programmatically, add a cognitiveServices section to the skillset. Nehmen Sie in diesen Abschnitt den Schlüssel der Cognitive Services-Ressource auf, die Sie der Qualifikationsgruppe zuordnen möchten.In that section, include the key of the Cognitive Services resource that you want to associate with the skillset. Denken Sie daran, dass sich die Ressource in derselben Region wie die Azure Search-Ressource befinden muss.Remember that the resource must be in the same region as your Azure Search resource. Nehmen Sie außerdem @odata.type auf, und legen Sie ihn auf #Microsoft.Azure.Search.CognitiveServicesByKey fest.Also include @odata.type, and set it to #Microsoft.Azure.Search.CognitiveServicesByKey.

Das folgende Beispiel zeigt dieses Muster.The following example shows this pattern. Beachten Sie den Abschnitt cognitiveServices am Ende der Definition.Notice the cognitiveServices section at the end of the definition.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2019-05-06
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": "<your key goes here>"
    }
}

Beispiel: Schätzen der KostenExample: Estimate costs

Zum Schätzen der Kosten für die Indizierung der kognitiven Suche gehen Sie von einem durchschnittlichen Dokument aus, damit einige Zahlen zur Verfügung stehen.To estimate the costs associated with cognitive search indexing, start with an idea of what an average document looks like so you can run some numbers. Beispielsweise kann Folgendes angenommen werden:For example, you might approximate:

  • 1.000 PDFs1,000 PDFs.
  • Jeweils sechs SeitenSix pages each.
  • Ein Bild pro Seite (6.000 Bilder)One image per page (6,000 images).
  • 3.000 Zeichen pro Seite3,000 characters per page.

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.Assume a pipeline that consists of document cracking of each PDF, image and text extraction, optical character recognition (OCR) of images, and entity recognition of organizations.

Die in diesem Artikel angegebenen Preise sind hypothetisch.The prices shown in this article are hypothetical. Sie dienen der Veranschaulichung des Schätzungsprozesses.They're used to illustrate the estimation process. Ihre Kosten können niedriger ausfallen.Your costs could be lower. Die tatsächlichen Preise von Transaktionen finden Sie unter Cognitive Services – Preise.For the actual prices of transactions, see See Cognitive Services pricing.

  1. Im Fall der Dokumententschlüsselung mit Text- und Bildinhalten ist die Textextraktion derzeit kostenlos.For document cracking with text and image content, text extraction is currently free. Bei 6.000 Bildern und einem angenommenen Preis von 1 € für jeweils 1.000 extrahierte BilderFor 6,000 images, assume $1 for every 1,000 images extracted. belaufen sich die Kosten auf 6,00 € für diesen Schritt.That's a cost of $6.00 for this step.

  2. Für die optische Zeichenerkennung (OCR) von 6.000 Bildern in Englisch verwendet die kognitive Qualifikation „OCR“ den besten Algorithmus (DescribeText).For OCR of 6,000 images in English, the OCR cognitive skill uses the best algorithm (DescribeText). Angenommen, jeweils 1.000 zu analysierende Bilder kosten 2,50 €, dann würden für diesen Schritt 15,00 € anfallen.Assuming a cost of $2.50 per 1,000 images to be analyzed, you would pay $15.00 for this step.

  3. Für die Extraktion von Entitäten würden insgesamt 3 Textdatensätze pro Seite entstehen.For entity extraction, you'd have a total of three text records per page. Jeder Datensatz umfasst 1.000 Zeichen.Each record is 1,000 characters. Drei Textdatensätze pro Seite multipliziert mit 6.000 Seiten ergibt 18.000 Textdatensätze.Three text records per page multiplied by 6,000 pages equals 18,000 text records. Angenommen, die Kosten betragen 2,00 €/1.000 Textdatensätze, dann würde dieser Schritt 36,00 € kosten.Assuming $2.00 per 1,000 text records, this step would cost $36.00.

Insgesamt würden Sie also etwa 57,00 € zahlen, um 1.000 PDF-Dokumente dieser Art mit der beschriebenen Qualifikationsgruppe zu erfassen.Putting it all together, you'd pay about $57.00 to ingest 1,000 PDF documents of this type with the described skillset.

Nächste SchritteNext steps