Een Azure AI-resource voor meerdere services koppelen aan een vaardighedenset in Azure AI Search

Artikel
01/30/2025

Als u ingebouwde vaardigheden gebruikt voor optionele AI-verrijking in Azure AI Search, kunt u gratis een klein aantal documenten verrijken, beperkt tot 20 transacties per index. Voor grotere en frequentere workloads moet u een factureerbare Azure AI-account voor meerdere services koppelen.

Azure AI Search maakt gebruik van toegewezen, intern gehoste Azure AI multiservice-resources voor de uitvoering van ingebouwde vaardigheden, maar heeft uw account met meerdere services nodig voor factureringsdoeleinden.

Een account met meerdere services biedt een verzameling Azure AI-services in plaats van afzonderlijke services. Als u een account in een azure AI Search-vaardighedenset oplevert, kan Microsoft u kosten in rekening brengen voor het gebruik van deze services:

Azure AI Vision voor afbeeldingsanalyse, optische tekenherkenning (OCR) en multimodale insluitingen
Azure AI-taal voor taaldetectie, entiteitsherkenning, sentimentanalyse en extractie van sleuteltermen
Azure AI Speech voor spraak naar tekst en tekst naar spraak
Azure AI Translator voor automatische tekstomzetting

Uitzonderingen op facturering via het account voor meerdere services omvatten AzureOpenAIEmbedding of de facturering van AML-vaardigheden. Azure AI Search host geen modellen intern vanuit Azure OpenAI of de azure AI Foundry-modelcatalogus. Het gebruik voor AML- en Azure OpenAI-vaardigheden en vectorizers vindt plaats via respectievelijk betalen per gebruik van Azure OpenAI en azure Machine Learning-prijzen voor betalen per gebruik. Een paar andere vaardigheden, zoals Tekst splitsen en Tekst samenvoegen, kunnen niet worden gefactureerd.

Als u een Azure AI-resource met meerdere resources wilt koppelen, moet u verbindingsgegevens opgeven in de vaardighedenset. U kunt een sleutel gebruiken voor de verbinding of een sleutelloze benadering implementeren die momenteel in preview is.

Tip

Azure biedt een infrastructuur voor het bewaken van facturering en budgetten. Zie Kosten voor Azure AI-services plannen en beheren voor Azure AI-services voor meer informatie over het bewaken van Azure AI-services.

Vereisten

Connectiviteit via een openbaar eindpunt, tenzij uw zoekservice voldoet aan de vereisten voor het maken van de aanmaakdatum, laag en regio voor privéverbindingen met een Azure AI-account met meerdere services.

Notitie

Als uw Azure AI-resource is geconfigureerd voor het gebruik van een privé-eindpunt, kan Azure AI Search verbinding maken met behulp van een gedeelde privékoppeling voor meer informatie. Zie de vereisten en limieten voor het gebruik van gedeelde privékoppelingen.

Factureren via een sleutelloze verbinding

Notitie

Deze functie is momenteel beschikbaar als openbare preview-versie. Deze preview wordt aangeboden zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Met behulp van Azure Portal of nieuwere PREVIEW REST API's en bèta-SDK-pakketten kunt u een Azure AI-resource voor meerdere services koppelen met behulp van een beheerde identiteit en machtigingen. Het voordeel van deze benadering is dat facturering sleutelloos is en geen afhankelijkheid heeft van regio's.

Configureer Azure AI Search om een beheerde identiteit te gebruiken.
Wijs in uw Azure AI-resource voor meerdere services de identiteit toe aan de rol Cognitive Services-gebruiker .
Met behulp van Azure Portal of de Skillset 2024-11-01-preview REST API of een Azure SDK-bètapakket dat de syntaxis biedt, configureert u een vaardighedenset voor het gebruik van een identiteit:
- De beheerde identiteit die op de verbinding wordt gebruikt, behoort tot de zoekservice. Het kan door het systeem beheerde of door de gebruiker toegewezen worden.
- De identiteit moet Cognitive Services-gebruikersmachtigingen hebben voor de Azure AI-resource.
- @odata.type is altijd #Microsoft.Azure.Search.AIServicesByIdentity.
- subdomainUrl is het eindpunt van uw Azure AI-resource voor meerdere services. De URL van het subdomein moet een unieke naam bevatten (bijvoorbeeld https://hereismyuniquename.cognitiveservices.azure.com). Als de service is gemaakt via Azure Portal, wordt automatisch een uniek subdomein gegenereerd als onderdeel van uw service-installatie. Zorg ervoor dat uw service een uniek subdomein bevat voordat u deze gebruikt met de Integratie van Azure AI Search.

Net als bij sleutels worden de gegevens die u opgeeft over de Azure AI Services-resource gebruikt voor facturering, niet voor verbindingen. Alle API-aanvragen van Azure AI Search naar Azure AI-services voor de verwerking van ingebouwde vaardigheden blijven intern en beheerd door Microsoft.

Voorbeeld: door het systeem toegewezen beheerde identiteit

De identiteit is ingesteld op null.

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

Voorbeeld: door de gebruiker toegewezen beheerde identiteit

Identiteit wordt ingesteld op de resource-id van de door de gebruiker toegewezen beheerde identiteit. Als u een bestaande door de gebruiker toegewezen beheerde identiteit wilt vinden, raadpleegt u Door de gebruiker toegewezen beheerde identiteiten beheren.

Stel voor een door de gebruiker toegewezen beheerde identiteit de @odata.type en de userAssignedIdentity eigenschappen in.

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}"" 
        }
    } 
}

