Aptitudes cognitivas en desuso en Azure AI Search

Artículo
11/15/2023

En este documento se describen las aptitudes cognitivas que se consideran en desuso (retirado). Use la siguiente guía para el contenido:

Nombre de la aptitud: nombre de la aptitud que quedará en desuso; se asigna al atributo @odata.type.
Última versión de API disponible: la última versión de la API pública de Azure AI Search a través de la cual se pueden crear o actualizar conjuntos de habilidades que contienen la correspondiente aptitud en desuso. Los indexadores con conjuntos de aptitudes asociados que tengan estas aptitudes seguirán funcionando incluso en futuras versiones de la API hasta la fecha de "finalización del soporte técnico", momento en el que empezarán a dar error.
Finalización del soporte técnico: el día después del cual se considera que la aptitud deja de tener soporte técnico y de funcionar. Los conjuntos de habilidades creados anteriormente todavía funcionan, pero se recomienda a los usuarios realizar la migración desde una aptitud en desuso.
Recomendaciones: Ruta de migración hacia delante para usar una aptitud admitida. Se aconseja a los usuarios seguir las recomendaciones para continuar recibiendo soporte técnico.

Si usa Microsoft.Skills.Text.EntityRecognitionSkill (Aptitud cognitiva Reconocimiento de entidades [versión 2]), este artículo le ayuda a actualizar su conjunto de aptitudes para usar Microsoft.Skills.Text.v2.EntityRecognitionSkill, que está disponible de forma general e incorpora nuevas características.

Si usa Microsoft.Skills.Text.SentimentSkill (Aptitud cognitiva Opinión [versión 2]), este artículo le ayudará a actualizar su conjunto de aptitudes para usar Microsoft.Skills.Text.v2.SentimentSkill, que está disponible de forma general e incorpora nuevas características.

Si usa Microsoft.Skills.Text.NamedEntityRecognitionSkill (Aptitud cognitiva Reconocimiento de entidades con nombre [versión 2]), este artículo le ayudará a actualizar su conjunto de aptitudes para usar Microsoft.Skills.Text.v2.EntityRecognitionSkill, que está disponible de forma general e incorpora nuevas características.

Microsoft.Skills.Text.EntityRecognitionSkill

Última versión de API disponible

2021-04-30-Preview

Finalización del soporte técnico

31 de agosto de 2024

Recomendaciones

Use Microsoft.Skills.Text.V3.EntityRecognitionSkill en su lugar. Proporciona la mayor parte de la funcionalidad de EntityRecognitionSkill con una calidad superior. También tiene una información más completa en sus campos de salida compleja.

Para migrar a Microsoft.Skills.Text.V3.EntityRecognitionSkill, realice uno o varios de los siguientes cambios en la definición de la aptitud. Puede actualizar la definición de aptitud mediante la API de actualización de conjuntos de aptitudes.

(Obligatorio) Cambie @odata.type de "#Microsoft.Skills.Text.EntityRecognitionSkill" a "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".
(Opcional) El parámetro includeTypelessEntities ya no se admite, ya que la nueva aptitud solo devuelve entidades con tipos conocidos, por lo que, si la definición de aptitud anterior hacía referencia a él, ahora debería quitarse.

(Opcional) Si usa el resultado namedEntities, hay algunos cambios secundarios en los nombres de las propiedades.

value ahora se llama text
confidence ahora se llama confidenceScore

Si necesita generar los mismos nombres de propiedad, agregue un objeto ShaperSkill para volver a dar forma al resultado con los nombres necesarios. Por ejemplo, este objeto ShaperSkill cambia el nombre de las propiedades a sus valores antiguos.

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntitiesV3/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntitiesV3/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntitiesV3/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntitiesV3/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntitiesV3/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "namedEntities"
        }
    ]
}

(Opcional) Si usa el resultado entities para vincular entidades a entidades conocidas, esta característica es ahora una nueva aptitud, Microsoft.Skills.Text.V3.EntityLinkingSkill. Agregue la aptitud de vinculación de entidad al conjunto de aptitudes para generar las entidades vinculadas. También hay algunos cambios secundarios en los nombres de las propiedades del resultado entities entre el objeto EntityRecognitionSkill y el nuevo objeto EntityLinkingSkill.

