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:

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

    Choose a type of Language Understanding authoring resource.

    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.

Select authoring subscription and authoring resource

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.

  1. Wählen Sie im linken Navigationsbereich die Option Prebuilt domains (Vordefinierte Domänen) aus.

  2. Suchen Sie nach HomeAutomation.

  3. Wählen Sie auf der Karte „HomeAutomation“ die Option Domäne hinzufügen aus.

    Select 'Prebuilt domains' then search for 'HomeAutomation'. Select 'Add domain' on the HomeAutomation card.

    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

  1. 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.QueryState und HomeAutomation.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.

  2. Wählen Sie die Absicht HomeAutomation.TurnOff aus. Die Absicht enthält eine Liste von Beispieläußerungen, die mit Entitäten beschriftet sind.

    Screenshot of HomeAutomation.TurnOff intent

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

    Image alt text

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.

  1. Wählen Sie rechts oben auf der LUIS-Website die Schaltfläche Train (Trainieren) aus.

    Train button

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

  1. Wählen Sie im Navigationsbereich rechts oben die Option Testen aus.

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

    Screenshot of test panel with utterance highlighted

  3. Wählen Sie Überprüfen aus, um weitere Informationen zur Vorhersage anzuzeigen.

    Screenshot of test panel with inspection information

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

  1. Wählen Sie im linken Navigationsbereich Absichten aus.
  2. Klicken Sie auf Erstellen
  3. 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

  1. Wählen Sie im linken Navigationsmenü Entitäten aus.
  2. Klicken Sie auf Erstellen
  3. 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.

  1. Wählen Sie die Entität aus, die als Erstes bezeichnet werden soll.

    labelling an entity using the entity palette

  2. Markieren Sie den Text, den Sie mit dieser Entität bezeichnen möchten.

    label an entity using the entity palette

Inlinebezeichnung

  1. Markieren Sie den Text, den Sie bezeichnen möchten.

  2. Wählen Sie im daraufhin angezeigten Menü die Entität aus, mit der Sie den Text bezeichnen möchten.

    menu for label the text

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

  1. Navigieren Sie in Ihrer Anwendung zur Registerkarte Verwalten.

  2. Wählen Sie im linken Navigationsbereich die Option Azure-Ressourcen aus.

  3. Wählen Sie die Schaltfläche Vorhersageressource hinzufügen aus.

    Add Prediction resource from portal

    Wenn Sie bereits über eine Vorhersageressource verfügen, fügen Sie sie hinzu. Wählen Sie andernfalls Neue Vorhersageressource erstellen aus.

    Add Prediction resource from portal-2

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.

  1. Wählen Sie im Navigationsbereich rechts oben die Option Veröffentlichen aus.

    A screenshot of the button for publishing to the endpoint.

  2. Wählen Sie den Slot Produktion und anschließend Fertig aus.

    A screenshot of LUIS publishing to the endpoint.

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

    A screenshot of a message showing the app has been published.

Abfragen des V3-API-Vorhersageendpunkts

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

    example query in the prediction resources section

    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.

  1. 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=true
    • show-all-intents=true
  2. 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.

Nächste Schritte