Metadados de entidade

O objeto de metadados de entidade armazena detalhes suplementares opcionais sobre entidades detectadas, fornecendo especificamente resoluções padronizadas para dados numéricos e temporais.

Esse atributo só é preenchido quando informações extras estão disponíveis e podem estar vazias ou ausentes para algumas entidades.

As resoluções de metadados convertem várias formas de entidade em formatos consistentes, por exemplo, tanto "oitenta" quanto "80" são transformadas no número inteiro 80. Essas resoluções NER permitem ações downstream, como extrair entidades de data e hora para integração com um sistema de agendamento de reuniões.

Observação

O suporte para metadados de entidade está disponível com a API 2023-04-15-preview e versões posteriores. Para versões mais antigas da API, consulte Resoluções de Entidade.

Entidades com atributos de metadados

Entities Entities Entities Entities Entities Entities
Idade Área Moeda Data Datetime Informação
Comprimento Número NumericRange Ordinal Configurar Velocidade
Temperatura Time Volume Peso

Idade

Metadados Tipo Description
unidade cadeia Unidade de medida para a idade.
value número Valor numérico para a idade.
"metadata": {
                "unit": "Year",
                "value": 10
            }

Valores possíveis para a unidade:

  • Dia
  • Month
  • Semana
  • Year
  • Unspecified

Area

Metadados Tipo Description
unidade cadeia Unidade de medida para área.
value número Valor numérico para área.
"metadata": {
                "unit": "Acre",
                "value": 30
            }

Valores possíveis para a unidade:

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

Moeda

Metadados Tipo Description
unidade cadeia Nome da moeda.
value número Quantia numérica de moeda.
ISO4217 cadeia O código de moeda de três letras ISO 4217 usa as duas primeiras letras do código ISO 3166 do país e, quando possível, a terceira letra é a primeira letra do nome da moeda.
"metadata": {
                "unit": "Egyptian pound",
                "value": 30,
                "ISO4217": "EGP"
            }

Valores possíveis para ISO4217:

Data

Metadados Tipo Description
Timex cadeia A data formatada iso 8601: YYYY-MM-DD (ano, mês, dia).
value cadeia A data atual indicada.

Sempre que uma data ambígua é fornecida, você recebe opções diferentes para a resolução dela. Por exemplo, "12 de abril" pode se referir a qualquer ano. A resolução fornece este ano e o próximo como opções. O valor XXXX de timex indica que nenhum ano foi especificado na consulta.

"metadata": {
                "dateValues": [
                    {
                        "timex": "XXXX-04-12",
                        "value": "2022-04-12"
                    },
                    {
                        "timex": "XXXX-04-12",
                        "value": "2023-04-12"
                    }
                ]
            }

A ambiguidade pode ocorrer mesmo para um determinado dia da semana. Por exemplo, "segunda-feira" pode se referir à segunda-feira passada ou a esta segunda-feira. Novamente, o valor timex indica que nenhum ano ou mês foi especificado e usa um dia do identificador de semana (W) para indicar o primeiro dia da semana.

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

Datetime

Metadados Tipo Description
Timex cadeia A data e hora no formato ISO 8601:
YYYY-MM-DDTHH:MM:SS(ano, mês, dia, hora, minutos, segundos, milissegundos) com um T separador.
value cadeia A data e a hora real indicadas.

Assim como as datas, você pode ter entidades de datetime ambíguas. A resolução fornece este ano e o próximo como opções. O valor timexXXXX indica que nenhum ano foi especificado.

"metadata": {
                 "dateValues": [
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2022-05-03 12:00:00"
                       },
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2023-05-03 12:00:00"
                       }
                  ]
              }

Informação

Metadados Tipo Description
unidade cadeia Unidade de medida para obter informações (dados).
value número Valor numérico para informação.

"metadata": {
                "unit": "Kilobit",
                "value": 30
            }

Valores possíveis para a unidade:

  • bit
  • Byte
  • Gigabit
  • Gigabyte
  • Kilobit
  • Quilobyte
  • Megabit
  • Megabyte
  • Petabit
  • Petabyte
  • Terabit
  • Terabyte
  • Unspecified

Comprimento

Metadados Tipo Description
unidade cadeia Unidade de medida para comprimento
value número Valor numérico.

"metadata": {
                "unit": "Kilobit",
                "value": 30
            }

Valores possíveis para a unidade:

  • Centímetro
  • Decâmetro
  • Decímetro
  • Hectômetro
  • Polegada
  • Quilômetro
  • LightYear
  • Medidor
  • Micrômetros
  • Milha
  • Milímetro
  • Nanômetro
  • Picômetro
  • Point
  • Jarda
  • Unspecified

