Compétence cognitive Sentiment (v2)

Note

Recherche Azure AI est disponible via le portail Azure, les API REST et les SDK Azure. Il sous-tend également Foundry IQ, la couche de connaissances managée qui transforme le contenu d’entreprise en bases de connaissances réutilisables et prenant en charge les autorisations pour les agents dans le portail Microsoft Foundry.

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 Foundry Tools.

Important

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

Note

Lorsque vous développez l’étendue en augmentant la fréquence de traitement, en ajoutant davantage de documents ou en ajoutant d’autres algorithmes d’IA, vous devez attacher une ressource Microsoft Foundry facturable. Les frais s’accumulent lors de l’appel d’API dans Foundry Tools et pour l’extraction d’images dans le cadre de la phase de craquage de document dans Recherche IA Azure. L’extraction de texte à partir des documents est gratuite.

L’exécution des compétences intégrées est facturée au prix standard des outils Foundry existants. Les prix appliqués pour l'extraction d'images sont présentés sur la page de tarification d’Recherche Azure AI.

@odata.type

Microsoft.Skills.Text.Sentimentskill

Limites des 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 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.

Données de compétences

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.

Résultats des compétences

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 résultat

{
    "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