Tutorial: Identificación de intenciones y entidades habitualesTutorial: Identify common intents and entities

En este tutorial, agregue intenciones y entidades creadas previamente a una aplicación de tutorial de recursos humanos para obtener de manera inmediata predicciones de intenciones y extracciones de datos.In this tutorial, add prebuilt intents and entities to a Human Resources tutorial app to quickly gain intent prediction and data extraction. No es necesario marcar ninguna expresión con entidades creadas previamente porque la entidad se detecta automáticamente.You do not need to mark any utterances with prebuilt entities because the entity is detected automatically.

Los modelos creados previamente (dominios, intenciones y entidades) ayudan a crear rápidamente el modelo.Prebuilt models (domains, intents, and entities) help you build your model quickly.

En este tutorial, aprenderá a:In this tutorial, you learn how to:

  • Crear nueva aplicaciónCreate new app
  • Agregar intenciones creadas previamenteAdd prebuilt intents
  • Agregar entidades creadas previamenteAdd prebuilt entities
  • TrainTrain
  • PublicarPublish
  • Obtener intenciones y entidades del punto de conexiónGet intents and entities from endpoint

Para este artículo, puede usar la cuenta de LUIS gratuita para crear la aplicación de LUIS.For this article, you can use the free LUIS account in order to author your LUIS application.

Creación de una nueva aplicaciónCreate a new app

  1. Inicie sesión en el portal de LUIS con la dirección URL https://www.luis.ai.Sign in to the LUIS portal with the URL of https://www.luis.ai.

  2. Seleccione Create new app (Crear nueva aplicación).Select Create new app.

    Captura de pantalla de la página My Apps (Mis aplicaciones) de Language Understanding (LUIS)Screenshot of Language Understanding (LUIS) My Apps page

  3. En el cuadro de diálogo emergente, escriba el nombre HumanResources y mantenga la referencia cultural predeterminada, English (Inglés).In the pop-up dialog, enter the name HumanResources and keep the default culture, English. Deje en blanco la descripción.Leave the description empty.

    Creación de una nueva aplicación LUIS de HumanResources

  4. Seleccione Listo.Select Done.

Incorporación de intenciones creadas previamente para ayudarle con las intenciones de usuario comunesAdd prebuilt intents to help with common user intentions

LUIS proporciona varias intenciones creadas previamente para ayudarle con las intenciones de usuario comunes.LUIS provides several prebuilt intents to help with common user intentions.

  1. Asegúrese de que la aplicación de recursos humanos se encuentra en la sección Build (Crear) de LUIS.Make sure your Human Resources app is in the Build section of LUIS. Para cambiar a esta sección, seleccione Build (Crear) en la barra de menús superior derecha.You can change to this section by selecting Build on the top, right menu bar.

  2. Haga clic en Add prebuilt domain intent (Agregar intención de dominio creado previamente).Select Add prebuilt domain intent.

  3. Busque Utilities.Search for Utilities.

    Captura de pantalla del cuadro de diálogo de intenciones creadas previamente con las utilidades en el cuadro de búsquedaScreenshot of prebuilt intents dialog with Utilities in the search box

  4. Seleccione las siguientes intenciones y haga clic en Done (Listo):Select the following intents and select Done:

    • Utilities.CancelUtilities.Cancel

    • Utilities.ConfirmUtilities.Confirm

    • Utilities.HelpUtilities.Help

    • Utilities.StartOverUtilities.StartOver

    • Utilities.StopUtilities.Stop

      Estas intenciones son útiles para determinar, en la conversación, dónde está el usuario y qué es lo que pide que se haga.These intents are helpful to determine where, in the conversation, the user is and what they are asking to do. En ellas se incluye el uso de entidades.These intents include usage of entities. En la aplicación LUIS se agregan automáticamente estas entidades: number, ordinal y Utilities.DirectionalReference.These entities are automatically added to the LUIS app: number, ordinal, and Utilities.DirectionalReference.

