Abilitare o disabilitare il classificatore semantico

Il ranker semantico è una funzionalità Premium fatturata dall'utilizzo. Per impostazione predefinita, il ranker semantico viene disattivato quando si crea un nuovo servizio di ricerca, ma chiunque disponga delle autorizzazioni di collaboratore può abilitarlo. Per evitare di abilitarlo involontariamente, è possibile disabilitarlo usando l'API REST.

Verifica disponibilità

Per verificare se il ranker semantico è disponibile nell'area, vedere l'elenco delle aree di Ricerca di intelligenza artificiale di Azure.

Abilitare il classificatore semantico

Seguire questa procedura per abilitare il classificatore semantico a livello di servizio. Una volta abilitato, è disponibile per tutti gli indici. È possibile attivarlo o disattivarlo per indici specifici.

  1. Apri il portale di Azure.

  2. Passare al servizio di ricerca. Nella pagina Panoramica verificare che il piano tariffario sia impostato su Basic o versione successiva.

  3. Nel riquadro di spostamento a sinistra selezionare Impostazioni>Classificazione semantica.

  4. Selezionare il piano Gratuito o il piano Standard. È possibile passare dal piano gratuito al piano standard in qualsiasi momento.

    Screenshot dell'abilitazione della classificazione semantica nel portale di Azure.

Il piano gratuito è limitato a 1.000 query al mese. Dopo le prime 1.000 query nel piano gratuito, un messaggio di errore indica che è stata esaurita la quota nella query semantica successiva. Quando la quota è esaurita, è necessario eseguire l'aggiornamento al piano standard per continuare a usare la classificazione semantica.

Disabilitare il classificatore semantico usando l'API REST

Per disattivare l'abilitazione delle funzionalità o per la protezione completa dall'utilizzo accidentale e dagli addebiti, è possibile disabilitare il ranker semantico usando l'API Crea o Aggiorna servizio nel servizio di ricerca. Dopo aver disabilitato la funzionalità, tutte le richieste che includono il tipo di query semantica vengono rifiutate.

Le chiamate API REST di gestione vengono autenticate tramite Microsoft Entra ID. Per istruzioni su come eseguire l'autenticazione, vedere Gestire i servizio di ricerca di intelligenza artificiale di Azure con le 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"
      }
    }

Per riabilitare il ranker semantico, eseguire di nuovo la richiesta precedente e impostare semanticSearch su Gratuito (impostazione predefinita) o Standard.

Passaggio successivo