Der kognitive Skill „Stimmung“ (v2)

Artikel
09/01/2024

Der Skill Stimmung (v2) bewertet unstrukturierten Text anhand eines Positiv-Negativ-Kontinuums und gibt für jeden Datensatz einen numerischen Wert zwischen 0 und 1 zurück. Dabei weisen Werte nahe 1 auf eine positive Stimmung und Werte nahe 0 auf eine negative Stimmung hin. Bei diesem Skill werden die Machine Learning-Modelle verwendet, die in Azure KI Services über die Textanalyse bereitgestellt werden.

Wichtig

Der Skill „Stimmung“ (v2) (Microsoft.Skills.Text.SentimentSkill) wurde eingestellt und ersetzt durch Microsoft.Skills.Text.V3.SentimentSkill. Führen Sie unter Berücksichtigung der Empfehlungen unter Veraltete Azure KI Search Skills eine Migration zu einem unterstützten Skill durch.

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 Azure KI Services-Ressource anfügen. Gebühren fallen beim Aufrufen von APIs in Azure AI Services sowie für die Bildextraktion im Rahmen der Dokumentaufschlüsselungsphase in Azure AI Search an. Für die Textextraktion aus Dokumenten fallen keine Gebühren an.

Die Ausführung integrierter Skills wird nach dem bestehenden nutzungsbasierten Preis für Azure KI Services berechnet. Die Preise für die Bildextraktion werden auf der Preisseite von Azure KI Search beschrieben.

@odata.type

Microsoft.Skills.Text.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 das Stimmungsanalysetool 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.

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
`score`	Ein Wert zwischen 0 und 1, der die Stimmung des analysierten Textes repräsentiert. Werte nahe 0 stehen für eine negative, nahe 0,5 für eine neutrale und nahe 1 für eine positive Stimmung.

Beispieldefinition

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

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": {
                "score": 0.01
            }
        }
    ]
}

Warnungsfälle

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

Freigeben über