Povolení nebo zakázání sémantického rankeru

Sémantický ranker je prémiová funkce fakturovaná podle využití. Ve výchozím nastavení je sémantický ranker při vytváření nové vyhledávací služby vypnutý, ale kdokoli s oprávněním přispěvatele ho může povolit. Pokud nechcete, aby ho někdo povolil neúmyslně, můžete ho pomocí rozhraní REST API pro správu zakázat pro celou službu.

Zkontrolovat dostupnost

Pokud chcete zkontrolovat, jestli je ve vaší oblasti k dispozici sémantický ranker, podívejte se na seznam oblastí služby Azure AI Search.

Povolení sémantického rankeru

Pomocí těchto kroků povolte sémantické rankery na úrovni služby. Po povolení je k dispozici pro všechny indexy. Nemůžete ho zapnout nebo vypnout pro konkrétní indexy.

Azure Portal

1. Otevřete Azure Portal.

2. Přejděte do vyhledávací služby. Na stránce Přehled se ujistěte, že je cenová úroveň nastavená na Basic nebo vyšší.

3. V levém navigačním podokně vyberte Sémantický ranker nastavení>.

4. Vyberte plán Free nebo Plán Standard. Mezi bezplatným plánem a standardním plánem můžete kdykoli přepínat.

   

Bezplatný plán je omezený na 1 000 dotazů za měsíc. Po prvních 1 000 dotazech v bezplatném plánu se zobrazí chybová zpráva, že jste v dalším sémantickém dotazu vyčerpali kvótu. Při vyčerpání kvóty byste měli upgradovat na standardní plán, abyste mohli dál používat sémantické řazení.

REST

K povolení sémantického rankeru pomocí rozhraní REST API můžete použít rozhraní API pro vytvoření nebo aktualizaci služby.

Volání rozhraní REST API pro správu se ověřují prostřednictvím ID Microsoft Entra. Pokyny k ověřování najdete v tématu Správa Search Azure AI pomocí rozhraní REST API.

• Vlastnost konfigurace poskytuje rozhraní REST API pro správu verze 2023-11-01.

• K povolení nebo zakázání funkcí se vyžadují oprávnění vlastníka nebo přispěvatele .

Poznámka:

Vytvoření nebo aktualizace podporuje dvě metody HTTP: PUT a PATCH. Put i PATCH lze použít k aktualizaci stávajících služeb, ale k vytvoření nové služby je možné použít pouze PUT. Pokud se k aktualizaci existující služby používá put, nahradí všechny vlastnosti ve službě jejich výchozími nastaveními, pokud nejsou v požadavku zadané. Pokud se funkce PATCH používá k aktualizaci existující služby, nahradí pouze vlastnosti zadané v požadavku. Při použití metody PUT k aktualizaci existující služby je možné neúmyslně zavést neočekávanou změnu škálování nebo konfigurace. Při povolování sémantického řazení u stávající služby se místo PUT doporučuje použít funkci PATCH.

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

Zakázání sémantického rankeru pomocí rozhraní REST API

Pokud chcete vypnout povolení funkcí nebo úplnou ochranu před náhodným použitím a poplatky, můžete zakázat sémantické rankery pomocí rozhraní API služby Create nebo Update Service ve vyhledávací službě. Jakmile je funkce zakázaná, všechny požadavky, které obsahují sémantický typ dotazu, budou odmítnuty.

Volání rozhraní REST API pro správu se ověřují prostřednictvím ID Microsoft Entra. Pokyny k ověřování najdete v tématu Správa Search Azure AI pomocí rozhraní REST API.

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

Pokud chcete znovu povolit sémantický ranker, spusťte předchozí požadavek znovu a nastavte semanticSearch hodnotu Free (výchozí) nebo Standard.

Další krok

Konfigurace sémantického rankeru