Cómo crear un proyecto CLU

Use este artículo para obtener información sobre cómo configurar estos requisitos y crear un proyecto.

Prerrequisitos

Antes de empezar a usar CLU, necesitará varias cosas:

• Una suscripción a Azure (cree una cuenta gratuita).
• Un recurso de Lenguaje Azure AI

Creación de un recurso de idioma

Antes de empezar a utilizar CLU, necesitará un recurso de Lenguaje de Azure AI.

Nota:

• Para crear un recurso de idioma, debe tener asignado un rol de propietario en el grupo de recursos.

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.

Creación de un nuevo recurso de idioma desde Language Studio

Si es la primera vez que inicia sesión, verá una ventana en Language Studio que le permitirá elegir un recurso de idioma existente o crear uno. También puede crear un recurso; para ello, haga clic en el icono de configuración de la esquina superior derecha, seleccione Recursos y, a continuación, haga clic en Crear un nuevo recurso.

Cree un recurso de idioma con los detalles siguientes.

Detalles de la instancia	Valor requerido
Suscripción de Azure	Su suscripción de Azure
Grupo de recursos de Azure	Su grupo de recursos de Azure
Nombre de recurso de Azure	El nombre de su recurso de idioma
Ubicación	Una región admitida para el recurso de lenguaje.
Plan de tarifa	Un plan de tarifa admitidos para el recurso de lenguaje.

Importante

• Asegúrese de habilitar la opción Identidad administrada al crear el recurso de idioma.
• Lea y confirme el aviso de inteligencia artificial responsable.

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 conversación

Una vez que tenga un recurso de idioma creado, cree un proyecto de reconocimiento del lenguaje conversacional.

Language Studio

1. En Language Studio, busque la sección con la etiqueta Reconocer las cuestiones y el lenguaje conversacional y seleccione Reconocimiento del lenguaje conversacional.
   

2. Esto lo llevará a la página Proyectos de reconocimiento del lenguaje conversacional. Seleccione Create new project (Crear proyecto).

   

Para crear un nuevo proyecto, deberá proporcionar los detalles siguientes:

Value	Descripción
Nombre	Nombre del proyecto. Una vez creada, no se puede cambiar
Descripción	Descripción opcional del proyecto.
Idioma principal de las expresiones	Idioma principal del proyecto. Los datos de entrenamiento deben estar principalmente en este idioma.
Habilitación de varios idiomas	Si desea permitir que el proyecto admita varios idiomas a la vez.

Cuando haya terminado, seleccione Siguiente y revise los detalles. Seleccione Crear para completar el proceso. Ahora debería ver la pantalla Compilación de esquema en el proyecto.

API de REST

Envíe una solicitud PATCH con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para crear un nuevo 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}?api-version={API-VERSION}

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{API-VERSION}	La versión de la API a la que llama.	2023-04-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.
Content-Type	'application/merge-patch+json'

Body

Use el siguiente código JSON de ejemplo como cuerpo.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

