Inicio rápido: Reconocimiento del lenguaje conversacional

Requisitos previos

• Una suscripción a Azure: cree una cuenta gratuita.

Inicio de sesión en Language Studio

1. Vaya a Language Studio e inicie sesión con su cuenta de Azure.

2. En la ventana Choose a language resource (Elección de recurso de idioma) que aparece, busque la suscripción de Azure y elija el recurso de idioma. Si no tiene un recursos, puede crearlo.

   Detalles de la instancia	Valor requerido
   Suscripción de Azure	Su suscripción de Azure.
   Grupo de recursos de Azure	Nombre de su grupo de recursos de Azure.
   Nombre de recurso de Azure	Nombre de su recurso de Azure.
   Location	Una de las regiones admitidas para el recurso de lenguaje. Por ejemplo, "Oeste de EE. UU. 2".
   Plan de tarifa	Uno de los planes de tarifa válidos para el recurso de lenguaje. Puede usar el nivel de servicio Gratis (F0) para probar el servicio.

   

Creación de un proyecto de reconocimiento del lenguaje conversacional

Cuando tenga un recurso de idioma seleccionado, cree un proyecto de reconocimiento del lenguaje conversacional. Un proyecto es un área de trabajo para compilar modelos de Machine Learning personalizados basados en los datos. A su proyecto solo puede acceder usted y otros usuarios que tengan acceso al recurso de idioma que se usa.

Para este inicio rápido, puede descargar este proyecto de ejemplo e importarlo. Este proyecto puede predecir los comandos previstos de la entrada del usuario, como: leer correos electrónicos, eliminar correos electrónicos y adjuntar un documento a un correo electrónico.

1. En la sección Descripción de preguntas y lenguaje conversacional de Language Studio, seleccione Reconocimiento del lenguaje conversacional.

   

2. Esto lo llevará a la página Proyectos de reconocimiento del lenguaje conversacional. Junto al botón Crear nuevo proyecto, seleccione Importar.

   

3. En la ventana que aparece, cargue el archivo JSON que desea importar. Asegúrese de que el archivo sigue el formato JSON admitido.

Una vez completada la carga, llegará a la página Definición de esquema. En este inicio rápido, el esquema ya está compilado y las expresiones ya están etiquetadas con intenciones y entidades.

Entrenamiento de un modelo

Por lo general, después de crear un proyecto, debe compilar un esquema y expresiones de etiqueta. En este inicio rápido, ya importamos un proyecto listo con esquema compilado y expresiones etiquetadas.

Para entrenar un modelo, debe iniciar un trabajo de entrenamiento. La salida de un trabajo de entrenamiento correcto es el modelo entrenado.

Para empezar a entrenar el modelo desde Language Studio:

1. Seleccione Entrenar modelo en el menú de la izquierda.

2. Seleccione Iniciar un trabajo de entrenamiento en el menú superior.

3. Seleccione Entrenar un nuevo modelo y escriba el nombre del nuevo modelo en el cuadro de texto. De lo contrario, para reemplazar un modelo existente por un modelo entrenado en los nuevos datos, seleccione Sobrescribir un modelo existente y, a continuación, seleccione un modelo existente. La sobrescritura de un modelo entrenado es irreversible, pero no afectará a los modelos implementados hasta que implemente el nuevo modelo.

4. Seleccionar datos de entrenamiento. Puede elegir Entrenamiento estándar para un entrenamiento más rápido, pero solo está disponible para inglés. También puede elegir Formación avanzada compatible con otros idiomas y proyectos multilingües, pero implica tiempos de entrenamiento más largos. Más información sobre los modos de entrenamiento.

5. Seleccione un método de división de datos. Puede elegir Dividir automáticamente el conjunto de pruebas de los datos de entrenamiento, y el sistema dividirá las expresiones entre los conjuntos de entrenamiento y pruebas, según los porcentajes especificados. También puede usar una división manual de datos de entrenamiento y pruebas; esta opción solo se habilita si han agregado expresiones al conjunto de pruebas al etiquetar las expresiones.

6. Seleccione el botón Entrenar.

   

7. Seleccione el identificador del trabajo de entrenamiento de la lista. Aparecerá un panel en el que podrá comprobar el progreso del entrenamiento, el estado del trabajo y otros detalles de este trabajo.

   Nota

   • Los trabajos de entrenamiento completados correctamente serán los únicos que generarán modelos.
   • El entrenamiento puede durar entre un par de minutos y un par de horas en función del número de expresiones.
   • Solo puede haber un trabajo de entrenamiento ejecutándose en un momento dado. No se pueden iniciar otros trabajos de entrenamiento dentro del mismo proyecto hasta que se complete el trabajo en ejecución.
   • El aprendizaje automático que se usa para entrenar modelos se actualiza periódicamente. Para entrenar en una versión de configuración anterior, seleccione Seleccione aquí para cambiar en la página Iniciar un trabajo de entrenamiento y elija una versión anterior.

Implementación del modelo

Por lo general, después de entrenar un modelo, revisaría sus detalles de evaluación. En este inicio rápido, solo implementará el modelo y lo tendrá disponible para probarlo en Language Studio, o bien puede llamar a la API de predicción.

Para implementar el modelo desde Language Studio:

1. Seleccione Implementación de un modelo en el menú de la izquierda.

2. Seleccione Agregar implementación para iniciar el asistente Agregar implementación.

   

3. Seleccione Crear un nuevo nombre de implementación para crear una nueva implementación y asignar un modelo entrenado de la lista desplegable siguiente. De lo contrario, puede seleccionar Sobrescribir un nombre de implementación existente para reemplazar eficazmente el modelo usado por una implementación existente.

   Nota:

   La sobrescritura de una implementación existente no requiere cambios en la llamada de la API de predicción, pero los resultados que obtendrá se basarán en el modelo recién asignado.

   

4. Seleccione un modelo entrenado de la lista desplegable Modelo.

5. Seleccione Implementar para iniciar el trabajo de implementación.

6. Después de que la implementación se realice correctamente, aparecerá una fecha de expiración junto a ella. La expiración de la implementación aparece cuando el modelo implementado deja de estar disponible para usarlo en la predicción, lo que suele ocurrir doce meses después de que expire una configuración de entrenamiento.

Comprobación del modelo implementado

Para comprobar los modelos implementados desde Language Studio:

1. Seleccione Prueba de implementaciones en el menú lateral izquierdo.

2. En proyectos multilingües, en la lista desplegable Seleccione el lenguaje de texto, seleccione el lenguaje que esté probando de la expresión.

3. En la lista desplegable Nombre de implementación, seleccione el nombre de implementación correspondiente al modelo que desee probar. Solo se pueden probar modelos que estén asignados a implementaciones.

4. En el cuadro de texto, escriba una expresión que se va a probar. Por ejemplo, si ha creado una aplicación para expresiones relacionadas con el correo electrónico, puede escribir Eliminar este correo electrónico.

5. En la parte superior de la página, seleccione Ejecutar la prueba.

6. Después de ejecutar la prueba, debería ver la respuesta del modelo en el resultado. Puede ver los resultados en la vista de tarjetas de entidades o verlo en formato JSON.

Limpieza de recursos

Cuando ya no necesite el proyecto, puede eliminarlo mediante Language Studio. Seleccione Projectos del menú de navegación izquierdo, seleccione el proyecto que quiera eliminar y, a continuación, seleccione Eliminar en el menú superior.

Requisitos previos

• Una suscripción a Azure: cree una cuenta gratuita.

Creación de un nuevo recurso en Azure Portal

1. Inicie sesión en Azure Portal y cree un recurso de Lenguaje de Azure AI.

2. Seleccione Crear un nuevo recurso

3. En la ventana que se abre, busque Servicio de idioma.

4. Seleccione Crear

5. Cree un recurso de idioma con los detalles siguientes.

   Detalles de la instancia	Valor obligatorio
   Region	Una de las regiones admitidas para el recurso de lenguaje.
   Nombre	Nombre requerido para su recurso lingüístico
   Plan de tarifa	Uno de los planes de tarifa admitidos para el recurso de lenguaje.

Obtención del punto de conexión y las claves del recurso

1. Vaya a la página de información general del recurso en Azure Portal.

