Anfügen einer abrechnenden Ressource an ein Skillset in Azure KI Search

Hinweis

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Wenn Sie integrierte Fähigkeiten für AI-Anreicherung in Azure KI-Suche verwenden, können Sie eine kleine Anzahl kostenloser Dokumente erweitern, bis zu 20 Transaktionen pro Index pro Tag. Für größere oder häufigere Workloads sollten Sie eine rechnungsbare Microsoft Foundry-Ressource an Ihre skillset anfügen.

Azure KI-Suche verwendet dedizierte, intern gehostete Ressourcen, um integrierte Fähigkeiten auszuführen, die von Foundry Tools unterstützt werden, und erfordert eine Foundry-Ressource ausschließlich zu Abrechnungszwecken. Die Ausnahme ist die Azure Content Understanding Skills, die Ihre Ressource sowohl für die Abrechnung als auch für die Verarbeitung verwendet.

Eine Foundry-Ressource bietet Zugriff auf mehrere Dienste in Foundry Tools. Wenn Sie es in einem Skillset angeben, kann Microsoft Ihnen die Nutzung der folgenden Dienste in Rechnung stellen:

Die Skillset-Verarbeitung wird dem zugrunde liegenden Dienst der einzelnen Fähigkeiten in Rechnung gestellt. Azure KI-Suche konsolidiert Gebühren für Foundry Tools in einer einzigen Foundry-Ressource. Wenn Sie beispielsweise die Image Analysis und Language Detection verwenden, erscheinen die Gebühren für Azure Vision und Azure Language auf derselben Rechnung für Ihre Foundry-Ressource. Alle anderen Ressourcen werden unabhängig abgerechnet.

Um eine Foundry-Ressource anzufügen, stellen Sie Verbindungsinformationen im Skillset bereit. Sie können einen schlüsselbasierten oder schlüssellosen Ansatz verwenden.

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 einer Foundry-Ressource.

  • Eine Foundry-Ressource mit der AIServices API-Art. Sie können die API-Art auf der Seite Overview im Azure-Portal überprüfen:

    Screenshot der API-Art-Eigenschaft im Azure portal.

Hinweis

Abrechnung über eine schlüssellose Verbindung

Sie können eine verwaltete Identität und Berechtigungen verwenden, um eine Foundry-Ressource anzufügen. Der Vorteil dieses Ansatzes besteht darin, dass die Abrechnung schlüssellos ist und keine Regionsanforderungen hat.

Wie bei Schlüsseln werden die Details, die Sie zu der Ressource angeben, für die Abrechnung verwendet, nicht für Verbindungen. Alle API-Anforderungen, die von Azure KI-Suche an Foundry Tools zur integrierten Verarbeitung von Fähigkeiten vorgenommen werden, bleiben intern und von Microsoft verwaltet.

Um über eine schlüssellose Verbindung abzurechnen:

  1. konfigurieren Sie in Ihrem Azure KI-Suche dienst eine verwaltete Identität. Sowohl vom System zugewiesene als auch vom Benutzer zugewiesene Identitäten werden unterstützt.

  2. Weisen Sie ihrer Foundry-Ressource die Rolle "Cognitive Services User" der verwalteten Identität Ihres Suchdiensts zu.

  3. Konfigurieren Sie ein Skillset für die Verwendung der verwalteten Identität. Sie können das Azure Portal, die neueste stabile Version von Skillsets – Create Or Update (REST API) oder ein Azure SDK-Paket verwenden, das die Syntax bereitstellt.

    • @odata.type ist immer #Microsoft.Azure.Search.AIServicesByIdentity.

    • subdomainUrl ist der Endpunkt Ihrer Foundry-Ressource. Sie können das Format https://<resource-name>.services.ai.azure.com oder https://<resource-name>.cognitiveservices.azure.com verwenden, die beide auf der Seite Keys und Endpoint im Azure-Portal verfügbar sind.

    • Andere Eigenschaften sind spezifisch für den Typ der verwalteten Identität, wie in den folgenden REST-API-Beispielen gezeigt.

    Hier ist eine Beispielkonfiguration für eine vom System zugewiesene verwaltete Identität. In diesem Szenario müssen Sie identity auf null setzen.

    POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json

{
  "name": "my-skillset",
  "skills": [
    // Skills definition goes here
  ],
  "cognitiveServices": {
    "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",
    "description": "A sample configuration for a system-assigned managed identity.",
    "subdomainUrl": "https://[resource-name].services.ai.azure.com",
    "identity": null
  }
}

Abrechnung über einen Ressourcenschlüssel

Standardmäßig berechnet Azure KI-Suche Gebühren für Transaktionen, die den Schlüssel einer Foundry-Ressource verwenden. Dieser Ansatz ist allgemein verfügbar. Sie können das Azure-Portal, eine stabile REST-API-Version oder eine entsprechende 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 ruft die Subdomäne auf. Wir empfehlen diesen Typ, da er freigegebene private Links unterstützt und keine regionalen Anforderungen im Verhältnis zum Suchdienst aufweist.

Ihre Foundry-Ressource muss sich in derselben Region wie Ihr Suchdienst befinden. Wählen Sie eine region Azure KI-Suche aus, die die Integration von Foundry Tools ermöglicht, die durch die Spalte AI-Anreicherung angegeben wird. Weitere Informationen zur Anforderung, dass dieselbe Region genutzt werden muss, finden Sie unter Wie der Schlüssel verwendet wird.

Wenn Sie die cognitiveServices Eigenschaft nicht angeben, versucht Ihr Suchdienst jeden Tag, die für ihren Indexer verfügbaren freien Anreicherungen zu verwenden. Die Ausführung abrechenbarer Skills wird bei 20 Transaktionen pro Indexeraufruf beendet, und im Ausführungsverlauf des Indexers wird eine Timeoutmeldung angezeigt.

  1. Melden Sie sich beim portal Azure an.

  2. Erstellen Sie eine Foundry-Ressource in derselben Region wie Ihr Suchdienst.

  3. Wählen Sie im linken Bereich Ressourcenverwaltungsschlüssel>und Endpunkt aus.

  4. Kopieren Sie einen der Schlüssel.

  5. Fügen Sie den Schlüssel zu einer Skillset-Definition hinzu.

    • Wenn Sie den Assistenten zum Importieren von Daten verwenden, wählen Sie die Findry-Ressource 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 Skillset-Definition bereit.

    Screenshot der Schlüsselseite.

Hinweis

Das Portal fügt automatisch den Schlüssel vom Typ #Microsoft.Azure.Search.CognitiveServicesByKey an.

Entfernen des Schlüssels

Anreicherungen sind abrechnungsfähige Vorgänge. Wenn Sie foundry Tools nicht mehr aufrufen müssen, folgen Sie diesen Anweisungen, um den Schlüssel zu entfernen und die Verwendung der Foundry-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 abrechenbaren Skills endet bei 20 Transaktionen, und es wird eine Timeout-Meldung im Indexerausführungsverlauf angezeigt, wenn die Zuordnung verwendet wird.

  1. Wechseln Sie zum Suchdienst im Azure-Portal.

  2. Wählen Sie unter "Fähigkeiten im Suchmanagement>" in der Liste ein Skillset aus.

    Screenshot der Skillset-Seite.

  3. Scrollen Sie zum "cognitiveServices" Abschnitt in der Datei.

  4. Löschen Sie den Schlüsselwert aus dem JSON.Delete the key value from the JSON.

  5. Speichern Sie das Skillset.

    Screenshot des Skillset JSON.

Verwendung des Schlüssels

Die Abrechnung tritt in Kraft, wenn API-Aufrufe einer Foundry-Ressource 20 API-Aufrufe pro Indexer pro Tag überschreiten. Sie können den Indexer zurücksetzen , um die API-Anzahl zurückzusetzen.

