Compartir a través de


Resolución de entidades en formatos estándar

Una resolución es un formato estándar para una entidad. Las entidades se pueden expresar en varias formas y las resoluciones proporcionan formatos de predicción estándar para tipos cuantificables comunes. Por ejemplo, tanto "ochenta" como "80" deben resolverse en el entero 80.

Puede usar resoluciones de NER para implementar acciones o recuperar más información. Por ejemplo, el servicio puede extraer entidades datetime para extraer fechas y horas que se proporcionarán a un sistema de programación de reuniones.

Importante

A partir de la versión 2023-04-15-preview, la característica de resolución de entidades se reemplaza por metadatos de entidad

Nota:

Las respuestas de resolución de entidades solo se admiten a partir de api-version=2022-10-01-preview y "modelVersion": "2022-10-01-preview".

En este artículo se documentan los objetos de resolución devueltos para cada categoría o subcategoría de entidad.

Age

Ejemplos: "10 años", "23 meses", "sesenta años"

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

Los valores posibles para "unit" son:

  • Year
  • Month (Mes)
  • Semana
  • Día

Moneda

Ejemplos: "30 libras egipcias", "77 USD"

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

Valores posibles para "unit" e "ISO4217":

Datetime

Datetime incluye varios subtipos distintos que devuelven objetos de respuesta diferentes.

Date

Días específicos.

Ejemplos: "1 de enero de 1995", "12 de abril", "7 de octubre de 2022", "mañana"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]

Cada vez que se proporciona una fecha ambigua, se ofrecen diferentes opciones para la resolución. Por ejemplo, "12 de abril" podría hacer referencia a cualquier año. La resolución proporciona el año actual y el siguiente como opciones. El valor timexXXXX indica que no se especificó ningún año en la consulta.

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

La ambigüedad puede producirse incluso para un día determinado de la semana. Por ejemplo, decir "lunes" podría referirse al lunes pasado o a este lunes. Una vez más, el valor timex indica que no se especificó ningún año o mes y usa un día del identificador de semana (W) para indicar el primer día de la semana.

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

Hora

Horas específicas.

Ejemplos: "9:39:33 a. m.", "siete a. m.", "20:03"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Time",
                        "timex": "T09:39:33",
                        "value": "09:39:33"
                    }
                ]

Datetime

Combinaciones de fecha y hora específicas.

Ejemplos: "6 p. m. mañana", "8 p. m. el 3 de enero", "1 de noviembre 19:30"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "timex": "2022-10-07T18",
                        "value": "2022-10-07 18:00:00"
                    }
                ]

De forma similar a las fechas, puede tener entidades datetime ambiguas. Por ejemplo, "3 de mayo mediodía" podría referirse a cualquier año. La resolución proporciona el año actual y el siguiente como opciones. El valor timexXXXX indica que no se especificó ningún año.

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

Intervalos datetime

Un intervalo datetime es un período con una fecha, hora o datetime de inicio y finalización.

Ejemplos: "del 3 de enero a las 6 a. m. al 25 de abril a las 8 p. m. de 2022", "entre lunes y jueves", "junio", "el fin de semana"

El parámetro "duration" indica el tiempo transcurrido en segundos (S), minutos (M), horas (H) o días (D). Este parámetro solo se devuelve cuando una fecha y hora de inicio y de finalización explícitas están en la consulta. "Next week" solo se devolvería con los parámetros "begin" y "end" de la semana.

"resolutions": [
                    {
                        "resolutionKind": "TemporalSpanResolution",
                        "duration": "PT2702H",
                        "begin": "2022-01-03 06:00:00",
                        "end": "2022-04-25 20:00:00"
                    }
                ]

Set

Un conjunto es un período de datetime recurrente. Los conjuntos no se resuelven en valores exactos, ya que no indican una datetime exacta.

Ejemplos: "todos los lunes a las 6 p. m.", "todos los jueves", "cada fin de semana"

Para "todos los lunes a las 6 p m.", el valor timex no indica ningún año especificado con el XXXX inicial, después, cada lunes mediante WXX-1 para determinar el primer día de cada semana y, por último, T18 para indicar 6 p. m.

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

Dimensions

Ejemplos: "24 km/hr", "44 metros cuadrados", "sesenta y seis kilobytes"

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

Valores posibles para "resolutionKind" y sus valores de "unit":

  • AreaResolution:

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

    • bit
    • Kilobit
    • Megabit
    • Gigabit
    • Terabit
    • Petabit
    • Byte
    • Kilobyte
    • Megabyte
    • Gigabyte
    • Terabyte
    • Petabyte
  • LengthResolution:

    • Kilometer
    • Hectometer
    • Decameter
    • Medidor
    • Decimeter
    • Centímetro
    • Milímetro
    • Micrómetro
    • Nanometer
    • Picometer
    • Mile
    • Yard
    • Inch
    • Foot
    • Light year
    • Pt
  • SpeedResolution:

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

    • CubicMeter
    • CubicCentimeter
    • CubicMillimiter
    • Hectoliter
    • Decaliter
    • Liter
    • Deciliter
    • Centiliter
    • Milliliter
    • CubicYard
    • CubicInch
    • CubicFoot
    • CubicMile
    • FluidOunce
    • Teaspoon
    • Tablespoon
    • Pint
    • Quart
    • Cup
    • Gill
    • Reducir
    • FluidDram
    • Barrel
    • Minim
    • Cord
    • Peck
    • Bushel
    • Hogshead
  • WeightResolution:

    • Kilogramo
    • Gramo
    • Miligramo
    • Microgramo
    • Gallon
    • MetricTon
    • Ton
    • Pound
    • Ounce
    • Grain
    • Pennyweight
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Stone
    • Dram

Número

Ejemplos: "27", "ciento tres", "38,5", "2/3", "33 %"

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

Valores posibles para "numberKind":

  • Entero
  • Decimal
  • Fraction
  • Power
  • Percent

Ordinal

Ejemplos: "3º", "primero", "último"

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

Valores posibles para "relativeTo":

  • Inicio
  • End

Temperatura

Ejemplos: "88 grados fahrenheit", "veintitrés grados celsius"

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

Los valores posibles para "unit" son:

  • Grados centígrados
  • Fahrenheit
  • Kelvin
  • Rankine