Szemantikai rangsoroló engedélyezése vagy letiltása

A szemantikai rangsoroló egy prémium szolgáltatás, amelyet a használat számláz. Alapértelmezés szerint a szemantikai rangsoroló minden szolgáltatásban le van tiltva.

Elérhetőség ellenőrzése

Tekintse meg az Azure webhelyén az Elérhető termékek régiónként lapot, és ellenőrizze, hogy a régió szerepel-e a listában.

Szemantikai rangsorolás engedélyezése

Az alábbi lépéseket követve engedélyezheti a szemantikai rangsorolót a szolgáltatás szintjén. Ha engedélyezve van, minden index számára elérhető. Adott indexek esetében nem kapcsolhatja be és nem kapcsolhatja ki.

Azure Portalra

1. Nyissa meg az Azure Portalt.

2. Lépjen a keresési szolgáltatáshoz. Az Áttekintés lapon győződjön meg arról, hogy a szolgáltatás számlázható szint, alapszintű vagy magasabb.

3. A bal oldali navigációs panelen válassza a Szemantikai rangsorolás lehetőséget.

4. Válassza ki az Ingyenes vagy a Standard csomagot. Az ingyenes csomag és a standard csomag között bármikor válthat.

   

Az ingyenes csomag havi 1000 lekérdezéssel van leképezve. Az ingyenes csomag első 1000 lekérdezése után hibaüzenet jelenik meg, amely tájékoztatja arról, hogy a következő alkalommal, amikor szemantikai lekérdezést ad ki, kimerítette a kvótát. Ha ez történik, frissítenie kell a standard csomagra, hogy továbbra is használhassa a szemantikai rangsorolást.

REST

Ha a REST API-val szeretné engedélyezni a szemantikai rangsorolást, használhatja a Szolgáltatás létrehozása vagy frissítése API-t.

A felügyeleti REST API-hívások hitelesítése a Microsoft Entra-azonosítón keresztül történik. A hitelesítéssel kapcsolatos útmutatásért tekintse meg az Azure AI-Search szolgáltatás REST API-kkal való kezelését.

• A felügyeleti REST API 2023-11-01-es verziója biztosítja a konfigurációs tulajdonságot.

• A funkciók engedélyezéséhez vagy letiltásához tulajdonosi vagy közreműködői engedélyekre van szükség.

Feljegyzés

A Létrehozás vagy frissítés két HTTP-metódust támogat: a PUT és a PATCH metódust. A PUT és a PATCH is használható a meglévő szolgáltatások frissítésére, de csak a PUT használható új szolgáltatás létrehozásához. Ha a PUT egy meglévő szolgáltatás frissítésére szolgál, a szolgáltatás összes tulajdonságát lecseréli az alapértelmezett értékre, ha nincsenek megadva a kérésben. Ha a PATCH-et egy meglévő szolgáltatás frissítésére használják, az csak a kérelemben megadott tulajdonságokat cseréli le. Ha a PUT használatával frissít egy meglévő szolgáltatást, előfordulhat, hogy véletlenül váratlan skálázást vagy konfigurációmódosítást vezet be. Ha engedélyezi a szemantikai rangsorolást egy meglévő szolgáltatáson, ajánlott a PATCH-et használni a PUT helyett.

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

Szemantikai rangsorolás letiltása a REST API használatával

A funkció engedélyezésének megfordításához vagy a véletlen használat és díjak elleni teljes védelem érdekében letilthatja a szemantikai rangsorolást a keresési szolgáltatás Létrehozás vagy Frissítés szolgáltatás API-jával . A funkció letiltása után a szemantikai lekérdezéstípust tartalmazó kérelmeket a rendszer elutasítja.

A felügyeleti REST API-hívások hitelesítése a Microsoft Entra-azonosítón keresztül történik. A hitelesítéssel kapcsolatos útmutatásért tekintse meg az Azure AI-Search szolgáltatás REST API-kkal való kezelését.

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

A szemantikai rangsorolás újbóli engedélyezéséhez futtassa újra a fenti kérést, és állítsa a "szemanticSearch" értéket "ingyenes" (alapértelmezett) vagy "standard" értékre.

Következő lépések

Konfigurálja a szemantikai rangsorolást , hogy tesztelhesse a szemantikai rangsorolást a tartalomon.