Włączanie lub wyłączanie klasyfikatora semantycznego

Ranga semantyczna to funkcja w warstwie Premium rozliczana według użycia. Domyślnie semantyczny ranger jest wyłączany podczas tworzenia nowej usługi wyszukiwania, ale każda osoba z uprawnieniami Współautor może ją włączyć. Jeśli nie chcesz, aby ktokolwiek go włączał przypadkowo, możesz go wyłączyć przy użyciu interfejsu API REST.

Sprawdź dostępność

Aby sprawdzić, czy semantyczny rangą jest dostępny w Twoim regionie, zobacz listę regionów usługi Azure AI Search.

Włączanie klasyfikatora semantycznego

Wykonaj następujące kroki, aby włączyć semantyczny rangą na poziomie usługi. Po włączeniu jest ona dostępna dla wszystkich indeksów. Nie można go włączyć ani wyłączyć dla określonych indeksów.

Witryna Azure Portal

1. Otwórz portal Azure Portal.

2. Przejdź do usługi wyszukiwania. Na stronie Przegląd upewnij się, że warstwa cenowa jest ustawiona na Wartość Podstawowa lub nowsza.

3. W okienku nawigacji po lewej stronie wybierz pozycję Ustawienia>Semantyczny rangą.

4. Wybierz plan Bezpłatna lub Plan standardowy. W dowolnym momencie możesz przełączać się między planem bezpłatnym a planem standardowym.

   

Plan bezpłatny jest ograniczony do 1000 zapytań miesięcznie. Po pierwszych 1000 zapytaniach w ramach planu bezpłatnego komunikat o błędzie wskazuje, że limit przydziału został wyczerpany w następnym zapytaniu semantycznym. Po wyczerpaniu limitu przydziału należy uaktualnić do planu standardowego, aby nadal korzystać z klasyfikacji semantycznej.

REST

Aby włączyć semantyczny ranger przy użyciu interfejsu API REST, możesz użyć interfejsu API tworzenia lub aktualizowania usługi.

Wywołania interfejsu API REST zarządzania są uwierzytelniane za pośrednictwem identyfikatora Entra firmy Microsoft. Aby uzyskać instrukcje dotyczące uwierzytelniania, zobacz Manage your Azure AI usługa wyszukiwania with REST APIs (Zarządzanie usługa wyszukiwania azure AI za pomocą interfejsów API REST).

• Interfejs API REST zarządzania w wersji 2023-11-01 udostępnia właściwość konfiguracji.

• Uprawnienia właściciela lub współautora są wymagane do włączania lub wyłączania funkcji.

Uwaga

Funkcja Create lub Update obsługuje dwie metody HTTP: PUT i PATCH. Zarówno PUT, jak i PATCH mogą służyć do aktualizowania istniejących usług, ale tylko put może służyć do tworzenia nowej usługi. Jeśli funkcja PUT jest używana do aktualizowania istniejącej usługi, zastępuje wszystkie właściwości w usłudze wartością domyślną, jeśli nie zostały określone w żądaniu. Gdy funkcja PATCH jest używana do aktualizowania istniejącej usługi, zastępuje tylko właściwości określone w żądaniu. W przypadku używania funkcji PUT do aktualizowania istniejącej usługi można przypadkowo wprowadzić nieoczekiwaną zmianę skalowania lub konfiguracji. Podczas włączania klasyfikacji semantycznej w istniejącej usłudze zaleca się użycie funkcji PATCH zamiast 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"
      }
    }

Wyłączanie semantycznego rangatora przy użyciu interfejsu API REST

Aby wyłączyć włączanie funkcji lub pełną ochronę przed przypadkowym użyciem i opłatami, można wyłączyć semantyczny ranger przy użyciu interfejsu API tworzenia lub aktualizowania usługi wyszukiwania. Po wyłączeniu funkcji wszystkie żądania, które zawierają semantyczny typ zapytania, zostaną odrzucone.

Wywołania interfejsu API REST zarządzania są uwierzytelniane za pośrednictwem identyfikatora Entra firmy Microsoft. Aby uzyskać instrukcje dotyczące uwierzytelniania, zobacz Manage your Azure AI usługa wyszukiwania with REST APIs (Zarządzanie usługa wyszukiwania azure AI za pomocą interfejsów API REST).

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

Aby ponownie włączyć semantyczną rangę, uruchom ponownie poprzednie żądanie i ustaw wartość semanticSearch Bezpłatna (domyślna) lub Standardowa.

Następny krok

Konfigurowanie klasyfikatora semantycznego