2. En el menú de la izquierda, seleccione Claves y punto de conexión. Usará el punto de conexión y la clave para las solicitudes de API.

   

Importación de un nuevo proyecto de ejemplo de CLU

Una vez que tenga un recurso de idioma creado, cree un proyecto de reconocimiento del lenguaje conversacional. Un proyecto es un área de trabajo para compilar modelos de Machine Learning personalizados basados en los datos. A su proyecto solo puede acceder usted y otros usuarios que tengan acceso al recurso de idioma que se usa.

Para este inicio rápido, puede descargar este proyecto de ejemplo e importarlo. Este proyecto puede predecir los comandos previstos de la entrada del usuario, como: leer correos electrónicos, eliminar correos electrónicos y adjuntar un documento a un correo electrónico.

Desencadenamiento del trabajo del proyecto de importación

Envíe una solicitud POST con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para importar el proyecto.

URL de la solicitud

Use la siguiente dirección URL al crear la solicitud de API. Reemplace los valores de los marcadores de posición por sus propios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Body

El cuerpo JSON que envía es similar al ejemplo siguiente. Consulte la documentación de referencia para obtener más detalles sobre el objeto JSON.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

Tras una solicitud correcta, la respuesta de la API contendrá un encabezado operation-location con una dirección URL que puede usar para comprobar el estado del trabajo de importación. Tendrá el formato siguiente:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

Conocer el estado del trabajo de importación

Cuando se envía una solicitud de importación del proyecto correcta, la dirección URL de solicitud completa para comprobar el estado de la implementación del trabajo (incluido el punto de conexión, el nombre del proyecto y el id. de trabajo) se encuentra en el encabezado de respuesta operation-location.

Use la siguiente solicitud GET para consultar el estado del trabajo de importación. Puede usar la dirección URL que recibió en el paso anterior o reemplazar los valores de los marcadores de posición por sus propios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Response body

Una vez que envíe la solicitud, recibirá la siguiente respuesta. Siga sondeando este punto de conexión hasta que el parámetro status cambie a "succeeded".

{
  "jobId": "xxxxx-xxxxx-xxxx-xxxxx",
  "createdDateTime": "2022-04-18T15:17:20Z",
  "lastUpdatedDateTime": "2022-04-18T15:17:22Z",
  "expirationDateTime": "2022-04-25T15:17:20Z",
  "status": "succeeded"
}

Inicio del entrenamiento del modelo

Por lo general, después de crear un proyecto, debe compilar expresiones de esquema y etiqueta. En este inicio rápido, ya importamos un proyecto listo con esquema compilado y expresiones etiquetadas.

Cree una solicitud POST mediante la dirección URL, los encabezados y el cuerpo JSON para enviar un trabajo de entrenamiento.

URL de la solicitud

Use la siguiente dirección URL al crear la solicitud de API. Reemplace los valores de los marcadores de posición por sus propios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:train?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Cuerpo de la solicitud

Use el siguiente objeto en la solicitud. El nombre del modelo será el mismo que use para el parámetro modelLabel una vez completado el entrenamiento.

{
  "modelLabel": "{MODEL-NAME}",
  "trainingMode": "{TRAINING-MODE}",
  "trainingConfigVersion": "{CONFIG-VERSION}",
  "evaluationOptions": {
    "kind": "percentage",
    "testingSplitPercentage": 20,
    "trainingSplitPercentage": 80
  }
}

Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que se ha realizado correctamente. En los encabezados de respuesta, extraiga el valor operation-location. Tendrá el formato siguiente:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}

Puede usar esta dirección URL para obtener el estado del trabajo de entrenamiento.

Conocer el estado del trabajo de entrenamiento

El entrenamiento puede tardar tiempo en completarse, a veces entre 10 y 30 minutos. Puede usar la siguiente solicitud para mantener el sondeo del estado del trabajo de entrenamiento hasta que se complete correctamente.

Cuando se envía una solicitud de entrenamiento correcta, la dirección URL de solicitud completa para comprobar el estado del trabajo (incluido el punto de conexión, el nombre del proyecto y el id. de trabajo) se encuentra en el encabezado de respuesta operation-location.

