Anfügen einer Azure KI Multi-Service-Ressource an ein Skillset in Azure KI Search

Artikel
11/19/2024

Wenn Sie eine optionale KI-Anreicherungspipeline in Azure KI-Suche konfigurieren, können Sie eine kleine Anzahl Dokumente kostenlos anreichern, beschränkt auf täglich 20 Transaktionen pro Index. Für umfangreichere und häufigere Workloads sollten Sie eine abrechenbare Azure KI Ressource für mehrere Dienste anfügen.

Ein Mehrfachdienstkonto bietet eine Sammlung von Azure KI Services anstelle einzelner Dienste. Das Bereitstellen eines Kontos in einem Azure KI-Such-Skillset ermöglicht es Microsoft, Sie für die Nutzung dieser Dienste zu belasten:

Azure KI Vision für Bildanalyse, optische Zeichenerkennung (OCR) und multimodale Text- und Bildeinbettung.
Azure KI Language für Spracherkennung, Entitätserkennung, Stimmungsanalyse und Schlüsselbegriffserkennung
Azure AI Speech für Spracherkennung und Sprachsynthese
Azure KI Übersetzer für die maschinelle Textübersetzung

Sie müssen Verbindungsinformationen zu Azure KI Multi-Ressource im Skillset bereitstellen. Azure KI-Suche verwendet die Verbindung nicht für Skillset-Workloads, aber sie verwendet die Verbindung, um auf die Abrechnungszähler auf der Ressource zuzugreifen. Daher wird Ihr Azure KI-Dienstkonto für die Abrechnung und nicht für die Verarbeitung von Fähigkeiten verwendet. Azure KI-Suche verwendet separate dedizierte Ressourcen für die Verarbeitung von Fähigkeiten.

Sie können einen Schlüssel für die Verbindung verwenden oder einen schlüssellosen Ansatz implementieren, der sich derzeit in der Vorschau befindet.

Tipp

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

Voraussetzungen

Konnektivität über einen öffentlichen Endpunkt, es sei denn, Ihr Suchdienst erfüllt das Erstellungsdatum, die Ebene und die Regionsanforderungen für private Verbindungen mit einem Azure KI Multi-Service-Konto.

Hinweis

Wenn Ihre Azure KI-Ressource für die Verwendung eines privaten Endpunkts konfiguriert ist, kann Azure KI-Suche eine Verbindung über einen freigegebenen privaten Link herstellen, wenn der Suchdienst nach dem 3. April 2024 erstellt wurde und sich in einer Region befindet, die Rechenleistung mit höherer Kapazität bietet und sich auf einer unterstützten Ebene befindet. Weitere Informationen finden Sie unter den Anforderungen für die Verwendung freigegebener privater Links.

Abrechnung über eine schlüssellose Verbindung

Hinweis

Dieses Feature ist zurzeit als öffentliche Preview verfügbar. Diese Vorschau wird ohne Vereinbarung zum Servicelevel bereitgestellt und nicht für Produktionsworkloads empfohlen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Mithilfe des Azure-Portals oder neuerer Vorschau-REST-APIs und Beta-SDK-Pakete können Sie eine Azure KI Multi-Service-Ressource mithilfe einer verwalteten Identität und Berechtigungen anfügen. Der Vorteil dieses Ansatzes besteht darin, dass die Abrechnung schlüssellos ist und keine Abhängigkeit von Regionen hat.

Konfigurieren Sie Azure KI-Suche für die Verwendung einer verwalteten Identität.
Weisen Sie in Ihrer Azure KI Multi-Service-Ressource die Identität der Rolle Cognitive Services User zu.
Mit dem Azure-Portal oder dem Skillset 2024-11-01-Preview-REST-API oder einem Azure SDK-Betapaket, das die Syntax bereitstellt, konfigurieren Sie ein Skillset für die Verwendung einer Identität:
- Die verwaltete Identität, die für die Verbindung verwendet wird, gehört zum Suchdienst.
- Die Identität kann vom System verwaltet oder vom Benutzer zugewiesen werden.
- Die Identität muss über die Berechtigung Cognitive Services User für die Azure KI-Ressource verfügen.
- @odata.type ist immer #Microsoft.Azure.Search.AIServicesByIdentity.
- subdomainUrl ist der Endpunkt Ihrer Azure KI Multi-Service-Ressource. Es kann sich in jeder Region befinden, die gemeinsam von Azure KI Search und Azure KI-Diensten unterstützt wird.

