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