Factureren via een resourcesleutel

Azure AI Search kan ook kosten in rekening brengen voor transacties met behulp van de Azure AI-resourcesleutel voor meerdere services. Deze methode is de standaardinstelling en is algemeen beschikbaar. U kunt de Azure-portal, REST API of een Azure SDK gebruiken om de sleutel toe te voegen aan een vaardighedenset.

Er zijn twee ondersteunde sleuteltypen: #Microsoft.Azure.Search.CognitiveServicesByKey die het regionale eindpunt aanroept en "#Microsoft.Azure.Search.AIServicesByKey het subdomein aanroept. We raden u aan om te gebruiken AIServicesByKey voor de ondersteuning van gedeelde private link en de mogelijkheid om te functioneren zonder regionale vereisten ten opzichte van de zoekservice.

Het Azure AI-account voor meerdere services moet zich in dezelfde regio bevinden als Azure AI Search. Zie Regio's die worden ondersteund door Azure AI Search en kies een regio die integratie van AI-services biedt voor meer informatie.

Als u de cognitiveServices eigenschap niet opgeeft, probeert uw zoekservice dagelijks de gratis verrijkingen te gebruiken die beschikbaar zijn voor uw indexeerfunctie. De uitvoering van factureerbare vaardigheden stopt bij 20 transacties per aanroep van de indexeerfunctie en er wordt een time-outbericht weergegeven in de uitvoeringsgeschiedenis van de indexeerfunctie.

Meld u aan bij het Azure-portaal.
Maak een Azure AI-resource voor meerdere services in dezelfde regio als uw zoekservice.
Haal de resourcesleutel op via de pagina Resourcessleutels>en het eindpunt.
Voeg de sleutel toe aan een definitie van een vaardighedenset:
- Als u een wizard Gegevens importeren gebruikt, maakt of selecteert u het Azure AI-account. De wizard voegt de resourcesleutel toe aan de definitie van uw vaardighedenset.
- Geef voor een nieuwe of bestaande vaardighedenset de sleutel op in de definitie van de vaardighedenset.

Notitie

Azure Portal koppelt momenteel automatisch sleutel van het type #Microsoft.Azure.Search.CognitiveServicesByKey.

Gebruik de API Vaardighedenset maken of bijwerken, waarin de sectie wordt opgegeven cognitiveServices in de hoofdtekst van de aanvraag:

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>"
    }
}

Het volgende codefragment is afkomstig van azure-search-dotnet-samples, ingekort voor beknoptheid.

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);

De sleutel verwijderen

Verrijkingen zijn factureerbare bewerkingen. Als u Azure AI-services niet meer hoeft aan te roepen, volgt u deze instructies om de sleutel voor meerdere services te verwijderen en het gebruik van de externe resource te voorkomen. Zonder de sleutel wordt de vaardighedenset teruggezet naar de standaardtoewijzing van 20 gratis transacties per indexeerfunctie, per dag. De uitvoering van factureerbare vaardigheden stopt bij 20 transacties en er wordt een time-outbericht weergegeven in de uitvoeringsgeschiedenis van de indexeerfunctie wanneer de toewijzing wordt gebruikt.

Azure-portal
REST

Meld u aan bij het Azure-portaal.
Selecteer onder Vaardighedensets voor zoekbeheer > een vaardighedenset in de lijst.
Schuif naar de sectie in het bestand met "cognitiveServices".
Verwijder de sleutelwaarde uit de JSON en sla de vaardighedenset op.

Haal vaardighedenset op zodat u de volledige definitie hebt.
Formuleer een aanvraag voor het bijwerken van vaardighedensets , die de JSON-definitie van de vaardighedenset biedt.

Verwijder de sleutel in de hoofdtekst van de definitie en verzend de aanvraag:

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": ""
    }
}

