Semantische rangschikking in- of uitschakelen

Semantische ranker is een Premium-functie die wordt gefactureerd op basis van gebruik. Semantische rangschikking is standaard uitgeschakeld wanneer u een nieuwe zoekservice maakt, maar iedereen met inzendermachtigingen kan deze inschakelen. Als u niet wilt dat iemand deze per ongeluk inschakelt, kunt u deze servicebreed uitschakelen met behulp van de REST API voor beheer.

Beschikbaarheid controleren

Als u wilt controleren of de semantische rangschikking beschikbaar is in uw regio, raadpleegt u de lijst met Azure AI Search-regio's.

Semantische rangschikking inschakelen

Volg deze stappen om semantische ranker in te schakelen op serviceniveau. Zodra deze optie is ingeschakeld, is deze beschikbaar voor alle indexen. U kunt deze functie niet in- of uitschakelen voor specifieke indexen.

Azure-portal

1. Open de Azure Portal.

2. Navigeer naar uw zoekservice. Controleer op de pagina Overzicht of de prijscategorie is ingesteld op Basic of hoger.

3. Selecteer in het linkernavigatiedeelvenster Instellingen>semantische rangschikking.

4. Selecteer het gratis abonnement of het Standard-abonnement. U kunt op elk gewenst moment schakelen tussen het gratis abonnement en het standaardabonnement.

   

Het gratis abonnement is beperkt tot 1000 query's per maand. Na de eerste 1000 query's in het gratis abonnement geeft een foutbericht aan dat u uw quotum hebt uitgeput voor de volgende semantische query. Wanneer het quotum is uitgeput, moet u upgraden naar het standaardplan om de semantische classificatie te blijven gebruiken.

REST

Als u een semantische rangschikking wilt inschakelen met behulp van de REST API, kunt u de SERVICE-API maken of bijwerken gebruiken.

REST API-aanroepen voor beheer worden geverifieerd via Microsoft Entra-id. Zie Uw Azure AI-Search-service beheren met REST API's voor instructies voor verificatie.

• Beheer REST API versie 2023-11-01 biedt de configuratie-eigenschap.

• Machtigingen voor eigenaar of inzender zijn vereist om functies in of uit te schakelen.

Notitie

Maken of bijwerken ondersteunt twee HTTP-methoden: PUT en PATCH. Zowel PUT als PATCH kan worden gebruikt om bestaande services bij te werken, maar alleen PUT kan worden gebruikt om een nieuwe service te maken. Als PUT wordt gebruikt om een bestaande service bij te werken, worden alle eigenschappen in de service vervangen door de standaardwaarden als ze niet zijn opgegeven in de aanvraag. Wanneer PATCH wordt gebruikt om een bestaande service bij te werken, worden alleen eigenschappen vervangen die in de aanvraag zijn opgegeven. Wanneer u PUT gebruikt om een bestaande service bij te werken, is het mogelijk om per ongeluk een onverwachte schaal- of configuratiewijziging te introduceren. Wanneer u semantische classificatie inschakelt voor een bestaande service, is het raadzaam PATCH te gebruiken in plaats van PUT.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

Semantische rangschikking uitschakelen met behulp van de REST API

Als u het inschakelen van functies wilt uitschakelen of voor volledige beveiliging tegen onopzettelijke gebruik en kosten, kunt u de semantische rangschikking uitschakelen met behulp van de API voor het maken of bijwerken van services in uw zoekservice. Nadat de functie is uitgeschakeld, worden alle aanvragen met het semantische querytype geweigerd.

REST API-aanroepen voor beheer worden geverifieerd via Microsoft Entra-id. Zie Uw Azure AI-Search-service beheren met REST API's voor instructies voor verificatie.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

Als u de semantische rangschikking opnieuw wilt inschakelen, voert u de vorige aanvraag opnieuw uit en stelt u deze in semanticSearch op Gratis (standaard) of Standard.

Volgende stap

Semantische rangschikking configureren