Come creare e gestire risorse 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.

   

Creare risorse LUIS senza usare il portale LUIS

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

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

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

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.