Migrar la última versión de Lenguaje de Azure AI

  • Artículo

Sugerencia

Introducción a Lenguaje de Azure AI Consulte el artículo de información general para los detalles sobre el servicio, las características disponibles y los vínculos a inicios rápidos para obtener información sobre la versión actual de la API.

Si las aplicaciones aún usan la API de Text Analytics o biblioteca cliente (anterior a la versión estable v5.1.0), este artículo le ayudará a actualizar las aplicaciones para usar la versión más reciente de las características de Lenguaje de Azure AI.

Punto de conexión de lenguaje unificado (API de REST)

Esta sección se aplica a las aplicaciones que usan el formato de punto de conexión anterior /text/analytics/... para las llamadas a la API de REST. Por ejemplo:

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

Si la aplicación usa el formato de punto de conexión anterior, ha cambiado el punto de conexión de la API de REST para las siguientes características del servicio de lenguaje:

El servicio de lenguaje proporciona ahora un punto de conexión unificado para enviar solicitudes de API de REST a estas características. Si la aplicación usa la API de REST, actualice su punto de conexión de solicitud para usar el punto de conexión actual:

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

Además, el formato del cuerpo de la solicitud JSON ha cambiado. Deberá actualizar la estructura de solicitudes que la aplicación envía a la API, por ejemplo, el siguiente cuerpo JSON de reconocimiento de entidades:

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "I had a wonderful trip to Seattle last week."
            }
        ]
    }
}

Use los inicios rápidos vinculados anteriormente para ver las llamadas API de REST de ejemplo actuales para las características que usa y la salida de la API asociada.

Bibliotecas de clientes

Para usar la versión más reciente de la biblioteca cliente, tendrá que descargar el paquete de software más reciente en el espacio de nombres Azure.AI.TextAnalytics. Consulte los artículos de inicio rápido vinculados anteriormente para obtener código de ejemplo e instrucciones para usar la biblioteca cliente en su lenguaje preferido.

Cambios en la funcionalidad de la versión 2.1

Si va a migrar una aplicación de la versión 2.1 de la API, hay varios cambios en la funcionalidad de características que debe tener en cuenta.

Análisis de sentimiento v2.1

Análisis de sentimiento en la versión 2.1 devuelve puntuaciones de sentimiento entre 0 y 1 para cada documento enviado a la API. Las puntuaciones más próximas a 1 indican un sentimiento más positivo. La versión actual de esta característica devuelve etiquetas de opinión (como "positivo" o "negativo") para las oraciones y el documento en su totalidad, así como sus puntuaciones de confianza asociadas.

NER, PII, y vinculación de entidad v2.1

En la versión 2.1, la API Text Analytics utilizaba un punto de conexión para Reconocimiento de entidades con nombre (NER) y la vinculación de entidad. La versión actual de esta característica proporciona la detección expandida de entidades con nombre y tiene puntos de conexión independientes para las solicitudes NER y de vinculación de entidad. Además, puede usar otra característica ofrecida en el servicio de lenguaje que le permite detectar información personal (PII) y médica (PHI).

También necesitará actualizar la aplicación para usar las categorías de entidad devueltas en la respuesta de la API.

Categorías de entidad de la versión 2.1

En la tabla siguiente se enumeran las categorías de entidad devueltas para NER v2.1.

Category Descripción
Person Nombres de personas.
Location Puntos de referencia naturales y humanos, estructuras, características geográficas y entidades geopolíticas.
Organización Empresas, grupos políticos, bandas musicales, clubs deportivos, organismos gubernamentales y organizaciones públicas. Las nacionalidades y las religiones no se incluyen en este tipo de entidad.
PhoneNumber Números de teléfono (solo números de teléfono de EE. UU y la UE).
Email Direcciones de correo.
URL Direcciones URL de sitios web.
IP Direcciones IP de red.
DateTime Fechas y horas del día.
Date Fechas calendario.
Time Horas del día
DateRange Intervalos de fechas.
TimeRange Intervalos de horas.
Duration Duraciones.
Set Establecer varias veces repetidas.
Cantidad Números y cantidades numéricas.
Number Números.
Porcentaje Porcentajes.
Ordinal Números ordinales.
Age Edades.
Moneda Monedas.
Dimensión Dimensiones y medidas.
Temperatura Temperaturas.

Detección de idioma v2.1

La salida de la característica de detección de idioma ha cambiado en la versión actual. La respuesta JSON contendrá ConfidenceScore en lugar de score. La versión actual también devuelve solo un idioma para cada documento.

Extracción de frases clave v2.1

La funcionalidad de la característica de extracción de frases clave no ha cambiado actualmente fuera del punto de conexión y formato de solicitud.

Consulte también