Tutorial: 8.Tutorial: 8. Hinzufügen der keyPhrase-EntitätAdd keyPhrase entity

In diesem Tutorial verwenden Sie eine App, die veranschaulicht, wie Sie Schlüsselinhalte aus Äußerungen extrahieren.In this tutorial, use an app that demonstrates how to extract key subject matter from utterances.

  • Grundlegendes zu keyPhrase-EntitätenUnderstand keyPhrase entities
  • Verwenden der LUIS-App im PersonalbereichUse LUIS app in Human Resources (HR) domain
  • Hinzufügen der keyPhrase-Entität zum Extrahieren von Schlüsselinhalten aus einer ÄußerungAdd keyPhrase entity to extract content from utterance
  • Trainieren und Veröffentlichen der AppTrain, and publish app
  • Abfragen des App-Endpunkts zum Anzeigen der LUIS-JSON-Antwort (einschließlich Schlüsselbegriffen)Query endpoint of app to see LUIS JSON response including key phrases

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.

VoraussetzungenBefore you begin

Falls Sie nicht über die Personal-App aus dem Tutorial zur einfachen Entität verfügen, importieren Sie den JSON-Code in eine neue App (auf der LUIS-Website).If you don't have the Human Resources app from the simple entity tutorial, import the JSON into a new app in the LUIS website. Die zu importierende App befindet sich im GitHub-Repository LUIS-Samples.The app to import is found in the LUIS-Samples Github repository.

Wenn Sie die ursprüngliche Personal-App behalten möchten, klonen Sie die Version auf der Seite Einstellungen, und nennen Sie sie keyphrase.If you want to keep the original Human Resources app, clone the version on the Settings page, and name it keyphrase. 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.

keyPhrase-EntitätsextraktionkeyPhrase entity extraction

Schlüsselinhalte werden von der vordefinierten Entität keyPhrase bereitgestellt.Key subject matter is provided by the prebuilt entity, keyPhrase. Diese Entität gibt Schlüsselinhalte aus der Äußerung zurück.This entity returns key subject matter in the utterance.

Die folgenden Äußerungen sind Beispiele für Schlüsselbegriffe:The following utterances show examples of key phrases:

ÄußerungUtterance keyPhrase-EntitätswertekeyPhrase entity values
Is there a new medical plan with a lower deductible offered next year? (Gibt es nächstes Jahr eine neue Krankenversicherung mit einem niedrigeren Selbstbehalt?)Is there a new medical plan with a lower deductible offered next year? „lower deductible“ (niedrigeren Selbstbehalt)"lower deductible"
„new medical plan“ (neue Krankenversicherung)"new medical plan"
„year“ (Jahr)"year"
Is vision therapy covered in the high deductible medical plan? (Ist Visionstherapie in der Krankenversicherung mit hohem Selbstbehalt abgedeckt?)Is vision therapy covered in the high deductible medical plan? „high deductible medical plan“ (Krankenversicherung mit hohem Selbstbehalt)"high deductible medical plan"
„vision therapy“ (Visionstherapie)"vision therapy"

Ihre Clientanwendung kann diese Werte zusammen mit anderen extrahierten Entitäten verwenden, um zu entscheiden, wie es in dem Gespräch weitergehen soll.Your client application can use these values, along with other extracted entities, to decide the next step in the conversation.

Hinzufügen der keyPhrase-EntitätAdd keyPhrase entity

Fügen Sie die vordefinierte keyPhrase-Entität hinzu, um Schlüsselinhalte aus Äußerungen zu extrahieren.Add keyPhrase prebuilt entity to extract subject matter from utterances.

  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 im linken Menü die Option Entitäten.Select Entities from the left menu.

    Screenshot mit hervorgehobener Option „Entitäten“ im linken Navigationsbereich des Abschnitts „Erstellen“ Screenshot of Entities highlighted in left nav of Build section

  3. Klicken Sie auf Manage prebuilt entities (Vordefinierte Entitäten verwalten).Select Manage prebuilt entities.

    Screenshot des Popupdialogfensters mit der Liste der Entitäten Screenshot of Entities list pop-up dialog

  4. Klicken Sie im Popupdialogfenster auf keyPhrase und anschließend auf Fertig.In the pop-up dialog, Select keyPhrase, then select Done.

    Screenshot des Popupdialogfensters mit der Liste der Entitäten Screenshot of Entities list pop-up dialog

  5. Klicken Sie im linken Menü auf Absichten, und wählen Sie die Absicht Utilities.Confirm aus.Select Intents from the left menu, then select the Utilities.Confirm intent. Die keyPhrase-Entität ist in mehreren Äußerungen gekennzeichnet.The keyPhrase entity is labeled in several utterances.

    Screenshot: Absicht „Utilities.Confirm“ mit keyPhrases-Kennzeichnung in Äußerungen Screenshot of Utilities.Confirm intent with keyPhrases labeled in utterances

Trainieren der LUIS-AppTrain the LUIS app

  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öffentlichen der App im EndpunktPublish app to endpoint

Damit Sie eine LUIS-Vorhersage in einem Chatbot oder einer anderen Anwendung abrufen können, muss die App veröffentlicht werden.In order to get a LUIS prediction in a chatbot or other application, you need to publish the app.

