Aptitud cognitiva Opinión (v3)
La aptitud Opinión (v3) evalúa texto no estructurado y, para cada registro, proporciona etiquetas de opinión (como "negativa", "neutra" y "positiva") en función de la puntuación de confianza más alta que encontró el servicio a nivel de la oración y del documento. Esta aptitud utiliza los modelos de Machine Learning proporcionados por la versión 3 de Servicio de lenguaje en los servicios de Azure AI. También expone las funcionalidades de minería de opiniones, que proporciona información más pormenorización sobre las opiniones relacionadas con atributos de productos o servicios en texto.
Nota:
Esta aptitud está enlazada a los servicios de Azure AI y necesita un recurso facturable para las transacciones que superan los 20 documentos por indexador al día. La ejecución de aptitudes integradas se carga al actual precio de pago por uso de los servicios de Azure AI.
@odata.type
Microsoft.Skills.Text.V3.SentimentSkill
Límites de datos
El tamaño máximo de un registro debe tener 5000 caracteres, medido por String.Length. Si tiene que desglosar los datos antes de enviarlos a la aptitud de opiniones, use la aptitud División de texto.
Parámetros de la aptitud
Los parámetros distinguen mayúsculas de minúsculas.
| Nombre de parámetro | Descripción |
|---|---|
defaultLanguageCode |
(Opcional) Es el código de idioma que se aplicará a los documentos que no especifiquen el lenguaje de forma explícita. Vea Full list of supported languages (Lista completa de idiomas admitidos). |
modelVersion |
(Opcional) Especifica la versión del modelo que se va a usar al llamar al análisis de sentimiento. Si no se especifica, el valor predeterminado será la versión más reciente disponible. Se recomienda no especificar este valor a menos que sea necesario. |
includeOpinionMining |
Si se establece en true, habilita la característica de minería de opiniones, que permite incluir en los resultados de salida el análisis de sentimiento basado en aspectos. Tiene como valor predeterminado false. |
Entradas de la aptitud
| Nombre de entrada | Descripción |
|---|---|
text |
Texto que se va a analizar. |
languageCode |
(Opcional) Cadena que indica el idioma de los registros. Si esta no se especifica este parámetro, se usa el valor predeterminado "en". Vea Full list of supported languages (Lista completa de idiomas admitidos). |
Salidas de la aptitud
| Nombre de salida | Descripción |
|---|---|
sentiment |
Valor de cadena que representa la etiqueta de opinión de todo el texto analizado (positiva, neutra o negativa). |
confidenceScores |
Un tipo complejo con tres valores dobles, uno para la calificación positiva, otro para la calificación neutra y otro para la calificación negativa. Los valores oscilan entre 0 y 1,00, donde 1,00 representa la mayor confianza posible en una asignación de etiqueta determinada. |
sentences |
Colección de tipos complejos que desglosa la opinión del texto frase por frase. Aquí también es donde se devuelven los resultados de minería de opiniones en forma de destinos y evaluaciones si includeOpinionMining se establece en true. |
Definición de ejemplo
{
"@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 ejemplo
{
"values": [
{
"recordId": "1",
"data": {
"text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
"languageCode": "en"
}
}
]
}
Salida de ejemplo
{
"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 advertencia
Si el texto está vacío, se genera una advertencia y no se devuelven resultados de opinión. Si no se admite un idioma, se genera una advertencia y no se devuelven resultados de opinión.