Creación y administración de recursos de LUIS

Importante

LUIS se retirará el 1 de octubre de 2025. Además, a partir del 1 de abril de 2023, ya no se podrán crear recursos de este servicio. Se recomienda migrar las aplicaciones de LUIS al reconocimiento del lenguaje conversacional para aprovechar el soporte continuo del producto y las capacidades multilingües.

Utilice este artículo para obtener información sobre los tipos de recursos de Azure que puede usar con LUIS y cómo administrarlos.

Recurso de creación

Un recurso de creación le permite crear, administrar, entrenar, probar y publicar las aplicaciones. Hay un plan de tarifa disponible para el recurso de creación de LUIS: el nivel gratis (F0) que le proporciona:

• 1 millón de transacciones de creación
• 1 000 solicitudes de punto de conexión de predicción de prueba al mes.

Puede utilizar v3.0-preview LUIS Programmatic APIs (API de programación de LUIS v3.0-versión preliminar) para administrar los recursos de creación.

Recurso de predicción

Un recurso de predicción permite consultar el punto de conexión de predicción más allá de las 1 000 solicitudes proporcionadas por el recurso de creación. El recurso de predicción dispone de dos planes de tarifa:

• El recurso de predicción (F0) gratis, que le otorga 10 000 solicitudes de punto de conexión de predicción al mes.
• Recurso de predicción (S0) estándar, que es el plan de pago.

Puede utilizar v3.0-preview LUIS Endpoint API (API de punto de conexión de LUIS v3.0-versión preliminar) para administrar los recursos de predicción.

Nota:

• También puede usar un recurso de varios servicios para obtener un único punto de conexión que puede utilizar para varios servicios de Azure AI.
• LUIS proporciona dos tipos de recursos F0 (nivel gratuito): uno para las transacciones de creación y otro para las transacciones de predicción. Si está agotando la cuota de transacciones de predicción gratuitas, asegúrese de que está usando el recurso de predicción F0, que le otorga 10 000 transacciones gratuitas al mes, y no el recurso de creación, que le da 1000 transacciones de predicción al mes.
• Debe crear las aplicaciones de LUIS en las regiones donde desee publicar y consultar contenido.

Creación de recursos de LUIS

Para crear recursos de LUIS, puede usar el portal de LUIS, Azure Portal o la CLI de Azure. Después de crear los recursos, deberá asignarlos a las aplicaciones para que las utilicen.

Portal de LUIS

Creación de un recurso de creación de LUIS mediante el portal de LUIS

1. Inicie sesión en el portal de LUIS, seleccione su país o región, y acepte las condiciones de uso. Si ve la sección Aplicaciones en el portal, ya existe un recurso de LUIS y puede omitir el paso siguiente.

2. En la ventana Choose an authoring (Elección de una creación) que aparece, busque una suscripción de Azure y un recurso de creación de LUIS. Si no tiene un recursos, puede crearlo.

   

   Al crear un recurso de creación, especifique la siguiente información:

   • Nombre de inquilino: el inquilino al que está asociada la suscripción de Azure.
   • Nombre de la suscripción de Azure: la suscripción que se facturará para el recurso.
   • Nombre del grupo de recursos de Azure: nombre personalizado del grupo de recursos que elija o cree. Los grupos de recursos le permiten agrupar los recursos de Azure para el acceso y la administración.
   • Nombre del recurso de Azure: un nombre personalizado que elija y que utilice como parte de la dirección URL para las consultas de punto de conexión de creación y predicción.
   • Plan de tarifa: el plan de tarifa determina el número máximo de transacciones por segundo y mes.

Creación de un recurso de predicción de LUIS mediante el portal de LUIS

1. Vaya a la pestaña Administrar de la aplicación.

2. En el panel de navegación izquierdo, seleccione Recursos de Azure.

3. Seleccione el botón Agregar recurso de predicción.

   

   Si ya tiene un recurso de predicción, agréguelo. De lo contrario, seleccione Create a new prediction resource (Crear un nuevo recurso de predicción).

   

Sin el portal de LUIS

Creación de recursos de LUIS sin usar el portal de LUIS

Use la CLI de Azure para crear cada recursos de manera individual.

Sugerencia

• El recurso de creación kind es LUIS.Authoring
• El recurso de predicción kind es LUIS

1. Inicie sesión en la CLI de Azure.

   az login
   

   Este comando abre un explorador para que pueda seleccionar la cuenta correcta y proporcionar autenticación.

2. Defina un recurso de creación de LUIS de tipo LUIS.Authoring, denominado my-luis-authoring-resource. Créelo en el grupo de recursos existente denominado my-resource-group para la región westus.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. Cree un recurso de punto de conexión de predicción de LUIS de tipo LUIS, denominado my-luis-prediction-resource. Créelo en el grupo de recursos existente denominado my-resource-group para la región westus. Si quiere contar con una capacidad de proceso superior a la que proporciona el nivel de servicio gratis, cambie F0 a S0. Más información sobre planes de tarifa y la capacidad de proceso.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

Asignación de recursos de LUIS

La creación de un recurso no significa necesariamente que se pueda utilizar, lo tiene que asignar a las aplicaciones. Puede asignar un recurso de creación de una sola aplicación o de todas las aplicaciones en LUIS.

Portal de LUIS

Asignación de recursos mediante el portal de LUIS

Asignación de un recurso de creación a todas las aplicaciones

En el siguiente procedimiento se asigna el recurso de creación a todas las aplicaciones.

1. Inicie sesión en el portal de LUIS.
2. En la esquina superior derecha, seleccione su cuenta de usuario y, a continuación, seleccione Configuración.
3. En la página User Settings (Configuración de usuario), seleccione Add authoring resource (Agregar recurso de creación) y, a continuación, seleccione un recurso de creación existente. Seleccione Guardar.

Asignación de un recurso a una aplicación específica

En el siguiente procedimiento se asigna un recurso a una aplicación específica.

1. Inicie sesión en el portal de LUIS. Seleccione una aplicación de la lista Mis aplicaciones.

2. Vaya a Administrar>Recursos de Azure:

   

3. En la pestaña Prediction resource (Recurso de predicción) o Authoring resource (Recurso de creación), seleccione el botón Add prediction resource (Agregar recurso de predicción) o Add authoring resource (Agregar recurso de creación), respectivamente.

4. Use los campos del formulario para buscar el recurso correcto y, a continuación, seleccione Save (Guardar).

Sin el portal de LUIS

Asignación de un recurso de predicción sin usar el portal de LUIS

En el caso de procesos automatizados, como las canalizaciones de CI/CD, puede automatizar la asignación de un recurso de LUIS a una aplicación de LUIS mediante los pasos siguientes:

1. Obtenga un token de Azure Resource Manager que es una cadena alfanumérica de caracteres. Este token expira, por lo que debe usarlo de inmediato. También puede usar el siguiente comando de la CLI de Azure.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Use el token para solicitar los recursos de entorno de ejecución de LUIS en distintas suscripciones. Utilice la API para obtener la cuenta de Azure de LUIS a la que tiene acceso su cuenta de usuario.

   Esta API POST requiere los siguientes valores:

   Encabezado	Value
   Authorization	El valor de Authorization es Bearer {token}. El valor del token debe ir precedido de la palabra Bearer y un espacio.
   Ocp-Apim-Subscription-Key	Su clave de creación.

   La API devuelve una matriz de objetos JSON que representan las suscripciones a LUIS. Los valores devueltos incluyen el identificador de suscripción, el grupo de recursos y el nombre de recurso, devuelto como AccountName. Busque en la matriz el elemento que corresponde al recurso de LUIS que desea asignar a la aplicación de LUIS.

3. Asigne el token al recurso de LUIS mediante la API Assign a LUIS Azure accounts to an application.

   Esta API POST requiere los siguientes valores:

   Tipo	Configuración	Value
   Encabezado	Authorization	El valor de Authorization es Bearer {token}. El valor del token debe ir precedido de la palabra Bearer y un espacio.
   Encabezado	Ocp-Apim-Subscription-Key	Su clave de creación.
   Encabezado	Content-type	application/json
   QueryString	appid	El id. de la aplicación LUIS.
   Body		{AzureSubscriptionId: Id. de suscripción, ResourceGroup: nombre del grupo de recursos que tiene el recurso de predicción, AccountName: nombre del recurso de predicción}

   Cuando esta API finaliza correctamente, devuelve 201 - created status.

Anulación de la asignación de un recurso

Al anular la asignación de un recurso, no se elimina de Azure; solo se desvincula de LUIS.

Portal de LUIS

Cancelación de asignación de recursos mediante el portal de LUIS

1. Inicie sesión en el portal de LUIS y seleccione una aplicación de la lista Mis aplicaciones.
2. Vaya a Administrar>Recursos de Azure.
3. Seleccione el botón Cancelar la asignación del recurso para el recurso.

Sin el portal de LUIS

Cancelación de la asignación de un recurso de predicción sin usar el portal de LUIS

1. Obtenga un token de Azure Resource Manager que es una cadena alfanumérica de caracteres. Este token expira, por lo que debe usarlo de inmediato. También puede usar el siguiente comando de la CLI de Azure.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Use el token para solicitar los recursos de entorno de ejecución de LUIS en distintas suscripciones. Use la API Get LUIS Azure accounts, a la que su cuenta de usuario tiene acceso.

   Esta API POST requiere los siguientes valores:

   Encabezado	Value
   Authorization	El valor de Authorization es Bearer {token}. El valor del token debe ir precedido de la palabra Bearer y un espacio.
   Ocp-Apim-Subscription-Key	Su clave de creación.

   La API devuelve una matriz de objetos JSON que representan las suscripciones a LUIS. Los valores devueltos incluyen el identificador de suscripción, el grupo de recursos y el nombre de recurso, devuelto como AccountName. Busque en la matriz el elemento que corresponde al recurso de LUIS que desea asignar a la aplicación de LUIS.

