Métadonnées d'entité

  • Article

L’objet de métadonnées d’entité capture des informations supplémentaires facultatives à propos des entités détectées. Cela fournit des résolutions spécifiques pour les entités numériques et temporelles. Cet attribut est alimenté uniquement lorsqu’il existe des données supplémentaires disponibles, ce qui améliore l’exhaustivité des entités détectées. Le composant Métadonnées englobe des résolutions conçues pour les entités numériques et temporelles. Il est important de gérer les cas où l’attribut Métadonnées peut être vide ou absent, car sa présence n’est pas garantie pour chaque entité.

Actuellement, les composants de métadonnées gèrent les résolutions au format standard pour une entité. Les entités peuvent être exprimées sous différentes formes et résolutions, et fournissent des formats prédictibles standard pour les types modifiables courants. Par exemple, « quatre-vingts » et « 80 » devraient tous deux donner le nombre entier 80.

Vous pouvez utiliser des résolutions NER pour implémenter des actions ou récupérer des informations supplémentaires. Par exemple, votre service peut extraire des entités DateHeure pour extraire des dates et des heures qui sont fournies à un système de planification de réunion.

Notes

Les métadonnées d’entité sont uniquement prises en charge à partir de api-version=2023-04-15-preview. Pour les versions antérieures de l’API, vous pouvez consulter l’article Résolutions d’entité.

Cet article documente les objets de résolution retournés pour chaque catégorie ou sous-catégorie d’entité dans l’objet de métadonnées.

Entités numériques

Age

Exemples : « 10 ans », « 23 mois », « 60 ans ».

"metadata": {
                "unit": "Year",
                "value": 10
            }

Les valeurs possibles pour « unit » sont :

  • Year
  • Month
  • Semaine
  • Jour

Devise

Exemples : « 30 livres égyptiennes », « 77 USD »

"metadata": {
                "unit": "Egyptian pound",
                "ISO4217": "EGP",
                "value": 30
            }

Valeurs possibles pour « unité » et « ISO4217 » :

Entités DateHeure/temporelles

Le datetime inclut plusieurs sous-types différents qui retournent différents objets de réponse.

Date

Jours spécifiques.

Exemples : « 1er janvier 1995 », « 12 avril », « 7 octobre 2022 », « demain »

"metadata": {
                "dateValues": [
                    {
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]
            }

Chaque fois qu’une date ambiguë est fournie, vous disposez de différentes options pour votre résolution. Par exemple, « 12 avril » peut faire référence à n’importe quelle année. La résolution fournit cette année et la suivante comme options. La valeur timexXXXX indique qu’aucune année n’a été spécifiée dans la requête.

"metadata": {
                "dateValues": [
                    {
                        "timex": "XXXX-04-12",
                        "value": "2022-04-12"
                    },
                    {
                        "timex": "XXXX-04-12",
                        "value": "2023-04-12"
                    }
                ]
            }

L’ambiguïté peut se produire même pour un jour donné de la semaine. Par exemple, dire « lundi » peut faire référence à lundi dernier ou à ce lundi. Une fois encore, la valeur timex indique qu’aucune année ou aucun mois n’a été spécifié, et utilise un identifiant de jour de la semaine (W) pour indiquer le premier jour de la semaine.

"metadata" :{
                "dateValues": [
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-03"
                    },
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-10"
                    }
                ]
            }

Temps

Heures spécifiques.

Exemples : « 9:39:33 AM », « sept heures du matin », « 20:03 »

"metadata": {
                "timex": "T09:39:33",
                "value": "09:39:33"
            }

Datetime

Combinaisons de date et d’heure spécifiques.

Exemples : « 18 heures demain », « 20 heures le 3 janvier », « 1er novembre 19:30 »

"metadata": {
                "timex": "2022-10-07T18",
                "value": "2022-10-07 18:00:00"
            }

Comme pour les dates, vous pouvez avoir des entités datetime ambiguës. Par exemple, « 3 mai midi » peut faire référence à n’importe quelle année. La résolution fournit cette année et la suivante comme options. La valeur timexXXXX indique qu’aucune année n’a été spécifiée.

"metadata": {
                 "dateValues": [ 
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2022-05-03 12:00:00"
                       },
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2023-05-03 12:00:00"
                       }
                  ]
              }

