Tutorial: 7.Tutorial: 7. 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 auf Build klicken.You can change to this section by selecting Build on the top, right menu bar.

    Screenshot: LUIS-App mit hervorgehobener Build-Option (rechts oben auf der Navigationsleiste) Screenshot of LUIS app with Build hightlighted in top, right navigation 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

Die neue keyphrase-Version der App muss trainiert werden.The new keyphrase version of the app needs to be trained.

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

    Trainieren der App

  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.

    Training erfolgreich

Veröffentlichen der App im EndpunktPublish app to endpoint

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

  2. Wählen Sie den Produktionsslot aus, und klicken Sie auf die Schaltfläche Publish (Veröffentlichen).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. Klicken Sie unten auf der Seite Veröffentlichen auf den Link Endpunkt.On the Publish page, select the endpoint link at the bottom of the page. Dadurch 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.

    Screenshot der Seite „Veröffentlichen“ mit hervorgehobener Endpunkt-URL

  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 im Menü oben links die Option Meine Apps.Select My apps in the top left menu. Klicken Sie in der Liste rechts vom App-Namen auf die drei Punkte (...) und anschließend auf Löschen.Select the three dot menu (...) to the right of the app name in the app list, select Delete. Klicken Sie im Popupdialogfenster Delete app? (App löschen?) auf OK.On the pop-up dialog Delete app?, select Ok.

Nächste SchritteNext steps