Aktivera eller inaktivera semantisk rankning

Semantisk ranker är en premiumfunktion som debiteras av användning. Som standard är semantisk rankning inaktiverat på en ny söktjänst, men den kan aktiveras av alla med deltagarbehörighet . Om du inte vill att någon ska aktivera den oavsiktligt kan du inaktivera den med hjälp av REST-API:et.

Kontrollera tillgänglighet

Kontrollera listan med regioner för att se om din region visas.

Aktivera semantisk rankning

Följ de här stegen för att aktivera semantisk rankning på tjänstnivå. När den är aktiverad är den tillgänglig för alla index. Du kan inte aktivera eller inaktivera det för specifika index.

Azure-portalen

1. Öppna Azure Portal.

2. Gå till söktjänsten. På sidan Översikt kontrollerar du att tjänsten är en fakturerbar nivå, Basic eller högre.

3. I det vänstra navigeringsfönstret väljer du Inställningar>Semantisk rangordning.

4. Välj antingen den kostnadsfria planen eller standardplanen. Du kan växla mellan den kostnadsfria planen och standardplanen när som helst.

   

Den kostnadsfria planen är begränsad till 1 000 frågor per månad. Efter de första 1 000 frågorna i den kostnadsfria planen anger ett felmeddelande att du har förbrukat din kvot för nästa semantiska fråga. När kvoten är slut bör du uppgradera till standardplanen för att fortsätta använda semantisk rangordning.

REST

Om du vill aktivera semantisk rankning med hjälp av REST-API:et kan du använda API:et Skapa eller uppdatera tjänst.

REST API-anrop för hantering autentiseras via Microsoft Entra-ID. Mer information om hur du autentiserar finns i Hantera azure AI-tjänsten Search med REST-API:er.

• Rest API-version 2023-11-01 för hantering tillhandahåller konfigurationsegenskapen.

• Ägar- eller deltagarbehörigheter krävs för att aktivera eller inaktivera funktioner.

Kommentar

Skapa eller uppdatera stöder två HTTP-metoder: PUT och PATCH. Både PUT och PATCH kan användas för att uppdatera befintliga tjänster, men endast PUT kan användas för att skapa en ny tjänst. Om PUT används för att uppdatera en befintlig tjänst ersätts alla egenskaper i tjänsten med deras standardvärden om de inte anges i begäran. När PATCH används för att uppdatera en befintlig tjänst ersätter den bara egenskaper som anges i begäran. När du använder PUT för att uppdatera en befintlig tjänst kan du oavsiktligt introducera en oväntad skalning eller konfigurationsändring. När du aktiverar semantisk rangordning för en befintlig tjänst rekommenderar vi att du använder PATCH i stället för 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"
      }
    }

Inaktivera semantisk rankning med hjälp av REST-API:et

Om du vill aktivera bakåtfunktioner eller för fullständigt skydd mot oavsiktlig användning och avgifter kan du inaktivera semantisk ranker med hjälp av API:et Skapa eller uppdatera tjänst i söktjänsten. När funktionen har inaktiverats avvisas alla begäranden som innehåller den semantiska frågetypen.

REST API-anrop för hantering autentiseras via Microsoft Entra-ID. Mer information om hur du autentiserar finns i Hantera azure AI-tjänsten Search med REST-API:er.

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"
      }
    }

Om du vill återaktivera semantisk rankning kör du den föregående begäran igen och anger "semanticSearch" till antingen "kostnadsfri" (standard) eller "standard".

Nästa steg

Konfigurera semantisk rankning så att du kan testa semantisk rangordning på ditt innehåll.