Incorporación de entidades creadas previamente para ayudarle con la extracción de tipos de datos habitualesAdd prebuilt entities to help with common data type extraction

LUIS proporciona varias entidades creadas previamente para la extracción de datos comunes.LUIS provides several prebuilt entities for common data extraction.

  1. Seleccione Entities (Entidades) en el menú de navegación izquierdo.Select Entities from the left navigation menu.

  2. Seleccione el botón Add prebuilt entity (Agregar entidad creada previamente).Select Add prebuilt entity button.

  3. Seleccione las siguientes entidades de la lista de entidades creadas previamente y, después, seleccione Done (Listo):Select the following entities from the list of prebuilt entities then select Done:

    • PersonNamePersonName

    • GeographyV2GeographyV2

      Captura de pantalla del cuadro de diálogo de la selección de número en entidades creadas previamente

      Estas entidades le ayudarán a incorporar el reconocimiento de nombres y lugares a la aplicación cliente.These entities will help you add name and place recognition to your client application.

Adición de expresiones de ejemplo a la intención NoneAdd example utterances to the None intent

La aplicación cliente debe saber si una expresión no es significativa o adecuada para la aplicación.The client application needs to know if an utterance is not meaningful or appropriate for the application. La intención None se agrega a cada aplicación como parte del proceso de creación para determinar si la aplicación cliente no puede responder a una expresión.The None intent is added to each application as part of the creation process to determine if an utterance can't be answered by the client application.

Si LUIS devuelve la intención None para una expresión, la aplicación cliente puede preguntar al usuario si quiere finalizar la conversación o dar más instrucciones para continuarla.If LUIS returns the None intent for an utterance, your client application can ask if the user wants to end the conversation or give more directions for continuing the conversation.

Precaución

No deje la intención None vacía.Do not leave the None intent empty.

  1. Seleccione Intents (Intenciones) en el panel izquierdo.Select Intents from the left panel.

  2. Seleccione la intención None.Select the None intent. Agregue tres expresiones que el usuario podría solicitar pero que no son pertinentes para la aplicación de recursos humanos:Add three utterances that your user might enter but are not relevant to your Human Resources app:

    Expresiones de ejemploExample utterances
    Barking dogs are annoying (Los perros que ladran son molestos)Barking dogs are annoying
    Order a pizza for me (Pídanme una pizza)Order a pizza for me
    Penguins in the ocean (Pingüinos en el océano)Penguins in the ocean

Entrenamiento de la aplicación para probar los cambios en la intenciónTrain the app so the changes to the intent can be tested

  1. En la parte superior derecha del sitio web de LUIS, haga clic en el botón Entrenar.In the top right side of the LUIS website, select the Train button.

    Botón Train (Entrenar)

  2. El entrenamiento se completa cuando ve la barra de estado verde en la parte superior del sitio web que confirma que se ha realizado correctamente.Training is complete when you see the green status bar at the top of the website confirming success.

    Barra de estado que indica que el entrenamiento se realizó

Publicación de la aplicación para que se pueda consultar al modelo entrenado desde el punto de conexiónPublish the app so the trained model is queryable from the endpoint

Para recibir una predicción de LUIS en un bot de chat u otra aplicación cliente, tiene que publicar la aplicación en el punto de conexión.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. Seleccione Publish (Publicar) en el panel de navegación superior derecho.Select Publish in the top right navigation.

    Botón de publicación en el punto de conexión de LUIS del menú superior derecho

  2. Seleccione el espacio Production (Producción) y haga clic en el botón Publish (Publicar).Select the Production slot and the Publish button.

    Publicación en el punto de conexión de LUIS

  3. La publicación se completa cuando ve la barra de estado verde en la parte superior del sitio web que confirma que se ha realizado correctamente.Publishing is complete when you see the green status bar at the top of the website confirming success.

    Publicación en el punto de conexión de LUIS

  4. Seleccione el vínculo endpoints (puntos de conexión) en la barra de estado verde para ir a la página Keys and endpoints (Claves y puntos de conexión).Select the endpoints link in the green status bar to go to the Keys and endpoints page. Las direcciones URL de los puntos de conexión se muestran en la parte inferior.The endpoint URLs are listed at the bottom.

