Partager via

Compétences cognitives dépréciées dans Azure AI Search

  • Article

Ce document décrit les compétences cognitives qui sont considérées comme déconseillées (retirées). Utilisez le guide suivant pour le contenu :

  • Nom de compétence : nom de la compétence dépréciée. Il est mappé à l’attribut @odata.type.
  • Dernière version de l’API disponible : dernière version de l’API publique d’Azure AI Search via laquelle les compétences contenant la compétence déconseillée correspondante peut être créée/mise à jour. Les indexeurs auxquels sont attachés des ensembles de compétences ayant ces compétences continueront de s’exécuter même dans les futures versions d’API jusqu’à la date de « fin de support », date après laquelle ils cesseront de s’exécuter correctement.
  • Fin de support : jour au-delà duquel la compétence correspondante est considérée comme non prise en charge et cesse de fonctionner. Les compétences créées précédemment doivent continuer à fonctionner, mais il est recommandé aux utilisateurs de migrer hors d’une compétence déconseillée.
  • Recommandations : chemin de migration vers l’avant pour utiliser une compétence prise en charge. Il est conseillé aux utilisateurs de suivre ces suggestions pour continuer à bénéficier du support technique.

Si vous utilisez Microsoft.Skills.Text.EntityRecognitionSkill (Compétence cognitive de reconnaissance des entités (v2)), cet article va vous aider à mettre à niveau votre ensemble de compétences vers Microsoft.Skills.Text.V3.EntityRecognitionSkill, qui est en disponibilité générale et introduit de nouvelles fonctionnalités.

Si vous utilisez Microsoft.Skills.Text.SentimentSkill (compétence cognitive Sentiment (v2)), cet article va vous aider à mettre à niveau votre ensemble de compétences vers Microsoft.Skills.Text.v3.SentimentSkill, qui est en disponibilité générale et introduit de nouvelles fonctionnalités.

Si vous utilisez Microsoft.Skills.Text.NamedEntityRecognitionSkill (Compétence cognitive de reconnaissance des entités nommées(v2)), cet article va vous aider à mettre à niveau votre ensemble de compétences vers Microsoft.Skills.Text.v3.EntityRecognitionSkill, qui est en disponibilité générale et introduit de nouvelles fonctionnalités.

Microsoft.Skills.Text.EntityRecognitionSkill

Dernière version d’API disponible

Préversion du 30/04/2021

Fin de la prise en charge

31 août 2024

Recommandations

Utilisez Microsoft.Skills.Text.V3.EntityRecognitionSkill à la place. Il fournit la plupart des fonctionnalités de EntityRecognitionSkill avec une qualité supérieure. Il détient également des informations plus riches dans ses champs de sortie complexes.

Pour migrer vers Microsoft.Skills.Text.V3.EntityRecognitionSkill, apportez un ou plusieurs des changements suivants à votre définition de compétence. Vous pouvez mettre à jour la définition de compétence à l’aide de l’API de mise à jour de compétences.

  1. (Obligatoire) Modifiez @odata.type en remplaçant "#Microsoft.Skills.Text.EntityRecognitionSkill" par "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Facultatif) Le paramètre includeTypelessEntities n’est plus pris en charge, car la nouvelle compétence retourne uniquement les entités ayant des types connus. Ainsi, si votre précédente définition de compétence le référence, vous devez désormais le supprimer.

  3. (Facultatif) Si vous utilisez la sortie namedEntities, cela signifie que quelques changements mineurs ont été apportés aux noms de propriétés.

    1. value est renommé text
    2. confidence est renommé confidenceScore

    Si vous devez générer exactement les mêmes noms de propriétés, ajoutez ShaperSkill pour remodéliser la sortie avec les noms nécessaires. Par exemple, ce ShaperSkill renomme les propriétés en utilisant leurs anciennes valeurs.

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

  4. (Facultatif) Si vous utilisez la sortie entities pour lier des entités à des entités bien connues, cette fonctionnalité est désormais une nouvelle compétence, Microsoft.Skills.Text.V3.EntityLinkingSkill. Ajoutez la compétence de liaison d’entités à votre ensemble de compétences pour générer les entités liées. Quelques changements mineurs ont également été apportés aux noms de propriétés de la sortie entities entre EntityRecognitionSkill et le nouveau EntityLinkingSkill.

    1. wikipediaId est renommé id
    2. wikipediaLanguage est renommé language
    3. wikipediaUrl est renommé url
    4. Les propriétés type et subtype ne sont plus retournées.

    Si vous devez générer exactement les mêmes noms de propriétés, ajoutez ShaperSkill pour remodéliser la sortie avec les noms nécessaires. Par exemple, ce ShaperSkill renomme les propriétés en utilisant leurs anciennes valeurs.

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

  5. (Facultatif) Si vous ne spécifiez pas explicitement categories, EntityRecognitionSkill V3 peut retourner un type différent de catégories en plus de celles qui étaient prises en charge par EntityRecognitionSkill. Si ce comportement est indésirable, veillez à définir explicitement le paramètre categories sur ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

    Exemples de définitions de migration

    • Migration simple

      (Avant) Définition de compétence EntityRecognition

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

      (Après) Définition de compétence EntityRecognition V3

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

    • Migration complexe

      (Avant) Définition de compétence 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"
        }
    ]
}

      (Après) Définition de compétence 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

