Procedimiento para usar características del servicio de lenguaje de forma asincrónica

  • Artículo

El servicio de lenguaje permite enviar solicitudes de API de forma asincrónica, mediante la API REST o la biblioteca cliente. También puede incluir varias características diferentes del servicio de lenguaje en la solicitud, que se realizarán en los datos al mismo tiempo.

Actualmente, las siguientes características están disponibles para usarse de forma asincrónica:

  • Vinculación de entidad
  • Resumen de documento
  • Resumen de conversación
  • Extracción de la frase clave
  • Detección de idiomas
  • Reconocimiento de entidades con nombre (NER)
  • Detección de contenido del cliente
  • Análisis de opiniones y minería de opiniones
  • Text Analytics for Health
  • Información de identificación personal

Al enviar solicitudes asincrónicas, incurrirá en cargos en función del número de registros de texto que incluya en la solicitud para el uso de cada característica. Por ejemplo, si envía un registro de texto para el análisis de sentimiento y NER, se cuenta como el envío de dos registros de texto y se le cobrará por ambos según el plan de tarifa.

Envío de un trabajo asincrónico mediante la API REST

Para enviar un trabajo asincrónico, revise la documentación de referencia del cuerpo JSON que enviará en la solicitud.

  1. Agregue los documentos al objeto analysisInput.
  2. En el objeto tasks, incluya las operaciones que quiere realizar en los datos. Por ejemplo, si quisiera realizar análisis de sentimiento, incluiría el objeto SentimentAnalysisLROTask.
  3. Si lo desea, puede:
    1. Elija una versión específica del modelo que se usa en los datos.
    2. Incluya características adicionales del servicio de lenguaje en el objeto tasks, que se realizarán en los datos al mismo tiempo.

Una vez que haya creado el cuerpo JSON para la solicitud, agregue la clave al encabezado Ocp-Apim-Subscription-Key. A continuación, envíe la solicitud de API al punto de conexión de creación de trabajos. Por ejemplo:

POST https://your-endpoint.cognitiveservices.azure.com/language/analyze-text/jobs?api-version=2022-05-01

Una llamada correcta devolverá un código de respuesta 202. El operation-location en el encabezado de respuesta será la dirección URL que usará para recuperar los resultados de la API. El valor será similar a la dirección URL siguiente:

GET {Endpoint}/language/analyze-text/jobs/12345678-1234-1234-1234-12345678?api-version=2022-05-01

Para obtener el estado y recuperar los resultados de la solicitud, envíe una solicitud GET a la dirección URL que recibió en el encabezado operation-location de la respuesta de API anterior. No olvide incluir la clave en Ocp-Apim-Subscription-Key. La respuesta incluirá los resultados de la llamada API.

Envío de solicitudes de API asincrónicas mediante la biblioteca cliente

En primer lugar, asegúrese de que tiene instalada la biblioteca cliente para el idioma que prefiera. Para conocer los pasos para instalar la biblioteca cliente, consulte el artículo de inicio rápido sobre la característica que quiere usar.

Después, use el objeto de cliente para enviar llamadas asincrónicas a la API. Las llamadas al método que se van a usar variarán en función del idioma. Use los ejemplos disponibles y la documentación de referencia para ayudarle a empezar.

Disponibilidad de resultados

Cuando se usa esta característica de forma asincrónica, los resultados de la API están disponibles durante 24 horas desde el momento en que se ingiere la solicitud y se indican en la respuesta. Después de este período de tiempo, los resultados se purgan y ya no están disponibles para la recuperación.

Detección automática del lenguaje

A partir de la versión 2022-07-01-preview de la API de REST, se puede solicitar la detección automática del lenguaje en los documentos. Si el parámetro language se establece en auto, el código de lenguaje detectado del texto se devolverá como un valor de lenguaje en la respuesta. Esta detección del lenguaje no supondrá ningún cargo extra en el recurso de lenguaje.

Límites de datos

Nota

  • Si necesita analizar documentos con un tamaño superior al límite, puede dividir el texto en fragmentos más pequeños antes de enviarlos a la API.
  • Un documento es una sola cadena de caracteres de texto.

Puede enviar hasta 125 000 caracteres en todos los documentos incluidos en la solicitud asincrónica, medidos por StringInfo.LengthInTextElements. Este límite de caracteres es mayor que el límite para las solicitudes sincrónicas, con el fin de permitir un mayor rendimiento.

Si el documento supera el límite de caracteres, la API rechazará toda la solicitud y devolverá un error 400 bad request si algún documento de esta supera el tamaño máximo.

Consulte también