3. Asigne el token al recurso de LUIS mediante Unassign a LUIS Azure account from an application API.

   DELETE API requiere los siguientes valores:

   Tipo	Configuración	Value
   Encabezado	Authorization	El valor de Authorization es Bearer {token}. El valor del token debe ir precedido de la palabra Bearer y un espacio.
   Encabezado	Ocp-Apim-Subscription-Key	Su clave de creación.
   Encabezado	Content-type	application/json
   QueryString	appid	El id. de la aplicación LUIS.
   Body		{AzureSubscriptionId: Id. de suscripción, ResourceGroup: nombre del grupo de recursos que tiene el recurso de predicción, AccountName: nombre del recurso de predicción}

   Cuando esta API finaliza correctamente, devuelve 200 - OK status.

Propiedad de recurso

Los recursos de LUIS, como todos los recursos de Azure, pertenecen a la suscripción que los contiene.

Para cambiar la propiedad de un recurso, puede realizar una de estas acciones:

• Transferir la propiedad de la suscripción.
• Exportar la aplicación de LUIS como un archivo y, a continuación, importar la aplicación en otra suscripción. La exportación está disponible en la página Mis aplicaciones del portal de LUIS.

Límites de recursos

Limites al establecimiento de claves de creación

Puede tener hasta 10 claves de creación por región y suscripción. Las regiones de publicación son diferentes de las regiones de creación. Asegúrese de que crea la aplicación en la región de creación que corresponde a la región de publicación en la que quiere ubicar su aplicación cliente. Para obtener información sobre cómo se asignan las regiones de creación a las regiones de publicación, consulte Regiones de creación y publicación.

Consulte los límites de recursos para obtener más información.

Errores de los límites de uso de claves

El límite de uso depende del plan de tarifa.

Si supera su cuota de transacciones por segundo (TPS), recibirá un error HTTP 429. Si supera su cuota de transacciones por mes (TPM), recibirá un error HTTP 403.

Cambio del plan de tarifa

1. En Azure Portal, vaya a Todos los recursos y seleccione el recurso.

   

2. En el menú de la izquierda, seleccione Plan de tarifa para ver los planes de tarifa disponibles.

3. Elija el plan de tarifa que desee y haga clic en Seleccionar para guardar el cambio. Una vez completado el cambio de precios, aparecerá una notificación en la parte superior derecha con la actualización del plan de tarifa.

Visualización de las métricas de recursos de Azure

Visualización de un resumen del uso de recursos de Azure

En Azure Portal puede ver la información de uso de LUIS. En la página Información general se muestra un resumen, incluidas las llamadas y los errores recientes. Si realiza una solicitud de punto de conexión de LUIS, espere hasta cinco minutos para que aparezca el cambio.

Personalización de los gráficos de uso de los recursos de Azure

La página Métricas proporciona una vista más detallada de los datos. Puede configurar los gráficos de métricas para un período de tiempo y una métrica específicos.

Alerta de umbral de transacciones totales

Si desea saber cuándo se alcanza un umbral de transacciones determinado (por ejemplo 10 000 transacciones), puede crear una alerta:

1. En el menú de la izquierda, seleccione Alertas

2. En el menú superior, seleccione Nueva regla de alertas.

   

3. Seleccione Agregar condición

   

4. Seleccione Llamadas totales.

   

5. Desplácese hacia abajo hasta la sección Lógica de alerta, establezca los atributos como desee y haga clic en Listo.

   

6. Para enviar notificaciones o invocar acciones cuando se desencadene la regla de alerta, vaya a la sección Acciones y agregue el grupo de acciones.

   

Restablecimiento de las claves de creación

En el caso de aplicaciones migradas a recursos de creación: si la clave de creación se ve comprometida, restablézcala en Azure Portal, en la página Claves de ese recurso de creación.

En el caso de las aplicaciones que no se han migrado: la clave se restablece en todas las aplicaciones en el portal de LUIS. Si crea sus aplicaciones a través de las API de creación, debe cambiar el valor de Ocp-Apim-Subscription-Key por la clave nueva.

Regeneración de una clave de Azure

Puede volver a generar una clave de Azure desde la página Claves de Azure Portal.

Propiedad, acceso y seguridad de la aplicación

Una aplicación se define mediante sus recursos de Azure, que se determinan en función de la suscripción del propietario.

Puede mover la aplicación de LUIS. Use los siguientes recursos como ayuda para moverla mediante Azure Portal o la CLI de Azure:

• Traslado de los recursos a un nuevo grupo de recursos o a una nueva suscripción
• Traslado de los recursos dentro de la misma suscripción o entre suscripciones

Pasos siguientes

• Obtenga información sobre cómo usar versiones para controlar el ciclo de vida de la aplicación.