Anfügen einer abrechenbaren Ressource an ein Skillset in Foundry IQ (Azure KI-Suche)

Hinweis

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Important

Features oder Funktionen, die in diesem Artikel als "Vorschau" gekennzeichnet sind, befinden sich in der öffentlichen Vorschau und unterliegen den ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.

Vorschaubedingungen speziell für Foundry IQ (Azure KI-Suche) finden Sie unter Vorschaufunktionen.

Einige integrierte Fähigkeiten zur KI-Anreicherung in Foundry IQ (Azure KI-Suche) umfassen eine kostenlose Freigrenze von bis zu 20 Transaktionen pro Index pro Tag. Überprüfen Sie die Anforderungen der einzelnen Fähigkeiten, und fügen Sie bei Bedarf eine abrechenbare Microsoft Foundry-Ressource an Ihr Skillset an.

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. Foundry IQ 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 Foundry IQ-Dienst erfüllt die Anforderungen an Erstellungsdatum, Ebene und Region 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.

Um über eine schlüssellose Verbindung abzurechnen:

  1. Konfigurieren Sie auf Ihrem Foundry IQ-Dienst eine verwaltete Identität. Sowohl vom System zugewiesene als auch vom Benutzer zugewiesene Identitäten werden unterstützt.

  2. Weisen Sie auf Ihrer Foundry-Ressource der verwalteten Identität Ihres Foundry IQ-Diensts die Rolle "Cognitive Services User" 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-10-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

Foundry IQ berechnet standardmäßig 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 gemeinsam genutzte private Links unterstützt und keine regionalen Anforderungen im Verhältnis zum Foundry IQ-Dienst aufweist.

Ihre Foundry-Ressource muss sich in derselben Region wie Ihr Foundry IQ-Dienst befinden. Wählen Sie eine Foundry IQ-Region aus, die die Integration von Foundry Tools ermöglicht, die durch die "KI-Anreicherung"-Spalte 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 Foundry IQ-Dienst jeden Tag, die kostenlosen Anreicherungen zu verwenden, die Ihrem Indexer 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.

  1. Melden Sie sich beim portal Azure an.

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

  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 im Azure portal zu Ihrem Foundry IQ-Dienst.

  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

Für Fähigkeiten mit einem kostenlosen Zertifikat beginnt die Abrechnung, wenn API-Aufrufe einer Foundry-Ressource über 20 API-Aufrufe pro Indexer pro Tag hinausgehen. Sie können den Indexer zurücksetzen , um die API-Anzahl zurückzusetzen.

Für Fähigkeiten, deren Anreicherungsvorgänge auf den intern bereitgestellten Ressourcen von Foundry IQ ausgeführt werden, übernehmen schlüssellose und schlüsselbasierte Verbindungen zur angefügten Foundry-Ressource die Abrechnung, nicht die Anreicherungsverarbeitung. Die Azure Content Understanding-Skill verwendet die angefügte Foundry-Ressource für die Verarbeitung und Abrechnung. Überprüfen Sie die unterstützten Regionen und die Anforderungen für Verbindungen mit Foundry-Ressourcen.

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

Bei schlüssellosen Verbindungen authentifiziert sich ein Foundry IQ-Dienst 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.

Sie können Indexer für die Ausführung in einer privaten Ausführungsumgebung für dedizierte Verarbeitung konfigurieren, die nur die Suchknoten Ihres eigenen Foundry IQ-Diensts verwendet. Diese Einstellung führt nicht dazu, dass alle Fähigkeitsverarbeitungen auf Ihren Suchknoten ausgeführt werden. Einige Fähigkeiten verwenden die intern bereitgestellten Ressourcen von Foundry IQ, während Fähigkeiten wie Azure Content Understanding, Azure OpenAI Embedding und GenAI Prompt kundenkonfigurierte Ressourcen oder Modellendpunkte aufrufen.

Hinweis

Einige integrierte Fähigkeiten, z. B. die Fähigkeit zur Textübersetzung, basieren auf nicht regionalen Foundry Tools-Diensten. Wenn Sie einen nicht regionalen Skill verwenden, wird Ihre Anfrage möglicherweise in einer anderen Region als der Foundry IQ-Region bearbeitet. Weitere Informationen zu nicht regionalen Diensten finden Sie auf der Seite " Produktverfügbarkeit nach Region ".

Anforderungen an öffentliche Verbindungen

Je nachdem, wann Ihr Foundry IQ-Dienst erstellt wurde, dessen Preisniveau und seine Region, kann die Abrechnung für integrierte Fähigkeiten eine öffentliche Verbindung von Foundry IQ 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 festzustellen, ob Ihr Foundry IQ-Dienst 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 über Foundry IQ gemessen, erfordert jedoch einen Foundry-Ressourcenschlüssel, um Transaktionen über 20 pro Indexer pro Tag hinaus freizuschalten. 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 Foundry IQ APIs für integrierte Fähigkeiten auf, die auf Azure Vision, Azure Language 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 Foundry IQ-Vorgang, der auftritt, wenn Dokumente vor der Anreicherung aufgeschlü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 Seite "Foundry IQ Pricing".

Tipp

Um die Kosten der Verarbeitung von Skillsets zu senken, aktivieren Sie inkrementelle Anreicherung (Vorschau), um alle von Änderungen an einem Skillset nicht betroffenen Anreicherungen zwischenzuspeichern und wiederzuverwenden. 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önnen niedriger ausfallen. Den tatsächlichen Preis der Transaktionen finden Sie unter Foundry Tools Pricing.

Um die Kosten für die Indizierung von Foundry IQ zu schätzen, 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, jeweils 1.000 zu analysierende Bilder kosten 2,50 €, dann würden für diesen Schritt 15,00 € anfallen.

  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 würden Sie also etwa 57,00 € zahlen, um 1.000 PDF-Dokumente dieser Art mit der beschriebenen Qualifikationsgruppe zu erfassen.