Obtención de intención y predicción de entidad desde el punto de conexiónGet intent and entity prediction from endpoint

  1. En la sección Manage (Administrar) del menú superior derecho, en la página Keys and endpoints (Claves y puntos de conexión) del menú de la izquierda, seleccione la URL del punto de conexión al final de la página.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. Esta acción abre otra pestaña del explorador con la dirección URL del punto de conexión en la barra de direcciones.This action opens another browser tab with the endpoint URL in the address bar.

    La dirección URL del punto de conexión es similar a 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. Vaya al final de la dirección URL en la barra de direcciones del explorador y escriba I want to cancel my trip to Seattle to see Bob Smith.Go to the end of the URL in the browser address bar and enter I want to cancel my trip to Seattle to see Bob Smith. El último parámetro de la cadena de consulta es q, la expresión query.The last query string parameter is q, the utterance query.

    {
      "query": "I want to cancel my trip to Seattle to see Bob Smith",
      "topScoringIntent": {
        "intent": "Utilities.Cancel",
        "score": 0.807676256
      },
      "intents": [
        {
          "intent": "Utilities.Cancel",
          "score": 0.807676256
        },
        {
          "intent": "Utilities.StartOver",
          "score": 0.0487322025
        },
        {
          "intent": "Utilities.Help",
          "score": 0.0208660364
        },
        {
          "intent": "None",
          "score": 0.008789532
        },
        {
          "intent": "Utilities.Stop",
          "score": 0.006929268
        },
        {
          "intent": "Utilities.Confirm",
          "score": 0.00136293867
        }
      ],
      "entities": [
        {
          "entity": "seattle",
          "type": "builtin.geographyV2.city",
          "startIndex": 28,
          "endIndex": 34
        },
        {
          "entity": "bob smith",
          "type": "builtin.personName",
          "startIndex": 43,
          "endIndex": 51
        }
      ]
    }
    

    El resultado predijo la intención Utilities.Cancel con una confianza del 80 % y extrajo los datos de nombre de ciudad y de persona.The result predicted the Utilities.Cancel intent with 80% confidence and extracted the city and person name data.

Limpieza de recursosClean up resources

Cuando ya no sea necesaria, elimine la aplicación de LUIS.When no longer needed, delete the LUIS app. Para hacerlo, seleccione My apps (Mis aplicaciones) en el menú superior izquierdo.To do so, select My apps from the top left menu. Seleccione los puntos suspensivos (...) a la derecha del nombre de la aplicación en la lista de aplicaciones y, después, seleccione Delete (Eliminar).Select the ellipsis (...) to the right of the app name in the app list, select Delete. En el cuadro de diálogo emergente Delete app? (¿Eliminar aplicación?), haga clic en Ok (Aceptar).On the pop-up dialog Delete app?, select Ok.

Más información sobre los modelos creados previamente:Learn more about prebuilt models:

  • Dominios creados previamente: estos son dominios comunes que reducen la creación general de aplicaciones de LUISPrebuilt domains: these are common domains that reduce overall LUIS app authoring
  • Intenciones creadas previamente: estas son las intenciones individuales de los dominios comunes.Prebuilt intents: these are the individual intents of the common domains. Puede agregar intenciones individualmente en lugar de agregar todo el dominio.You can add intents individually instead of adding the entire domain.
  • Entidades creadas previamente: estas resultan tipos de datos comunes útiles para la mayoría de aplicaciones de LUIS.Prebuilt entities: these are common data types useful to most LUIS apps.

Más información acerca del trabajo con la aplicación de LUIS:Learn more about working with your LUIS app:

Pasos siguientesNext steps

Al agregar intenciones y entidades creadas previamente, la aplicación cliente puede establecer las intenciones comunes de los usuarios y extraer tipos de datos comunes.By adding prebuilt intents and entities, the client application can determine common user intentions and extract common datatypes.