Schlüssellose und schlüsselbasierte Verbindungen werden für die Abrechnung, aber nicht für Verbindungen im Zusammenhang mit Anreicherungsvorgängen verwendet.

Bei schlüsselbasierten Verbindungen stellt ein Suchdienst eine Verbindung über das interne Netzwerk mit einer Foundry-Ressource her, die sich in derselben physischen Region befindet. Die meisten Regionen, die Azure KI-Suche anbieten, bieten auch andere Azure Dienstleistungen an. Wenn Sie versuchen, KI-Anreicherung in einer Region durchzuführen, die nicht über beide Dienste verfügt, wird die folgende Meldung angezeigt: "Der bereitgestellte Schlüssel ist kein gültiger CognitiveServices-Typ-Schlüssel für die Region Ihres Suchdienstes."

Bei schlüssellosen Verbindungen authentifiziert sich ein Suchdienst mithilfe seiner Identitäts- und Rollenzuweisung und zielt auf eine Foundry-Ressource ab. Die Ressource wird als vollqualifizierter URI angegeben, und der URI enthält eine eindeutige Unterdomäne.

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. Selbst wenn Sie eine private Ausführungsumgebung verwenden, verwendet Azure KI-Suche weiterhin seine intern bereitgestellten Ressourcen, um alle Fähigkeiten anreichern zu können.

Hinweis

Einige integrierte Fähigkeiten, z. B. die Fähigkeit zur Textübersetzung, basieren auf nicht regionalen Foundry Tools-Diensten. Wenn Sie eine nicht regionale Qualifikation verwenden, wird Ihre Anforderung möglicherweise in einer anderen Region als der Azure KI-Suche Region gewartet. Weitere Informationen zu nicht regionalen Diensten finden Sie auf der Seite " Produktverfügbarkeit nach Region ".

Anforderungen an öffentliche Verbindungen

Abhängig davon, wann Ihr Suchdienst erstellt wurde, seiner Preisstufe und seiner Region, kann die Abrechnung für integrierte Fähigkeiten eine öffentliche Verbindung von Azure KI-Suche zu Ihrer Foundry-Ressource 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 verwenden können, können Sie eine Custom Web API skill mit einer Azure Function konfigurieren, die private Endpunkte unterstützt und Ihre Foundry-Ressource zum gleichen VNET hinzufügen. In diesem Szenario können Sie Ihre Foundry-Ressource direkt über die benutzerdefinierte Fähigkeit aufrufen, indem Sie private Endpunkte verwenden.

Wichtige Anforderungen Sonderfälle

Custom Entity Lookup wird von Azure KI-Suche getaktet, erfordert jedoch einen Foundry-Ressourcenschlüssel, um Transaktionen über 20 pro Indexer pro Tag zu entsperren. Nur für diese Fähigkeit entsperrt der Ressourcenschlüssel die Anzahl der Transaktionen, ist aber nicht mit der Abrechnung verbunden.

Kostenlose Erweiterungen

KI-Anreicherung bietet eine geringe Menge kostenloser Verarbeitung abrechnungsfähiger Anreicherungen, sodass Sie kurze Übungen ausführen können, ohne externe Ressourcen verbinden zu müssen. Freie Anreicherungen sind 20 Dokumente pro Indexer pro Tag. Sie können den Indexer zurücksetzen , um den Zähler zurückzusetzen, wenn Sie eine Übung wiederholen möchten.

Einige Anreicherungen sind immer kostenlos:

  • Hilfskompetenzen, die keine Foundry-Tools aufrufen (d. h. die Fähigkeiten "Bedingt", "Dokumentextraktion", "Shaper", "Textzusammenführung" und " Textteilung ") können nicht abgerechnet werden.

  • Die Textextraktion aus PDF-Dokumenten und anderen Anwendungsdateien ist nicht abrechnend. Die Textextraktion, die während der Dokumentspaltung auftritt, ist keine KI-Anreicherung, sondern tritt während der KI-Anreicherung auf und wird daher hier erwähnt.

