Cognitieve vaardigheid gevoel (v3)

Note

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

De gevoelsvaardigheid (v3) evalueert ongestructureerde tekst en biedt voor elke record sentimentlabels (zoals 'negatief', 'neutraal' en 'positief') op basis van de hoogste betrouwbaarheidsscore die door de service op zin- en documentniveau wordt gevonden. Deze vaardigheid maakt gebruik van de machine learning-modellen die worden geleverd door versie 3 van Language Service in Foundry Tools. Het biedt ook mogelijkheden voor meninganalyse, die meer gedetailleerde informatie biedt over de meningen met betrekking tot kenmerken van producten of services in tekst.

Note

Deze vaardigheid is gebonden aan Foundry Tools en vereist een factureerbare resource voor transacties die meer dan 20 documenten per indexeerfunctie per dag overschrijden. Uitvoering van ingebouwde vaardigheden wordt in rekening gebracht tegen de bestaande Prijs van Foundry Tools Standard.

@odata.type

Microsoft.Skills.Text.V3.SentimentSkill

Gegevenslimieten

De maximale grootte van een record moet 5000 tekens zijn, zoals gemeten door String.Length. Als u uw gegevens wilt opsplitsen voordat u deze naar de gevoelsvaardigheid verzendt, gebruikt u de vaardigheid Tekst splitsen.

Vaardigheidsparameters

Parameters zijn hoofdlettergevoelig.

Parameternaam Description
defaultLanguageCode (optioneel) De taalcode die moet worden toegepast op documenten die niet expliciet taal opgeven.
Zie de volledige lijst met ondersteunde talen.
modelVersion (optioneel) Hiermee geeft u de versie van het model op die moet worden gebruikt bij het aanroepen van sentimentanalyse. Deze wordt standaard ingesteld op de meest recente versie wanneer deze niet is opgegeven. U wordt aangeraden deze waarde niet op te geven, tenzij dit nodig is.
includeOpinionMining Als deze optie is ingesteld true, schakelt u de functie voor meninganalyse in, waardoor sentimentanalyse op basis van een aspect kan worden opgenomen in uw uitvoerresultaten. Standaard ingesteld op false.

Invoer van vaardigheden

Invoernaam Description
text De te analyseren tekst.
languageCode (optioneel) Een tekenreeks die de taal van de records aangeeft. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'.
Zie de volledige lijst met ondersteunde talen.

Uitvoer van vaardigheden

Uitvoernaam Description
sentiment Een tekenreekswaarde die het gevoelslabel van de volledige geanalyseerde tekst vertegenwoordigt (positief, neutraal of negatief).
confidenceScores Een complex type met drie dubbele waarden, één voor de positieve waardering, één voor de neutrale waardering en één voor de negatieve waardering. Waarden variëren van 0 tot 1,00, waarbij 1,00 het hoogst mogelijke vertrouwen in een bepaalde labeltoewijzing vertegenwoordigt.
sentences Een verzameling complexe typen die het gevoel van de tekst zin per zin opsplitsen. Dit is ook waar meninganalyseresultaten worden geretourneerd in de vorm van doelen en evaluaties indien includeOpinionMining ingesteld op true.

Voorbeelddefinitie

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

Voorbeeldinvoer

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

Voorbeelduitvoer

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

Waarschuwingscases

Als uw tekst leeg is, wordt er een waarschuwing gegenereerd en worden er geen sentimentresultaten geretourneerd. Als een taal niet wordt ondersteund, wordt er een waarschuwing gegenereerd en worden er geen sentimentresultaten geretourneerd.

Zie ook

  • Laatst bijgewerkt om