Kognitiv kunskap om sentiment (v3)

Note

Azure AI-sökning är tillgängligt via Azure-portalen, REST-API:er och Azure-SDK:er. Den ligger också till grund för Foundry IQ, det hanterade kunskapsskiktet som omvandlar företagsinnehåll till återanvändbara, behörighetsmedvetna kunskapsbaser för agenter i Microsoft Foundry-portalen.

Attitydfärdigheten (v3) utvärderar ostrukturerad text och för varje post tillhandahåller sentimentetiketter (till exempel "negativa", "neutrala" och "positiva") baserat på den högsta konfidenspoängen som hittats av tjänsten på menings- och dokumentnivå. Den här färdigheten använder maskininlärningsmodellerna som tillhandahålls av version 3 av Language Service i Foundry Tools. Det exponerar också åsiktsutvinningsfunktioner, vilket ger mer detaljerad information om åsikter relaterade till attribut för produkter eller tjänster i text.

Note

Den här färdigheten är bunden till Foundry Tools och kräver en fakturerbar resurs för transaktioner som överstiger 20 dokument per indexerare och dag. Körning av inbyggda färdigheter debiteras till det befintliga standardpriset för Foundry Tools.

@odata.type

Microsoft.Skills.Text.V3.SentimentSkill

Databegränsningar

Den maximala storleken på en post ska vara 5 000 tecken mätt med String.Length. Om du behöver dela upp dina data innan du skickar dem till attitydfärdigheten använder du färdigheten Textdelning.

Kompetensparametrar

Parametrar är skiftlägeskänsliga.

Parameternamn Description
defaultLanguageCode (valfritt) Språkkoden som ska tillämpas på dokument som inte uttryckligen anger språk.
Se den fullständiga listan med språk som stöds.
modelVersion (valfritt) Anger vilken version av modellen som ska användas när attitydanalys anropas. Den kommer som standard att vara den senaste versionen när den inte har angetts. Vi rekommenderar att du inte anger det här värdet om det inte är nödvändigt.
includeOpinionMining Om inställningen är inställd truepå aktiverar du funktionen för åsiktsutvinning, vilket gör att aspektbaserad attitydanalys kan inkluderas i dina utdataresultat. Standardvärdet är false.

Kunskapsindata

Indatanamn Description
text Texten som ska analyseras.
languageCode (valfritt) En sträng som anger posternas språk. Om den här parametern inte anges är standardvärdet "en".
Se den fullständiga listan med språk som stöds.

Färdighetsresultat

Utdatanamn Description
sentiment Ett strängvärde som representerar attitydetiketten för hela den analyserade texten (antingen positiv, neutral eller negativ).
confidenceScores En komplex typ med tre dubbla värden, en för det positiva omdömet, en för det neutrala omdömet och en för det negativa omdömet. Värdena varierar från 0 till 1,00, där 1,00 representerar högsta möjliga förtroende för en viss etiketttilldelning.
sentences En samling komplexa typer som delar upp attityden i text mening efter mening. Det är också här som yttrandets gruvresultat returneras i form av mål och utvärderingar om includeOpinionMining är inställt på true.

Exempeldefinition

{
    "@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"
        }
    ]
}

Exempelindata

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

Exempel på utdata

{
    "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
                            }
                        ],
                    }
                ]
            }
        }
    ]
}

Varningsfall

Om texten är tom genereras en varning och inga sentimentresultat returneras. Om ett språk inte stöds genereras en varning och inga sentimentresultat returneras.

Se även