Metadados de entidade

Artigo
09/04/2024

O objeto Metadados de Entidade captura informações adicionais opcionais sobre entidades detectadas, fornecendo resoluções especificamente para entidades numéricas e temporais. Esse atributo é preenchido somente quando há dados suplementares disponíveis, melhorando a integralidade das entidades detectadas. O componente Metadados abrange resoluções projetadas para entidades numéricas e temporais. É importante lidar com casos em que o atributo Metadados pode estar vazio ou ausente, pois sua presença não é garantida para todas as entidades.

Atualmente, os componentes de metadados lidam com resoluções para um formato padrão para uma entidade. As entidades podem ser expressas em várias formas, e as resoluções fornecem formatos previsíveis padrão para tipos quantificáveis comuns. Por exemplo, "oitenta" e "80" devem ambos ser resolvidos para o inteiro 80.

Você pode usar resoluções NER para implementar ações ou recuperar mais informações. Por exemplo, seu serviço pode extrair entidades datetime para extrair datas e horas que serão fornecidas a um sistema de agendamento de reunião.

Observação

Os Metadados de Entidade só têm suporte a partir de api-version=2023-04-15-preview. Para versões mais antigas da API, você pode verificar o artigo Resoluções de Entidade.

Este artigo documenta os objetos de resolução retornados para cada categoria ou subcategoria de objeto metadados.

Entidades numéricas

Idade

Exemplos: "10 anos de idade", "23 meses de idade", "60 anos de idade".

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

Valores possíveis para a “unidade”:

Ano
Mês
Semana
Dia

Moeda

Exemplos: "30 libras egípcias", "77 USD"

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

Valores possíveis para "unidade" e "ISO4217":

Referência ISO 4217.

Entidades datetime/temporal

Datetime inclui vários subtipos diferentes que retornam objetos de resposta diferentes.

Data

Dias específicos.

Exemplos: "1º de janeiro de 1995", "12 de abril", "7 de outubro de 2022", "amanhã"

"metadata": {
                "dateValues": [
                    {
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]
            }

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

Hora

Horários específicos.

Exemplos: "9:39:33 AM", "sete AM", "20:03"

"metadata": {
                "timex": "T09:39:33",
                "value": "09:39:33"
            }

Datetime

Combinações de data e hora específicas.

Exemplos: "amanhã às 18:00", "3 de janeiro às 20:00", "1º de novembro às 19:30"

"metadata": {
                "timex": "2022-10-07T18",
                "value": "2022-10-07 18:00:00"
            }

Assim como as datas, você pode ter entidades de datetime ambíguas. Por exemplo, "3 de maio ao meio-dia" pode se referir a qualquer ano. 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"
                       }
                  ]
              }

Intervalos de datetime

Um intervalo de datetime é um período com uma data, hora ou datetime de início e término.

Exemplos: "de 3 de janeiro às 6:00 a 25 de abril às 20:00 de 2022", "entre a segunda a quinta-feira", "junho", "no fim de semana"

O parâmetro "duration" indica o tempo transcorrido em segundos (S), minutos (M), horas (H) ou dias (D). Esse parâmetro só é retornado quando um datetime de início e término explícito está na consulta. "Semana que vem" retornaria apenas com os parâmetros "begin" e "end" para a semana.

"metadata": {
                "duration": "PT2702H",
                "begin": "2022-01-03 06:00:00",
                "end": "2022-04-25 20:00:00"
            }

Definir

Um conjunto é um período de datetime recorrente. Os conjuntos não resolvem para valores exatos, pois não indicam uma data exata.

Exemplos: "todas as segundas-feiras às 18:00", "todas as quintas-feiras", "todos os fins de semana"

Para "todas as segundas-feiras às 18:00", o valor timex não indica nenhum ano especificado com o XXXX inicial, e em seguida indica todas as segundas-feiras até WXX-1 para determinar o primeiro dia de cada semana e, finalmente, t18 para indicar 18:00.

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

Dimensões

Exemplos: "24 km/h", "44 metros quadrados", "sessenta e seis quilobytes"

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

Valores possíveis para os valores de campo "unidade":

Para medidas:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- Acre
Para obter informações:
- bit
- Kilobit
- Megabit
- Gigabit
- Terabit
- Petabit
- Byte
- Quilobyte
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
Para comprimento, largura, altura:
- Quilômetro
- Hectômetro
- Decâmetro
- Medidor
- Decímetro
- Centímetro
- Milímetro
- Micrometer
- Nanômetro
- Picômetro
- Milha
- Jarda
- Polegada
- Pé
- Ano-luz
- Pt
Para velocidade:
- MetersPerSecond
- KilometersPerHour
- KilometersPerMinute
- KilometersPerSecond
- MilesPerHour
- Knot
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MetersPerMillisecond
- CentimetersPerMillisecond
- KilometersPerMillisecond
Para volume:
- CubicMeter
- CubicCentimeter
- CubicMillimiter
- Hectoliter
- Decaliter
- Liter
- Deciliter
- Centiliter
- Milliliter
- CubicYard
- CubicInch
- CubicFoot
- CubicMile
- FluidOunce
- Teaspoon
- Tablespoon
- Pint
- Quart
- Cup
- Gill
- Fixar
- FluidDram
- Barrel
- Minim
- Cord
- Peck
- Bushel
- Hogshead
Para peso:
- Quilograma
- Grama
- Miligrama
- Micrograma
- Gallon
- MetricTon
- Tonelada
- Libra
- Onça
- Grão
- Peso-centavo
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Stone
- Dracma

Ordinal

Exemplos: "3º", "primeiro", "último"

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

Valores possíveis para "relativeTo":

Iniciar
End

Temperatura

Exemplos: "88 graus fahrenheit", "23 graus celsius"

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