Freigeben über


Der kognitive Skill „Stimmung“ (V3)

Der Skill Stimmung (v3) bewertet unstrukturierten Text und gibt für jeden Datensatz Stimmungsbezeichnungen (z. B. „negativ“, „neutral“ und „positiv“) basierend auf der höchsten Zuverlässigkeitsbewertung an, die vom Dienst auf Satz- und Dokumentebene gefunden wird. Bei diesem Skill werden die Machine Learning-Modelle verwendet, die in Azure KI Services von Version 3 der Sprachdienste bereitgestellt werden. Damit werden außerdem die Opinion Mining-Funktionen verfügbar gemacht. Diese liefern detailliertere Informationen zu den Meinungen in Bezug auf die Attribute von Produkten oder Dienstleistungen im Text.

Hinweis

Dieser Skill ist an Azure KI Services gebunden und erfordert eine abrechenbare Ressource für Transaktionen, die 20 Dokumente pro Indexer und Tag überschreiten. Die Ausführung integrierter Skills wird nach dem bestehenden nutzungsbasierten Preis für Azure KI Services berechnet.

@odata.type

Microsoft.Skills.Text.V3.SentimentSkill

Datengrenzwerte

Die maximale Größe eines Datensatzes beträgt 5.000 Zeichen (gemessen durch String.Length). Wenn Sie Ihre Daten teilen müssen, bevor Sie sie an den Skill für Stimmung senden, verwenden Sie den Skill „Text teilen“.

Skillparameter

Bei den Parametern wird zwischen Groß- und Kleinschreibung unterschieden.

Parametername Beschreibung
defaultLanguageCode (Optional) Der Sprachcode, der für Dokumente gilt, die nicht explizit eine Sprache angeben.
Siehe die vollständige Liste der unterstützten Sprachen.
modelVersion (Optional) Gibt die Version des Modells an, die beim Aufruf der Stimmungsanalyse verwendet wird. Wenn nichts angegeben ist, wird standardmäßig die neueste Version verwendet. Es wird empfohlen, diesen Wert nur anzugeben, wenn es notwendig ist.
includeOpinionMining Bei Festlegung dieser Option auf true wird die Opinion Mining-Funktion aktiviert. Damit kann die aspektbasierte Stimmungsanalyse in die Ausgabeergebnisse aufgenommen werden. Wird standardmäßig auf false festgelegt.

Skilleingaben

Eingabename Beschreibung
text Der zu analysierende Text
languageCode (Optional) Eine Zeichenfolge, die die Sprache der Datensätze angibt. Wenn dieser Parameter nicht angegeben wird, ist der Standardwert „en“.
Siehe die vollständige Liste der unterstützten Sprachen.

Skillausgaben

Ausgabename Beschreibung
sentiment Ein Zeichenfolgenwert, der die Stimmungsbezeichnung des gesamten analysierten Texts darstellt (entweder positiv, neutral oder negativ)
confidenceScores Ein komplexer Typ mit drei double-Werten, einer für die positive Bewertung, einer für die neutrale Bewertung und einer für die negative Bewertung. Die Werte reichen von 0 bis 1,00. Dabei stellt 1,00 die höchstmögliche Konfidenz in einer bestimmten Bezeichnungszuweisung dar.
sentences Eine Auflistung komplexer Typen, die die Stimmung des Texts Satz für Satz aufschlüsseln. Hier werden auch Opinion Mining-Ergebnisse in Form von Zielen und Bewertungen zurückgegeben, wenn includeOpinionMining auf true festgelegt ist.

Beispieldefinition

{
    "@odata.type": "#Microsoft.Skills.Text.V3.SentimentSkill",
    "context": "/document",
    "includeOpinionMining": true,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        },
        {
            "name": "languageCode",
            "source": "/document/languageCode"
        }
    ],
    "outputs": [
        {
            "name": "sentiment",
            "targetName": "sentiment"
        },
        {
            "name": "confidenceScores",
            "targetName": "confidenceScores"
        },
        {
            "name": "sentences",
            "targetName": "sentences"
        }
    ]
}

Beispieleingabe

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

Beispielausgabe

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "sentiment": "negative",
                "confidenceScores": {
                    "positive": 0.0,
                    "neutral": 0.0,
                    "negative": 1.0
                },
                "sentences": [
                    {
                        "text": "I had a terrible time at the hotel.",
                        "sentiment": "negative",
                        "confidenceScores": {
                            "positive": 0.0,
                            "neutral": 0.0,
                            "negative": 1.0
                        },
                        "offset": 0,
                        "length": 35,
                        "targets": [],
                        "assessments": [],
                    },
                    {
                        "text": "The staff was rude and the food was awful.",
                        "sentiment": "negative",
                        "confidenceScores": {
                            "positive": 0.0,
                            "neutral": 0.0,
                            "negative": 1.0
                        },
                        "offset":36,
                        "length": 42,
                        "targets": [
                            {
                                "text": "staff",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 40,
                                "length": 5,
                                "relations": [
                                    {
                                        "relationType": "assessment",
                                        "ref": "#/documents/0/sentences/1/assessments/0",
                                    }
                                ]
                            },
                            {
                                "text": "food",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 63,
                                "length": 4,
                                "relations": [
                                    {
                                        "relationType": "assessment",
                                        "ref": "#/documents/0/sentences/1/assessments/1",
                                    }
                                ]
                            }
                        ],
                        "assessments": [
                            {
                                "text": "rude",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 50,
                                "length": 4,
                                "isNegated": false
                            },
                            {
                                "text": "awful",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 72,
                                "length": 5,
                                "isNegated": false
                            }
                        ],
                    }
                ]
            }
        }
    ]
}

Warnungsfälle

Wenn der Text leer ist, wird eine Warnung generiert, und es werden keine Stimmungswerte zurückgegeben. Wird eine Sprache nicht unterstützt, wird eine Warnung generiert, und es werden keine Stimmungswerte zurückgegeben.

Siehe auch