Metadados da Entidade
O objeto Metadados de Entidade captura informações adicionais opcionais sobre entidades detetadas, fornecendo resoluções especificamente para entidades numéricas e temporais. Este atributo só é preenchido quando existem dados suplementares disponíveis, o que melhora a integridade das entidades detetadas. O componente Metadados abrange resoluções concebidas para entidades numéricas e temporais. É importante processar casos em que o atributo Metadados possa estar vazio ou ausente, uma vez que a sua presença não é garantida para cada entidade.
Atualmente, os componentes de metadados processam 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 resolver para o número inteiro 80
.
Pode utilizar resoluções NER para implementar ações ou obter mais informações. Por exemplo, o seu serviço pode extrair entidades datetime para extrair datas e horas fornecidas a um sistema de agendamento de reuniões.
Nota
Os Metadados de Entidade só são suportados a partir da api-version=2023-04-15-preview. Para versões de API mais antigas, pode verificar o artigo Resoluções de Entidades.
Este artigo documenta os objetos de resolução devolvidos para cada categoria de entidade ou subcategoria no objeto de metadados.
Entidades Numéricas
Idade
Exemplos: "10 anos", "23 meses de idade", "sessenta E.S.".
"metadata": {
"unit": "Year",
"value": 10
}
Valores possíveis para "unidade":
- Anual
- Mensal
- 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":
Data/Entidades temporais
Datetime inclui vários subtipos diferentes que devolvem objetos de resposta diferentes.
Date
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 for fornecida uma data ambígua, são-lhe oferecidas diferentes opções para a sua resolução. Por exemplo, "12 de Abril" pode referir-se a qualquer ano. A resolução fornece este ano e o próximo como opções. O timex
valor XXXX
indica que não foi especificado nenhum ano 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, dizer "Segunda-feira" pode referir-se à última segunda-feira ou esta segunda-feira. Mais uma vez, o timex
valor indica que não foi especificado nenhum ano ou mês e utiliza um dia do identificador da 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
Horas específicas.
Exemplos: "9:39:33", "sete DA MANHÃ", "20:03"
"metadata": {
"timex": "T09:39:33",
"value": "09:39:33"
}
Datetime
Combinações específicas de data e hora.
Exemplos: "18:00 amanhã", "20:00 de 3 de janeiro", "Nov 1 19:30"
"metadata": {
"timex": "2022-10-07T18",
"value": "2022-10-07 18:00:00"
}
Semelhante a datas, pode ter entidades datetime ambíguas. Por exemplo, "3 de maio ao meio-dia" pode referir-se a qualquer ano. A resolução fornece este ano e o próximo como opções. O timex
valor XXXX indica que não foi especificado nenhum ano.
"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 fim.
Exemplos: "das 06:00 às 25:00 de 25 de abril de 2022", "entre segunda-feira e quinta-feira", "Junho", "o fim de semana"
O parâmetro "duração" indica o tempo passado em segundos (S), minutos (M), horas (H) ou dias (D). Este parâmetro só é devolvido quando um datetime de início e de fim explícito está na consulta. "Semana seguinte" só regressaria com parâmetros "começar" e "terminar" 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 periódico. Os conjuntos não são resolvidos para valores exatos, uma vez que não indicam um datetime exato.
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 timex
valor não indica nenhum ano especificado com o XXXX inicial e, em seguida, todas as segundas-feiras até WXX-1 para determinar o primeiro dia de cada semana e, por fim, 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 "unit":
Para Medições:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- Pé Quadrado
- SquareMile
- SquareYard
- Acre
Para Obter Informações:
- Bit
- Kilobit
- Megabit
- Gigabit
- Terabit
- Petabit
- Byte
- Kilobyte
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
Para Comprimento, largura, altura:
- Quilómetro
- Hectometrómetro
- Decametrador
- Medidor
- Decimeter
- Centímetro
- Milímetro
- Micrometer
- Nanométrico
- Picometer
- Milha
- Quintal
- Polegada
- Pé
- Ano-luz
- Pt
Para Velocidade:
- MeterPerSecond
- KmsPerHour
- KmsPerMinute
- KmsPerSecond
- MilesPerHour
- Nó
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MeterPerMillisecond
- CentimetersPerMillisecond
- KmsPerMillisecond
Para Volume:
- CubicMeter
- CubicCentimeter
- CubicMillimiter
- Hectoliter
- Decaliter
- Litro
- Deciliter
- Centilitro
- Mililitro
- Cubículo
- CubicInch
- Pés Cúbicos
- Cúbiculo
- FluidOunce
- Colher de chá
- Colher de sopa
- Pint
- Quarto
- Copo
- Guelra
- Beliscar
- FluidDram
- Barril
- Minim
- Cabo
- Bicar
- Alqueire
- Cabeça de Porco
Para Peso:
- Quilograma
- Grama
- Miligrama
- Micrograma
- Galão
- MetricTon
- Tonelada
- Libra
- Onça
- Grão
- Peso-moeda
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Pedra
- Dram
Ordinal
Exemplos: "3º", "primeiro", "último"
"metadata": {
"offset": "3",
"relativeTo": "Start",
"value": "3"
}
Valores possíveis para "relativeTo":
- Iniciar
- Fim
Temperatura
Exemplos: "88 graus fahrenheit", "vinte e três graus celsius"
"metadata": {
"unit": "Fahrenheit",
"value": 88
}
Valores possíveis para "unidade":
- Celsius
- Fahrenheit
- Kelvin
- Rankine
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários