Facturering voor agentgebaseerde gegevensophaling in- of uitschakelen

Note

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

Agentisch ophalen is een Premium-functie die wordt gefactureerd op basis van gebruik. Standaard worden alle zoekservices ingeschreven in het gratis abonnement, dat gratis een maandelijkse vergoeding biedt. Als u continue toegang wilt inschakelen nadat het gratis quotum is verbruikt, kunt u overschakelen naar het standaardabonnement.

Vanaf de REST API-versie 2026-04-01van Search Service is factureringstoestemming voor semantische rangschikking en agentisch ophalen gescheiden. Gebruik knowledgeRetrieval om het gebruik van betaald agentgebruik onafhankelijk van semanticSearch te beheersen.

Voorwaarden

Een Azure AI Zoeken-service in elke regio die op agent gebaseerde gegevensophaling biedt.
Toegang van eigenaar of inzender tot de zoekservice.
Search Management REST API versie 2026-03-01-preview of hoger om de knowledgeRetrieval eigenschap in te stellen.

Opsplitsing van facturering

U stelt factureringstoestemming in met behulp van de REST API van Search Management. In de volgende tabel ziet u welke eigenschap van kracht wordt op basis van de REST API-versie van Search Service die door uw toepassing wordt gebruikt.

REST API-versie van Search Service	Semantische ranker facturering	Facturering voor agentisch ophalen
2026-04-01 en hoger	Beheerd door `semanticSearch`	Beheerd door `knowledgeRetrieval`
2025-11-01-preview en eerder	Beheerd door `semanticSearch`	Beheerd door `semanticSearch`

Voor Search Service REST API-versie 2026-04-01 en later regelt knowledgeRetrieval de facturering voor agentische gegevensophaling los van semanticSearch. Voor informatie over het beheren van de facturering van semantische rankers, zie Semantische rankerfacturering in- of uitschakelen.

Voor Search Service REST API-versie 2025-11-01-preview en ouder regelt semanticSearch de toestemming voor zowel de semantische ranker als het betaalde agentische retrievalgebruik. De knowledgeRetrieval eigenschap wordt genegeerd.

Factureringsplannen

Agentic retrieval heeft twee tariefplannen. Zie Azure AI Zoeken prijzen voor prijzen per valuta.

Plan	Beschrijving	Availability
Gratis (standaard)	Biedt een maandelijkse tokenvergoeding zonder kosten aan. Nadat de gratis vergoeding is verbruikt, retourneren aanvragen die betaald gebruik zouden opleveren een betalingsfout.	Beschikbaar voor alle prijscategorieën.
Standaard	Betalen per gebruik nadat de maandelijkse gratis tegoed is opgebruikt.	Vereist de Basic-laag of hoger.

Facturering voor agent-gebaseerd ophalen inschakelen

Volg deze stappen om van agentisch ophalen over te schakelen naar het standaardfactureringsplan.

Azure-portal
REST

Ga naar uw zoekservice in de Azure portal.
Controleer op de pagina Overzicht of de prijscategorie Basic of hoger is.
Selecteer In het linkerdeelvenster Instellingen>Premium-functies.
Selecteer onder Kennis ophalen in de Standard-kaart Plan selecteren.

Gebruik Services - Create Or Update (Search Management REST API) om knowledgeRetrieval in te stellen op standard:

PATCH https://management.azure.com/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}

{
  "properties": {
    "knowledgeRetrieval": "standard"
  }
}

REST API-aanroepen voor beheer worden geverifieerd via Microsoft Entra ID. Zie Manage your Azure AI Zoeken service with REST API's voor instructies.

Belangrijk

Als u eerder gebruikmaakte van semanticSearch om betaald gebruik van agentische retrieval in te schakelen, moet u knowledgeRetrieval expliciet instellen op standard voordat u workloads voor agentische retrieval migreert naar Search Service REST API-versie 2026-04-01 of hoger. Bestaande semanticSearch=standard toestemming wordt niet overgedragen aan knowledgeRetrieval.

Facturering voor agentische retrieval uitschakelen

Volg deze stappen om agentisch ophalen terug te zetten naar het gratis factureringsplan.

Azure-portal
REST

Ga naar uw zoekservice in de Azure portal.
Selecteer In het linkerdeelvenster Instellingen>Premium-functies.
Selecteer onder Kennis ophalenAbonnement selecteren op de kaart Gratis.

Gebruik Services - Maken of bijwerken (Search Management REST API) om knowledgeRetrieval in te stellen op free:

PATCH https://management.azure.com/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}

{
  "properties": {
    "knowledgeRetrieval": "free"
  }
}

REST API-aanroepen voor beheer worden geverifieerd via Microsoft Entra ID. Zie Beheer van uw Azure AI Zoeken-service met REST API's voor instructies voor verificatie.

Feedback

Is deze pagina nuttig?

Laatst bijgewerkt om 2026-08-31