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

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. Genom att tillhandahålla ett konto i en Azure AI Search-kompetensuppsättning kan Microsoft 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

Du måste ange anslutningsinformation till Azure AI-multiresursen i kompetensuppsättningen. Azure AI Search använder inte anslutningen för kompetensuppsättningsarbetsbelastningar, men den använder anslutningen för att komma åt faktureringsmätare för resursen. Därför används ditt Azure AI-tjänstkonto för fakturering, inte för kompetensbearbetning. Azure AI Search använder separata dedikerade resurser för kompetensbearbetning.

Du kan använda en nyckel för anslutningen eller implementera en nyckellös metod som för närvarande är i förhandsversion.

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.

Förutsättningar

• Anslutning via en offentlig slutpunkt, såvida inte söktjänsten uppfyller kraven för att skapa datum, nivå och region för privata anslutningar till ett Azure AI-multitjänstkonto.

Kommentar

Om din Azure AI-resurs har konfigurerats för att använda en privat slutpunkt kan Azure AI Search ansluta med en delad privat länk om söktjänsten skapades efter den 3 april 2024 och finns i en region som ger högre kapacitetsberäkningskraft och är på en nivå som stöds. Mer information finns i kraven för att använda delade privata länkar.

Fakturera via en nyckellös anslutning

Kommentar

Den här funktionen är för närvarande i allmänt tillgänglig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och rekommenderas inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Med hjälp av rest-API:er för Azure Portal eller nyare förhandsversion och beta-SDK-paket kan du koppla en Azure AI-resurs med flera tjänster med hjälp av en hanterad identitet och behörigheter. Fördelen med den här metoden är att faktureringen är nyckellös och inte har något beroende av regioner.

1. Konfigurera Azure AI Search för att använda en hanterad identitet.

2. På din Azure AI-resurs med flera tjänster tilldelar du identiteten till cognitive services-användarrollen.

3. Med hjälp av Azure Portal, eller Skillset 2024-11-01-preview REST API, eller ett Azure SDK-betapaket som tillhandahåller syntaxen, konfigurerar du en kompetensuppsättning för att använda en identitet:

   • Den hanterade identitet som används på anslutningen tillhör söktjänsten.
   • Identiteten kan vara systemhanterad eller användartilldelad.
   • Identiteten måste ha Cognitive Services-användarbehörigheter för Azure AI-resursen.
   • @odata.type är alltid #Microsoft.Azure.Search.AIServicesByIdentity.
   • subdomainUrl är slutpunkten för din Azure AI-resurs för flera tjänster. Det kan finnas i alla regioner som stöds gemensamt av Azure AI Search- och Azure AI-tjänster.

Precis som med nycklar används den information du anger om Azure AI Services-resursen för fakturering, inte anslutningar. Alla API-begäranden som görs av Azure AI Search till Azure AI-tjänster för inbyggd kompetensbearbetning fortsätter att vara interna och hanterade av Microsoft.

Exempel: systemtilldelad hanterad identitet

Identiteten är inställd på 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 
    }  
} 

Exempel: användartilldelad hanterad identitet

Identiteten är inställd på resurs-ID för den användartilldelade hanterade identiteten. Information om hur du hittar en befintlig användartilldelad hanterad identitet finns i Hantera användartilldelade hanterade identiteter.

Ange egenskaperna och userAssignedIdentity för en användartilldelad hanterad identitet@odata.type.

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

Fakturera via en resursnyckel

Azure AI Search kan också debiteras för transaktioner med hjälp av azure AI-resursnyckeln för flera tjänster. Den här metoden är standard och är allmänt tillgänglig. Du kan använda Azure Portal, REST API eller en Azure SDK för att lägga till nyckeln i en kompetensuppsättning.

Det finns två nyckeltyper som stöds: #Microsoft.Azure.Search.CognitiveServicesByKey som anropar den regionala slutpunkten och "#Microsoft.Azure.Search.AIServicesByKey som anropar underdomänen. Vi rekommenderar att du använder AIServicesByKey för dess stöd för delad privat länk och möjlighet att fungera utan regionala krav i förhållande till söktjänsten.

Om du lämnar egenskapen cognitiveServices 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.

Azure-portalen

1. Logga in på Azure-portalen.

2. Skapa en Azure AI-resurs med flera tjänster i samma region som din söktjänst.

3. Hämta resursnyckeln från sidan Resursnycklar>och slutpunkt.

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

Kommentar

Azure Portal kopplar för närvarande automatiskt nyckeln av typen #Microsoft.Azure.Search.CognitiveServicesByKey.

REST

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

.NET SDK

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

1. Logga in på Azure-portalen.

2. Under Kompetensuppsättningar för sökhantering > väljer du en kompetensuppsättning i listan.

   

3. Rulla till avsnittet i filen som innehåller "cognitiveServices".

4. Ta bort nyckelvärdet från JSON och spara kunskapsuppsättningen.

   

REST

1. Hämta Kunskapsuppsättning så att du har den fullständiga definitionen.

2. Formulera en begäran om uppdateringskunskaper med JSON-definitionen för kompetensuppsättningen.

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

Faktureringen träder i kraft 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.

Nyckellösa och nyckelbaserade anslutningar 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."

Indexerare kan konfigureras att köras i en privat körningsmiljö för dedikerad bearbetning med bara söknoderna i din egen söktjänst. Även om du använder en privat körningsmiljö använder Azure AI Search fortfarande sin internt etablerade Azure AI multiservice-resurs för att utföra alla kompetensberikningar.

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 .

Krav för offentlig anslutning

Beroende på när din söktjänst skapades och dess nivå och region kan fakturering för inbyggda kunskaper kräva en offentlig anslutning från Azure AI Search till Azure AI multi-service. Om du inaktiverar åtkomst till offentliga nätverk bryts faktureringen i vissa scenarier. Granska kraven för anslutningar via en delad privat länk för att avgöra om din söktjänst kräver en offentlig anslutning.

Om du inte kan använda det offentliga nätverket 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.

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.

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

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

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

Nästa steg

• Prissättningssidan för Azure AI Search
• Så här definierar du en kompetensuppsättning
• Skapa kunskapsuppsättning (REST)
• Så här mappar du berikade fält