Aktivera eller inaktivera semantisk rankning

Semantisk ranker är en premiumfunktion som debiteras av användning. Som standard är semantisk ranker inaktiverad för alla tjänster.

Kontrollera tillgänglighet

Kontrollera sidan Tillgängliga produkter per region på Azure-webbplatsen för att se om din region visas.

Aktivera semantisk rangordning

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 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 får du ett felmeddelande om att du har förbrukat kvoten nästa gång du utfärdar en semantisk fråga. När detta händer måste du uppgradera till standardplanen för att fortsätta använda semantisk rangordning.

REST

Om du vill aktivera semantisk rangordning 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 rangordning 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 rangordning 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 rangordning kör du begäran ovan igen och anger "semanticSearch" till antingen "kostnadsfri" (standard) eller "standard".

Nästa steg

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