Semantische rangschikking in- of uitschakelen

Semantische ranker is een Premium-functie die wordt gefactureerd op basis van gebruik. Semantische rangschikking is standaard uitgeschakeld voor alle services.

Beschikbaarheid controleren

Controleer de pagina Beschikbare producten per regio op de Azure-website 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 Semantische rangschikking in het linkernavigatievenster.

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 krijgt u een foutbericht waarin u weet dat u uw quotum hebt uitgeput wanneer u de volgende keer een semantische query uitvoert. Als dit gebeurt, moet u een upgrade uitvoeren naar het standaardplan om de semantische classificatie te blijven gebruiken.

REST

Als u semantische classificatie 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 classificatie 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 semantische rangschikking uitschakelen met behulp van de API service maken of bijwerken 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 bovenstaande aanvraag opnieuw uit en stelt u 'semanticSearch' in op 'gratis' (standaard) of 'standaard'.

Volgende stappen

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