Koppla en fakturerbar resurs till en kompetensuppsättning i Azure AI-sökning

Om du använder inbyggda kunskaper för AI-berikning i Azure AI-sökning kan du utöka ett litet antal dokument kostnadsfritt, upp till 20 transaktioner per index per dag. För större eller mer frekventa arbetsbelastningar bör du koppla en fakturerbar Microsoft Foundry-resurs till din skillset.

Azure AI-sökning använder dedikerade, internt värdbaserade resurser för att köra inbyggda kunskaper som backas upp av Foundry Tools och kräver en Foundry-resurs enbart för faktureringsändamål. Undantaget är Azure Content Understanding-färdigheten, som använder din resurs för både fakturering och bearbetning.

En Foundry-resurs ger åtkomst till flera tjänster i Foundry Tools. När du anger den i en kompetensuppsättning kan Microsoft debitera dig för att använda följande tjänster:

• Azure Vision i Foundry Tools för bildanalys, optisk teckenigenkänning (OCR) och multimodala inbäddningar.
• Azure Language in Foundry Tools för språkidentifiering, entitetsigenkänning, attitydanalys och extrahering av nyckelfraser.
• Azure Translator i Foundry Tools för maskintextöversättning.

Kompetensbearbetning faktureras till den underliggande tjänsten för varje färdighet. Azure AI-sökning konsoliderar avgifter för Foundry Tools till en enda Foundry-resurs. Om du till exempel använder Image Analysis och Language Detection, visas avgifter för Azure Vision och Azure Language på samma faktura för din Foundry-resurs. Alla andra resurser faktureras oberoende av varandra.

Om du vill koppla en Foundry-resurs anger du anslutningsinformation i kompetensuppsättningen. Du kan använda en nyckelbaserad eller nyckellös metod.

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 en Foundry-resurs.

• En Foundry-resurs med API-typen AIServices . Du kan verifiera API-typen på resursens sida Overview i Azure portalen:

  

Fakturera via en nyckellös anslutning

Du kan använda en hanterad identitet och behörigheter för att koppla en Foundry-resurs. Fördelen med den här metoden är att faktureringen är nyckellös och inte har regionkrav.

Precis som med nycklar används den information du anger om resursen för fakturering, inte anslutningar. Alla API-begäranden som görs av Azure AI-sökning till Foundry Tools för inbyggd kompetensbearbetning förblir interna och hanteras av Microsoft.

Så här fakturerar du via en nyckellös anslutning:

1. I din Azure AI-sökning-tjänst konfigurera en hanterad identitet. Både systemtilldelade och användartilldelade identiteter stöds.

2. På din Foundry-resurs tilldelar du rollen Cognitive Services-användare till söktjänstens hanterade identitet.

3. Konfigurera en kompetensuppsättning för att använda den hanterade identiteten. Du kan använda Azure-portalen, den senaste stabila versionen av Skillsets – Skapa eller uppdatera (REST API) eller ett Azure SDKs paket som innehåller syntaxen.

   • @odata.type är alltid #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl är slutpunkten för din Foundry-resurs. Du kan använda formatet https://<resource-name>.services.ai.azure.com eller https://<resource-name>.cognitiveservices.azure.com, som båda är tillgängliga på sidan Keys och Endpoint i Azure portalen.

   • Andra egenskaper är specifika för den typ av hanterad identitet som visas i följande REST API-exempel.

   • Systemtilldelad hanterad identitet
   • Användartilldelad hanterad identitet

   Här är ett exempel på konfiguration av kompetensuppsättningar för en systemtilldelad hanterad identitet. I det här scenariot måste du ange identity till null.

   POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
   api-key: [admin-key]
   Content-Type: application/json
   
   {
     "name": "my-skillset",
     "skills": [
       // Skills definition goes here
     ],
     "cognitiveServices": {
       "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",
       "description": "A sample configuration for a system-assigned managed identity.",
       "subdomainUrl": "https://[resource-name].services.ai.azure.com",
       "identity": null
     }
   }
   

Fakturera via en resursnyckel

Som standardinställning debiterar Azure AI-sökning transaktioner med hjälp av nyckeln för en Foundry-resurs. Den här metoden är allmänt tillgänglig. Du kan använda Azure-portalen, en stabil REST API-version eller en motsvarande Azure SDKs för att lägga till nyckeln i en kompetensuppsättning.

Det finns två nyckeltyper som stöds:

• #Microsoft.Azure.Search.CognitiveServicesByKey anropar den regionala slutpunkten.
• #Microsoft.Azure.Search.AIServicesByKey anropar underdomänen. Vi rekommenderar den här typen eftersom den stöder delade privata länkar och inte har regionala krav i förhållande till söktjänsten.

Din Foundry-resurs måste finnas i samma region som söktjänsten. Välj en Azure AI-sökning-region som tillhandahåller Foundry Tools-integrering, vilket anges av kolumnen AI enrichment. Mer information om kravet för samma region finns i Så här används nyckeln.