Abrechnungsfähige Anreicherungen

Während der KI-Anreicherung ruft Azure KI-Suche APIs für built-in-Fähigkeiten auf, die auf Azure Vision, Azure Sprache und Azure Translator basieren.

Zu den abrechnenden integrierten Fähigkeiten, die Back-End-Aufrufe an externe Dienste tätigen, gehören:

Ein durch das multimodale Einbettungsmodell von Azure Vision unterstützter Abfragezeitvektorisierer ist ebenfalls eine abrechenbare Anreicherung.

Die Bildextraktion ist ein Azure KI Search-Vorgang, der ausgeführt wird, wenn Dokumente vor der Anreicherung entschlüsselt werden. Die Bildextraktion ist für alle Preisstufen abgerechnet, mit Ausnahme von 20 kostenlosen täglichen Extraktionen auf der kostenlosen Stufe. Die Kosten für die Bildextraktion gelten für Bilddateien in Blobs, eingebettete Bilder in anderen Dateien (PDF- und andere App-Dateien) und Bilder, die mit der Dokumentextraktion extrahiert wurden. Informationen zum Preis für die Bildextraktion finden Sie auf der Azure KI-Suche-Preisseite.

Tipp

Um die Kosten der Skillset-Verarbeitung zu senken, ermöglichen Sie die inkrementelle Anreicherung, um Anreicherungen zwischenzuspeichern und wiederzuverwenden, die von Änderungen an einem Skillset nicht betroffen sind. Zwischenspeichern erfordert Azure Storage (siehe pricing), aber die kumulierten Kosten für die Ausführung von Skillset sind niedriger, wenn vorhandene Anreicherungen wiederverwendet werden können, insbesondere für Skillsets, die Bildextraktion und -analyse verwenden.

Beispiel: Kosten schätzen

Die in diesem Abschnitt gezeigten Preise sind hypothetisch und werden verwendet, um den Schätzungsprozess zu veranschaulichen. Ihre Kosten könnten niedriger sein. Den tatsächlichen Preis der Transaktionen finden Sie unter Foundry Tools Pricing.

Um die Kosten zu schätzen, die mit Azure KI-Suche Indizierung verbunden sind, beginnen Sie mit einer Vorstellung davon, wie ein durchschnittliches Dokument aussieht, damit Sie einige Zahlen ausführen können. Zum Beispiel könnten Sie Annahmen treffen:

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

Gehen Sie von einer Pipeline aus, die aus dem Knacken der einzelnen PDF-Dateien, Bild- und Textextraktion, OCR von Bildern und der Entitätserkennung von Organisationen besteht.

  1. Für das Knacken von Dokumenten 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 Das kostet für diesen Schritt 6,00 $.

  2. Für OCR von 6.000 Bildern in Englisch verwendet die OCR-kognitive Fähigkeit den besten Algorithmus (DescribeText). Angenommen, sie kosten 2,50 $ pro 1.000 Zu analysierende Bilder, würden Sie für diesen Schritt 15,00 $ bezahlen.

  3. Für die Entitätsextraktion verfügen Sie über insgesamt drei Texteinträge pro Seite. Jeder Datensatz ist 1.000 Zeichen. Drei Texteinträge pro Seite multipliziert mit 6.000 Seiten entsprechen 18.000 Texteinträgen. Wenn davon ausgegangen wird, dass 2,000 $ pro 1.000 Textdatensätze anfallen, kostet dieser Schritt 36,00 $.

Insgesamt zahlen Sie ca. 57,00 $ für das Einlesen von 1.000 PDF-Dokumenten dieses Typs mit den beschriebenen Fähigkeiten.

Verwandte Inhalte

  • Last updated on