wikipediaId ahora se llama id
wikipediaLanguage ahora se llama language
wikipediaUrl ahora se llama url
Las propiedades type y subtype ya no se devuelven.

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "LinkedEntitiesShaper",
    "description": "LinkedEntitiesShaper",
    "context": "/document/linkedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/linkedEntitiesV3/*",
            "inputs": [
                {
                    "name": "name",
                    "source": "/document/linkedEntitiesV3/*/name"
                },
                {
                    "name": "wikipediaId",
                    "source": "/document/linkedEntitiesV3/*/id"
                },
                {
                    "name": "wikipediaLanguage",
                    "source": "/document/linkedEntitiesV3/*/language"
                },
                {
                    "name": "wikipediaUrl",
                    "source": "/document/linkedEntitiesV3/*/url"
                },
                {
                    "name": "bingId",
                    "source": "/document/linkedEntitiesV3/*/bingId"
                },
                {
                    "name": "matches",
                    "source": "/document/linkedEntitiesV3/*/matches"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

(Opcional) Si no especifica explícitamente categories, EntityRecognitionSkill V3 puede devolver un tipo diferente de categorías, además de las compatibles con EntityRecognitionSkill. Si no desea este comportamiento, asegúrese de establecer explícitamente el parámetro categories en ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

Definiciones de migración de ejemplo

Migración simple

(Antes) Definición de la aptitud EntityRecognition

{   
    "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

(Después) Definición de la aptitud EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

Migración complicada

(Antes) Definición de la aptitud EntityRecognition

{
    "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "includeTypelessEntities": true,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities",
            "targetName": "namedEntities"
        },
        {
            "name": "entities",
            "targetName": "entities"
        }
    ]
}

(Después) Definición de la aptitud EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities",
            "targetName": "namedEntitiesV3"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntitiesV3/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntitiesV3/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntitiesV3/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntitiesV3/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntitiesV3/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "namedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "entities",
            "targetName": "linkedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "LinkedEntitiesShaper",
    "description": "LinkedEntitiesShaper",
    "context": "/document/linkedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/linkedEntitiesV3/*",
            "inputs": [
                {
                    "name": "name",
                    "source": "/document/linkedEntitiesV3/*/name"
                },
                {
                    "name": "wikipediaId",
                    "source": "/document/linkedEntitiesV3/*/id"
                },
                {
                    "name": "wikipediaLanguage",
                    "source": "/document/linkedEntitiesV3/*/language"
                },
                {
                    "name": "wikipediaUrl",
                    "source": "/document/linkedEntitiesV3/*/url"
                },
                {
                    "name": "bingId",
                    "source": "/document/linkedEntitiesV3/*/bingId"
                },
                {
                    "name": "matches",
                    "source": "/document/linkedEntitiesV3/*/matches"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

Microsoft.Skills.Text.SentimentSkill

Última versión de API disponible

2021-04-30-Preview

Finalización del soporte técnico

31 de agosto de 2024

Recomendaciones

Use Microsoft.Skills.Text.V3.SentimentSkill en su lugar. Proporciona un modelo mejorado e incluye la opción de agregar minería de opiniones u opiniones basadas en aspectos. Como la aptitud es significativamente más compleja, los resultados también son muy diferentes.

Para migrar a Microsoft.Skills.Text.V3.SentimentSkill, realice uno o varios de los siguientes cambios en la definición de la aptitud. Puede actualizar la definición de aptitud mediante la API de actualización de conjuntos de aptitudes.

Nota:

Los resultados de aptitudes para la aptitud de opinión V3 no son compatibles con la definición de índice basada en SentimentSkill. Tendrá que realizar cambios en la definición del índice, el conjunto de aptitudes (entradas de aptitudes posteriores o proyecciones del almacén de conocimiento) y las asignaciones de campos de salida del indexador para reemplazar la aptitud de opinión por la nueva versión.

(Obligatorio) Cambie @odata.type de "#Microsoft.Skills.Text.SentimentSkill" a "#Microsoft.Skills.Text.V3.SentimentSkill".
(Obligatorio) La aptitud de opinión V3 proporciona una puntuación positive, neutral y negative para el texto general y las mismas puntuaciones para cada oración del texto general, mientras que el objeto SentimentSkill anterior solo proporcionaba un único doble que oscilaba entre 0 (negativo) y 1 (positivo) para el texto general. Deberá actualizar la definición de índice para aceptar los tres valores dobles en lugar de una sola puntuación y asegurarse de que todas las entradas de aptitud de nivel inferior, las proyecciones del almacén de conocimiento y las asignaciones de campos de salida sean coherentes con los cambios de nomenclatura.

Se recomienda reemplazar por completo el objeto SentimentSkill anterior por SentimentSkill V3, actualizar las entradas de aptitud de nivel inferior, las proyecciones del almacén de conocimiento, las asignaciones de campos de salida del indexador y la definición de índice para que coincidan con el nuevo formato de salida, y restablecer el indexador para que todos los documentos tengan resultados de opinión coherentes en el futuro.

Nota:

Si necesita ayuda adicional para actualizar la canalización de enriquecimiento a fin de usar la versión más reciente de la aptitud de opinión o si no considera restablecer el indexador como opción, abra una nueva solicitud de soporte técnico en la que podamos trabajar directamente con usted.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Última versión de API disponible

2017-11-11-Preview

Finalización del soporte técnico

31 de agosto de 2024

Recomendaciones

Use Microsoft.Skills.Text.V3.EntityRecognitionSkill en su lugar. Proporciona la mayor parte de la funcionalidad de NamedEntityRecognitionSkill con una calidad superior. También tiene una información más completa en sus campos de salida compleja.

(Obligatorio) Cambie @odata.type de "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" a "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

(Opcional) Si usa el resultado entities, utilice el resultado de la colección compleja namedEntities de EntityRecognitionSkill V3 en su lugar. Hay algunos cambios secundarios en los nombres de las propiedades del nuevo resultado complejo namedEntities:

value ahora se llama text
confidence ahora se llama confidenceScore

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntities",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntities/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntities/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntities/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntities/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntities/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

(Opcional) Si no especifica explícitamente categories, EntityRecognitionSkill V3 puede devolver un tipo diferente de categorías, además de las compatibles con NamedEntityRecognitionSkill. Si no desea este comportamiento, asegúrese de establecer explícitamente el parámetro categories en ["Person", "Location", "Organization"].

Definiciones de migración de ejemplo

Migración simple

(Antes) Definición de aptitud NamedEntityRecognition

{
    "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

(Después) Definición de la aptitud EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

Migración ligeramente complicada

(Antes) Definición de aptitud NamedEntityRecognition

{
    "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "entities"
        }
    ]
}

(Después) Definición de la aptitud EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntities",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntities/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntities/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntities/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntities/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntities/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

Aptitudes cognitivas en desuso en Azure AI Search

Microsoft.Skills.Text.EntityRecognitionSkill

Última versión de API disponible

Finalización del soporte técnico

Recomendaciones

Microsoft.Skills.Text.SentimentSkill

Última versión de API disponible

Finalización del soporte técnico

Recomendaciones

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Última versión de API disponible

Finalización del soporte técnico

Recomendaciones

Consulte también

Recursos adicionales