Clave	Marcador de posición	Valor	Ejemplo
projectName	{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	EmailApp
language	{LANGUAGE-CODE}	Una cadena que especifica el código de idioma de las expresiones que se usan en el proyecto. Si el proyecto es un proyecto multilingüe, elija el código de idioma de la mayoría de las expresiones.	en-us
multilingual	true	Valor booleano que le permite tener documentos en varios idiomas del conjunto de datos y, cuando se implementa el modelo, puede consultarlo en cualquier idioma admitido (no necesariamente incluido en los documentos de entrenamiento). Consulte compatibilidad con idiomas para obtener más información sobre la compatibilidad multilingüe.	true

Importación del proyecto

Language Studio

Puedes exportar un proyecto de Entendimiento del Lenguaje Conversacional como un archivo JSON en cualquier momento yendo a la página de proyectos de conversación, seleccionando un proyecto y, en el menú superior, haciendo clic en Exportar.

Ese proyecto se puede volver a importar como un proyecto nuevo. Si importa un proyecto con el mismo nombre exacto, reemplaza los datos del proyecto por los datos del proyecto recién importado.

Si tiene una aplicación de LUIS existente, puede importar directamente el JSON de la aplicación de LUIS a Conversational Language Understanding y creará un proyecto conversación con todas las partes que están disponibles actualmente: intenciones, entidades de ML y expresiones. Consulte el artículo sobre la migración de LUIS para obtener más información.

Para importar un proyecto, seleccione el botón de flecha situado junto a Crear un nuevo proyecto y seleccione Importar, a continuación seleccione el archivo LUIS o reconocimiento del lenguaje conversacional JSON.

API de REST

Puede importar un archivo JSON de CLU en el servicio

Envíe una solicitud PUBLICAR 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}

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas y debe coincidir con el nombre del proyecto en el archivo JSON que va a importar.	EmailAppDemo
{API-VERSION}	Versión de la API a la que se llama.	2023-04-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

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": []
      }
    ]
  }
}

Clave	Marcador de posición	Valor	Ejemplo
{API-VERSION}	Versión de la API a la que se llama.	2023-04-01
projectName	{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	EmailAppDemo
language	{LANGUAGE-CODE}	Una cadena que especifica el código de idioma de las expresiones que se usan en el proyecto. Si el proyecto es un proyecto multilingüe, elija el código de idioma de la mayoría de las expresiones.	en-us
multilingual	true	Valor booleano que permite tener documentos en varios idiomas en el conjunto de datos. Cuando el modelo se implementa, se puede consultar en cualquier lenguaje admitido incluido en los documentos de entrenamiento.	true
dataset	{DATASET}	Consulte cómo entrenar un modelo para obtener información sobre cómo dividir los datos entre un conjunto de pruebas y entrenamiento. Los valores posibles que admite este campo son Train y Test.	Train

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}

Exportar un proyecto

Language Studio

Puede exportar un proyecto de Conversational Language Understanding como un archivo JSON en cualquier momento; para ello, vaya a la página de proyectos de conversación, seleccione un proyecto y presione Exportar.

API de REST

Puede exportar un proyecto de Entendimiento del Lenguaje Conversacional como un archivo JSON en cualquier momento.

Cree una solicitud POST con la dirección URL, los encabezados y el cuerpo JSON siguientes para exportar 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}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	EmailApp
{API-VERSION}	La versión de la API a la que llama.	2023-04-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

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}/jobs/{JOB-ID}?api-version={API-VERSION}

JOB-ID se usa para identificar la solicitud, ya que esta operación es asincrónica. Use esta dirección URL para obtener el JSON del proyecto exportado mediante el mismo método de autenticación.

Obtener los detalles de los proyectos CLU

Language Studio

1. Vaya a la página de configuración del proyecto en Language Studio.

2. Puede ver los detalles del proyecto.

3. En esta página puede actualizar la descripción del proyecto y habilitar o deshabilitar el conjunto de datos multilingüe en la configuración del proyecto.

4. Igualmente, puede recuperar la clave de recurso principal en esta página.

   

API de REST

Para obtener los detalles de su proyecto, envíe una solicitud GET usando la dirección URL y los encabezados siguientes. Reemplace los valores de los marcadores de posición por sus propios valores.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{API-VERSION}	La versión de la API a la que llama.	2023-04-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

Cuerpo de la respuesta

Una vez que envíe la solicitud, recibirá la siguiente respuesta.

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation project.",
  "language": "{LANGUAGE-CODE}"
}

Una vez que envíe la solicitud de API, recibirá una respuesta 200 que indica que se ha realizado correctamente y el cuerpo de la respuesta JSON con los detalles del proyecto.

Eliminar proyecto

Language Studio

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.

API de REST

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}

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{API-VERSION}	La versión de la API a la que llama.	2023-04-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

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.

Pasos siguientes

Compilación de esquema