Om du inte anger cognitiveServices egenskapen försöker söktjänsten använda de kostnadsfria berikanden som är tillgängliga för indexeraren varje dag. Körningen av fakturerbara färdigheter stoppas vid 20 transaktioner per indexeruppmaning, och ett "Time-Out"-meddelande visas i indexerarens körningshistorik.

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json
{
    "name": "my-skillset",
    "skills": 
    [
      // Skills definition goes here
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
        "description": "A sample configuration for key-based billing.",
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "key": "{your-billable-resource-key}"
    }
}

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

Förbättringar är fakturerbara åtgärder. Om du inte längre behöver anropa Foundry Tools följer du de här anvisningarna för att ta bort nyckeln och förhindra användning av Foundry-resursen.

Utan nyckeln återgår funktionaliteten till standardallokeringen på 20 kostnadsfria transaktioner per indexeringsprogram per dag. Körningen av fakturerbara färdigheter stoppas vid 20 transaktioner och ett "Time Out"-meddelande visas i indexerarkörningshistorik när resurstilldelningen används.

Hur nyckeln används

Faktureringen träder i kraft när API-anrop till en Foundry-resurs överskrider 20 API-anrop per indexerare per 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 anslutningar relaterade till berikningsåtgärder.

För nyckelbaserade anslutningar ansluter en söktjänst via det interna nätverket till en Foundry-resurs som finns i samma fysiska region. De flesta regioner som erbjuder Azure AI-sökning erbjuder även andra Azure tjänster. 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 nyckellösa anslutningar autentiseras en söktjänst med hjälp av dess identitets- och rolltilldelning och riktar in sig på en Foundry-resurs. Resursen anges som en fullständigt kvalificerad URI och URI:n innehåller en unik underdomän.

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-sökning fortfarande sina internt tilldelade resurser för att utföra alla färdighetsberikningar.

Krav för offentlig anslutning

Beroende på när söktjänsten skapades, prisnivån och dess region kan fakturering för definierade kunskaper kräva en offentlig anslutning från Azure AI-sökning till din Foundry-resurs. 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 Web API implementerad med en Azure Function som stöder privata slutpunkter och lägga till din Foundry-resurs till samma VNET. I det här scenariot kan du anropa din Foundry-resurs direkt från den anpassade färdigheten med hjälp av privata slutpunkter.

Särskilda fall av nyckelkrav

Custom Entity Lookup mäts av Azure AI-sökning, men det krävs en Foundry-resursnyckel för att låsa upp transaktioner över 20 per indexerare per dag. Endast för denna färdighet avblockeras antalet transaktioner med resursnyckeln, men den är inte relaterad till fakturering.

Kostnadsfria berikningar

AI-berikning erbjuder en liten mängd kostnadsfri bearbetning av fakturerbara berikningar så att du kan utföra korta övningar utan att behöva koppla en extern resurs. Kostnadsfria berikningar är 20 dokument per indexerare och dag. 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 Foundry Tools (det vill säga villkorliga kunskaper, extrahering av dokument, formare, sammanslagning av text och textdelning ) kan inte faktureras.

• Textextrahering från PDF-dokument och andra programfiler kan inte faktureras. Textextrahering, som inträffar under dokumentspräckning, är inte en AI-berikning, men detta sker under AI-berikning och noteras därför här.

Fakturerbara berikningar

Under AI-berikning anropar Azure AI-sökning API:er för definierade kunskaper som baseras på Azure Vision, Azure Language och Azure Translator.

Fakturerbara inbyggda färdigheter som gör backendanrop till externa tjänster är:

• Entitetslänkning
• Entitetsigenkänning
• Bildanalys
• Extrahering av nyckelfras
• Språkidentifiering
• OCR
• Identifiering av personligt identifierbar information (PII)
• Känsla
• Textöversättning
• Azure Vision multimodala inbäddningar (förhandsversion)

En query-time vectorizer som backas upp av Azure Vision multimodal inbäddningsmodell är också en fakturerbar berikning.

Bildextrahering är en Azure AI-sökning åtgärd som inträffar när dokument knäckas före berikning. Bildextrahering kan faktureras på alla prisnivå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 bilder som extraheras med hjälp av dokumentextrahering. Priser för bildextrahering finns på prissidan Azure AI-sökning.

Exempel: Beräkna kostnader

Priserna som visas i det här avsnittet är hypotetiska och 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 Foundry Tools.

Om du vill beräkna kostnaderna för Azure AI-sökning 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 approximera:

• 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 dokumentbearbetning för varje PDF, bild- och textextrahering, OCR-bearbetning av bilder och igenkänning av organisationer.

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 av 6 000 bilder på engelska använder den OCR-kognitiva förmågan 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 textposteringar 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.

Relaterat innehåll

• Azure AI-sökning prissättningssida
• Hur man definierar en kompetens
• Skapa kunskapsuppsättning (REST)
• Så här mappar du berikade fält