Aptitud cognitiva OpiniónSentiment cognitive skill

La aptitud Opinión evalúa el texto no estructurado a lo largo de una continuidad positiva-negativa y, para cada registro, devuelve un valor numérico entre 0 y 1.The Sentiment skill evaluates unstructured text along a positive-negative continuum, and for each record, returns a numeric score between 0 and 1. Las puntuaciones próximas a 1 indican una opinión positiva y las puntuaciones próximas a 0 indican una opinión negativa.Scores close to 1 indicate positive sentiment, and scores close to 0 indicate negative sentiment. Esta aptitud utiliza los modelos de aprendizaje automático proporcionados por Text Analytics en Cognitive Services.This skill uses the machine learning models provided by Text Analytics in Cognitive Services.

Nota

A medida que expanda el ámbito aumentando la frecuencia de procesamiento, agregando más documentos o agregando más algoritmos de IA, tendrá que asociar un recurso facturable de Cognitive Services.As you expand scope by increasing the frequency of processing, adding more documents, or adding more AI algorithms, you will need to attach a billable Cognitive Services resource. Se acumulan cargos cuando se llama a las API de Cognitive Services y en la extracción de imágenes como parte de la fase de descifrado de documentos de Azure Cognitive Search.Charges accrue when calling APIs in Cognitive Services, and for image extraction as part of the document-cracking stage in Azure Cognitive Search. No hay ningún cargo por la extracción de texto de documentos.There are no charges for text extraction from documents.

La ejecución de aptitudes integradas se cobra según los precios de pago por uso de Cognitive Services existentes.Execution of built-in skills is charged at the existing Cognitive Services pay-as-you go price. Los precios de la extracción de imágenes se describen en la página de precios de Búsqueda cognitiva de Azure.Image extraction pricing is described on the Azure Cognitive Search pricing page.

@odata.type

Microsoft.Skills.Text.SentimentSkillMicrosoft.Skills.Text.SentimentSkill

Límites de datosData limits

El tamaño máximo de un registro debe tener 5000 caracteres, medido por String.Length.The maximum size of a record should be 5000 characters as measured by String.Length. Si tiene que dividir los datos antes de enviarlos al analizador de opiniones, use la aptitud División de texto.If you need to break up your data before sending it to the sentiment analyzer, use the Text Split skill.

Parámetros de la aptitudSkill parameters

Los parámetros distinguen mayúsculas de minúsculas.Parameters are case-sensitive.

Nombre de parámetroParameter Name
defaultLanguageCodedefaultLanguageCode (Opcional) Es el código de idioma que se aplicará a los documentos que no especifiquen el lenguaje de forma explícita.(optional) The language code to apply to documents that don't specify language explicitly.
Vea Full list of supported languages (Lista completa de idiomas admitidos).See Full list of supported languages

Entradas de la aptitudSkill inputs

Nombre de entradaInput Name DESCRIPCIÓNDescription
texttext Texto que se va a analizar.The text to be analyzed.
languageCodelanguageCode (Opcional) Cadena que indica el idioma de los registros.(Optional) A string indicating the language of the records. Si esta no se especifica este parámetro, se usa el valor predeterminado "en".If this parameter is not specified, the default value is "en".
Vea Full list of supported languages (Lista completa de idiomas admitidos).See Full list of supported languages.

Salidas de la aptitudSkill outputs

Nombre de salidaOutput Name DESCRIPCIÓNDescription
de la aplicaciónscore Un valor entre 0 y 1 que representa la opinión del texto analizado.A value between 0 and 1 that represents the sentiment of the analyzed text. Valores próximos a 0 tienen opiniones negativo, los valores próximos a 0,5 tienen opiniones neutras y los valores próximos a 1 tienen opiniones positivas.Values close to 0 have negative sentiment, close to 0.5 have neutral sentiment, and values close to 1 have positive sentiment.

Definición de ejemploSample definition

{
    "@odata.type": "#Microsoft.Skills.Text.SentimentSkill",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        },
        {
            "name": "languageCode",
            "source": "/document/languagecode"
        }
    ],
    "outputs": [
        {
            "name": "score",
            "targetName": "mySentiment"
        }
    ]
}

Entrada de ejemploSample 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"
            }
        }
    ]
}

Salida de ejemploSample output

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "score": 0.01
            }
        }
    ]
}

NotasNotes

Si no hay nada, no se devuelve una puntuación de la opinión para dichos registros.If empty, a sentiment score is not returned for those records.

Casos de errorError cases

Si no se admite un idioma, se genera un error y no se devuelve ninguna puntuación de opinión.If a language is not supported, an error is generated and no sentiment score is returned.

Otras referenciasSee also