Número

Metadados Tipo Description
numberKind cadeia Tipo de número.
value número Valor numérico para o número.

"metadata": {
                "numberKind": "Integer",
                "value": 30
            }

Valores possíveis para numberKind:

  • Decimal
  • Fraction
  • Integer
  • Percent
  • Energia
  • Unspecified

NumericRange

Metadados Tipo Description
rangeKind cadeia Um intervalo numérico com suporte.
mínimo: número O valor inicial do intervalo.
máximo número O valor final do intervalo.

"metadata": {
                "rangeKind": "length",
                "minimum": 30,
                "maximum": 100
            }

Valores possíveis para rangeKind:

  • Idade
  • Area
  • Moeda
  • Informação
  • Comprimento
  • Número
  • Velocidade
  • Temperatura
  • Volume
  • Weight

Ordinal

Metadados Tipo Description
deslocamento cadeia O deslocamento em relação à referência (por exemplo, deslocamento = -1 indica do segundo ao último)
relativeTo O ponto de referência que o número ordinal indica.
value número Valor numérico para posição ordinal.

"metadata": {
                "offset": -1,
                "relativeTo":"Current",
                "value": "first"
            }

Valores possíveis para relativeTo:

  • Atual
  • participante
  • Iniciar

Definir

Um período recorrente de data e hora (exemplo: "toda segunda-feira às 18:00.")

Metadados Tipo Description
Timex cadeia A data e hora no formato ISO 8601:
YYYY-MM-DDTHH:MM:SS(ano, mês, dia, hora, minutos, segundos, milissegundos) com um T separador.
value cadeia Os conjuntos não resolvem para valores exatos, pois não indicam uma data exata.

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

Valores possíveis para o tipo:

  • begin
  • término
  • duration
  • modificador (exemplo: before, after)
  • Timex

Velocidade

Metadados Tipo Description
unidade cadeia Unidade de medida para velocidade.
value número Valor numérico para velocidade.

"metadata": {
                "unit": "Knots",
                "value": 50
            }

Valores possíveis para a unidade:

  • CentimetersPerMillisecond
  • FeetPerMinute
  • FeetPerSecond
  • KilometersPerHour
  • KilometersPerMillisecond
  • KilometersPerMinute
  • KilometersPerSecond
  • Nós
  • MetersPerMillisecond
  • MetersPerSecond
  • MilesPerHour
  • YardsPerMinute
  • YardsPerSecond
  • Unspecified

Temperatura

Metadados Tipo Description
unidade cadeia Unidade de medida para temperatura.
value número Valor numérico.

"metadata": {
                "unit" "Kelvin",
                "value": 310
            }

Valores possíveis para a unidade:

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine
  • Unspecified

Hora

Metadados Tipo Description
Timex cadeia A data e hora no formato ISO 8601:
[hh]:[mm]:[ss](hora, minutos, segundos).
value número Valor numérico.

"metadata": {
                "timex":"T14:30:15",
                "value": "14:30:15"
            }

Volume

Metadados Tipo Description
unidade cadeia Unidade de medida para volume.
value número Valor numérico do volume.

"metadata": {
                "unit": "Quart",
                "value": 4
            }

Valores possíveis para a unidade:

  • Barrel
  • Bushel
  • Centilitro
  • Cord
  • CubicCentimeter
  • CubicFoot
  • CubicInch
  • CubicMeter
  • CubicMile
  • Milímetro Cúbico
  • CubicYard
  • Cup
  • Decalitro
  • FluidDram
  • FluidOunce
  • Gill
  • Hectoliter
  • Hogshead
  • Litro
  • Milliliter
  • Minim
  • Peck
  • Pinçar
  • Pint
  • Quart
  • Tablespoon
  • Teaspoon
  • Unspecified

Weight

Metadados Tipo Description
unidade cadeia Unidade de medida para peso.
value número Valor numérico para peso.

"metadata": {
                "unit": "Ounce",
                "value": 16
            }

Valores possíveis para a unidade:

  • Dracma
  • Gallon
  • Grão
  • Grama
  • Quilograma
  • LongTonBritish
  • MetricTon
  • Miligrama
  • Onça
  • PennyWeight
  • Libra
  • ShortHundredWeightUS
  • ShortTonUS
  • Stone
  • Tonelada
  • Unspecified

Próximas etapas

Saiba como usar o NER