Condividi tramite


Come creare e gestire risorse LUIS

Importante

LUIS verrà ritirato il 1 ottobre 2025 e a partire dal 1 aprile 2023 non è più possibile creare nuove risorse LUIS. Si consiglia di eseguire la migrazione delle applicazioni LUIS a comprensione del linguaggio di conversazione per sfruttare appieno un supporto costante per i prodotti e le funzionalità multilingue.

Leggere questo articolo per informazioni sui tipi di risorse Azure che è possibile usare con LUIS e sul modo in cui gestirle.

Risorsa Creazione

Una risorsa di creazione consente di creare, gestire, eseguire il training, testare e pubblicare applicazioni. Per la risorsa di creazione LUIS è disponibile un piano tariffario, il piano gratuito (F0), che offre:

  • 1 milione di transazioni di creazione
  • 1.000 richieste endpoint di previsione al mese.

È possibile usare le API programmatiche LUIS v3.0-preview per gestire le risorse di creazione.

Risorsa di previsione

Una risorsa di previsione consente di eseguire query sull'endpoint di previsione oltre le 1.000 richieste consentite dalla risorsa di creazione. Per la risorsa di previsione sono disponibili due piani tariffari:

  • La risorsa di previsione gratuita (F0), che offre 10.000 richieste endpoint di previsione ogni mese.
  • Risorsa di previsione standard (S0), ovvero il piano a pagamento.

È possibile usare l'API endpoint LUIS v3.0-preview per gestire le risorse di previsione.

Nota

  • È inoltre possibile usare una risorsa multiservizio per ottenere un singolo endpoint utilizzabile per più Servizi di Azure AI.
  • LUIS offre due tipi di risorse F0 (piano gratuito): uno per le transazioni di creazione e uno per le transazioni di previsione. Se si esaurisce la quota gratuita per le transazioni di previsione, assicurarsi di usare la risorsa di previsione F0, che offre 10.000 transazioni gratuite al mese, e non la risorsa di creazione, che offre 1.000 transazioni di previsione al mese.
  • È consigliabile creare app LUIS nelle aree in cui si vuole pubblicare ed eseguire query.

Creare le risorse di LUIS

Per creare risorse LUIS, è possibile usare il portale LUIS, il portale di Azure o l'interfaccia della riga di comando di Azure. Dopo aver creato le risorse, è necessario assegnarle alle app che verranno usate.

Creare una risorsa di creazione LUIS usando il portale LUIS

  1. Accedere al portale LUIS, selezionare il paese/area geografica e accettare le condizioni per l'utilizzo. Se viene visualizzata la sezione App personali nel portale, esiste già una risorsa LUIS ed è possibile ignorare il passaggio successivo.

  2. Nella finestra Choose an authoring (Scegliere una risorsa Creazione) visualizzata, trovare la sottoscrizione di Azure e la risorsa di creazione LUIS. Se non si ha una risorsa, è possibile crearne una nuova.

    Scegliere un tipo di risorsa di creazione Language Understanding.

    Quando si crea una nuova risorsa di creazione, fornire le informazioni seguenti:

    • Nome del tenant: il tenant a cui è associata la sottoscrizione di Azure.
    • Nome della sottoscrizione di Azure: la sottoscrizione in cui verrà fatturata la risorsa.
    • Nome del gruppo di risorse di Azure: il nome del gruppo di risorse scelto o creato. I gruppi di risorse consentono di raggruppare le risorse di Azure per l'accesso e la gestione.
    • Nome della risorsa di Azure: un nome personalizzato che viene usato come parte dell'URL per le query dell'endpoint di creazione e previsione.
    • Piano tariffario: il piano tariffario determina il numero massimo di transazioni al secondo e al mese.

Creare una risorsa di previsione LUIS usando il portale LUIS

  1. Passare alla scheda Gestisci dell'applicazione.

  2. Nel riquadro di spostamento sinistro selezionare Risorse di Azure.

  3. Selezionare il pulsante Aggiungi risorsa di previsione.

    Aggiungere una risorsa di previsione dal portale

    Se si dispone già di una risorsa di previsione, aggiungerla. In caso contrario, selezionare Crea una nuova risorsa di previsione.

    Aggiungere una risorsa di previsione dal portale-2

Assegnare risorse LUIS

Creare una risorsa non significa necessariamente utilizzarla, ma è necessario assegnarla alle app. È possibile assegnare una risorsa di creazione per una singola app o per tutte le app in LUIS.

Assegnare risorse tramite il portale LUIS

Assegnare una risorsa di creazione a tutte le app

La procedura seguente assegna la risorsa di creazione a tutte le app.

  1. Accedere al portale LUIS.
  2. Nell'angolo in alto a destra selezionare l'account utente, quindi selezionare Impostazioni.
  3. Nella pagina Impostazioni utente selezionare Aggiungi risorsa di creazione, quindi selezionare una risorsa di creazione esistente. Seleziona Salva.

Assegnare una risorsa a un'app specifica

La procedura seguente assegna una risorsa a un'app specifica.

  1. Accedere al portale LUIS. Selezionare un'app nell'elenco My apps (App personali).

  2. Passare a Gestisci>Risorse di Azure:

    Scegliere un tipo di risorsa di previsione di Language Understanding.

  3. Nella scheda Risorsa di previsione o Risorsa di creazione selezionare il pulsante Aggiungi risorsa di previsione o Aggiungi risorsa di creazione.

  4. Usare i campi del modulo per trovare la risorsa corretta, quindi selezionare Salva.

