Tutorial 2: Identifizieren häufiger Absichten und EntitätenTutorial 2: Identify common intents and entities

In diesem Tutorial ändern Sie die Personal-App.In this tutorial, modify the Human Resources app. Fügen Sie der Personal-App aus dem Tutorial vordefinierte Absichten und Entitäten hinzu, um schnell Absichtsvorhersagen und extrahierte Daten zu erhalten.Add prebuilt intents and entities to the Human Resources tutorial app to quickly gain intent prediction and data extraction. Sie müssen Äußerungen nicht mit vordefinierten Entitäten bezeichnen, da die Entität automatisch erkannt wird.You do not need to label any utterances with prebuilt entities because the entity is detected automatically.

Vordefinierte Modelle allgemeiner Themendomänen und Datentypen unterstützen Sie beim schnellen Erstellen Ihres Modells und dienen als Beispiele für das Aussehen eines Modells.Prebuilt models of common subject domains and data types help you build your model quickly as well as provide an example of what a model looks like.

In diesem Tutorial lernen Sie Folgendes:In this tutorial, you learn how to:

  • Verwenden der vorhandenen Tutorial-AppUse existing tutorial app
  • Hinzufügen vordefinierter AbsichtenAdd prebuilt intents
  • Hinzufügen vordefinierter EntitätenAdd prebuilt entities
  • TrainierenTrain
  • VeröffentlichenPublish
  • Abrufen von Absichten und Entitäten vom EndpunktGet intents and entities from endpoint

Für diesen Artikel können Sie das kostenlose LUIS-Konto für die Erstellung Ihrer LUIS-Anwendung verwenden.For this article, you can use the free LUIS account in order to author your LUIS application.

Verwenden der vorhandenen AppUse existing app

Fahren Sie mit der im letzten Tutorial erstellten App mit dem Namen HumanResources fort.Continue with the app created in the last tutorial, named HumanResources.

Wenn Sie nicht über die HumanResources-App aus dem vorhergehenden Tutorial verfügen, befolgen Sie diese Schritte:If you do not have the HumanResources app from the previous tutorial, use the following steps:

  1. Laden Sie die App-JSON-Datei herunter, und speichern Sie sie.Download and save app JSON file.

  2. Importieren Sie den JSON-Code in eine neue App.Import the JSON into a new app.

  3. Klonen Sie die Version von der Registerkarte Versionen aus dem Abschnitt Verwalten, und geben Sie ihr den Namen prebuilts.From the Manage section, on the Versions tab, clone the version, and name it prebuilts. Durch Klonen können Sie ohne Auswirkungen auf die ursprüngliche Version mit verschiedenen Features von LUIS experimentieren.Cloning is a great way to play with various LUIS features without affecting the original version. Da der Versionsname als Teil der URL-Route verwendet wird, darf er keine Zeichen enthalten, die in einer URL ungültig sind.Because the version name is used as part of the URL route, the name can't contain any characters that are not valid in a URL.

Hinzufügen vordefinierter AbsichtenAdd prebuilt intents

LUIS enthält mehrere vordefinierte Absichten für allgemeine Benutzerabsichten.LUIS provides several prebuilt intents to help with common user intentions.

  1. Vergewissern Sie sich, dass sich Ihre Personal-App im LUIS-Abschnitt Build befindet.Make sure your Human Resources app is in the Build section of LUIS. Zu diesem Abschnitt gelangen Sie, indem Sie rechts oben auf der Menüleiste Build auswählen.You can change to this section by selecting Build on the top, right menu bar.

  2. Wählen Sie Add prebuilt intent (Vordefinierte Absicht hinzufügen) aus.Select Add prebuilt intent.

  3. Suchen Sie nach Utilities.Search for Utilities.

    Screenshot des Dialogfelds zum Hinzufügen vordefinierter Absichten mit eingegebenem Suchbegriff „Utilities“ Screenshot of prebuilt intents dialog with Utilities in the search box

  4. Wählen Sie die folgenden Absichten und dann Fertig aus:Select the following intents and select Done:

    • Utilities.CancelUtilities.Cancel
    • Utilities.ConfirmUtilities.Confirm
    • Utilities.HelpUtilities.Help
    • Utilities.StartOverUtilities.StartOver
    • Utilities.StopUtilities.Stop

Hinzufügen vordefinierter EntitätenAdd prebuilt entities

LUIS enthält mehrere vordefinierte Entitäten für das Extrahieren allgemeiner Daten.LUIS provides several prebuilt entities for common data extraction.

  1. Wählen Sie im linken Navigationsmenü die Option Entities (Entitäten) aus.Select Entities from the left navigation menu.

  2. Wählen Sie die Schaltfläche Manage prebuilt entity (Vordefinierte Entität verwalten) aus.Select Manage prebuilt entity button.

  3. Wählen Sie in der Liste mit den vordefinierten Entitäten number und datetimeV2 und danach Fertig aus.Select number and datetimeV2 from the list of prebuilt entities then select Done.

    Screenshot: Auswahl von „number“ im Dialogfeld mit den vordefinierten Entitäten

TrainierenTrain

  1. Wählen Sie oben rechts auf der LUIS-Website die Schaltfläche Train (Trainieren) aus.In the top right side of the LUIS website, select the Train button.

    Schaltfläche „Train“ (Trainieren)

  2. Das Training ist abgeschlossen, wenn oben auf der Website die grüne Statusleiste angezeigt wird.Training is complete when you see the green status bar at the top of the website confirming success.

    Statusleiste bei abgeschlossenem Training

VeröffentlichenPublish