U kunt 'cognitiveServices' ook instellen op null:

"cognitiveServices": null,

Hoe de sleutel wordt gebruikt

Facturering wordt van kracht wanneer API-aanroepen naar Azure AI-servicesresources meer dan 20 API-aanroepen per indexeerfunctie per dag overschrijden. U kunt de indexeerfunctie opnieuw instellen om het aantal API's opnieuw in te stellen.

Sleutelloze en sleutelverbindingen worden gebruikt voor facturering, maar niet voor verbindingen van verrijkingsbewerkingen.

Voor verbindingen op basis van sleutels maakt een zoekservice verbinding via het interne netwerk met een Azure AI-servicesresource die zich in dezelfde fysieke regio bevindt. De meeste regio's die Azure AI Search bieden, bieden ook andere Azure AI-services, zoals Taal. Als u AI-verrijking probeert uit te voeren in een regio die niet beide services heeft, ziet u dit bericht: 'Opgegeven sleutel is geen geldige CognitiveServices-typesleutel voor de regio van uw zoekservice'.

Voor sleutelloze verbindingen wordt een zoekservice geverifieerd met behulp van de identiteit en roltoewijzing, gericht op een Azure AI-resource met meerdere services die is opgegeven als een volledig gekwalificeerde URI, met een uniek subdomein in die URI.

Indexeerfuncties kunnen worden geconfigureerd voor uitvoering in een privé-uitvoeringsomgeving voor toegewezen verwerking met behulp van alleen de zoekknooppunten van uw eigen zoekservice. Zelfs als u een privé-uitvoeringsomgeving gebruikt, gebruikt Azure AI Search nog steeds de intern ingerichte Azure AI multiservice-resource om alle vaardigheidsverrijkingen uit te voeren.

Notitie

Sommige ingebouwde vaardigheden zijn gebaseerd op niet-regionale Azure AI-services (bijvoorbeeld de vaardigheid Tekstomzetting). Als u een niet-regionale vaardigheid gebruikt, betekent dit dat uw aanvraag mogelijk wordt verwerkt in een andere regio dan de Azure AI Search-regio. Zie de pagina Azure AI-services per regio voor meer informatie over niet-regionale services.

Vereisten voor openbare verbindingen

Afhankelijk van wanneer uw zoekservice is gemaakt en de bijbehorende laag en regio, kan facturering voor ingebouwde vaardigheden een openbare verbinding van Azure AI Search naar Azure AI-multiservice vereisen. Als u openbare netwerktoegang uitschakelt, wordt de facturering in sommige scenario's verbroken. Bekijk de vereisten voor verbindingen via een gedeelde privékoppeling om te bepalen of uw zoekservice een openbare verbinding vereist.

Als u het openbare netwerk niet kunt gebruiken, kunt u een aangepaste web-API-vaardigheid configureren die is geïmplementeerd met een Azure-functie die privé-eindpunten ondersteunt en de Azure AI-servicesresource aan hetzelfde VNET toevoegt. Op deze manier kunt u azure AI-servicesresource rechtstreeks vanuit de aangepaste vaardigheid aanroepen met behulp van privé-eindpunten.

Belangrijke vereisten, speciale gevallen

Aangepaste entiteit zoeken wordt gemeten door Azure AI Search, niet azure AI-services, maar vereist een Resourcesleutel voor meerdere services van Azure AI om transacties te ontgrendelen die groter zijn dan 20 per indexeerfunctie, per dag. Alleen voor deze vaardigheid wordt het aantal transacties met de resourcesleutel opgeheven, maar is deze niet gerelateerd aan facturering.

Gratis verrijkingen

AI-verrijking biedt een kleine hoeveelheid gratis verwerking van factureerbare verrijkingen, zodat u korte oefeningen kunt uitvoeren zonder dat u een Azure AI-resource met meerdere services hoeft te koppelen. Gratis verrijkingen zijn 20 documenten per dag, per indexeerfunctie. U kunt de indexeerfunctie opnieuw instellen om de teller opnieuw in te stellen als u een oefening wilt herhalen.

Sommige verrijkingen zijn altijd gratis:

Hulpprogrammavaardigheden die geen Azure AI-services aanroepen (namelijk voorwaardelijke, documentextractie, shaper, tekst samenvoegen en vaardigheden voor tekst splitsen) kunnen niet worden gefactureerd.
Tekstextractie uit PDF-documenten en andere toepassingsbestanden is niet factureerbaar. Tekstextractie, die optreedt tijdens het kraken van het document, is geen AI-verrijking, maar vindt plaats tijdens AI-verrijking en wordt hier dus vermeld.

Factureerbare verrijkingen

