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 NER resoluciones para implementar acciones o recuperar más información. Por ejemplo, el servicio puede extraer entidades de fecha y hora para extraer fechas y horas que se proporcionarán a un sistema de programación de reuniones.

Importante

Con la versión 2023-04-15-preview y en adelante, los metadatos de entidad reemplazan a la característica de resolución de entidades.

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: "Diez años", "23 meses", "60 Y.O."

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

Los valores posibles para "unit" son:

  • Year
  • Month
  • 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"
                    }
                ]

Time

Horas específicas.

Ejemplos: "9:39:33 AM", "siete de la mañana", "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 de 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 de 6 a. m. al 25 de abril de 2022", "entre el lunes y el 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"
                    }
                ]

Conjunto

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 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
    • Sumar verticalmente
    • Año luz
    • 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
    • Penny weight
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Stone
    • Dram

Number

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

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

Valores posibles para "numberKind":

  • Entero
  • Decimal
  • Fracción
  • Potencia
  • Por ciento

Ordinal

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

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

Valores posibles para "relativeTo":

  • Start
  • 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