Partage via


Compétence cognitive Sentiment (v2)

La compétence Sentiment (v2) évalue du texte non structuré sur un continuum positif-négatif et, pour chaque enregistrement, retourne un score numérique compris entre 0 et 1. Un score proche de 1 indique un sentiment positif, et un score proche de 0 un sentiment négatif. Cette compétence utilise les modèles Machine Learning fournis par Analyse de texte dans les services Azure AI.

Important

La compétence Sentiment (v2) (Microsoft.Skills.Text.SentimentSkill) est désormais abandonnée et remplacée par Microsoft.Skills.Text.V3.SentimentSkill. Suivez les recommandations de la page Compétences Azure AI Search déconseillées pour migrer vers une compétence prise en charge.

Remarque

Si vous élargissez le champ en augmentant la fréquence des traitements, en ajoutant des documents supplémentaires ou en ajoutant plusieurs algorithmes d’IA, vous devez attacher une ressource de service Azure AI facturable. Des frais sont applicables durant l’appel des API dans les services Azure AI ainsi que pour l’extraction d’images durant la phase d’extraction du contenu des documents d’Azure AI Search. L’extraction de texte à partir des documents est gratuite.

L'exécution des compétences intégrées est facturée au prix actuel du paiement à l'utilisation des services Azure AI. Les prix appliqués pour l'extraction d'images sont présentés sur la page de tarification d’Azure AI Search.

@odata.type

Microsoft.Skills.Text.SentimentSkill

Limites de données

La taille maximale d’un enregistrement est de 5 000 caractères selon String.Length. Si vous avez besoin de découper vos données avant de les envoyer à l’Analyseur des sentiments, utilisez la compétence Fractionnement du texte.

Paramètres de la compétence

Les paramètres respectent la casse.

Nom du paramètre Description
defaultLanguageCode (Facultatif) Code de langue à appliquer aux documents qui ne spécifient pas explicitement la langue.
Voir la liste complète des langues prises en charge.

Entrées de la compétence

Nom d’entrée Description
text Texte à analyser.
languageCode (Facultatif) Chaîne indiquant la langue des enregistrements. Si ce paramètre n’est pas spécifié, la valeur par défaut est « en ».
Voir la liste complète des langues prises en charge.

Sorties de la compétence

Nom de sortie Description
score Valeur comprise entre 0 et 1 qui représente le sentiment du texte analysé. Les valeurs proches de 0 indiquent un sentiment négatif, les valeurs proches de 0,5 un sentiment neutre et les valeurs proches de 1 un sentiment positif.

Exemple de définition

{
    "@odata.type": "#Microsoft.Skills.Text.SentimentSkill",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        },
        {
            "name": "languageCode",
            "source": "/document/languagecode"
        }
    ],
    "outputs": [
        {
            "name": "score",
            "targetName": "mySentiment"
        }
    ]
}

Exemple d’entrée

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
                "languageCode": "en"
            }
        }
    ]
}

Exemple de sortie

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "score": 0.01
            }
        }
    ]
}

Cas d’avertissement

Si votre texte est vide, un avertissement est généré et aucun score de sentiment n’est renvoyé. Si la langue n’est pas prise en charge, un avertissement est généré et aucun score de sentiment n’est renvoyé.

Voir aussi