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 usa los modelos de aprendizaje automático proporcionados por la versión 3 de Language Service en Foundry Tools. 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.

Note

Esta aptitud está enlazada a Foundry Tools y requiere un recurso facturable para transacciones que superen los 20 documentos por indexador al día. La ejecución de aptitudes integradas se cobra por el precio estándar de Las herramientas de foundry existentes.

@odata.type

Microsoft.Skills.Text.V3.SentimentSkill

Data limits

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.

Skill parameters

Los parámetros distinguen mayúsculas de minúsculas.

Parameter Name Description
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.

Skill inputs

Input Name Description
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).

Skill outputs

Output Name Description
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.

Sample definition

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

Sample input

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

Sample output

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

Warning cases

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.

See also