Wie bei Schlüsseln werden die Details, die Sie über die Azure KI Services-Ressource angeben, für die Abrechnung und nicht für Verbindungen verwendet. Alle API-Anforderungen, die von Azure KI Search an Azure KI-Dienste für die integrierte Verarbeitung von Fähigkeiten vorgenommen werden, werden weiterhin intern und von Microsoft verwaltet.

Beispiel: systemseitig zugewiesenen verwalteten Identität

Die Identität ist auf NULL festgelegt.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": null 
    }  
}

Beispiel: Benutzerseitig zugewiesene verwaltete Identität aktivieren

Identität ist auf die Ressourcen-ID der benutzerseitig zugewiesenen verwalteten Identität gesetzt. Informationen zum Finden einer vorhandenen nutzerzugewiesenen Identität finden Sie unter Nutzerzugewiesene verwaltete Identitäten verwalten.

Legen Sie für eine vom Benutzer zugewiesene verwaltete Identität die Eigenschaften @odata.type und userAssignedIdentity fest.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": {   
            "@odata.type":  "#Microsoft.Azure.Search.DataUserAssignedIdentity",   
            "userAssignedIdentity": ""/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}"" 
        }
    } 
}

Abrechnung über einen Ressourcenschlüssel

Azure KI Search kann auch eine Transaktion mit dem Azure KI Multi-Service-Ressourcenschlüssel berechnen. Dieser Ansatz ist der Standardwert und ist allgemein verfügbar. Sie können das Azure-Portal, die REST-API oder ein Azure-SDK verwenden, um den Schlüssel zu einem Skillset hinzuzufügen.

Es gibt zwei unterstützte Schlüsseltypen: #Microsoft.Azure.Search.CognitiveServicesByKey ruft den regionalen Endpunkt auf, "#Microsoft.Azure.Search.AIServicesByKey die Unterdomäne. Wir empfehlen die Verwendung von AIServicesByKey für die Unterstützung gemeinsamer privater Links und die Fähigkeit, ohne regionale Anforderungen in Bezug auf den Suchdienst zu funktionieren.

Wenn Sie die cognitiveServices Eigenschaft nicht angeben, versucht Ihr Suchdienst, die kostenlosen Anreicherungen zu verwenden, die Ihrem Indexer täglich zur Verfügung stehen. Die Ausführung abrechenbarer Skills wird bei 20 Transaktionen pro Indexeraufruf beendet, und im Ausführungsverlauf des Indexers wird eine Timeoutmeldung angezeigt.

Melden Sie sich beim Azure-Portal an.
Erstellen Sie eine Azure KI Services-Ressource für mehrere Dienste in derselben Region wie Ihr Suchdienst.
Rufen Sie den Ressourcenschlüssel von der Seite Ressourcen>Schlüssel und Endpunkt ab.
Fügen Sie den Schlüssel einer Skillsetdefinition hinzu:
- Wenn Sie einen Datenimport-Assistenten verwenden, erstellen oder wählen Sie das Azure KI-Konto aus. Der Assistent fügt Ihrer Skillsetdefinition den Ressourcenschlüssel hinzu.
- Stellen Sie für ein neues oder vorhandenes Skillset den Schlüssel in der Skillsetdefinition bereit.

Hinweis

Azure-Portal hängt derzeit automatisch Schlüssel des Typs #Microsoft.Azure.Search.CognitiveServicesByKey an.

