Habilidade cognitiva de Sentiment (v3)
A habilidade do Sentiment (v3) avalia o texto não estruturado e, para cada registro, fornece rótulos de sentimento (como “negativo”, “neutro” e “positivo”) com base na pontuação de confiança mais alta encontrada pelo serviço em uma frase e no nível do documento. Essa habilidade usa os modelos de machine learning fornecidos pela versão 3 do serviço de linguagem nos serviços de IA do Azure. Ele também expõe recursos de mineração de opiniões, que fornece informações mais granulares sobre as opiniões relacionadas a atributos de produtos ou serviços em texto.
Observação
Essa habilidade está associada aos serviços de IA do Azure e requer um recurso faturável para transações que excedem 20 documentos por indexador por dia. A execução de habilidades internas é cobrada pelo preço pago conforme o uso dos serviços de IA do Azure existentes.
@odata.type
Microsoft.Skills.Text.V3.SentimentSkill
Limites de dados
O tamanho máximo de um registro deve ser de 5.000 caracteres conforme medido por String.Length. Se você precisar dividir seus dados antes de enviá-los para a habilidade de sentimento, use a habilidade de Divisão de Texto.
Parâmetros de habilidades
Os parâmetros diferenciam maiúsculas de minúsculas.
| Nome do Parâmetro | Descrição |
|---|---|
defaultLanguageCode |
(opcional) O código de idioma a ser aplicado a documentos que não especifica explicitamente o idioma. Consulte a Lista completa dos idiomas com suporte. |
modelVersion |
(opcional) Especifica a versão do modelo a ser usada ao chamar a análise de sentimento. Quando não for especificada, a versão padrão será a mais recente. Recomendamos que você não especifique esse valor, a menos que seja necessário. |
includeOpinionMining |
Se definido como true, habilita o recurso de mineração de opiniões, permitindo que a análise de sentimento baseada em aspecto seja inclusa nos resultados de saída. Assume o padrão de false. |
Entradas de habilidades
| Nome de entrada | Descrição |
|---|---|
text |
O texto a ser analisado. |
languageCode |
(opcional) Uma cadeia de caracteres que indica o idioma dos registros. Se este parâmetro não for especificado, o valor padrão é “en”. Consulte a Lista completa dos idiomas com suporte. |
Saídas de habilidades
| Nome de Saída | Descrição |
|---|---|
sentiment |
Um valor de cadeia de caracteres que representa o rótulo de sentimento de todo o texto analisado (positivo, neutro ou negativo). |
confidenceScores |
Um tipo complexo com três valores duplos, um para a classificação positiva, um para a classificação neutra e outro para a classificação negativa. Os valores variam de 0 a 1,00, em que 1,00 representa a maior confiança possível em uma determinada atribuição de rótulo. |
sentences |
Uma coleção de tipos complexos que divide o sentimento da frase do texto por frase. Esse também é o local em que os resultados da mineração de opiniões são retornados na forma de destinos e avaliações, se includeOpinionMining estiver definido como true. |
Definição de exemplo
{
"@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"
}
]
}
Entrada de exemplo
{
"values": [
{
"recordId": "1",
"data": {
"text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
"languageCode": "en"
}
}
]
}
Saída de exemplo
{
"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
}
],
}
]
}
}
]
}
Casos de aviso
Se o texto estiver vazio, um aviso será gerado e nenhuma pontuação de sentimentos retornará. Se não houver suporte para um idioma, será gerado um aviso e nenhuma pontuação de sensibilidade retornará.