Koppel een factureerbare resource aan een vaardighedenset in Azure AI Zoeken

Als u ingebouwde vaardigheden gebruikt voor AI-verrijking in Azure AI Zoeken, kunt u een klein aantal documenten gratis verrijken, maximaal 20 transacties per index per dag. Voor grotere of frequentere workloads moet u een factureerbare Microsoft Foundry-resource koppelen aan uw skillset.

Azure AI Zoeken maakt gebruik van toegewezen, intern gehoste resources voor het uitvoeren van ingebouwde vaardigheden die worden ondersteund door Foundry Tools en vereist alleen een Foundry-resource voor factureringsdoeleinden. De uitzondering hierop is de vaardigheid Azure Content Understanding, die gebruikmaakt van uw resource voor facturering en verwerking.

Een Foundry-resource biedt toegang tot meerdere services in Foundry Tools. Wanneer u deze opgeeft in een vaardighedenset, kunt Microsoft u kosten in rekening brengen voor het gebruik van de volgende services:

• Azure Vision in Foundry Tools voor afbeeldingsanalyse en multimodale embeddings.
• Azure Document Intelligence in Foundry Tools voor OCR-verwerking via de OCR-vaardigheid.
• Azure Language in Foundry Tools voor taaldetectie, entiteitsherkenning, sentimentanalyse en sleuteltermextractie.
• Azure Translator in Foundry Tools voor automatische tekstomzetting.

Enige tijd na 5 november 2026 wordt ocr-verwerking naar verwachting gefactureerd als Document Intelligence-gebruik in plaats van Azure Vision-gebruik. De timing is afhankelijk van wanneer de update uw zoekservice bereikt. U hoeft de gekoppelde Foundry-resource niet te vervangen of de configuratie van uw skillset te wijzigen.

De verwerking van vaardigheden wordt in rekening gebracht bij de onderliggende service van elke vaardigheid. Azure AI Zoeken voegt kosten voor Foundry Tools samen in één Foundry-resource. Als u bijvoorbeeld de vaardigheden Image Analysis en Language Detection gebruikt, worden kosten voor Azure Vision en Azure Language weergegeven op dezelfde factuur voor uw Foundry-resource. Alle andere resources worden onafhankelijk gefactureerd.

Als u een Foundry-resource wilt koppelen, geeft u verbindingsgegevens op in de vaardighedenset. U kunt een sleutel- of sleutelloze benadering gebruiken.

Voorwaarden

• Verbondenheid via een openbaar eindpunt, tenzij uw zoekservice voldoet aan de vereisten voor de aanmaakdatum, laag en regio voor privéverbindingen met een Foundry-resource.

• Een Foundry-resource met het AIServices API-type. U kunt het API-type controleren op de pagina Overview van de resource in de Azure-portal:

  

Factureren via een sleutelloze verbinding

U kunt een beheerde identiteit en machtigingen gebruiken om een Foundry-resource te koppelen. Het voordeel van deze benadering is dat facturering sleutelloos is en geen regiovereisten heeft.

Net als bij sleutels worden de gegevens die u over de resource opgeeft, gebruikt voor facturering, niet voor verbindingen. Alle API-aanvragen van Azure AI Zoeken naar Foundry Tools voor ingebouwde vaardighedenverwerking blijven intern en beheerd door Microsoft.

Factureren via een sleutelloze verbinding:

1. In uw Azure AI Zoeken-service configureert u een beheerde identiteit. Zowel door het systeem toegewezen als door de gebruiker toegewezen identiteiten worden ondersteund.

2. Aan de beheerde identiteit van uw zoekservice wijst u op uw Foundry-resource de rol 'Cognitive Services User' toe.

