Włączanie lub wyłączanie klasyfikatora semantycznego

Ranga semantyczna to funkcja premium, która jest rozliczana według użycia. Domyślnie ranga semantyczna jest wyłączona we wszystkich usługach.

Sprawdź dostępność

Sprawdź stronę Produkty dostępne według regionów w witrynie internetowej platformy Azure, aby sprawdzić, czy twój region jest wymieniony.

Włączanie klasyfikacji semantycznej

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 usługa jest warstwą rozliczaną, Podstawowa lub nowsza.

3. W okienku nawigacji po lewej stronie wybierz pozycję Ranking semantyczny.

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 zostanie wyświetlony komunikat o błędzie informujący o wyczerpaniu limitu przydziału przy następnym wydaniu zapytania semantycznego. W takim przypadku należy przeprowadzić uaktualnienie do planu standardowego, aby nadal korzystać z klasyfikacji semantycznej.

REST

Aby włączyć klasyfikację semantyczną 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 Zarządzanie usługa wyszukiwania usługi 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 klasyfikacji semantycznej przy użyciu interfejsu API REST

Aby odwrócić włączanie funkcji lub w celu zapewnienia pełnej ochrony przed przypadkowym użyciem i opłatami, można wyłączyć klasyfikację semantyczną przy użyciu interfejsu API tworzenia lub aktualizowania usługi w usłudze wyszukiwania. Po wyłączeniu funkcji wszystkie żądania zawierające typ zapytania semantycznego 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 Zarządzanie usługa wyszukiwania usługi 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ć klasyfikację semantyczną, uruchom ponownie powyższe żądanie, ustawiając wartość "semanticSearch" na wartość "free" (wartość domyślna) lub "standard".

Następne kroki

Skonfiguruj klasyfikację semantyczną, aby można było przetestować klasyfikację semantyczną na zawartości.