Sentiment cognitive skill (v2)

  • Article

The Sentiment skill (v2) evaluates unstructured text along a positive-negative continuum, and for each record, returns a numeric score between 0 and 1. Scores close to 1 indicate positive sentiment, and scores close to 0 indicate negative sentiment. This skill uses the machine learning models provided by Text Analytics in Azure AI services.

Important

The Sentiment skill (v2) (Microsoft.Skills.Text.SentimentSkill) is now discontinued replaced by Microsoft.Skills.Text.V3.SentimentSkill. Follow the recommendations in Deprecated Azure AI Search skills to migrate to a supported skill.

Note

As you expand scope by increasing the frequency of processing, adding more documents, or adding more AI algorithms, you will need to attach a billable Azure AI services resource. Charges accrue when calling APIs in Azure AI services, and for image extraction as part of the document-cracking stage in Azure AI Search. There are no charges for text extraction from documents.

Execution of built-in skills is charged at the existing Azure AI services Standard Pay-in-Advance Offer price. Image extraction pricing is described on the Azure AI Search pricing page.

@odata.type

Microsoft.Skills.Text.SentimentSkill

Data limits

The maximum size of a record should be 5000 characters as measured by String.Length. If you need to break up your data before sending it to the sentiment analyzer, use the Text Split skill.

Skill parameters

Parameters are case-sensitive.

Parameter Name Description
defaultLanguageCode (optional) The language code to apply to documents that don't specify language explicitly.
See the full list of supported languages.

Skill inputs

Input Name Description
text The text to be analyzed.
languageCode (Optional) A string indicating the language of the records. If this parameter is not specified, the default value is "en".
See the full list of supported languages.

Skill outputs

Output Name Description
score A value between 0 and 1 that represents the sentiment of the analyzed text. Values close to 0 have negative sentiment, close to 0.5 have neutral sentiment, and values close to 1 have positive sentiment.

Sample definition

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

Sample input

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

Sample output

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

Warning cases

If your text is empty, a warning is generated and no sentiment score is returned. If a language is not supported, a warning is generated and no sentiment score is returned.

See also