Modifications de l’API en préversion
Cet article offre une vue d’ensemble des modifications de la nouvelle API comparé à la version 2024-11-01. 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 des versions 2022-05-01 et 2023-04-01 vers la version 2024-11-01 de l’API
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.
Versions 2022-05-01 et 2023-04-01 vers la version actuelle des mappages d'entités API
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 à partir des versions 2022-05-01 et 2023-04-01 et la version actuelle de l’API.
| 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 |
| Courrier | |
| URL | URL |
| Compétence | Compétence |
| Événement | Événement |
| CulturalEvent | Event, CulturalEvent |
| SportsEvent | Event, SportsEvent |
| NaturalEvent | Event, NaturalEvent |