Migrer vers la version 3.x de l’API Analyse de texteMigrate to version 3.x of the Text Analytics API

Si vous utilisez la version 2.1 de l’API Analyse de texte, cet article vous aide à mettre à niveau votre application pour utiliser la version 3.x.If you're using version 2.1 of the Text Analytics API, this article will help you upgrade your application to use version 3.x. La version 3.0 est en disponibilité générale et introduit de nouvelles fonctionnalités comme la Reconnaissance d’entité nommée (NER) et le contrôle de version de modèle.Version 3.0 is generally available and introduces new features such as expanded Named Entity Recognition (NER) and model versioning. Une préversion de v3.1 (v3.1-preview.x) est également disponible, elle ajoute des fonctionnalités comme l’exploration des opinions.A preview version of v3.1 (v3.1-preview.x) is also available, which adds features such as opinion mining. Les modèles utilisés dans v2 ne reçoivent pas les mises à jour ultérieures.The models used in v2 will not receive future updates.

Évolution des fonctionnalitésFeature changes

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.Sentiment Analysis in version 2.1 returns sentiment scores between 0 and 1 for each document sent to the API, with scores closer to 1 indicating more positive sentiment. La version 3 à la place 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.Version 3 instead returns sentiment labels (such as "positive" or "negative") for both the sentences and the document as a whole, and their associated confidence scores.

Étapes de migrationSteps to migrate

API RESTREST API

Si votre application utilise l’API REST, mettez à jour son point de terminaison de demande sur le point de terminaison v3 pour l’analyse des sentiments.If your application uses the REST API, update its request endpoint to the v3 endpoint for sentiment analysis. Par exemple, https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/v3.0/sentiment.For example:https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/v3.0/sentiment. Vous devez également mettre à jour l’application pour utiliser les étiquettes de sentiment retournées dans la réponse de l’API.You will also need to update the application to use the sentiment labels returned in the API's response.

Consultez la documentation de référence pour obtenir des exemples de réponse JSON.See the reference documentation for examples of the JSON response.

Bibliothèques clientesClient libraries

Pour utiliser la dernière version de la bibliothèque cliente Analyse de texte v3, vous devez télécharger le dernier package logiciel dans l’espace de noms Azure.AI.TextAnalytics.To use the latest version of the Text Analytics v3 client library, you will need to download the latest software package in the Azure.AI.TextAnalytics namespace. La section Configuration de l’article de démarrage rapide liste les commandes que vous pouvez utiliser pour le langage de votre choix, avec un exemple de code.The Setting up section in the quickstart article lists the commands you can use for your preferred language, with example code.

Vous recherchez un exemple de code qui utilise la version 2.1 de l’API ?Looking for example code that uses v2.1 of the API? Plusieurs exemples sont disponibles sur GitHub pour les kits SDK v2.1 suivants : C#, Go, JavaScript, Python et Ruby.There are several samples available on GitHub for the following v2.1 SDKs: C#, Go, JavaScript, Python, and Ruby.

Voir aussiSee also