Koppla en Azure AI-resurs med flera tjänster till en kompetensuppsättning i Azure AI Search

Artikel
10/22/2024

När du konfigurerar en valfri AI-berikande pipeline i Azure AI Search kan du utöka ett litet antal dokument kostnadsfritt, begränsat till 20 transaktioner dagligen per index. För större och mer frekventa arbetsbelastningar bör du koppla en fakturerbar Azure AI-resurs med flera tjänster.

Ett konto med flera tjänster tillhandahåller en samling Azure AI-tjänster i stället för enskilda tjänster. Kontot har en associerad resursnyckel. Den här nyckeln anges i en Azure AI Search-kompetensuppsättning och gör att Microsoft kan debitera dig för att använda dessa tjänster:

Azure AI Vision för bildanalys, optisk teckenigenkänning (OCR) och multimodal text- och bildinbäddning.
Azure AI Language för språkidentifiering, entitetsigenkänning, attitydanalys och extrahering av nyckelfraser
Azure AI Speech för tal till text och text till tal
Azure AI Translator för maskintextöversättning

Nyckeln används för fakturering, inte anslutningar. Du måste ange en nyckel i kompetensuppsättningen även om du använder andra mekanismer, till exempel rolltilldelningar och hanterade identiteter, i anslutningen.

Dricks

Azure tillhandahåller infrastruktur för att övervaka fakturering och budgetar. Mer information om övervakning av Azure AI-tjänster finns i Planera och hantera kostnader för Azure AI-tjänster.

Hämta resursnyckeln för ett Azure AI-multitjänstkonto

Logga in på Azure-portalen.
Skapa en Azure AI-resurs med flera tjänster i samma region som din söktjänst.
Hämta resursnyckeln från sidan Resursnycklar>och slutpunkt.

Lägga till resursnyckeln i en kompetensuppsättning

Du kan använda Azure Portal, REST API eller en Azure SDK för att lägga till nyckeln i en kompetensuppsättning.

Om du lämnar egenskapen ospecificerad försöker din söktjänst använda de kostnadsfria berikningar som är tillgängliga för indexeraren dagligen. Körningen av fakturerbara färdigheter stoppas vid 20 transaktioner per indexerares anrop och ett "Time Out"-meddelande visas i indexerarens körningshistorik.

Lägg till nyckeln i en kompetensuppsättningsdefinition:

Om du använder guiden Importera data skapar eller väljer du Azure AI-kontot. Guiden lägger till resursnyckeln i din kompetensuppsättningsdefinition.
För en ny eller befintlig kompetensuppsättning anger du nyckeln i kompetensuppsättningsdefinitionen.

Använd API:et Create or Update Skillset (Skapa eller uppdatera kompetensuppsättning ) och cognitiveServices ange i brödtexten i begäran:

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

Följande kodfragment är från azure-search-dotnet-samples, trimmat för korthet.

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

Ta bort nyckeln

Berikningar är fakturerbara åtgärder. Om du inte längre behöver anropa Azure AI-tjänster följer du de här anvisningarna för att ta bort nyckeln för flera tjänster och förhindra användning av den externa resursen. Utan nyckeln återgår kompetensuppsättningen till standardallokeringen av 20 kostnadsfria transaktioner per indexerare och dag. Körningen av fakturerbara färdigheter stoppas vid 20 transaktioner och ett "Time Out"-meddelande visas i indexerarens körningshistorik när allokeringen används.

Azure-portalen
REST

Logga in på Azure-portalen.
Under Kompetensuppsättningar för sökhantering > väljer du en kompetensuppsättning i listan.
Rulla till avsnittet i filen som innehåller "cognitiveServices".
Ta bort nyckelvärdet från JSON och spara kunskapsuppsättningen.

Hämta Kunskapsuppsättning så att du har den fullständiga definitionen.
Formulera en begäran om uppdateringskunskaper med JSON-definitionen för kompetensuppsättningen.

Ta bort nyckeln i definitionens brödtext och skicka sedan begäran:

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

Du kan också ange "cognitiveServices" till null:

"cognitiveServices": null,

Hur nyckeln används

Nyckelbaserad fakturering gäller när API-anrop till Azure AI-tjänstresurser överskrider 20 API-anrop per indexerare och dag. Du kan återställa indexeraren för att återställa API-antalet.

Nyckeln används för fakturering, men inte för berikningsåtgärders anslutningar. För anslutningar ansluter en söktjänst via det interna nätverket till en Azure AI-tjänstresurs som finns i samma fysiska region. De flesta regioner som erbjuder Azure AI Search erbjuder även andra Azure AI-tjänster, till exempel Language. Om du försöker berika AI i en region som inte har båda tjänsterna visas följande meddelande: "Den tillhandahållna nyckeln är inte en giltig CognitiveServices-typnyckel för söktjänstens region."

