Modifications de l’API en préversion

Cet article offre une vue d’ensemble des modifications de la nouvelle API comparé à la version 2023-04-15-preview. Cette modification de l’API introduit essentiellement deux nouveaux concepts (entity types et entity tags) qui remplacent les champs category et subcategory dans l’actuelle API en disponibilité générale. Vous trouverez une vue d’ensemble détaillée de chaque paramètre d’API et les versions d’API prises en charge qu’il correspond à [Paramètres de compétence][.. Page /how-to/skill-parameters.md]

Types d’entités

Les types d’entités représentent la granularité la plus faible (ou la plus fine) à laquelle une entité est détectée et peuvent être considérés comme la classe de base détectée.

Étiquettes d’entité

Les étiquettes d’entité permettent d’identifier davantage une entité. L’entité détectée est marquée par le type d’entité et par des étiquettes supplémentaires pour différencier l’entité identifiée. La liste des étiquettes d’entité peut être considérée comme incluant des catégories, des sous-catégories, des sous-catégories secondaires, etc.

Modifications de l’API en préversion comparé à l’API en disponibilité générale

Les modifications introduisent une plus grande flexibilité pour le service de reconnaissance des entités nommées, notamment :

Mises à jour de la structure des formats d’entrée : • InclusionList • ExclusionList • Stratégie de chevauchement

Mises à jour de la gestion des formats de sortie :

  • Des résultats de la reconnaissance d’entités plus granulaires grâce à l’introduction d’une liste d’étiquettes, ce qui permet de marquer une entité avec plusieurs étiquettes d’entité.
  • Les entités qui se chevauchent, ce qui permet de reconnaître les entités comme relevant de plusieurs types d’entités et de les retourner à deux reprises, le cas échéant. Si une entité est reconnue comme appartenant à deux étiquettes d’entité d’un même type d’entité, les deux étiquettes d’entité sont retournées dans la liste d’étiquettes.
  • Pour en savoir plus sur le filtrage d’entités à l’aide d’étiquettes d’entité, accédez à cet article.
  • Les objets de métadonnées qui contiennent des informations supplémentaires sur l’entité, mais qui agissent uniquement comme wrapper de la fonctionnalité de résolution d’entité existante pour le moment. Pour en savoir plus sur cette nouvelle fonctionnalité, consultez cette page.

Mappage des entités de l’API en disponibilité générale vers l’API en préversion

Pour obtenir une comparaison entre la structure des catégories/types d’entités, consultez l’article Catégories d’entités de reconnaissance d’entité nommée (NER) et types d’entités pris en charge. Vous trouverez ci-dessous un tableau décrivant les mappages entre les résultats attendus de l’API en disponibilité générale et ceux de l’API en préversion.

Type Balises
Date Temporal, Date
DateRange Temporal, DateRange
DateTime Temporal, DateTime
DateTimeRange Temporal, DateTimeRange
Duration Temporal, Duration
SetTemporal Temporal, SetTemporal
Heure Temporal, Time
TimeRange Temporal, TimeRange
City GPE, Location, City
State GPE, Location, State
CountryRegion GPE, Location, CountryRegion
Continent GPE, Location, Continent
GPE Location, GPE
Emplacement Emplacement
Airport Structural, Location
Structurel Location, Structural
Geological Location, Geological
Age Numeric, Age
Devise Numeric, Currency
Number Numeric, Number
PhoneNumber PhoneNumber
NumberRange Numeric, NumberRange
Pourcentage Numeric, Percentage
Ordinal Numeric, Ordinal
Température Numeric, Dimension, Temperature
Vitesse Numeric, Dimension, Speed
Poids Numeric, Dimension, Weight
Hauteur Numeric, Dimension, Height
Longueur Numeric, Dimension, Length
Volume Numeric, Dimension, Volume
Domaine Numeric, Dimension, Area
Information Numeric, Dimension, Information
Adresse Adresse
Personne Personne
PersonType PersonType
Organisation Organisation
Produit Produit
ComputingProduct Product, ComputingProduct
IP IP
E-mail Courrier
URL URL
Compétence Compétence
Événement Événement
CulturalEvent Event, CulturalEvent
SportsEvent Event, SportsEvent
NaturalEvent Event, NaturalEvent