Use la siguiente solicitud GET para obtener el estado del proceso de entrenamiento del modelo. Reemplace los valores de los marcadores de posición por sus propios valores.

URL de la solicitud

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Cuerpo de la respuesta

Una vez que envíe la solicitud, recibirá la siguiente respuesta. Siga sondeando este punto de conexión hasta que el parámetro status cambie a "succeeded".

{
  "result": {
    "modelLabel": "{MODEL-LABEL}",
    "trainingConfigVersion": "{TRAINING-CONFIG-VERSION}",
    "trainingMode": "{TRAINING-MODE}",
    "estimatedEndDateTime": "2022-04-18T15:47:58.8190649Z",
    "trainingStatus": {
      "percentComplete": 3,
      "startDateTime": "2022-04-18T15:45:06.8190649Z",
      "status": "running"
    },
    "evaluationStatus": {
      "percentComplete": 0,
      "status": "notStarted"
    }
  },
  "jobId": "xxxxx-xxxxx-xxxx-xxxxx-xxxx",
  "createdDateTime": "2022-04-18T15:44:44Z",
  "lastUpdatedDateTime": "2022-04-18T15:45:48Z",
  "expirationDateTime": "2022-04-25T15:44:44Z",
  "status": "running"
}

Implementación del modelo

Por lo general, después de entrenar un modelo, revisaría sus detalles de evaluación. En este inicio rápido, solo implementará el modelo y llamará a la API de predicción para consultar los resultados.

Envío del trabajo de implementación

Cree una solicitud PUT con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para empezar a implementar un modelo de reconocimiento del lenguaje conversacional.

URL de la solicitud

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Cuerpo de la solicitud

{
  "trainedModelLabel": "{MODEL-NAME}",
}

Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que se ha realizado correctamente. En los encabezados de respuesta, extraiga el valor operation-location. Tendrá el formato siguiente:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

Puede usar esta dirección URL para obtener el estado del trabajo de implementación.

Obtención del estado del trabajo de implementación

Cuando se envía una solicitud de implementación correcta, la dirección URL de solicitud completa para comprobar el estado del trabajo (incluido el punto de conexión, el nombre del proyecto y el id. de trabajo) se encuentra en el encabezado de respuesta operation-location.

Use la siguiente solicitud GET para consultar el estado del trabajo de implementación. Reemplace los valores de los marcadores de posición por sus propios valores.

URL de la solicitud

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Cuerpo de la respuesta

Una vez que envíe la solicitud, recibirá la siguiente respuesta. Siga sondeando este punto de conexión hasta que el parámetro status cambie a "succeeded".

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Consulta del modelo

Una vez implementado el modelo, puede empezar a usarlo para realizar predicciones a través de la API de predicción.

Una vez que la implementación se realice correctamente, puede empezar a consultar el modelo de implementación para obtener predicciones.

Cree una solicitud POST con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para empezar a probar un modelo de reconocimiento del lenguaje conversacional.

URL de la solicitud

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Cuerpo de la solicitud

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Una vez que envíe la solicitud, recibirá la siguiente respuesta para la predicción

Response body

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

Respuesta de API de un proyecto de conversaciones

En un proyecto de conversaciones, se obtienen predicciones para las intenciones y las entidades existentes en el proyecto.

• Las intenciones y entidades incluyen una puntuación de confianza de entre 0,0 y 1,0 asociada a la confianza del modelo en la predicción de un determinado elemento del proyecto.
• La intención con la mayor puntuación se encuentra dentro de su propio parámetro.
• Solo las entidades predichas se mostrarán en la respuesta.
• Las entidades indican lo siguiente:
  • El texto de la entidad que se ha extraído
  • Su ubicación inicial, indicada mediante un valor de desplazamiento
  • La longitud del texto de la entidad, indicada mediante un valor de longitud

Limpieza de recursos

Cuando ya no necesite el proyecto, puede eliminarlo mediante las API.

Cree una solicitud deELIMINAR con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para eliminar un proyecto de reconocimiento del lenguaje conversacional.

URL de la solicitud

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que se ha realizado correctamente, lo que significa que el proyecto se ha eliminado.