Der kognitive Skill „Stimmung“Sentiment cognitive skill

Der Skill Stimmung bewertet unstrukturierten Text anhand eines Positiv-Negativ-Kontinuums und gibt für jeden Datensatz einen numerischen Wert zwischen 0 und 1 zurück.The Sentiment skill evaluates unstructured text along a positive-negative continuum, and for each record, returns a numeric score between 0 and 1. Dabei weisen Werte nahe 1 auf eine positive Stimmung und Werte nahe 0 auf eine negative Stimmung hin.Scores close to 1 indicate positive sentiment, and scores close to 0 indicate negative sentiment. Bei dieser Qualifikation werden die Machine Learning-Modelle verwendet, die in Cognitive Services über die Textanalyse bereitgestellt werden.This skill uses the machine learning models provided by Text Analytics in Cognitive Services.

Hinweis

Wenn Sie den Umfang erweitern, indem Sie die Verarbeitungsfrequenz erhöhen oder weitere Dokumente oder KI-Algorithmen hinzufügen, müssen Sie eine kostenpflichtige Cognitive Services-Ressource anfügen.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 Cognitive Services resource. Gebühren fallen beim Aufrufen von APIs in Cognitive Services sowie für die Bildextraktion im Rahmen der Dokumentaufschlüsselungsphase in Azure Search an.Charges accrue when calling APIs in Cognitive Services, and for image extraction as part of the document-cracking stage in Azure Search. Für die Textextraktion aus Dokumenten fallen keine Gebühren an.There are no charges for text extraction from documents.

Die Ausführung integrierter Qualifikationen wird nach dem bestehenden nutzungsbasierten Preis für Cognitive Services berechnet.Execution of built-in skills is charged at the existing Cognitive Services pay-as-you go price. Die Preise für die Bildextraktion werden auf der Preisseite von Azure Search beschrieben.Image extraction pricing is described on the Azure Search pricing page.

@odata.type

Microsoft.Skills.Text.SentimentSkillMicrosoft.Skills.Text.SentimentSkill

DatengrenzwerteData limits

Die maximale Größe eines Datensatzes sollte 5000 Zeichen betragen, wie mit String.Length gemessen.The maximum size of a record should be 5000 characters as measured by String.Length. Wenn Sie Ihre Daten teilen müssen, bevor Sie sie an das Stimmungsanalysetool senden, verwenden Sie den Skill „Text teilen“.If you need to break up your data before sending it to the sentiment analyzer, use the Text Split skill.

SkillparameterSkill parameters

Bei den Parametern wird zwischen Groß- und Kleinschreibung unterschieden.Parameters are case-sensitive.

ParameternameParameter Name
defaultLanguageCodedefaultLanguageCode (Optional) Der Sprachcode, der für Dokumente gilt, die nicht explizit eine Sprache angeben.(optional) The language code to apply to documents that don't specify language explicitly.
Siehe die vollständige Liste der unterstützten Sprachen.See Full list of supported languages

SkilleingabenSkill inputs

EingabenameInput Name BESCHREIBUNGDescription
texttext Der zu analysierende TextThe text to be analyzed.
languageCodelanguageCode (Optional) Eine Zeichenfolge, die die Sprache der Datensätze angibt.(Optional) A string indicating the language of the records. Wenn dieser Parameter nicht festgelegt ist, wird der Standardwert „en“ verwendet.If this parameter is not specified, the default value is "en".
Siehe die vollständige Liste der unterstützten Sprachen.See Full list of supported languages.

SkillausgabenSkill outputs

AusgabenameOutput Name BESCHREIBUNGDescription
Ergebnis Ihrer Appscore Ein Wert zwischen 0 und 1, der die Stimmung des analysierten Textes repräsentiert.A value between 0 and 1 that represents the sentiment of the analyzed text. Werte nahe 0 stehen für eine negative, nahe 0,5 für eine neutrale und nahe 1 für eine positive Stimmung.Values close to 0 have negative sentiment, close to 0.5 have neutral sentiment, and values close to 1 have positive sentiment.

BeispieldefinitionSample definition

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

BeispieleingabeSample 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"
            }
        }
    ]
}

BeispielausgabeSample output

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

NotizenNotes

Wenn der Wert leer ist, wird für diese Datensätze kein Stimmungswert zurückgegeben.If empty, a sentiment score is not returned for those records.

Auftretende FehlerError cases

Wenn eine Sprache nicht unterstützt wird, wird eine Fehlermeldung generiert und kein Stimmungswert zurückgegeben.If a language is not supported, an error is generated and no sentiment score is returned.

Weitere InformationenSee also