3. Configureer een vaardighedenset om de beheerde identiteit te gebruiken. U kunt de Azure-portal, de meest recente stabiele versie van Skillsets - Create Or Update (REST API) of een Azure SDK-pakket met de syntaxis gebruiken.

   • @odata.type is altijd #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl is het eindpunt van uw Foundry-resource. U kunt de indeling https://<resource-name>.services.ai.azure.com of https://<resource-name>.cognitiveservices.azure.com gebruiken, die beide beschikbaar zijn op de pagina Keys en Endpoint in de Azure-portal.

   • Andere eigenschappen zijn specifiek voor het type beheerde identiteit, zoals wordt weergegeven in de volgende REST API-voorbeelden.

   • Door het systeem toegewezen beheerde identiteit
   • Door de gebruiker toegewezen beheerde identiteit

   Hier volgt een voorbeeld van een set vaardigheden voor een door het systeem toegewezen beheerde identiteit. In dit scenario moet u identity instellen op 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
     }
   }
   

Factureren via een resource-sleutel

Standaard brengt Azure AI Zoeken kosten in rekening voor transacties waarbij gebruik wordt gemaakt van de sleutel van een Foundry-resource. Deze benadering is algemeen beschikbaar. U kunt de Azure-portal, een stabiele REST API-versie of een equivalente Azure SDK gebruiken om de sleutel toe te voegen aan een vaardighedenset.

Er zijn twee ondersteunde sleuteltypen:

• #Microsoft.Azure.Search.CognitiveServicesByKey roept het regionale eindpunt aan.
• #Microsoft.Azure.Search.AIServicesByKey roept het subdomein aan. We raden dit type aan omdat het ondersteuning biedt voor gedeelde privékoppelingen en geen regionale vereisten heeft ten opzichte van de zoekservice.

Uw Foundry-resource moet zich in dezelfde regio bevinden als uw zoekservice. Kies een Azure AI Zoeken regio die Integratie van Foundry Tools biedt, die wordt aangegeven door de kolom AI-verrijking. Zie Hoe de sleutel wordt gebruikt voor meer informatie over dezelfde regiovereiste.

Als u de cognitiveServices eigenschap niet opgeeft, probeert uw zoekservice elke dag 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.

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

De sleutel verwijderen

Verrijkingen zijn factureerbare bewerkingen. Als u Foundry Tools niet meer hoeft aan te roepen, volgt u deze instructies om de sleutel te verwijderen en het gebruik van de Foundry-resource te voorkomen.

Zonder de sleutel wordt het vaardighedenpakket gereset naar de standaard van 20 gratis transacties per indexeerder 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.

Hoe de sleutel wordt gebruikt

Facturering wordt van kracht wanneer API-aanroepen naar een Foundry-resource groter zijn dan 20 API-aanroepen per indexeerfunctie per dag. U kunt de indexeerfunctie opnieuw instellen om het aantal API's opnieuw in te stellen.

Sleutelloze en sleutelverbindingen worden gebruikt voor facturering, maar niet voor verbindingen met betrekking tot verrijkingsbewerkingen.

Voor verbindingen op basis van sleutels maakt een zoekservice verbinding via het interne netwerk met een Foundry-resource die zich in dezelfde fysieke regio bevindt. De meeste regio's die Azure AI Zoeken bieden, bieden ook andere Azure services. 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'.

Voor sleutelloze verbindingen wordt een zoekservice geverifieerd met behulp van de identiteit en roltoewijzing en is gericht op een Foundry-resource. De resource wordt opgegeven als een volledig gekwalificeerde URI en de URI bevat een uniek subdomein.

Indexeerfuncties kunnen worden geconfigureerd voor uitvoering in een privé-uitvoeringsomgeving voor toegewezen verwerking met behulp van alleen de zoekknooppunten van uw eigen zoekservice. Zelfs als u een privé-uitvoeringsomgeving gebruikt, gebruikt Azure AI Zoeken nog steeds intern ingerichte resources om alle vaardighedenverrijkingen uit te voeren.

Vereisten voor openbare verbindingen

Afhankelijk van wanneer uw zoekservice is gemaakt, kunnen de prijscategorie en de regio, facturering voor ingebouwde vaardigheden een openbare verbinding van Azure AI Zoeken naar uw Foundry-resource vereisen. Als u openbare netwerktoegang uitschakelt, wordt de facturering in sommige scenario's verbroken. Bekijk de vereisten voor verbindingen via een gedeelde privékoppeling om te bepalen of uw zoekservice een openbare verbinding vereist.

Als u het openbare netwerk niet kunt gebruiken, kunt u een Custom Web API-vaardigheid configureren geïmplementeerd met een Azure Function die ondersteuning biedt voor privé-eindpunten en uw Foundry-bron toevoegen aan hetzelfde VNET. In dit scenario kunt u uw Foundry-resource rechtstreeks vanuit de aangepaste functie aanroepen met behulp van privé-eindpunten.

Belangrijke vereisten, speciale gevallen

Custom Entity Lookup wordt gemeten door Azure AI Zoeken, maar hiervoor is een Foundry-resourcesleutel vereist voor het ontgrendelen van transacties buiten 20 per indexeerfunctie per dag. Voor deze vaardigheid deblokkeert de resource-sleutel alleen het aantal transacties en heeft geen betrekking op facturering.

Gratis verrijkingen

AI-verrijking biedt een kleine hoeveelheid gratis verwerking van factureerbare verrijkingen, zodat u korte oefeningen kunt voltooien zonder een externe resource te hoeven koppelen. Gratis verrijkingen zijn 20 documenten per indexeerder per dag. 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 Foundry Tools aanroepen (namelijk de vaardigheden Voorwaardelijk, Documentextractie, Shaper, Tekst samenvoegen en Tekst splitsen ) zijn niet factureerbaar.

• Tekstextractie uit PDF-documenten en andere toepassingsbestanden is niet factureerbaar. Tekstextractie, die optreedt tijdens het kraken van documenten, is geen AI-verrijking, maar het gebeurt tijdens AI-verrijking en wordt hier dus vermeld.

Factureerbare verrijkingen

Tijdens AI-verrijking roept Azure AI Zoeken API's aan voor built-in skills die zijn gebaseerd op Azure Vision, Azure Document Intelligence, Azure Language en Azure Translator.

Factureerbare ingebouwde vaardigheden die back-end-aanroepen naar externe services maken, zijn onder andere:

• Entiteit Verbinding
• Entiteitsherkenning
• Afbeeldingsanalyse
• Sleutelzinsdeelextactie
• Taaldetectie
• OCR
• PII-detectie (Persoonlijk Identificeerbare Informatie)
• Sentiment
• Vertalen van tekst
• Azure Vision multimodale insluitingen (preview)

Een query-time vectorizer ondersteund door het Azure Vision multimodale insluitingsmodel is ook een factureerbare verrijking.

Afbeeldingextractie is een Azure AI Zoeken bewerking die optreedt wanneer documenten worden gekraakt vóór verrijking. Afbeeldingsextractie is factureerbaar voor alle prijscategorieën, 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 afbeeldingen die zijn geëxtraheerd met documentextractie. Zie de Azure AI Zoeken prijspagina voor prijzen voor het extraheren van afbeeldingen.

Voorbeeld: Kosten schatten

In dit voorbeeld worden hypothetische prijzen gebruikt voor afbeeldingextractie en entiteitsherkenning. Zie prijzen voor Document Intelligence voor actuele tarieven voor OCR en prijzen voor Foundry Tools voor verwerking van andere vaardigheden. Zie Azure AI Zoeken prijzen voor afzonderlijke kosten voor het extraheren van afbeeldingen.

Als u de kosten wilt schatten die zijn gekoppeld aan Azure AI Zoeken 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 elk
• Eén afbeelding per pagina (6.000 afbeeldingen)
• 3000 tekens per pagina

Stel dat een pijplijn bestaat uit het kraken van documenten van elke PDF, afbeelding en tekstextractie, OCR van afbeeldingen en entiteitsherkenning van organisaties.

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 staat C_ocr voor de toepasselijke verwerkingskosten voor Document Intelligence Read. Zie prijzen voor Document Intelligence voor huidige tarieven.

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.

Met behulp van de bovenstaande hypothetische afbeeldingsextractie- en entiteitsherkenningstarieven is de totale schatting $ 42,00 plus C_ocr voor het verwerken van 1.000 PDF-documenten.

Verwante inhoud

• Azure AI Zoeken pagina met prijzen
• Hoe definieer je een vaardigheidsset
• Skillset maken (REST)
• Hoe verrijkte velden toe te wijzen