Aktivera eller inaktivera semantisk rankning

Semantisk ranker är en premiumfunktion som debiteras av användning. Som standard inaktiveras semantisk rankning när du skapar en ny söktjänst, men alla med deltagarbehörighet kan aktivera den. 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

Om du vill kontrollera om semantisk rankning är tillgänglig i din region kan du läsa listan Azure AI Search-regioner.

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 prisnivån är inställd på Basic eller högre.

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

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 visas ett felmeddelande om 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. Anvisningar 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ätter den 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 inaktivera funktionsaktivering 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. Anvisningar 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 tidigare begäran igen och anger semanticSearch antingen Kostnadsfri (standard) eller Standard.

Gå vidare

Konfigurera semantisk rankning