Tijdens ai-verrijking roept Azure AI Search de API's voor Azure AI-services aan voor ingebouwde vaardigheden die zijn gebaseerd op Azure AI Vision, Translator en Azure AI Language.

Factureerbare ingebouwde vaardigheden die back-endaanroepen naar Azure AI-services maken, zijn Onder andere Entity Linking, Entiteitsherkenning, Afbeeldingsanalyse, Sleuteltermextractie, Taaldetectie, OCR, PII-detectie (Personally Identifiable Information), Sentiment, Text Translation en Azure AI Vision multimodale insluitingsvaardigheden.

Een querytimevector die wordt ondersteund door het multimodale insluitingsmodel van Azure AI Vision is ook een factureerbare verrijking.

Afbeeldingextractie is een Azure AI Search-bewerking die optreedt wanneer documenten worden gekraakt voordat ze worden verrijkt. Afbeeldingsextractie is factureerbaar voor alle lagen, met uitzondering van 20 gratis dagelijkse extracties in de gratis laag. Kosten voor het extraheren van afbeeldingen zijn van toepassing op afbeeldingsbestanden in blobs, ingesloten afbeeldingen in andere bestanden (PDF- en andere app-bestanden) en voor afbeeldingen die zijn geëxtraheerd met documentextractie. Zie de pagina met prijzen voor het extraheren van afbeeldingen op de pagina met prijzen voor Azure AI Search.

Tip

Om de kosten van de verwerking van vaardighedensets te verlagen, schakelt u incrementele verrijking in de cache in en gebruikt u eventuele verrijkingen die niet worden beïnvloed door wijzigingen in een vaardighedenset. Caching vereist Azure Storage (zie prijzen , maar de cumulatieve kosten voor het uitvoeren van vaardighedensets zijn lager als bestaande verrijkingen opnieuw kunnen worden gebruikt, met name voor vaardighedensets die gebruikmaken van afbeeldingextractie en -analyse.

Voorbeeld: Kosten schatten

Als u de kosten wilt schatten die zijn gekoppeld aan azure AI Search-indexering, begint u met een idee van hoe een gemiddeld document eruitziet, zodat u enkele getallen kunt uitvoeren. U kunt bijvoorbeeld bij benadering het volgende doen:

1000 PDF-bestanden.
Zes pagina's per pagina.
Eén afbeelding per pagina (6.000 afbeeldingen).
3000 tekens per pagina.

Stel dat er een pijplijn bestaat die bestaat uit het kraken van documenten van elke PDF, afbeelding en tekstextractie, optische tekenherkenning (OCR) van afbeeldingen en entiteitsherkenning van organisaties.

De prijzen die in dit artikel worden weergegeven, zijn hypothetisch. Ze worden gebruikt om het schattingsproces te illustreren. Uw kosten kunnen lager zijn. Zie prijzen voor Azure AI-services voor de werkelijke prijs van transacties.

Voor het kraken van documenten met tekst- en afbeeldingsinhoud is tekstextractie momenteel gratis. Voor 6.000 afbeeldingen wordt uitgegaan van $ 1 voor elke 1000 afbeeldingen die zijn geëxtraheerd. Dat kost $ 6,00 voor deze stap.
Voor OCR van 6.000 afbeeldingen in het Engels gebruikt de OCR cognitieve vaardigheid het beste algoritme (DescribeText). Uitgaande van een kosten van $ 2,50 per 1000 afbeeldingen die moeten worden geanalyseerd, betaalt u $ 15,00 voor deze stap.
Voor entiteitextractie hebt u in totaal drie tekstrecords per pagina. Elke record is 1000 tekens. Drie tekstrecords per pagina vermenigvuldigd met 6.000 pagina's die gelijk zijn aan 18.000 tekstrecords. Uitgaande van $ 2,00 per 1.000 tekstrecords, kost deze stap $ 36,00.

Als u alles samenbrengt, betaalt u ongeveer $ 57,00 om 1000 PDF-documenten van dit type op te nemen met de beschreven vaardighedenset.

Delen via

Een Azure AI-resource voor meerdere services koppelen aan een vaardighedenset in Azure AI Search

Vereisten

Factureren via een sleutelloze verbinding

Voorbeeld: door het systeem toegewezen beheerde identiteit

Voorbeeld: door de gebruiker toegewezen beheerde identiteit

Factureren via een resourcesleutel

De sleutel verwijderen

Hoe de sleutel wordt gebruikt

Vereisten voor openbare verbindingen

Belangrijke vereisten, speciale gevallen

Gratis verrijkingen

Factureerbare verrijkingen

Voorbeeld: Kosten schatten

Volgende stappen

Feedback

Aanvullende resources