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

Artikel
10/21/2024

Bij het configureren van een optionele AI-verrijkingspijplijn 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-resource voor meerdere services koppelen.

Een account met meerdere services biedt een verzameling Azure AI-services in plaats van afzonderlijke services. Het account heeft een gekoppelde resourcesleutel. Deze sleutel wordt opgegeven in een azure AI Search-vaardighedenset en stelt Microsoft in staat om u in rekening te brengen voor het gebruik van deze services:

Azure AI Vision voor afbeeldingsanalyse, optische tekenherkenning (OCR) en multimodale tekst en insluiten van afbeeldingen.
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

De sleutel wordt gebruikt voor facturering, niet voor verbindingen. U moet een sleutel opgeven in de vaardighedenset, zelfs als u andere mechanismen gebruikt, zoals roltoewijzingen en beheerde identiteiten, op de verbinding.

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.

De resourcesleutel ophalen voor een Azure AI-account met meerdere services

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.

De resourcesleutel toevoegen aan een vaardighedenset

U kunt de Azure-portal, REST API of een Azure SDK gebruiken om de sleutel toe te voegen aan een vaardighedenset.

Als u de 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.

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.

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-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": "<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 op basis van sleutels is van toepassing 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.

De sleutel wordt gebruikt voor facturering, maar niet voor verbindingen van verrijkingsbewerkingen. Voor verbindingen 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'.

Op dit moment is voor facturering voor ingebouwde vaardigheden een openbare verbinding van Azure AI Search met een andere Azure AI-service vereist. Als u de toegang tot het openbare netwerk uitschakelt, wordt de facturering verbroken. Als het uitschakelen van openbare netwerken een vereiste is, kunt u een aangepaste web-API-vaardigheid configureren die is geïmplementeerd met een Azure-functie die ondersteuning biedt voor privé-eindpunten en de Azure AI-servicesresource toevoegen aan hetzelfde VNET. Op deze manier kunt u azure AI-servicesresource rechtstreeks vanuit de aangepaste vaardigheid aanroepen met behulp van privé-eindpunten.

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.

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, Entity Recognition, Image Analysis, Key Phrase Extraction, Language Detection, OCR, Personally Identifiable Information (PII) Detection, Sentiment en Text Translation.

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