Plages de datetimes

Une plage de datetimes est une période avec une date, une heure ou une date/heure de début et de fin.

Exemples : « du 3 janvier 6h au 25 avril 20h 2022 », « entre le lundi et le jeudi », « juin », « le week-end »

Le paramètre « duration » indique le temps écoulé en secondes (S), minutes (M), heures (H) ou jours (J). Ce paramètre est retourné uniquement lorsqu’une date/heure de début et de fin explicite figure dans la requête. « Semaine prochaine » ne renverrait que les paramètres « begin » et « end » pour la semaine.

"metadata": {
                "duration": "PT2702H",
                "begin": "2022-01-03 06:00:00",
                "end": "2022-04-25 20:00:00"
            }

Définissez

Un ensemble est une période de dates/heures récurrente. Les ensembles ne sont pas résolus en valeurs exactes, car ils n’indiquent pas de datetime exact.

Exemples : « tous les lundis à 18 heures », « tous les jeudis », « tous les week-ends »

Pour « tous les lundis à 18 heures », la valeur timex n’indique aucune année précise et commence par XXXX, puis tous les lundis jusqu’à WXX-1 pour déterminer le premier jour de chaque semaine, et enfin T18 pour indiquer 18 heures.

"metadata": {
                "timex": "XXXX-WXX-1T18",
                "value": "not resolved"
            }

Dimensions

Exemples : « 24 km/h », « 44 mètres carrés », « soixante-six kilo-octets »

"metadata": {
                "unit": "KilometersPerHour",
                "value": 24
            }

Valeurs possibles pour les valeurs du champ « unité » :

  • Pour les mesures :

    • SquareKilometer
    • SquareHectometer
    • SquareDecameter
    • SquareMeter
    • SquareDecimeter
    • SquareCentimeter
    • SquareMillimeter
    • SquareInch
    • SquareFoot
    • SquareMile
    • SquareYard
    • Acre

  • Pour les informations :

    • bit
    • Kilobit
    • Megabit
    • Go
    • Terabit
    • Petabit
    • Byte
    • Kilo-octet
    • Mégaoctet
    • Gigaoctet
    • Téraoctet
    • Pétaoctet

  • Pour la longueur, la largeur, la hauteur :

    • Kilomètre
    • Hectometer
    • Decameter
    • Compteur
    • Decimeter
    • Centimètre
    • Millimètre
    • Micrometer
    • Nanometer
    • Picometer
    • Mile
    • Yard
    • Pouce
    • Pied
    • Light year
    • Pt

  • Pour la vitesse :

    • MetersPerSecond
    • KilometersPerHour
    • KilometersPerMinute
    • KilometersPerSecond
    • MilesPerHour
    • Knot
    • FootPerSecond
    • FootPerMinute
    • YardsPerMinute
    • YardsPerSecond
    • MetersPerMillisecond
    • CentimetersPerMillisecond
    • KilometersPerMillisecond

  • Pour le volume :

    • CubicMeter
    • CubicCentimeter
    • CubicMillimiter
    • Hectoliter
    • Decaliter
    • Litre
    • Décilitre
    • Centilitre
    • Millilitre
    • CubicYard
    • CubicInch
    • CubicFoot
    • CubicMile
    • FluidOunce
    • Teaspoon
    • Tablespoon
    • Pint
    • Quart
    • Tasse
    • Gill
    • Pincer
    • FluidDram
    • Barrel
    • Minim
    • Cord
    • Peck
    • Bushel
    • Hogshead

  • Pour le poids :

    • Kilogram
    • Gramme
    • Milligram
    • Microgram
    • Gallon
    • MetricTon
    • Tonne
    • Dièse
    • Ounce
    • Grain
    • Pennyweight
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Pierre
    • Dram

Ordinal

Exemples : « 3e », « 1er », « dernier »

"metadata": {
                "offset": "3",
                "relativeTo": "Start",
                "value": "3"
            }

Valeurs possibles pour « relativeTo » :

  • Démarrer
  • End

Température

Exemples : « 88 deg fahrenheit », « vingt-trois degrés celsius »

"metadata": {
                "unit": "Fahrenheit",
                "value": 88
            }

Les valeurs possibles pour « unit » sont :

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine