Recursos de desarrolladores de SDK, REST y CLI para Language Understanding (LUIS)

  • Artículo

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.

Los SDK, las API REST o la CLI le ayudan a desarrollar aplicaciones de Language Understanding (LUIS) en su lenguaje de programación. Administre los recursos de Azure y predicciones de LUIS.

Administración de recursos de Azure

Utilice la capa de administración de servicios Azure AI para crear, editar, listar y eliminar el recurso Language Understanding o Azure AI services.

Encuentre la documentación de referencia basada en la herramienta:

Solicitudes de creación y predicción de Language Understanding

Al servicio Language Understanding se accede desde un recurso de Azure que tiene que crear. Hay dos recursos:

  • Use el recurso de creación para entrenar para la creación, edición, entrenamiento y publicación.
  • Use el recurso de predicción para que entorno de ejecución envíe el texto del usuario y reciba una predicción.

Utilice el Código de ejemplo de los servicios Azure AI para aprender y utilizar las tareas más comunes.

Especificaciones de REST

Las especificaciones de REST de LUIS, junto con todas las especificaciones de REST de Azure, están disponibles públicamente en GitHub.

API de REST

Las API de punto de conexión de predicción y de creación están disponibles en las API REST:

Tipo Versión
Creación V2
versión preliminar V3
Predicción V2
V3

Puntos de conexión REST

LUIS actualmente tiene dos tipos de puntos de conexión:

  • creación en el punto de conexión de entrenamiento
  • predicción de consultas en el punto de conexión en tiempo de ejecución.
Propósito URL
Versión 2 de creación en el punto de conexión de entrenamiento https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Versión 3 de creación en el punto de conexión de entrenamiento https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Versión 2 de predicción: todas las predicciones en el punto de conexión en tiempo de ejecución https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
Versión 3 de predicción: la predicción de las versiones en el punto de conexión en tiempo de ejecución https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
Versión 3 de predicción: predicciones de espacios en el punto de conexión en tiempo de ejecución https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

En la tabla siguiente se explican los parámetros que se muestran entre llaves {} en la tabla anterior.

Parámetro Propósito
your-resource-name Nombre de recurso de Azure
q o query Texto de expresión enviado desde la aplicación cliente, como un bot de chat
version Nombre de la versión de 10 caracteres
slot production o staging

Parámetros de cadena de consulta REST

Los parámetros de cadena de consulta de API v3 incluyen:

Parámetro de consulta Nombre del portal de LUIS Tipo Versión Valor predeterminado Propósito
log Guardar registros boolean v2 y v3 false Almacena la consulta en el archivo de registro. El valor predeterminado es False.
query - string Solo v3 No tiene valor predeterminado: es obligatorio en la solicitud GET. En la versión 2, la expresión que va a predecirse se almacena en el parámetro q.

En la versión 3, la funcionalidad se pasa en el parámetro query.
show-all-intents Incluir puntuaciones para todas las intenciones boolean Solo v3 false Devuelve todas las intenciones con la puntuación correspondiente en el objeto prediction.intents. Las intenciones se devuelven como objetos en un objeto intents primario. Esto habilita el acceso mediante programación sin necesidad de encontrar la intención en una matriz: prediction.intents.give. En la versión 2, se devuelven en una matriz.
verbose Incluir más detalles de entidades boolean v2 y v3 false En la versión 2, cuando se establece en true, se devuelven todas las intenciones previstas. Si necesita todas las intenciones previstas, use el parámetro v3 de show-all-intents.

En la versión 3, este parámetro solo proporciona detalles de los metadatos de la entidad para la predicción de entidad.
timezoneOffset - string V2 - Zona horaria aplicada a las entidades datetimeV2.
datetimeReference - string V3 - Zona horaria aplicada a las entidades datetimeV2. Reemplaza timezoneOffset de la versión 2.

Esquema de la aplicación

El esquema de la aplicación se importa y exporta en el formato .json o .lu.

SDK basados en lenguaje

Idioma Documentación de referencia Paquete Guías de inicio rápido
C# Creación
Predicción		 Creación en NuGet
Predicción en NuGet		 Creación
Predicción de consultas
Go Creación y predicción SDK
Java Creación y predicción Autorización con Maven
Predicción con Maven
JavaScript Creación
Predicción		 Creación con NPM
Predicción con NPM		 Creación
Predicción
Python Creación y predicción Pip Creación
Predicción

Contenedores

Language Understanding (LUIS) proporciona un contenedor que ofrece versiones locales y contenidas de la aplicación.

Exportación e importación de formatos

Language Understanding ofrece la posibilidad de administrar la aplicación y sus modelos en un formato JSON, el formato .LU (LUDown) y un paquete comprimido para el contenedor de Language Understanding.

La exportación e importación de estos formatos está disponible desde las API y desde el portal de LUIS. El portal proporciona importación y exportación como parte de la lista de aplicaciones y la lista de versiones.

Talleres

Herramientas de integración continua

Bot Framework Tools

El Framework bot está disponible como un SDK en varios idiomas y como servicio mediante Azure AI Bot Service.

Bot Framework proporciona varias herramientas para ayudar con Language Understanding, entre las que se incluyen:

  • Bot Framework Emulator: una aplicación de escritorio que permite que los desarrolladores de bots prueben y depuren los bots mediante el SDK de Bot Framework
  • Bot Framework Composer: es una herramienta de desarrollo integrado para desarrolladores y equipos multidisciplinares que permite crear bots y experiencias de conversación con Microsoft Bot Framework.
  • Ejemplos de Bot Framework: en C#, JavaScript, TypeScript, y Python

Pasos siguientes