Vor dem Veröffentlichen oder dem Testen der Endpunkt-URL müssen Sie keinen LUIS-Endpunktschlüssel im Azure-Portal erstellen.You do not have to create a LUIS endpoint key in the Azure portal before you publish or before you test the endpoint URL. Jede LUIS-App verfügt über einen kostenlosen Startschlüssel für die Erstellung.Every LUIS app has a free starter key for authoring. Dieser ermöglicht das unbegrenzte Erstellen und eine geringe Anzahl an Endpunkttreffern.It gives you unlimited authoring and a few endpoint hits.

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

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

  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.

Abfragen des Endpunkts mit einer ÄußerungQuery the endpoint with an utterance

  1. Wählen Sie unten auf der Seite Publish (Veröffentlichen) den Link endpoint (Endpunkt) aus.On the Publish page, select the endpoint link at the bottom of the page. Hierdurch wird ein weiteres Browserfenster mit der Endpunkt-URL in der Adressleiste geöffnet.This action opens another browser window with the endpoint URL in the address bar.

  2. Geben Sie in der Adressleiste am Ende der URL does form hrf-123456 cover the new dental benefits and medical plan ein.Go to the end of the URL in the address and enter does form hrf-123456 cover the new dental benefits and medical plan. Der letzte Parameter der Abfragezeichenfolge lautet q (für die Abfrage (query) der Äußerung).The last querystring parameter is q, the utterance query.

{
  "query": "does form hrf-123456 cover the new dental benefits and medical plan",
  "topScoringIntent": {
    "intent": "FindForm",
    "score": 0.9300641
  },
  "intents": [
    {
      "intent": "FindForm",
      "score": 0.9300641
    },
    {
      "intent": "ApplyForJob",
      "score": 0.0359598845
    },
    {
      "intent": "GetJobInformation",
      "score": 0.0141798034
    },
    {
      "intent": "MoveEmployee",
      "score": 0.0112197418
    },
    {
      "intent": "Utilities.StartOver",
      "score": 0.00507669244
    },
    {
      "intent": "None",
      "score": 0.00238501839
    },
    {
      "intent": "Utilities.Help",
      "score": 0.00202810857
    },
    {
      "intent": "Utilities.Stop",
      "score": 0.00102957746
    },
    {
      "intent": "Utilities.Cancel",
      "score": 0.0008688423
    },
    {
      "intent": "Utilities.Confirm",
      "score": 3.557994E-05
    }
  ],
  "entities": [
    {
      "entity": "hrf-123456",
      "type": "HRF-number",git 
      "startIndex": 10,
      "endIndex": 19
    },
    {
      "entity": "new dental benefits",
      "type": "builtin.keyPhrase",
      "startIndex": 31,
      "endIndex": 49
    },
    {
      "entity": "medical plan",
      "type": "builtin.keyPhrase",
      "startIndex": 55,
      "endIndex": 66
    },
    {
      "entity": "hrf",
      "type": "builtin.keyPhrase",
      "startIndex": 10,
      "endIndex": 12
    },
    {
      "entity": "-123456",
      "type": "builtin.number",
      "startIndex": 13,
      "endIndex": 19,
      "resolution": {
        "value": "-123456"
      }
    }
  ]
}

Bei der Suche nach einem Formular hat der Benutzer mehr Informationen angegeben als erforderlich.While searching for a form, the user provided more information than was necessary to find the form. Die zusätzlichen Informationen werden als builtin.keyPhrase zurückgegeben.The additional information is returned as builtin.keyPhrase. Die Clientanwendung kann diese zusätzlichen Informationen für Folgefragen nutzen (Beispiel: Möchten Sie mit einem Mitarbeiter der Personalabteilung über Zahnarztleistungen unterhalten?) oder ein Menü mit weiteren Optionen anzeigen (einschließlich einer Option für weitere Informationen zu Zahnarztleistungen oder zur medizinischen Versorgung).The client application can use this additional information for a follow-up question, such as "Would you like to talk to a Human Resource representative about new dental benefits" or provide a menu with more options including "More information about new dental benefits or medical plan."

Was wurde mit dieser LUIS-App erreicht?What has this LUIS app accomplished?

Diese App mit keyPhrase-Entitätserkennung hat eine Abfrageabsicht in natürlicher Sprache ermittelt und die extrahierten Daten sowie den Hauptschlüsselinhalt zurückgegeben.This app, with keyPhrase entity detection, identified a natural language query intention and returned the extracted data including the main subject matter.

Ihr Chatbot verfügt nun über ausreichend Informationen, um den nächsten Schritt in der Unterhaltung zu bestimmen.Your chatbot now has enough information to determine the next step in the conversation.

Wo werden diese LUIS-Daten verwendet?Where is this LUIS data used?

Für LUIS ist diese Anforderung abgeschlossen.LUIS is done with this request. Die aufrufende Anwendung (etwa ein Chatbot) kann das Ergebnis für „topScoringIntent“ und die keyPhrase-Daten aus der Äußerung verwenden, um den nächsten Schritt auszuführen.The calling application, such as a chatbot, can take the topScoringIntent result and the keyPhrase data from the utterance to take the next step. LUIS führt diese programmgesteuerte Aufgabe nicht für den Bot oder die aufrufende Anwendung aus.LUIS doesn't do that programmatic work for the bot or calling application. LUIS bestimmt lediglich die Absicht des Benutzers.LUIS only determines what the user's intention is.

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