Metadatos de entidad

Artículo
12/19/2023

El objeto Metadatos de entidad captura información adicional opcional sobre las entidades detectadas, lo que proporciona resoluciones específicas para entidades numéricas y temporales. Este atributo solo se rellena cuando hay datos adicionales disponibles, lo que mejora la amplitud de las entidades detectadas. El componente Metadatos abarca resoluciones diseñadas para entidades numéricas y temporales. Es importante controlar los casos en los que el atributo Metadatos puede estar vacío o ausente, ya que su presencia no está garantizada para cada entidad.

Actualmente, los componentes de metadatos controlan las resoluciones de 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.

Nota

Los metadatos de entidad solo se admiten a partir de api-version=2023-04-15-preview. En el caso de las versiones anteriores de la API, puede consultar el artículo Resoluciones de entidad.

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

Entidades numéricas

Age

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

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

Los valores posibles para "unit" son:

Year
Month (Mes)
Semana
Día

Moneda

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

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

Valores posibles para "unit" e "ISO4217":

Referencia ISO 4217.

Entidades datetime/temporales

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"

"metadata": {
                "dateValues": [
                    {
                        "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.

"metadata": {
                "dateValues": [
                    {
                        "timex": "XXXX-04-12",
                        "value": "2022-04-12"
                    },
                    {
                        "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.

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

Hora

Horas específicas.

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

"metadata": {
                "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"

"metadata": {
                "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.

"metadata": {
                 "dateValues": [ 
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2022-05-03 12:00:00"
                       },
                       {
                           "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.

"metadata": {
                "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.

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

Dimensions

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

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

Valores posibles para los valores de campo "unit":

Para medidas:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- Acre
Para información:
- bit
- Kilobit
- Megabit
- Gigabit
- Terabit
- Petabit
- Byte
- Kilobyte
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
Para longitud, ancho, alto:
- Kilometer
- Hectometer
- Decameter
- Medidor
- Decimeter
- Centímetro
- Milímetro
- Micrómetro
- Nanometer
- Picometer
- Mile
- Yard
- Inch
- Foot
- Light year
- Pt
Para velocidad:
- MetersPerSecond
- KilometersPerHour
- KilometersPerMinute
- KilometersPerSecond
- MilesPerHour
- Knot
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MetersPerMillisecond
- CentimetersPerMillisecond
- KilometersPerMillisecond
Para volumen:
- 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
Para peso:
- Kilogramo
- Gramo
- Miligramo
- Microgramo
- Gallon
- MetricTon
- Ton
- Pound
- Ounce
- Grain
- Pennyweight
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Stone
- Dram

Ordinal

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

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

Valores posibles para "relativeTo":

Inicio
End

Temperatura

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

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