Annullare l'assegnazione di una risorsa

Quando si annulla l'assegnazione di una risorsa, questa non viene eliminata da Azure. Viene soltanto scollegata da LUIS.

Annullare l'assegnazione delle risorse tramite il portale LUIS

  1. Accedere al portale LUIS, quindi selezionare un'app dall'elenco App personali .
  2. Passare a Gestisci>Risorse di Azure.
  3. Selezionare il pulsante Annulla assegnazione risorsa per la risorsa.

Proprietà di una risorsa

Una risorsa di Azure, come una risorsa LUIS, è di proprietà della sottoscrizione che contiene la risorsa stessa.

Per modificare la proprietà di una risorsa, è possibile eseguire una di queste azioni:

  • Trasferire la proprietà della sottoscrizione.
  • Esportare l'app LUIS come file, quindi importare l'app in una sottoscrizione diversa. L'esportazione è disponibile nella pagina App personali del portale LUIS.

Limiti delle risorse

Limiti di creazione della chiave di creazione

È possibile creare fino a 10 chiavi di creazione per area, per sottoscrizione. Le regioni di pubblicazione sono diverse dalle regioni di creazione. Assicurarsi di creare un'app nell'area di creazione corrispondente all'area di pubblicazione in cui si vuole che si trovi l'applicazione client. Per informazioni sul mapping delle aree di creazione con le aree di pubblicazione, vedere Aree di creazione e pubblicazione.

Per altre informazioni, vedi i limiti delle risorse.

Errori relativi ai limiti di utilizzo delle chiavi

I limiti di utilizzo sono basati sul piano tariffario.

Se si supera la quota di transazioni al secondo, viene visualizzato un errore HTTP 429. Se si supera la quota di transazioni al mese, viene visualizzato un errore HTTP 403.

Modificare il piano tariffario

  1. Nel portale di Azure passare a Tutte le risorse e selezionare la risorsa

    Screenshot che mostra una sottoscrizione LUIS nel portale di Azure.

  2. Nel menu a sinistra selezionare Piano tariffario per visualizzare i piani tariffari disponibili

  3. Selezionare il piano tariffario desiderato e cliccare su Seleziona per salvare la modifica. Al termine della modifica della tariffa, comparirà una notifica in alto a destra con l'aggiornamento del piano tariffario.

Visualizzare le metriche delle risorse di Azure

Visualizzare un riepilogo dell'utilizzo delle risorse di Azure

È possibile visualizzare le informazioni sull'utilizzo di LUIS nel portale di Azure. La pagina Panoramica mostra un riepilogo, che include le chiamate e gli errori recenti. Se si effettua una richiesta endpoint LUIS, attendere fino a cinque minuti affinché la modifica venga visualizzata.

Screenshot che mostra la pagina di panoramica.

Personalizzazione dei grafici di utilizzo delle risorse di Azure

La pagina Metriche offre una visualizzazione più dettagliata dei dati. È possibile configurare i grafici delle metriche per un periodo di tempo e una metrica specifici.

Screenshot che mostra la pagina delle metriche.

Avviso di superamento della soglia delle transazioni totali

Se si desidera sapere quando è stata raggiunta una determinata soglia delle transazioni, ad esempio 10.000 transazioni, è possibile creare un avviso:

  1. Dal menu a sinistra selezionare Avvisi

  2. Nel menu in alto selezionare Nuova regola di avviso

    Screenshot che mostra la pagina delle regole di avviso.

  3. Selezionare Aggiungi condizione

    Screenshot che mostra la pagina Aggiungi condizione per le regole di avviso.

  4. Selezionare Totale chiamate

    Screenshot che mostra la pagina delle chiamate totali per gli avvisi.

  5. Scorrere verso il basso fino alla sezione Logica di avviso e impostare gli attributi desiderati, poi cliccare su Fine

    Screenshot che mostra la pagina della logica di avviso.

  6. Per inviare notifiche o richiamare azioni quando la regola di avviso viene attivata, passare alla sezione Azioni e aggiungere il gruppo di azioni.

    Screenshot che mostra la pagina delle azioni per gli avvisi.

Reimpostare una chiave di creazione

Per le app migrate con risorse di creazione: se la chiave di creazione è compromessa, reimpostare la chiave nel portale di Azure nella pagina Chiavi per la risorsa di creazione.

Per le app di cui non è stata eseguita la migrazione: la chiave viene reimpostata in tutte le app nel portale LUIS. Se le app vengono create mediante le API di creazione, è necessario modificare il valore di Ocp-Apim-Subscription-Key con la nuova chiave.

Rigenerare una chiave di Azure

È possibile rigenerare una chiave di Azure dalla pagina Chiavi nel portale di Azure.

Proprietà, accesso e sicurezza delle app

Un'app viene definita dalle risorse di Azure, determinate dalla sottoscrizione del proprietario.

È possibile spostare l'app LUIS. Usare le risorse seguenti per eseguire questa operazione usando il portale di Azure o l'interfaccia della riga di comando di Azure:

Passaggi successivi