Guida introduttiva: Creare l'app nel portale 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.
In questa guida introduttiva creare un'app LUIS usando il dominio predefinito di home automation per accendere e spegnere le luci e gli elettrodomestici. Questo dominio predefinito fornisce all'utente finalità, entità ed espressioni di esempio. Provare quindi a personalizzare l'app aggiungendo altre finalità ed entità. Al termine, sarà disponibile un endpoint LUIS in esecuzione nel cloud.
Accedere al portale LUIS
Un nuovo utente di LUIS deve seguire questa procedura:
- Accedere al portale LUIS, selezionare il paese/area geografica e accettare le condizioni per l'utilizzo. Se invece si visualizza App personali, significa che esiste già una risorsa LUIS ed è necessario procedere alla creazione di un'app. In caso contrario, iniziare usando una risorsa di Azure, in questo modo è possibile collegare l'account LUIS a una risorsa di creazione di Azure nuova o esistente.
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.
Selezionare la sottoscrizione e la risorsa di creazione
Quando si seleziona una sottoscrizione specifica e una risorsa di creazione, verrà visualizzato un elenco di app associate.
Creare una nuova app
È possibile creare e gestire le applicazioni in My Apps (App personali).
Creare un'applicazione
Per creare un'applicazione, fare clic su + Nuova app.
Nella finestra visualizzata immettere le informazioni seguenti:
| Nome | Descrizione |
|---|---|
| Name | Un nome per l'app. Ad esempio "home automation". |
| Cultura | La lingua compresa e parlata dall'app. |
| Descrizione | Una descrizione dell'app. |
| Risorsa di previsione | La risorsa di previsione che riceverà le query. |
Seleziona Fatto.
Nota
Le impostazioni cultura non possono essere modificate dopo la creazione dell'applicazione.
Aggiungi dominio predefinito
LUIS offre un set di domini predefiniti che consentono di iniziare a usare l'applicazione. Un'app di dominio predefinita è già popolata con finalità, entità ed espressioni.
Selezionare Prebuilt domains (Domini predefiniti) nel riquadro di spostamento a sinistra.
Cercare HomeAutomation.
Selezionare Add domain (Aggiungi dominio) nella scheda HomeAutomation.
Dopo che il dominio è stato aggiunto, nella casella del dominio predefinito viene visualizzato un pulsante Remove domain (Rimuovi dominio).
Vedere finalità ed entità
Selezionare Intents (Finalità) nel menu di spostamento sinistro per visualizzare le finalità del dominio HomeAutomation. Contiene espressioni di esempio come
HomeAutomation.QueryStateeHomeAutomation.SetDevice.Nota
None (Nessuna) è una finalità fornita da tutte le app LUIS. Viene usata per gestire le espressioni che non corrispondono alle funzionalità offerte dall'app.
Selezionare la finalità HomeAutomation.TurnOff. La finalità contiene un elenco di espressioni di esempio con etichette di entità.
Per visualizzare le entità per l'app, selezionare Entities (Entità). Se si seleziona una delle entità, ad esempio HomeAutomation.DeviceName verrà visualizzato un elenco di valori associati.
Eseguire il training dell'app di Language Understanding
Dopo che l'applicazione viene popolata con finalità, entità ed espressioni, è necessario eseguire il training dell'applicazione in modo che le modifiche apportate possano essere riflesse.
In alto a destra nel sito Web LUIS selezionare il pulsante Train (Esegui il training).
Il training è completo quando il pulsante Esegui training risulta disabilitato.
Testare l'app
Dopo aver eseguito il training dell'app, è possibile eseguirne il test.
Selezionare Test nel riquadro di spostamento in altro a destra.
Digitare un'espressione di test nel riquadro di test interattivo e premere Invio. Ad esempio Spegni le luci.
In questo esempio, Disattiva le luci viene identificata correttamente come finalità di punteggio superiore di HomeAutomation.TurnOff.
Selezionare Inspect (Esamina) per visualizzare altre informazioni sulla stima.
Chiudere il riquadro di test.
Personalizzare l'applicazione
Oltre ai domini predefiniti LUIS consente di creare applicazioni personalizzate o di personalizzare in base a quelle predefinite.
Creare finalità
Per aggiungere altre finalità all'app
- Selezionare Finalità nel menu di spostamento a sinistra.
- Selezionare Crea.
- Immettere il nome della finalità,
HomeAutomation.AddDeviceAlias, e quindi selezionare Fine.
Creare entità
Per aggiungere altre entità all'app
- Selezionare Entità nel menu di spostamento a sinistra.
- Selezionare Crea.
- Immettere il nome dell'entità,
HomeAutomation.DeviceAlias, selezionare l’opzione relativa al Machine Learning dal tipo e quindi selezionare Crea.
Aggiungere espressioni di esempio
Le espressioni di esempio sono costituite da testo immesso da un utente in un chatbot o un'altra applicazione client. Associano l'intento del testo dell'utente a una finalità LUIS.
Nella pagina Intents (Finalità) per HomeAutomation.AddDeviceAlias aggiungere le espressioni di esempio seguenti nell'apposita sezione.
| # | Espressioni di esempio |
|---|---|
| 1 | Add alias to my fan to be wind machine |
| 2 | Alias lights to illumination |
| 3 | nickname living room speakers to our speakers a new fan |
| 4 | rename living room tv to main tv |
Per ottenere risultati ottimali, assicurarsi che le espressioni di esempio variano nei modi seguenti:
- lunghezza dell'espressione
- punteggiatura
- scelta delle parole
- tempi verbali (presente, passato, futuro)
- ordine delle parole
Etichettare le espressioni di esempio
L'etichettatura delle espressioni è necessaria perché è stata aggiunta un'entità ml. L'etichettatura viene usata dall'applicazione per informazioni su come estrarre le entità di Machine Learning create.
Per etichettare le espressioni, sono disponibili due opzioni: etichettatura del riquadro delle entità ed etichettatura inline.
Etichettatura del riquadro delle entità
Quando si fa clic sull'icona @ in alto a destra, il riquadro delle entità si apre sul lato destro della pagina.
Selezionare l'entità di cui si vuole avviare l'etichettatura.
Evidenziare il testo da etichettare con questa entità.
Etichettatura inline
Evidenziare il testo da etichettare.
Selezionare l'entità con cui si vuole etichettare il testo dal menu visualizzato.
Creare una risorsa di previsione
A questo punto, è stata completata la creazione dell'applicazione. È necessario creare una risorsa di previsione per pubblicare l'applicazione per ricevere le previsioni in un chat bot o in altre applicazioni client tramite l'endpoint di previsione
Per creare una risorsa di previsione dal portale LUIS
Passare alla scheda Gestisci nell'applicazione.
Nel riquadro di spostamento sinistro selezionare Risorse di Azure.
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.
Pubblicare l'app per ottenere l'URL endpoint
Per ottenere una previsione LUIS in un chatbot o in un'altra applicazione client, è necessario pubblicare l'app nell'endpoint di previsione.
Selezionare Pubblica nel riquadro di spostamento in alto a destra.
Selezionare Slot di produzione e quindi Fatto.
Selezionare il collegamento Accedi agli URL degli endpoint nella notifica per passare alla pagina Risorse di Azure. Sarà possibile visualizzare gli URL solo se all'app è associata una risorsa di previsione. Per passare alla pagina Risorse di Azure, è anche possibile fare clic su Gestisci.
Eseguire le query sull'endpoint di stima dell'API V3
Nella pagina Azure Resources (Risorse di Azure) (menu a sinistra) della sezione Manage (Gestisci) del portale LUIS (menu in alto a destra) copiare la query di esempio, visualizzata nella parte inferiore della pagina, nella scheda Prediction Resources (Risorse di previsione). L'URL contiene l'ID, la chiave e il nome dello slot dell'app. L'URL dell'endpoint di previsione V3 ha il formato
https://YOUR-RESOURCE-NAME.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-PREDICTION-KEY&<optional-name-value-pairs>&query=YOUR_QUERY_HERE
Incollare l'URL in un Web browser. Se l'URL non è visibile, significa che non è presente una risorsa di previsione e sarà necessario crearne una.
Nella barra degli indirizzi del browser, per la stringa di query, assicurarsi che i valori seguenti si trovino nell'URL. Se non sono presenti nella stringa di query, aggiungerle:
verbose=trueshow-all-intents=true
Nella barra degli indirizzi del browser passare alla fine dell'URL e immettere disattiva la luce del soggiorno per la stringa di query, quindi premere Invio.
{ "query": "turn off the living room light", "prediction": { "topIntent": "HomeAutomation.TurnOff", "intents": { "HomeAutomation.TurnOff": { "score": 0.969448864 }, "HomeAutomation.QueryState": { "score": 0.0122336326 }, "HomeAutomation.TurnUp": { "score": 0.006547436 }, "HomeAutomation.TurnDown": { "score": 0.0050634006 }, "HomeAutomation.SetDevice": { "score": 0.004951761 }, "HomeAutomation.TurnOn": { "score": 0.00312553928 }, "None": { "score": 0.000552945654 } }, "entities": { "HomeAutomation.Location": [ "living room" ], "HomeAutomation.DeviceName": [ [ "living room light" ] ], "HomeAutomation.DeviceType": [ [ "light" ] ], "$instance": { "HomeAutomation.Location": [ { "type": "HomeAutomation.Location", "text": "living room", "startIndex": 13, "length": 11, "score": 0.902181149, "modelTypeId": 1, "modelType": "Entity Extractor", "recognitionSources": [ "model" ] } ], "HomeAutomation.DeviceName": [ { "type": "HomeAutomation.DeviceName", "text": "living room light", "startIndex": 13, "length": 17, "modelTypeId": 5, "modelType": "List Entity Extractor", "recognitionSources": [ "model" ] } ], "HomeAutomation.DeviceType": [ { "type": "HomeAutomation.DeviceType", "text": "light", "startIndex": 25, "length": 5, "modelTypeId": 5, "modelType": "List Entity Extractor", "recognitionSources": [ "model" ] } ] } } } }
Pulire le risorse
Quando non è più necessaria, eliminare l'app LUIS. A questo scopo, scegliere My apps (App personali) dal menu in alto a sinistra. Selezionare i puntini di sospensione (...) a destra del nome dell'app nell'elenco di app e quindi selezionare Delete (Elimina). Nella finestra di dialogo popup Delete app? (Eliminare l'app?) selezionare OK.