Verwenden Sie die API Erstellen oder Aktualisieren des Skillsets, und geben Sie den Abschnitt cognitiveServices im Text der Anforderung an:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-11-01-Preview
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
        "description": "mycogsvcs",
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",
        "key": "<your key goes here>"
    }
}

Der folgende gekürzte Codeausschnitt ist aus azure-search-dotnet-samples.

IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
IConfigurationRoot configuration = builder.Build();

string searchServiceUri = configuration["SearchServiceUri"];
string adminApiKey = configuration["SearchServiceAdminApiKey"];
string cognitiveServicesKey = configuration["CognitiveServicesKey"];

SearchIndexerClient indexerClient = new SearchIndexerClient(new Uri(searchServiceUri), new AzureKeyCredential(adminApiKey));

// Create the skills
Console.WriteLine("Creating the skills...");
OcrSkill ocrSkill = CreateOcrSkill();
MergeSkill mergeSkill = CreateMergeSkill();

// Create the skillset
Console.WriteLine("Creating or updating the skillset...");
List<SearchIndexerSkill> skills = new List<SearchIndexerSkill>();
skills.Add(ocrSkill);
skills.Add(mergeSkill);

SearchIndexerSkillset skillset = CreateOrUpdateDemoSkillSet(indexerClient, skills, cognitiveServicesKey);

Entfernen Sie den Schlüssel

Anreicherungen sind abrechnungsfähige Vorgänge. Wenn Sie Azure KI Services nicht mehr aufrufen müssen, befolgen Sie diese Anweisungen, um den Mehrfachdienstschlüssel zu entfernen und die Verwendung der externen Ressource zu verhindern. Ohne den Schlüssel wird das Skillset auf die Standardzuweisung von 20 kostenlosen Transaktionen pro Indexer pro Tag zurückgesetzt. Die Ausführung von abrechnenden Fertigkeiten stoppt bei 20 Transaktionen und eine Meldung „TimeOut“ wird im Indexerausführungsverlauf angezeigt, wenn die Zuordnung verwendet wird.

Azure portal
REST

Melden Sie sich beim Azure-Portal an.
Wählen Sie unter Suchverwaltung > Skillsets ein Skillset aus der Liste aus.
Scrollen Sie zum Abschnitt in der Datei, die "cognitiveServices" enthält.
Löschen Sie den Schlüsselwert aus dem JSON, und speichern Sie das Skillset.

Get Skillset, damit Sie die vollständige Definition haben.
Formulieren einer Skillset aktualisieren-Anforderung, die die JSON-Definition des Skillsets bereitstellt.

Entfernen Sie den Schlüssel im Body der Definition, und senden Sie dann die Anforderung:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-07-01
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.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": ""
    }
}

Alternativ können Sie „cognitiveServices“ auf NULL festlegen:

"cognitiveServices": null,

Verwendung des Schlüssels

Die Abrechnung wird angewendet, wenn API-Aufrufe an Azure KI Services-Ressourcen 20 API-Aufrufe pro Indexer und Tag überschreiten. Sie können den Indexer zurücksetzen, um den API-Zähler zurückzusetzen.

Schlüssellose und schlüsselbasierte Verbindungen werden für die Abrechnung, aber nicht für die Verbindungen von Anreicherungsvorgängen verwendet. Für Verbindungen stellt ein Suchdienst über das interne Netzwerk eine Verbindung mit einer Azure KI Services-Ressource her, die sich in derselben physischen Region befindet. Die meisten Regionen, die Azure KI Search anbieten, bieten auch andere Azure KI Services wie Sprache an. Wenn Sie in einer Region, die nicht über beide Dienste verfügt, KI-Anreicherung auszuführen versuchen, wird die folgende Meldung angezeigt: Der angegebene Schlüssel ist kein gültiger CognitiveServices-Schlüssel für die Region des Suchdiensts.

