Cognitieve vaardigheid gevoel (v3)
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 Azure AI-services . Het biedt ook mogelijkheden voor meninganalyse, die meer gedetailleerde informatie biedt over de meningen met betrekking tot kenmerken van producten of services in tekst.
Notitie
Deze vaardigheid is gebonden aan Azure AI-services en vereist een factureerbare resource voor transacties die groter zijn dan 20 documenten per indexeerfunctie per dag. Voor de uitvoering van ingebouwde vaardigheden worden kosten in rekening gebracht voor de bestaande betalen per gebruik-prijs van Azure AI-services.
@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 | Beschrijving |
|---|---|
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 | Beschrijving |
|---|---|
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 | Beschrijving |
|---|---|
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.