Damit Sie eine LUIS-Vorhersage in einem Chatbot oder einer anderen Clientanwendung empfangen können, muss die App im Endpunkt veröffentlicht werden.In order to receive a LUIS prediction in a chat bot or other client application, you need to publish the app to the endpoint.

  1. Klicken Sie im Navigationsbereich oben rechts auf Veröffentlichen.Select Publish in the top right navigation.

    Schaltfläche für das Veröffentlichen von LUIS im Endpunkt im Menü oben rechts

  2. Wählen Sie den Produktionsslot und dann die Schaltfläche Veröffentlichen aus.Select the Production slot and the Publish button.

    Veröffentlichen von LUIS im Endpunkt

  3. Die Veröffentlichung ist abgeschlossen, wenn oben auf der Website die grüne Statusleiste angezeigt wird.Publishing is complete when you see the green status bar at the top of the website confirming success.

    Veröffentlichen von LUIS im Endpunkt

  4. Wählen Sie den Link Endpunkte in der grünen Statusleiste aus, um zur Seite Schlüssel und Endpunkte zu wechseln.Select the endpoints link in the green status bar to go to the Keys and endpoints page. Die Endpunkt-URLs sind unten aufgeführt.The endpoint URLs are listed at the bottom.

Abrufen von Absicht und Entitäten von einem EndpunktGet intent and entities from endpoint

  1. Wählen Sie auf der Seite Schlüssel und Endpunkte (linkes Menü) im Abschnitt Verwalten (Menü oben rechts) die Endpunkt-URL unten auf der Seite aus.In the Manage section (top right menu), on the Keys and endpoints page (left menu), select the endpoint URL at the bottom of the page. Hierdurch wird eine weitere Browserregisterkarte mit der Endpunkt-URL in der Adressleiste geöffnet.This action opens another browser tab with the endpoint URL in the address bar.

    Die Endpunkt-URL sieht etwa so aus: https://<region>.api.cognitive.microsoft.com/luis/v2.0/apps/<appID>?verbose=true&subscription-key=<YOUR_KEY>&<optional-name-value-pairs>&q=<user-utterance-text>.The endpoint URL looks like https://<region>.api.cognitive.microsoft.com/luis/v2.0/apps/<appID>?verbose=true&subscription-key=<YOUR_KEY>&<optional-name-value-pairs>&q=<user-utterance-text>.

  2. Wechseln Sie an das Ende der URL in der Adressleiste des Browsers, und geben Sie I want to cancel on March 3 ein.Go to the end of the URL in the browser address bar and enter I want to cancel on March 3. Der letzte Parameter der Abfragezeichenfolge lautet q (für die Abfrage (query) der Äußerung).The last query string parameter is q, the utterance query.

    {
      "query": "I want to cancel on March 3",
      "topScoringIntent": {
        "intent": "Utilities.Cancel",
        "score": 0.7818295
      },
      "intents": [
        {
          "intent": "Utilities.Cancel",
          "score": 0.7818295
        },
        {
          "intent": "ApplyForJob",
          "score": 0.0237864349
        },
        {
          "intent": "GetJobInformation",
          "score": 0.017576348
        },
        {
          "intent": "Utilities.StartOver",
          "score": 0.0130122062
        },
        {
          "intent": "Utilities.Help",
          "score": 0.006731322
        },
        {
          "intent": "None",
          "score": 0.00524190161
        },
        {
          "intent": "Utilities.Stop",
          "score": 0.004912514
        },
        {
          "intent": "Utilities.Confirm",
          "score": 0.00092950504
        }
      ],
      "entities": [
        {
          "entity": "march 3",
          "type": "builtin.datetimeV2.date",
          "startIndex": 20,
          "endIndex": 26,
          "resolution": {
            "values": [
              {
                "timex": "XXXX-03-03",
                "type": "date",
                "value": "2018-03-03"
              },
              {
                "timex": "XXXX-03-03",
                "type": "date",
                "value": "2019-03-03"
              }
            ]
          }
        },
        {
          "entity": "3",
          "type": "builtin.number",
          "startIndex": 26,
          "endIndex": 26,
          "resolution": {
            "value": "3"
          }
        }
      ]
    }
    

    Das Ergebnis hat die Absicht „Utilities.Cancel“ vorhergesagt und als Datum den 3. März und die Zahl 3 extrahiert.The result predicted the Utilities.Cancel intent and extracted the date of March 3 and the number 3.

    Es sind zwei Werte für den 3. März vorhanden, da die Äußerung keine Angaben dazu enthielt, ob der 3. März in der Vergangenheit oder in der Zukunft liegt.There are two values for March 3 because the utterance didn't state if March 3 is in the past or in the future. Es ist Aufgabe der Clientanwendung, eine Annahme zu treffen oder nachzufragen, falls dies erforderlich ist.It is up to the client application to make an assumption or ask for clarification, if that is needed.

Bereinigen von RessourcenClean up resources

Löschen Sie die LUIS-App, falls Sie sie nicht mehr benötigen.When no longer needed, delete the LUIS app. Wählen Sie hierzu im Menü oben links die Option Meine Apps.To do so, select My apps from the top left menu. Klicken Sie in der Liste rechts vom App-Namen auf die Auslassungspunkte (...) und anschließend auf Löschen.Select the ellipsis (...) to the right of the app name in the app list, select Delete. Wählen Sie im Popupdialogfenster Delete App? (App löschen?) OK aus.On the pop-up dialog Delete app?, select Ok.

Nächste SchritteNext steps

Durch das Hinzufügen vordefinierter Absichten und Entitäten kann die Clientanwendung allgemeine Benutzerabsichten bestimmen und allgemeine Datentypen extrahieren.By adding prebuilt intents and entities, the client application can determine common user intentions and extract common datatypes.