Come creare e gestire risorse LUIS

Importante

LUIS verrà ritirato il 1 ottobre 2025 e a partire dal 1 aprile 2023 non sarà 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.

Usare questo articolo per informazioni sui tipi di risorse di Azure che è possibile usare con LUIS e su come gestirle.

Risorsa Creazione

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

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

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

Risorsa di previsione

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

• La risorsa di stima gratuita (F0), che offre 10.000 richieste di endpoint di stima ogni mese.
• Risorsa di stima Standard (S0), ovvero il livello a pagamento.

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

Nota

• È anche possibile usare una risorsa multiservizio per ottenere un singolo endpoint che è possibile usare per più servizi di intelligenza artificiale di Azure.
• LUIS offre due tipi di risorse F0 (livello gratuito): una per la creazione di transazioni e una per le transazioni di stima. Se si esaurisce la quota gratuita per le transazioni di stima, assicurarsi di usare la risorsa di stima F0, che offre 10.000 transazioni gratuite mensilmente e non la risorsa di creazione, che offre 1.000 transazioni di stima mensile.
• È consigliabile creare app LUIS nelle aree in cui si vuole pubblicare ed eseguire query.

Creare risorse LUIS

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

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 tenant: il tenant a cui è associata la sottoscrizione di Azure.
   • Nome della sottoscrizione di Azure: la sottoscrizione che verrà fatturata per la risorsa.
   • Nome del gruppo di risorse di Azure: nome del gruppo di risorse personalizzato scelto o creato. I gruppi di risorse consentono di raggruppare le risorse di Azure per l'accesso e la gestione.
   • Nome risorsa di Azure: nome personalizzato scelto, usato come parte dell'URL per le query di creazione ed endpoint di stima.
   • Piano tariffario: il piano tariffario determina la transazione massima al secondo e al mese.

Creare una risorsa di stima LUIS usando il portale LUIS

1. Passare alla scheda Gestisci nell'applicazione.

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

3. Selezionare il pulsante Aggiungi risorsa stima .

   

   Se si dispone già di una risorsa di stima, 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 kind di creazione è LUIS.Authoring
• La risorsa di kind stima è LUIS

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

   az login
   

   Questo comando apre un browser in modo da poter selezionare l'account corretto e fornire l'autenticazione.

2. Creare una risorsa di creazione LUIS di tipo LUIS.Authoring, denominata my-luis-authoring-resource. Crearlo 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 stima LUIS di tipo LUIS, denominata my-luis-prediction-resource. Crearlo nel gruppo di risorse esistente denominato my-resource-group per l'area westus . Se si vuole una velocità effettiva superiore rispetto al livello gratuito, passare F0 a 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

La creazione di una risorsa non significa necessariamente che venga usata, è 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 e quindi selezionare Impostazioni.
3. Nella pagina User Impostazioni (Utente) selezionare Add authoring resource (Aggiungi risorsa di creazione) e 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 stima o Risorsa di creazione selezionare il pulsante Aggiungi risorsa di stima o Aggiungi risorsa di creazione.

4. Usare i campi nel modulo per trovare la risorsa corretta e quindi selezionare Salva.

Senza il portale LUIS

Assegnare una risorsa di stima 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 alfanumerica di caratteri. Questo token scade, quindi usarlo immediatamente. È anche possibile usare il comando seguente 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 tra 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 LUIS usando l'API Assegna un account luis di Azure a un'API dell'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, ResourceGroup: nome del gruppo di risorse con la risorsa di stima, AccountName: nome della risorsa di stima}

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

Annullare l'assegnazione di una risorsa

Quando si annulla l'assegnazione di una risorsa, non viene eliminata da Azure. Non è collegato solo da LUIS.

Portale LUIS

Annullare l'assegnazione delle risorse tramite il portale LUIS

1. Accedere al portale LUIS e 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 della risorsa di stima senza usare il portale LUIS

1. Ottenere un token di Azure Resource Manager che è una stringa alfanumerica di caratteri. Questo token scade, quindi usarlo immediatamente. È anche possibile usare il comando seguente 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 tra sottoscrizioni. Usare l'API Get LUIS Azure accounts (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 annulla l'assegnazione di un account DI Azure LUIS da un'API dell'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, ResourceGroup: nome del gruppo di risorse con la risorsa di stima, AccountName: nome della risorsa di stima}

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

Proprietà della risorsa

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

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

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

Limiti delle risorse

Limiti di creazione della chiave

È 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 trovare l'applicazione client. Per informazioni sul mapping delle aree di creazione alle aree di pubblicazione, vedere Creazione e pubblicazione di aree.

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 TPM (Transaction-Per-Month), viene visualizzato un errore HTTP 403.

Modificare il piano tariffario

1. Nella 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 fare clic su Seleziona per salvare la modifica. Al termine della modifica dei prezzi, verrà visualizzata 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 nella portale di Azure. La pagina Panoramica mostra un riepilogo, incluse le chiamate e gli errori recenti. Se si effettua una richiesta di endpoint LUIS, attendere fino a cinque minuti per la visualizzazione della modifica.

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 vuole sapere quando si raggiunge una determinata soglia di transazione, 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 Total calls (Totale chiamate)

   

5. Scorrere verso il basso fino alla sezione Logica di avviso e impostare gli attributi desiderati e fare clic 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 di risorse di creazione di cui è stata eseguita la migrazione: se la chiave di creazione è compromessa, reimpostare la chiave nella 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 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.