Włączanie lub wyłączanie klasyfikatora semantycznego

Sorter semantyczny to funkcja dostępna w wersji Premium, rozliczana na podstawie użycia. Domyślnie semantyczny ranking jest włączony w nowej rozliczanej usłudze wyszukiwania i jest skonfigurowany dla darmowego planu, ale każda osoba z uprawnieniami Współpracownik może go wyłączyć lub zmienić plan rozliczeniowy. Jeśli nie chcesz, aby ktokolwiek mógł korzystać z tej funkcji, możesz wyłączyć ją dla całej usługi przy użyciu interfejsu API REST zarządzania. Jeśli wyłączysz klasyfikację semantyczną, wyłączysz również agentyczne pobieranie.

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

Ranker semantyczny może nie być włączony w starszych usługach. 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.

Portal Azure
REST

Otwórz portal Azure.
Przejdź do usługi wyszukiwania. Na stronie Przegląd upewnij się, że warstwa cenowa jest ustawiona na Wartość Podstawowa lub nowsza.
W okienku nawigacji po lewej stronie wybierz pozycję Ustawienia>Funkcje Premium.
Wybierz plan bezpłatny (domyślny) 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 zapytań w ramach darmowego planu, komunikat o błędzie wskazuje, że wyczerpałeś swój limit przy następnym zapytaniu semantycznym. Po wyczerpaniu limitu przydziału można uaktualnić do planu standardowego, aby nadal korzystać z klasyfikacji semantycznej.

Aby włączyć klasyfikator semantyczny, możesz użyć usług — tworzenie lub aktualizowanie (interfejs API REST).

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

Interfejs zarządzania API REST w wersji 2023-11-01 lub nowszej 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=2025-05-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

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

Aby wyłączyć aktywację funkcji lub uzyskać pełną ochronę przed przypadkowym użyciem i naliczeniami, można wyłączyć semantyczny ranker 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.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2025-05-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

Aby ponownie włączyć semantyczny ranking, uruchom ponownie poprzednie żądanie i ustaw semanticSearch na Bezpłatna (domyślna) lub Standardowa.

Następny krok

Konfigurowanie klasyfikatora semantycznego

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-11-10