Compartir vía


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.

Consulte también