Competenza cognitiva del sentiment (v3)
La competenza Sentiment (v3) valuta il testo non strutturato e per ogni record fornisce etichette del sentiment (ad esempio "negative", "neutral" e "positive") in base al punteggio di attendibilità più alto trovato dal servizio a livello di frase e documento. Questa competenza usa i modelli di Machine Learning forniti dalla versione 3 del servizio di linguaggio nei servizi di intelligenza artificiale di Azure. Espone inoltre le funzionalità di opinion mining, che fornisce informazioni più granulari sulle opinioni relative agli attributi dei prodotti o dei servizi nel testo.
Nota
Questa competenza è associata ai servizi di intelligenza artificiale di Azure e richiede una risorsa fatturabile per le transazioni che superano 20 documenti per indicizzatore al giorno. L'esecuzione delle competenze predefinite viene addebitata secondo gli attuali prezzi con pagamento in base al consumo dei Servizi di Azure AI.
@odata.type
Microsoft.Skills.Text.V3.SentimentSkill
Limiti dei dati
Le dimensioni massime di un record devono essere 5000 caratteri in base alla misurazione di String.Length. Se è necessario suddividere i dati prima di inviarli alla competenza sentiment, usare la competenza Suddivisione testo.
Parametri della competenza
I parametri fanno distinzione tra maiuscole e minuscole.
| Nome parametro | Descrizione |
|---|---|
defaultLanguageCode |
(facoltativo) Il codice lingua da applicare ai documenti che non specificano in modo esplicito una lingua. Vedi l'elenco completo di linguaggi supportati. |
modelVersion |
(facoltativo) Specifica la versione del modello da usare quando si chiama l'analisi del sentiment. L'impostazione predefinita sarà la versione più recente quando non è specificata. È consigliabile non specificare questo valore a meno che non sia necessario. |
includeOpinionMining |
Se impostato su true, abilita la funzionalità di opinion mining, che consente l'inserimento dell'analisi del sentiment basata su aspetti nei risultati dell'output. Il valore predefinito è false. |
Input competenze
| Nome input | Descrizione |
|---|---|
text |
Testo da analizzare. |
languageCode |
(facoltativo) Stringa che indica la lingua dei record. Se questo parametro non è specificato, il valore predefinito è "en". Vedi l'elenco completo di linguaggi supportati. |
Output competenze
| Nome output | Descrizione |
|---|---|
sentiment |
Valore stringa che rappresenta l'etichetta del sentiment dell'intero testo analizzato (positivo, neutro o negativo). |
confidenceScores |
Tipo complesso con tre valori double, uno per la valutazione positiva, uno per la classificazione neutra e uno per la classificazione negativa. I valori sono compresi tra 0 e 1,00, dove 1,00 rappresenta la maggiore attendibilità possibile in una determinata assegnazione di etichetta. |
sentences |
Raccolta di tipi complessi che suddivide il sentiment della frase di testo per frase. Questo è anche il caso in cui i risultati di opinion mining vengono restituiti sotto forma di obiettivi e valutazioni se includeOpinionMining è impostato su true. |
Definizione di esempio
{
"@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"
}
]
}
Input di esempio
{
"values": [
{
"recordId": "1",
"data": {
"text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
"languageCode": "en"
}
}
]
}
Output di esempio
{
"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
}
],
}
]
}
}
]
}
Casi di avviso
Se il testo è vuoto, viene generato un avviso e non vengono restituiti risultati del sentiment. Se una lingua non è supportata, viene generato un avviso e non vengono restituiti risultati del sentiment.