Dernière version d’API disponible

Préversion du 30/04/2021

Fin de la prise en charge

31 août 2024

Recommandations

Utilisez Microsoft.Skills.Text.V3.SentimentSkill à la place. Il fournit un modèle amélioré et permet d’ajouter l’exploration des opinions, ou l’analyse des sentiments basés sur l’aspect. Dans la mesure où la compétence est nettement plus complexe, les sorties sont également très différentes.

Pour migrer vers Microsoft.Skills.Text.V3.SentimentSkill, apportez un ou plusieurs des changements suivants à votre définition de compétence. Vous pouvez mettre à jour la définition de compétence à l’aide de l’API de mise à jour de compétences.

Remarque

Les sorties de compétence pour la compétence Sentiment V3 ne sont pas compatibles avec la définition d’index basée sur SentimentSkill. Vous devez apporter des changements à la définition d’index, à l’ensemble de compétences (entrées de compétence et/ou projections de base de connaissances) ainsi qu’aux mappages de champs de sortie de l’indexeur pour remplacer la compétence de sentiment par la nouvelle version.

  1. (Obligatoire) Modifiez @odata.type en remplaçant "#Microsoft.Skills.Text.SentimentSkill" par "#Microsoft.Skills.Text.V3.SentimentSkill".

  2. (Obligatoire) La compétence Sentiment V3 fournit un score positive, neutral et negative pour l’ensemble du texte ainsi que pour chaque phrase de l’ensemble du texte, alors que la précédente compétence SentimentSkill fournissait uniquement une seule valeur double comprise entre 0,0 (négatif) et 1,0 (positif) pour l’ensemble du texte. Vous devez mettre à jour votre définition d’index pour accepter les trois valeurs doubles à la place d’un seul score. Vous devez également vérifier que les entrées de compétence en aval, les projections de base de connaissances et les mappages de champs de sortie sont cohérents par rapport aux changements de noms.

Il est recommandé de remplacer complètement l’ancien SentimentSkill par SentimentSkill V3, de mettre à jour les entrées de compétence en aval, les projections de base de connaissances, les mappages de champs de sortie de l’indexeur ainsi que la définition d’index pour correspondre au nouveau format de sortie, puis de réinitialiser l’indexeur pour que tous vos documents aient des résultats d’analyse de sentiments cohérents à l’avenir.

Remarque

Si vous avez besoin d’aide supplémentaire pour mettre à jour votre pipeline d’enrichissement afin d’utiliser la dernière version de la compétence Sentiment, ou si la réinitialisation de l’indexeur n’est pas une option pour vous, ouvrez une nouvelle demande de support pour que nous puissions travailler directement avec vous.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Dernière version d’API disponible

2017-11-11-Preview

Fin de la prise en charge

31 août 2024

Recommandations

Utilisez Microsoft.Skills.Text.V3.EntityRecognitionSkill à la place. Il fournit la plupart des fonctionnalités de NamedEntityRecognitionSkill à un meilleur niveau de qualité. Il détient également des informations plus riches dans ses champs de sortie complexes.

Pour migrer vers Microsoft.Skills.Text.V3.EntityRecognitionSkill, apportez un ou plusieurs des changements suivants à votre définition de compétence. Vous pouvez mettre à jour la définition de compétence à l’aide de l’API de mise à jour de compétences.

  1. (Obligatoire) Modifiez @odata.type en remplaçant "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" par "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Facultatif) Si vous utilisez la sortie entities, utilisez la sortie de collection complexe namedEntities issue de EntityRecognitionSkill V3 à la place. Quelques changements mineurs ont été apportés aux noms de propriétés de la nouvelle sortie complexe de namedEntities :

    1. value est renommé text
    2. confidence est renommé confidenceScore

    Si vous devez générer exactement les mêmes noms de propriétés, ajoutez ShaperSkill pour remodéliser la sortie avec les noms nécessaires. Par exemple, ce ShaperSkill renomme les propriétés en utilisant leurs anciennes valeurs.

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

  3. (Facultatif) Si vous ne spécifiez pas explicitement categories, EntityRecognitionSkill V3 peut retourner un type différent de catégories en plus de celles qui étaient prises en charge par NamedEntityRecognitionSkill. Si ce comportement est indésirable, veillez à définir explicitement le paramètre categories sur ["Person", "Location", "Organization"].

    Exemples de définitions de migration

    • Migration simple

      (Avant) Définition de compétence NamedEntityRecognition

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

      (Après) Définition de compétence EntityRecognition V3

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

    • Migration légèrement compliquée

      (Avant) Définition de compétence 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"
        }
    ]
}

      (Après) Définition de compétence 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"
        }
    ]
}

Voir aussi