Abilitare o disabilitare il ranker semantico

Il ranker semantico è una funzionalità Premium fatturata in base all'utilizzo. Per impostazione predefinita, il ranker semantico è disabilitato in tutti i servizi.

Verifica disponibilità

Controllare la pagina Prodotti disponibili per area nel sito Web di Azure per verificare se l'area è elencata.

Abilitare la classificazione semantica

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

Azure portal

1. Apri il portale di Azure.

2. Passare al servizio di ricerca. Nella pagina Panoramica verificare che il servizio sia un livello fatturabile, Basic o superiore.

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

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

   

Il piano gratuito è limitato a 1.000 query al mese. Dopo le prime 1.000 query nel piano gratuito, si riceverà un messaggio di errore che informa che la quota è stata esaurita al successivo rilascio di una query semantica. In questo caso, è necessario eseguire l'aggiornamento al piano standard per continuare a usare la classificazione semantica.

REST

Per abilitare la classificazione semantica usando l'API REST, è possibile usare l'API Di creazione o aggiornamento del servizio.

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.

• L'API REST di gestione versione 2023-11-01 fornisce la proprietà di configurazione.

• Le autorizzazioni proprietario o collaboratore sono necessarie per abilitare o disabilitare le funzionalità.

Nota

Create o Update supporta due metodi HTTP: PUT e PATCH. Sia PUT che PATCH possono essere usati per aggiornare i servizi esistenti, ma solo PUT può essere usato per creare un nuovo servizio. Se put viene usato per aggiornare un servizio esistente, sostituisce tutte le proprietà nel servizio con le relative impostazioni predefinite se non vengono specificate nella richiesta. Quando PATCH viene usato per aggiornare un servizio esistente, sostituisce solo le proprietà specificate nella richiesta. Quando si usa PUT per aggiornare un servizio esistente, è possibile introdurre accidentalmente una modifica imprevista della scalabilità o della configurazione. Quando si abilita la classificazione semantica in un servizio esistente, è consigliabile usare PATCH anziché 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"
      }
    }

Disabilitare la classificazione semantica usando l'API REST

Per annullare l'abilitazione delle funzionalità o per una protezione completa dall'utilizzo accidentale e dagli addebiti, è possibile disabilitare la classificazione semantica usando l'API Crea o Aggiorna servizio nel servizio di ricerca. Dopo la disabilitazione della funzionalità, tutte le richieste che includono il tipo di query semantica verranno 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 la classificazione semantica, eseguire nuovamente la richiesta precedente, impostando "semanticSearch" su "free" (impostazione predefinita) o "standard".

Passaggi successivi

Configurare la classificazione semantica in modo che sia possibile testare la classificazione semantica sul contenuto.