Schnellstart: Erstellen Ihrer App im LUIS-Portal
Wichtig
LUIS wird am 1. Oktober 2025 eingestellt, und ab dem 1. April 2023 können Sie keine neuen LUIS-Ressourcen erstellen. Es wird die Migration Ihrer LUIS-Anwendungen zu Conversational Language Understanding empfohlen, um fortgesetzte Produktunterstützung und mehrsprachige Funktionen zu erhalten.
In dieser Schnellstartanleitung erstellen Sie mithilfe der vordefinierten Domäne „HomeAutomation“ zum Ein- und Ausschalten von Beleuchtungen und Haushaltsgeräten eine LUIS-App. Diese vordefinierte Domäne bietet Absichten, Entitäten und Beispieläußerungen, die Sie nutzen können. Versuchen Sie als Nächstes, Ihre App anzupassen, indem Sie weitere Absichten und Entitäten hinzufügen. Am Ende dieser Schnellstartanleitung verfügen Sie über einen LUIS-Endpunkt in der Cloud.
Anmelden beim LUIS-Portal
Als neuer LUIS-Benutzer müssen Sie wie folgt vorgehen:
- Melden Sie sich beim LUIS-Portal an, wählen Sie Ihr Land bzw. Ihre Region aus, und stimmen Sie den Nutzungsbedingungen zu. Wenn stattdessen Meine Apps angezeigt wird, ist bereits eine LUIS-Ressource vorhanden, und Sie können mit dem Erstellen einer App fortfahren. Verwenden Sie andernfalls für den Einstieg eine Azure-Ressource. Dies ermöglicht es Ihnen, Ihr LUIS-Konto mit einer neuen oder vorhandenen Azure-Erstellungsressource zu verknüpfen.
Suchen Sie im angezeigten Fenster zum Auswählen einer Erstellungsressource nach Ihrem Azure-Abonnement und der LUIS-Erstellungsressource. Wenn keine Ressource vorhanden ist, können Sie eine neue erstellen.
Geben Sie beim Erstellen einer neuen Erstellungsressource die folgenden Informationen an:
- Mandantenname: Der Mandant, dem Ihr Azure-Abonnement zugeordnet ist.
- Azure-Abonnementname: Das Abonnement, unter dem die Ressource abgerechnet wird.
- Name der Azure-Ressourcengruppe: Ein benutzerdefinierter Ressourcengruppenname, den Sie auswählen oder erstellen. Mit Ressourcengruppen können Sie Azure-Ressourcen für den Zugriff und die Verwaltung gruppieren.
- Azure-Ressourcenname: Ein von Ihnen gewählter benutzerdefinierter Name, der als Teil der URL für Ihre Abfragen für Erstellungs- und Vorhersageendpunkte verwendet wird.
- Tarif: Der Tarif bestimmt die maximale Anzahl von Transaktionen pro Sekunde und Monat.
Auswählen einer Abonnement- und Erstellungsressource
Wenn Sie ein bestimmtes Abonnement und eine Erstellungsressource auswählen, wird eine Liste mit den zugeordneten Apps angezeigt.
Erstellen einer neuen App
Sie können Ihre Anwendungen auf der Seite Meine Apps erstellen und verwalten.
Erstellen einer Anwendung
Klicken Sie zum Erstellen einer Anwendung auf + Neue App.
Geben Sie im angezeigten Fenster die folgenden Informationen ein:
| Name | Beschreibung |
|---|---|
| Name | Ein Name für Ihre App. Beispiel: „Home Automation“. |
| culture | Die Sprache, die Ihre App versteht und spricht. |
| Beschreibung | Eine Beschreibung für Ihre App. |
| Vorhersageressource | Die Vorhersageressource, die Abfragen empfängt. |
Wählen Sie Fertigaus.
Hinweis
Die Kultur kann nach dem Erstellen der Anwendung nicht mehr geändert werden.
Hinzufügen einer vordefinierten Domäne
LUIS bietet eine Reihe vordefinierter Domänen, die Ihnen die ersten Schritte mit Ihrer Anwendung erleichtern können. Eine App mit vordefinierter Domänen ist bereits mit Absichten, Entitäten und Äußerungen aufgefüllt.
Wählen Sie im linken Navigationsbereich die Option Prebuilt domains (Vordefinierte Domänen) aus.
Suchen Sie nach HomeAutomation.
Wählen Sie auf der Karte „HomeAutomation“ die Option Domäne hinzufügen aus.
Wenn die Domäne erfolgreich hinzugefügt wurde, enthält das Feld für die vordefinierte Domäne eine Schaltfläche Remove domain (Domäne entfernen).
Überprüfen von Absichten und Entitäten
Wählen Sie im linken Navigationsmenü die Option Absichten aus, um die Absichten der Domäne „HomeAutomation“ anzuzeigen. Hierin sind Beispieläußerungen enthalten, z. B.
HomeAutomation.QueryStateundHomeAutomation.SetDevice.Hinweis
None (Keine) ist eine Absicht, die von allen LUIS-Apps bereitgestellt wird. Diese Absicht verwenden Sie zum Behandeln von Äußerungen, die keiner Funktionalität Ihrer App entsprechen.
Wählen Sie die Absicht HomeAutomation.TurnOff aus. Die Absicht enthält eine Liste von Beispieläußerungen, die mit Entitäten beschriftet sind.
Wählen Sie Entitäten aus, wenn Sie Entitäten für die App anzeigen möchten. Wenn Sie eine der Entitäten auswählen, z. B. HomeAutomation.DeviceName, wird eine Liste mit den zugehörigen Werten angezeigt.
Trainieren der LUIS-App
Nachdem Ihre Anwendung mit Absichten, Entitäten und Äußerungen aufgefüllt wurde, müssen Sie die Anwendung trainieren, damit die von Ihnen vorgenommenen Änderungen übernommen werden können.
Wählen Sie rechts oben auf der LUIS-Website die Schaltfläche Train (Trainieren) aus.
Das Training ist abgeschlossen, wenn die Schaltfläche Trainieren deaktiviert ist.
Testen Ihrer App
Nachdem Sie Ihre App trainiert haben, können Sie sie testen.
Wählen Sie im Navigationsbereich rechts oben die Option Testen aus.
Geben Sie eine Testäußerung in den interaktiven Testbereich ein, und drücken Sie die EINGABETASTE. Beispiel: Turn off the lights.
In diesem Beispiel wurde Turn off the lights korrekt als Absicht mit der höchsten Bewertung von HomeAutomation.TurnOff identifiziert.
Wählen Sie Überprüfen aus, um weitere Informationen zur Vorhersage anzuzeigen.
Schließen Sie den Testbereich.
Anpassen Ihrer Anwendung
Neben den vordefinierten Domänen ermöglicht LUIS Ihnen das Erstellen eigener benutzerdefinierter Anwendungen oder das Anpassen vordefinierter Anwendungen.
Erstellen von Absichten
So fügen Sie Ihrer App weitere Absichten hinzu
- Wählen Sie im linken Navigationsbereich Absichten aus.
- Klicken Sie auf Erstellen
- Geben Sie den Namen der Absicht (
HomeAutomation.AddDeviceAlias) ein, und wählen Sie dann „Fertig“ aus.
Erstellen von Entitäten
So fügen Sie Ihrer App weitere Entitäten hinzu
- Wählen Sie im linken Navigationsmenü Entitäten aus.
- Klicken Sie auf Erstellen
- Geben Sie den Namen der Entität (
HomeAutomation.DeviceAlias) ein, und wählen Sie unter Typ die Option „Durch maschinelles Lernen erworben“ und dann Erstellen aus.
Hinzufügen von Beispieläußerungen
Beispieläußerungen sind Text, den ein*e Benutzer*in in einen Chatbot oder eine andere Clientanwendung eingibt. Sie bilden die Absicht des Texts des Benutzers auf eine LUIS-Absicht ab.
Fügen Sie auf der Seite Absichten für HomeAutomation.AddDeviceAlias unter Beispieläußerung die folgenden Beispieläußerungen hinzu.
| # | Beispiele für Äußerungen |
|---|---|
| 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 |
Stellen Sie sicher, dass sich die Beispieläußerungen wie folgt unterscheiden, um optimale Ergebnisse zu erzielen:
- Länge der Äußerung
- Interpunktion
- Wortwahl
- Zeitform des Verbs (is, was, will be)
- Reihenfolge der Wörter
Bezeichnen von Beispieläußerungen
Das Bezeichnen Ihrer Äußerungen ist erforderlich, da Sie eine ML-Entität hinzugefügt haben. Anhand der Bezeichnung lernt Ihre Anwendung, wie die von Ihnen erstellten ML-Entitäten extrahiert werden.
Zum Bezeichnen von Äußerungen stehen zwei Möglichkeiten zur Verfügung: Entitätenpalettenbezeichnung und Inlinebezeichnung.
Entitätenpalettenbezeichnung
Wenn Sie oben rechts das Symbol @ auswählen, wird die Entitätenpalette rechts auf der Seite geöffnet.
Wählen Sie die Entität aus, die als Erstes bezeichnet werden soll.
Markieren Sie den Text, den Sie mit dieser Entität bezeichnen möchten.
Inlinebezeichnung
Markieren Sie den Text, den Sie bezeichnen möchten.
Wählen Sie im daraufhin angezeigten Menü die Entität aus, mit der Sie den Text bezeichnen möchten.
Erstellen einer Vorhersageressource
An diesem Punkt ist die Erstellung Ihrer Anwendung abgeschlossen. Sie müssen eine Vorhersageressource erstellen, um Ihre Anwendung zu veröffentlichen und Vorhersagen in einem Chatbot oder anderen Clientanwendungen über den Vorhersageendpunkt zu erhalten.
So erstellen Sie eine Vorhersageressource über das LUIS-Portal
Navigieren Sie in Ihrer Anwendung zur Registerkarte Verwalten.
Wählen Sie im linken Navigationsbereich die Option Azure-Ressourcen aus.
Wählen Sie die Schaltfläche Vorhersageressource hinzufügen aus.
Wenn Sie bereits über eine Vorhersageressource verfügen, fügen Sie sie hinzu. Wählen Sie andernfalls Neue Vorhersageressource erstellen aus.
Veröffentlichen der App zum Abrufen der Endpunkt-URL
Damit Sie eine LUIS-Vorhersage in einem Chatbot oder anderen Clientanwendungen empfangen können, muss die App im Vorhersageendpunkt veröffentlicht werden.
Wählen Sie im Navigationsbereich rechts oben die Option Veröffentlichen aus.
Wählen Sie den Slot Produktion und anschließend Fertig aus.
Wählen Sie in der Benachrichtigung die Option Access your endpoint URLs (Auf Endpunkt-URLs zugreifen) aus, um zur Seite Azure-Ressourcen zu navigieren. Die URLs werden nur angezeigt, wenn der App eine Vorhersageressource zugeordnet ist. Sie können auch auf die Seite Azure-Ressourcen zugreifen, indem Sie auf Verwalten klicken.
Abfragen des V3-API-Vorhersageendpunkts
Kopieren Sie im LUIS-Portal im Abschnitt Verwalten (Menü rechts oben) auf der Seite Azure-Ressourcen (linkes Menü) auf der Registerkarte Vorhersageressourcen die Beispielabfrage am unteren Seitenrand. Die URL enthält Ihre App-ID, den Schlüssel und den Slotnamen. Die URL für V3 des Vorhersageendpunkts hat das folgende Format:
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
Fügen Sie die URL in einen neuen Browsertab ein. Falls die URL nicht angezeigt wird, verfügen Sie nicht über eine Vorhersageressource und müssen eine erstellen.
Stellen Sie in der Adressleiste des Browsers für die Abfragezeichenfolge sicher, dass die URL die folgenden Werte enthält. Fügen Sie diese Angaben hinzu, falls sie in der Abfragezeichenfolge nicht enthalten sind:
verbose=trueshow-all-intents=true
Navigieren Sie in der Adressleiste des Browsers an das Ende der URL, und geben Sie turn off the living room light für die Abfragezeichenfolge ein. Drücken Sie anschließend die EINGABETASTE.
{ "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" ] } ] } } } }
Bereinigen von Ressourcen
Löschen Sie die LUIS-App, falls Sie sie nicht mehr benötigen. Wählen Sie hierzu im Menü oben links die Option Meine Apps. Wählen Sie in der App-Liste rechts vom App-Namen die Auslassungspunkte (...) und dann die Option Löschen aus. Wählen Sie im Popupdialogfenster Delete App? (App löschen?) OK aus.