Migrer vers la dernière version d’Azure Cognitive Service pour le langage

Conseil

Vous venez de commencer à utiliser Azure Cognitive Service pour le langage ? Consultez l’article de vue d’ensemble pour plus d’informations sur le service, les fonctionnalités disponibles et des liens vers des guides de démarrage rapide pour plus d’informations sur la version actuelle de l’API.

Si vos applications utilisent une version antérieure de l’API Analyse de texte ou de la bibliothèque cliente (avant la version stable v5.1.0), cet article vous aidera à mettre à niveau vos applications pour utiliser la dernière version d’Azure Cognitive Service for Language.

Point de terminaison de langage unifié (API REST)

Cette section s’applique aux applications qui utilisent le format de point de terminaison plus ancien /text/analytics/... pour les appels d’API REST. Par exemple :

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

Si votre application utilise le format de point de terminaison ci-dessus, le point de terminaison de l’API REST pour les fonctionnalités du serviceLangage suivantes a changé :

Le service Langage fournit désormais un point de terminaison unifié pour envoyer des requêtes d’API REST à ces fonctionnalités. Si votre application utilise l’API REST, mettez à jour son point de terminaison de demande afin d’utiliser le point de terminaison actuel :

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

En outre, le format du corps de la requête JSON a changé. Vous devez mettre à jour la structure de requête que votre application envoie à l’API, par exemple le corps JSON de reconnaissance d’entité suivant :

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

Utilisez les démarrages rapides liés ci-dessus pour voir un exemple actuel d’appels d’API REST pour les fonctionnalités que vous utilisez et la sortie associée de l’API.

Bibliothèques clientes

Pour utiliser la dernière version de la bibliothèque cliente, vous devez télécharger le dernier package logiciel dans l’espace de noms Azure.AI.TextAnalytics. Consultez les articles de démarrage rapide liés ci-dessus pour obtenir des exemples de code et des instructions pour l’utilisation de la bibliothèque cliente dans votre langage préféré.

Modifications apportées aux fonctionnalités de la version 2.1

Si vous migrez une application à partir de la version 2.1 de l’API, il existe plusieurs modifications apportées aux fonctionnalités dont vous devez avoir conscience.

Analyse des sentiments v2.1

L’analyse des sentiments dans la version 2.1 retourne des scores de sentiment entre 0 et 1 pour chaque document envoyé à l’API, les scores plus proches de 1 indiquant un sentiment plus positif. La version actuelle de cette fonctionnalité retourne des étiquettes de sentiment (par exemple, « positif » ou « négatif ») pour les phrases et le document dans son ensemble ainsi que les scores de confiance associés.

NER, PII et liaison d’entités v2.1

Dans la version 2.1, l’API Analyse de texte utilise un seul point de terminaison pour la reconnaissance d’entité nommée (NER) et la liaison d’entités. La version actuelle de cette fonctionnalité fournit une détection étendue des entités nommées et utilise des points de terminaison séparés pour les demandes NER et de liaison d’entités. En outre, vous pouvez utiliser une autre fonctionnalité offerte par le service de langage, qui vous permet de détecter les informations personnelles (PII) et médicales (PHI).

Vous devez également mettre à jour votre application pour utiliser les catégories d’entité retournées dans la réponse de l’API.

Catégories d’entité version 2.1

Le tableau suivant répertorie les catégories d’entités retournées pour NER v2.1.

Category Description
Personne Noms des personnes.
Emplacement Points de repère, structures et caractéristiques géographiques et entités géopolitiques naturels et créés par l’homme
Organisation Sociétés, partis politiques, groupes de musique, clubs de sport, organismes gouvernementaux et organisations publiques. Les nationalités et les religions ne sont pas incluses dans ce type d’entité.
PhoneNumber Numéros de téléphone (Numéros de téléphone américains et européens uniquement).
E-mail Adresses e-mail.
URL URL vers des sites web.
IP Adresses IP du réseau.
DateTime Dates et heures du jour.
Date Dates du calendrier.
Temps Heures de la journée
DateRange Plages de dates.
TimeRange Intervalles de temps.
Duration Durées.
Définissez Définie, répétée tant de fois.
Quantité Nombres et quantités numériques.
Number Nombres.
Pourcentage Pourcentages.
Ordinal Nombres ordinaux.
Age Ages.
Devise Devises.
Dimension Dimensions et mesures.
Température Températures.

Détection de la langue v2.1

La sortie de la fonctionnalité de détection de langue a changé dans la version actuelle. La réponse JSON contient ConfidenceScore au lieu de score. La version actuelle ne retourne également qu’une seule langue pour chaque document.

Extraction d’expressions clés v2.1

La fonctionnalité d’extraction de phrases clés n’a actuellement pas changé en dehors du point de terminaison et du format de la demande.

Voir aussi