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

Artículo
11/21/2024

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

¿Qué es Lenguaje de Azure AI?
Guía para desarrolladores de servicio de lenguaje
Consulte la siguiente documentación de referencia para información sobre las versiones anteriores de la API.
Use las siguientes guías de inicio rápido para ver ejemplos de la versión actual de estas características.

Compartir vía