Semantische rangschikking in- of uitschakelen

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

Beschikbaarheid controleren

Controleer de lijst met regio's om te zien of uw regio wordt vermeld.

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 service een factureerbare laag is, Basic of hoger.

3. Selecteer in het linkernavigatievenster 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 omkeren, 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, stelt u 'semanticSearch' in op 'free' (standaard) of 'standard'.

Volgende stappen

Configureer semantische rangschikking , zodat u semantische rangschikking op uw inhoud kunt testen.