Indexer können so konfiguriert werden, dass sie in einer privaten Ausführungsumgebung für die dedizierte Verarbeitung mit nur den Suchknoten Ihres eigenen Suchdiensts ausgeführt werden. Auch wenn Sie private Ausführungsumgebung verwenden, verwendet Azure KI Search weiterhin seine intern bereitgestellte Azure KI Multiservice-Ressource, um alle Fähigkeiten anreichern zu können.

Hinweis

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

Anforderungen an öffentliche Verbindungen

Je nachdem, wann Ihr Suchdienst erstellt wurde und je nach Ebene und Region, kann die Abrechnung für integrierte Fähigkeiten eine öffentliche Verbindung von Azure KI Search zu Azure KI Multi-Service erfordern. Das Deaktivieren des öffentlichen Netzwerkzugriffs unterbricht die Abrechnung in einigen Szenarien. Überprüfen Sie die Anforderungen für Verbindungen über einen freigegebenen privaten Link, um zu ermitteln, ob Ihr Suchdienst eine öffentliche Verbindung erfordert.

Wenn Sie das öffentliche Netzwerk nicht nutzen können, können Sie eine benutzerdefinierte Web-API-Fertigkeit konfigurieren, die mit einer Azure Function implementiert wird, die privaten Endpunkte unterstützt und die Azure KI Services-Ressource zum gleichen VNET hinzufügen. Auf diese Weise können Sie die Azure AI-Dienstressource direkt über die benutzerdefinierte Fertigkeit aufrufen, indem Sie private Endpunkte verwenden.

Wichtige Anforderungen in Sonderfällen

Die benutzerdefinierte Entitätssuche wird von Azure KI Search getaktet, nicht von Azure KI Services, aber es erfordert einen Azure KI Ressourcenschlüssel mit mehreren Diensten, um Transaktionen außerhalb von 20 pro Indexer pro Tag 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 Azure KI 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:

Hilfsprogrammskills, von denen Azure KI Services nicht aufgerufen wird (nämlich: Bedingter Skill sowie Skills für Dokumentextrahierung, Shaper, Textzusammenführung und Textaufteilung) sind nicht abrechenbar.
Die Textextraktion aus PDF-Dokumenten und anderen Anwendungsdateien ist nicht abrechenbar. Die Textextraktion, die während der Dokumententschlüsselung auftritt, ist keine KI-Anreicherung, sondern tritt während der KI-Anreicherung auf und wird daher hier erwähnt.

Abrechenbare Anreicherungen

Während der KI-Anreicherung ruft Azure AI Search die Azure AI-Dienste-APIs für integrierte Fertigkeiten auf, die auf Azure AI Vision, Translator und Azure AI Language basieren.

Zu den abrechenbaren integrierten Skills, die Back-End-Aufrufe an Azure KI Services ausführen, gehören Entitätsverknüpfung, Entitätserkennung, Bildanalyse, Schlüsselbegriffserkennung, Sprachenerkennung, OCR, Erkennung personenbezogener Informationen, Stimmung und Textübersetzung.

Die Bildextraktion ist ein Azure KI 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 auf der Preisseite von Azure KI Search.

Tipp

Um die Kosten für die Skillsetverarbeitung zu senken, aktivieren Sie die inkrementelle Anreicherung , 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 Azure KI 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. Informationen zum tatsächlichen Preis von Transaktionen finden Sie unter Azure KI Services-Preise.

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.
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.
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.

Freigeben über

Anfügen einer Azure KI Multi-Service-Ressource an ein Skillset in Azure KI Search

Voraussetzungen

Abrechnung über eine schlüssellose Verbindung

Beispiel: systemseitig zugewiesenen verwalteten Identität

Beispiel: Benutzerseitig zugewiesene verwaltete Identität aktivieren

Abrechnung über einen Ressourcenschlüssel

Entfernen Sie den Schlüssel

Verwendung des Schlüssels

Anforderungen an öffentliche Verbindungen

Wichtige Anforderungen in Sonderfällen

Freigeben von Anreicherungen

Abrechenbare Anreicherungen

Beispiel: Schätzen der Kosten

Nächste Schritte

Feedback

Zusätzliche Ressourcen