För närvarande kräver fakturering för inbyggda kunskaper en offentlig anslutning från Azure AI Search till en annan Azure AI-tjänst. Om du inaktiverar åtkomst till offentligt nätverk bryts faktureringen. Om det är ett krav att inaktivera offentliga nätverk kan du konfigurera en anpassad webb-API-färdighet som implementeras med en Azure-funktion som stöder privata slutpunkter och lägger till Azure AI-tjänstresursen i samma virtuella nätverk. På så sätt kan du anropa Azure AI-tjänstresursen direkt från den anpassade färdigheten med hjälp av privata slutpunkter.

Kommentar

Vissa inbyggda kunskaper baseras på icke-regionala Azure AI-tjänster (till exempel textöversättningsfärdigheten). Att använda en icke-regional kompetens innebär att din begäran kan betjänas i en annan region än Azure AI Search-regionen. Mer information om icke-regionala tjänster finns på sidan Produkt för Azure AI-tjänster per region .

Specialfall för viktiga krav

Anpassad entitetsökning mäts av Azure AI Search, inte Azure AI-tjänster, men det krävs en Azure AI-resursnyckel för flera tjänster för att låsa upp transaktioner över 20 per indexerare och dag. Endast för den här kunskapen avblockeras antalet transaktioner av resursnyckeln, men den är inte relaterad till fakturering.

Kostnadsfria berikningar

AI-berikning erbjuder en liten mängd kostnadsfri bearbetning av fakturerbara berikanden så att du kan utföra korta övningar utan att behöva koppla en Azure AI-resurs med flera tjänster. Kostnadsfria berikningar är 20 dokument per dag, per indexerare. Du kan återställa indexeraren för att återställa räknaren om du vill upprepa en övning.

Vissa berikanden är alltid kostnadsfria:

Verktygskunskaper som inte anropar Azure AI-tjänster (nämligen villkorsstyrd, dokumentextrahering, shaper, textsammanslagning och textdelning) kan inte faktureras.
Textextrahering från PDF-dokument och andra programfiler kan inte faktureras. Textextrahering, som sker under dokumentets sprickbildning, är inte en AI-berikning, men den sker under AI-berikning och noteras därför här.

Fakturerbara berikningar

Under AI-berikandet anropar Azure AI Search API:erna för Azure AI-tjänster för inbyggda kunskaper som baseras på Azure AI Vision, Translator och Azure AI Language.

Fakturerbara inbyggda kunskaper som gör serverdelsanrop till Azure AI-tjänster är entitetslänkning, entitetsigenkänning, bildanalys, extrahering av nyckelfraser, språkidentifiering, OCR, identifiering av personligt identifierbar information (PII), sentiment och textöversättning.

Bildextrahering är en Azure AI Search-åtgärd som inträffar när dokument knäckas före berikning. Bildextrahering kan faktureras på alla nivåer, förutom 20 kostnadsfria dagliga extraheringar på den kostnadsfria nivån. Kostnader för bildextrahering gäller för bildfiler i blobar, inbäddade bilder i andra filer (PDF och andra appfiler) och för bilder som extraheras med hjälp av dokumentextrahering. Priser för bildextrahering finns på prissättningssidan för Azure AI Search.

Dricks

För att sänka kostnaden för kompetensbearbetning kan du aktivera inkrementell berikning för att cachelagra och återanvända eventuella berikanden som inte påverkas av ändringar i en kompetensuppsättning. Cachelagring kräver Azure Storage (se priser men den kumulativa kostnaden för körning av kompetensuppsättningar är lägre om befintliga berikningar kan återanvändas, särskilt för kompetensuppsättningar som använder bildextrahering och analys.

Exempel: Beräkna kostnader

Om du vill beräkna kostnaderna för Azure AI Search-indexering börjar du med en uppfattning om hur ett genomsnittligt dokument ser ut så att du kan köra några siffror. Du kan till exempel approximeras:

1 000 PDF-filer.
Sex sidor vardera.
En bild per sida (6 000 bilder).
3 000 tecken per sida.

Anta en pipeline som består av dokumentsprickor för varje PDF, bild- och textextrahering, optisk teckenigenkänning (OCR) av bilder och entitetsigenkänning av organisationer.

Priserna som visas i den här artikeln är hypotetiska. De används för att illustrera uppskattningsprocessen. Dina kostnader kan vara lägre. Det faktiska priset för transaktioner finns i Prissättning för Azure AI-tjänster.

För dokumentsprickor med text- och bildinnehåll är textextrahering för närvarande kostnadsfritt. För 6 000 bilder antar du $1 för varje 1 000 bilder som extraheras. Det är en kostnad på 6,00 USD för det här steget.
För OCR på 6 000 bilder på engelska använder ocr-kognitiv skicklighet den bästa algoritmen (DescribeText). Om vi antar en kostnad på 2,50 USD per 1 000 bilder som ska analyseras, skulle du betala 15,00 USD för det här steget.
För entitetsextrahering skulle du ha totalt tre textposter per sida. Varje post är 1 000 tecken. Tre textposter per sida multiplicerat med 6 000 sidor är lika med 18 000 textposter. Om vi antar 2,00 USD per 1 000 textposter skulle det här steget kosta 36,00 USD.

Om du sätter ihop allt skulle du betala cirka $ 57.00 för att mata in 1 000 PDF-dokument av den här typen med den beskrivna kompetensuppsättningen.

Dela via