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

Bij het configureren van een optionele AI-verrijkingspijplijn in Azure AI Search kunt u gratis een beperkt aantal documenten verrijken. Voor grotere en frequentere workloads moet u een factureerbare Azure AI-resource voor meerdere services koppelen.

Een resource met meerdere services verwijst naar een set Azure AI-services als het aanbod, in plaats van afzonderlijke services, met toegang verleend via één API-sleutel. Deze sleutel wordt opgegeven in een vaardighedenset en stelt Microsoft in staat u kosten in rekening te brengen voor het gebruik van deze services:

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

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 instellen

U kunt de Azure-portal, REST API of een Azure SDK gebruiken om een factureerbare resource aan een vaardighedenset te koppelen.

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.

Azure-portal

1. Meld u aan bij de Azure-portal.

2. Maak een Azure AI-resource voor meerdere services in dezelfde regio als uw zoekservice.

3. Voeg de sleutel toe aan een definitie van een vaardighedenset:

   • Als u de wizard Gegevens importeren gebruikt, voert u de sleutel in de tweede stap 'AI-verrijkingen toevoegen' in.

   • Als u de sleutel toevoegt aan een nieuwe of bestaande vaardighedenset, geeft u de sleutel op het tabblad Azure AI-services op.

   

REST

1. Maak een Azure AI-resource voor meerdere services in dezelfde regio als uw zoekservice.

2. Maak of werk een vaardighedenset bij, waarin een sectie wordt opgegeven cognitiveServices in de hoofdtekst van de aanvraag voor de vaardighedenset:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
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>"
    }
}

.NET SDK

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 regio's 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

1. Meld u aan bij Azure Portal en open de pagina Overzicht van de zoekservice.

2. Selecteer onder Vaardighedensets de vaardighedenset met de sleutel die u wilt verwijderen.

   

3. Schuif naar het einde van het bestand.

4. Verwijder de sleutel uit de JSON en sla de vaardighedenset op.

   

REST

1. Haal vaardighedenset op zodat u de volledige definitie hebt.

2. Formuleer een aanvraag voor het bijwerken van vaardighedensets , die de JSON-definitie van de vaardighedenset biedt.

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

   PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
   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.

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 van Azure AI-services aan voor ingebouwde vaardigheden die zijn gebaseerd op Azure AI Vision, Vertalen 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 (preview) in om eventuele verrijkingen die niet worden beïnvloed door wijzigingen in een vaardighedenset, in de cache op te slaan en opnieuw te gebruiken. 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.

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

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

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

Volgende stappen

• Pagina met prijzen voor Azure AI Search
• Een vaardighedenset definiëren
• Vaardighedenset maken (REST)
• Verrijkte velden toewijzen