Partager via


Résoudre les entités en formats standard

Une résolution est un 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 datetime pour extraire des dates et des heures qui seront fournies à un système de planification de réunion.

Important

À partir de la version 2023-04-15-preview, la fonctionnalité de résolution d'entité est remplacée par des métadonnées d'entité

Remarque

Les réponses de résolution d’entités sont uniquement prises en charge à partir de l’api-version=2022-10-01-preview et de "modelVersion": "2022-10-01-preview".

Cet article documente les objets de résolution retournés pour chaque catégorie d’entité ou sous-catégorie.

Age

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

"resolutions": [
                    {
                        "resolutionKind": "AgeResolution",
                        "unit": "Year",
                        "value": 10
                    }
                ]

Les valeurs possibles pour « unit » sont :

  • Year
  • Month
  • Semaine
  • Jour

Devise

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

"resolutions": [
                    {
                        "resolutionKind": "CurrencyResolution",
                        "unit": "Egyptian pound",
                        "ISO4217": "EGP",
                        "value": 30
                    }
                ]

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

Datetime

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 »

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "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.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "XXXX-04-12",
                        "value": "2022-04-12"
                    },
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "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.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-03"
                    },
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-10"
                    }
                ]

Temps

Heures spécifiques.

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

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Time",
                        "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 »

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "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.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "timex": "XXXX-05-03T12",
                        "value": "2022-05-03 12:00:00"
                    },
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "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.

"resolutions": [
                    {
                        "resolutionKind": "TemporalSpanResolution",
                        "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.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Set",
                        "timex": "XXXX-WXX-1T18",
                        "value": "not resolved"
                    }
                ]

Dimensions

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

"resolutions": [
                    {
                        "resolutionKind": "SpeedResolution",
                        "unit": "KilometersPerHour",
                        "value": 24
                    }
                ]

Valeurs possibles pour « resolutionKind » et leurs valeurs « unit » :

  • AreaResolution :

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

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

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

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

    • 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
  • WeightResolution :

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

Number

Exemples : « 27 », « cent trois », « 38,5 », « 2/3 », « 33% »

"resolutions": [
                    {
                        "resolutionKind": "NumberResolution",
                        "numberKind": "Integer",
                        "value": 27
                    }
                ]

Valeurs possibles pour « numberKind » :

  • Integer
  • Decimal
  • Fraction
  • Power
  • Pourcentage

Ordinal

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

"resolutions": [
                    {
                        "resolutionKind": "OrdinalResolution",
                        "offset": "3",
                        "relativeTo": "Start",
                        "value": "3"
                    }
                ]

Valeurs possibles pour « relativeTo » :

  • Démarrer
  • End

Température

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

"resolutions": [
                    {
                        "resolutionKind": "TemperatureResolution",
                        "unit": "Fahrenheit",
                        "value": 88
                    }
                ]

Les valeurs possibles pour « unit » sont :

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine