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.

Portale LUIS

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.

   

   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.

   

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

   

Senza il portale LUIS

Creare risorse LUIS senza usare il portale LUIS

Usare l'interfaccia della riga di comando di Azure per creare ogni risorsa singolarmente.

Suggerimento

• La risorsa di creazione kind è LUIS.Authoring
• La risorsa di previsione kind è LUIS

1. Accedere all'interfaccia della riga di comando di Azure:

   az login
   

   Questo comando apre un browser, in modo che si possa selezionare l'account corretto e fornire l'autenticazione.

2. Creare una risorsa di creazione LUIS di tipo LUIS.Authoring, denominata my-luis-authoring-resource. Crearla nel gruppo di risorse esistente denominato my-resource-group per l'area westus.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. Creare una risorsa dell'endpoint di previsione LUIS di tipo LUIS, denominata my-luis-prediction-resource. Crearla nel gruppo di risorse esistente denominato my-resource-group per l'area westus. Se si vuole una velocità effettiva superiore rispetto a quella fornita dal piano gratuito, cambiare F0 in S0. Altre informazioni sui piani tariffari e sulla velocità effettiva.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

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.

Portale 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:

   

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.

Senza il portale LUIS

Assegnare una risorsa di previsione senza usare il portale LUIS

Per i processi automatizzati come le pipeline CI/CD, è possibile automatizzare l'assegnazione di una risorsa LUIS a un'app LUIS seguendo questa procedura:

1. Ottenere un token di Azure Resource Manager che è una stringa di caratteri alfanumerici. Questo token scade, quindi usarlo immediatamente. È inoltre possibile usare il seguente comando dell'interfaccia della riga di comando di Azure.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Usare il token per richiedere le risorse di runtime LUIS in tutte le sottoscrizioni. Usare l'API per ottenere l'account di Azure LUIS a cui ha accesso l'account utente.

   Questa API POST richiede i valori seguenti:

   Intestazione	Valore
   Authorization	Il valore di Authorization è Bearer {token}. Il valore del token deve essere preceduto dalla parola Bearer e da uno spazio.
   Ocp-Apim-Subscription-Key	La chiave di creazione.

   L'API restituisce una matrice di oggetti JSON che rappresentano le sottoscrizioni LUIS. I valori restituiti includono l'ID sottoscrizione, il gruppo di risorse e il nome della risorsa, restituiti come AccountName. Trovare l'elemento nella matrice che rappresenta la risorsa LUIS da assegnare all'app LUIS.

3. Assegnare il token alla risorsa servizio LUIS usando l'API Assegnare un account LUIS di Azure a un'applicazione.

   Questa API POST richiede i valori seguenti:

   Type	Impostazione	Valore
   Intestazione	Authorization	Il valore di Authorization è Bearer {token}. Il valore del token deve essere preceduto dalla parola Bearer e da uno spazio.
   Intestazione	Ocp-Apim-Subscription-Key	La chiave di creazione.
   Intestazione	Content-type	application/json
   QueryString	appid	L'ID dell'app LUIS.
   Corpo		{AzureSubscriptionId: ID sottoscrizione personale, ResourceGroup: nome del gruppo di risorse con la risorsa di previsione, AccountName: nome della risorsa di previsione}

   Quando questa API ha esito positivo, restituisce 201 - created status.

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.

Portale 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.

Senza il portale LUIS

Annullare l’assegnazione di una risorsa di previsione senza usare il portale LUIS

1. Ottenere un token di Azure Resource Manager che è una stringa di caratteri alfanumerici. Questo token scade, quindi usarlo immediatamente. È inoltre possibile usare il seguente comando dell'interfaccia della riga di comando di Azure.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Usare il token per richiedere le risorse di runtime LUIS in tutte le sottoscrizioni. Usare l'API Ottieni account di Azure LUIS, a cui l'account utente ha accesso.

   Questa API POST richiede i valori seguenti:

   Intestazione	Valore
   Authorization	Il valore di Authorization è Bearer {token}. Il valore del token deve essere preceduto dalla parola Bearer e da uno spazio.
   Ocp-Apim-Subscription-Key	La chiave di creazione.

   L'API restituisce una matrice di oggetti JSON che rappresentano le sottoscrizioni LUIS. I valori restituiti includono l'ID sottoscrizione, il gruppo di risorse e il nome della risorsa, restituiti come AccountName. Trovare l'elemento nella matrice che rappresenta la risorsa LUIS da assegnare all'app LUIS.

3. Assegnare il token alla risorsa LUIS usando l’API Annulla l’assegnazione di un account Azure LUIS a un’applicazione.

   Questa API DELETE richiede i valori seguenti:

   Type	Impostazione	Valore
   Intestazione	Authorization	Il valore di Authorization è Bearer {token}. Il valore del token deve essere preceduto dalla parola Bearer e da uno spazio.
   Intestazione	Ocp-Apim-Subscription-Key	La chiave di creazione.
   Intestazione	Content-type	application/json
   QueryString	appid	L'ID dell'app LUIS.
   Corpo		{AzureSubscriptionId: ID sottoscrizione personale, ResourceGroup: nome del gruppo di risorse con la risorsa di previsione, AccountName: nome della risorsa di previsione}

   Quando questa API ha esito positivo, restituisce 200 - OK status.

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

   

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.

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.

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

   

3. Selezionare Aggiungi condizione

   

4. Selezionare Totale chiamate

   

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

   

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

   

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:

• Spostare una risorsa in un nuovo gruppo di risorse o in una nuova sottoscrizione
• Spostare una risorsa all'interno della stessa sottoscrizione o tra sottoscrizioni

Passaggi successivi

• Informazioni su come usare le versioni per controllare il ciclo di vita dell'app.