Resolver entidades para formatos padrão
Uma resolução é um formato padrão para uma entidade. As entidades podem ser expressas de várias formas e as resoluções fornecem formatos previsíveis normalizados para tipos quantificáveis comuns. Por exemplo, "oitenta" e "80" devem resolver para o número 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.
Importante
A partir da versão 2023-04-15-preview, o recurso de resolução de entidade é substituído por metadados de entidade
Nota
As respostas de resolução de entidade só são suportadas a partir de api-version=2022-10-01-preview e "modelVersion": "2022-10-01-preview".
Este artigo documenta os objetos de resolução retornados para cada categoria ou subcategoria de entidade.
Antiguidade
Exemplos: "10 anos", "23 meses", "sessenta anos".
"resolutions": [
{
"resolutionKind": "AgeResolution",
"unit": "Year",
"value": 10
}
]
Valores possíveis para "unidade":
- Anual
- Month
- Semana
- Dia
Moeda
Exemplos: "30 libras egípcias", "77 USD"
"resolutions": [
{
"resolutionKind": "CurrencyResolution",
"unit": "Egyptian pound",
"ISO4217": "EGP",
"value": 30
}
]
Valores possíveis para "unidade" e "ISO4217":
- Referência ISO 4217.
Datetime
Datetime inclui vários subtipos diferentes que retornam objetos de resposta diferentes.
Date
Dias específicos.
Exemplos: "1 de janeiro de 1995", "12 de abril", "7 de outubro de 2022", "amanhã"
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "1995-01-01",
"value": "1995-01-01"
}
]
Sempre que uma data ambígua é fornecida, são oferecidas diferentes opções para a sua resolução. Por exemplo, "12 de abril" pode referir-se a qualquer ano. Resolução prevê este ano e o próximo como opções. O timex valor XXXX indica que nenhum ano foi especificado na 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"
}
]
A ambiguidade pode ocorrer mesmo para um determinado dia da semana. Por exemplo, dizer "segunda-feira" pode referir-se à última segunda-feira ou a esta segunda-feira. Mais uma vez, o timex valor indica que nenhum ano ou mês foi especificado e usa um identificador de dia da semana (W) para indicar o primeiro dia da 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
Horários específicos.
Exemplos: "9:39:33 AM", "seven AM", "20:03"
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Time",
"timex": "T09:39:33",
"value": "09:39:33"
}
]
Datetime
Combinações específicas de data e hora.
Exemplos: "18h de amanhã", "20h de 3 de janeiro", "1º de novembro 19h30"
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"timex": "2022-10-07T18",
"value": "2022-10-07 18:00:00"
}
]
Semelhante às datas, você pode ter entidades datetime ambíguas. Por exemplo, "3 de maio ao meio-dia" pode referir-se a qualquer ano. Resolução prevê este ano e o próximo como opções. O timex valor XXXX indica que nenhum ano foi especificado.
"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 de data/hora
Um intervalo datetime é um período com uma data de início e fim, hora ou datetime.
Exemplos: "de 3 de janeiro das 6h às 25h de abril das 20h de 2022", "entre segunda a quinta-feira", "junho", "fim de semana"
O parâmetro "duração" indica o tempo passado em segundos (S), minutos (M), horas (H) ou dias (D). Esse parâmetro só é retornado quando uma data/hora de início e término explícita estão na consulta. "Próxima semana" só retornaria com os parâmetros "começar" e "terminar" para a semana.
"resolutions": [
{
"resolutionKind": "TemporalSpanResolution",
"duration": "PT2702H",
"begin": "2022-01-03 06:00:00",
"end": "2022-04-25 20:00:00"
}
]
Definição
Um conjunto é um período de data-hora recorrente. Os conjuntos não resolvem para valores exatos, pois não indicam uma data/hora exata.
Exemplos: "todas as segundas-feiras às 18h", "todas as quintas-feiras", "todos os fins de semana"
Para "todas as segundas-feiras às 18h", o timex valor indica nenhum ano especificado com o início XXXX, depois todas as segundas-feiras até WXX-1 para determinar o primeiro dia de cada semana e, finalmente , T18 para indicar 18h .
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Set",
"timex": "XXXX-WXX-1T18",
"value": "not resolved"
}
]
Dimensões
Exemplos: "24 km/h", "44 metros quadrados", "sessenta e seis kilobytes"
"resolutions": [
{
"resolutionKind": "SpeedResolution",
"unit": "KilometersPerHour",
"value": 24
}
]
Valores possíveis para "resolutionKind" e seus valores "unit":
ÁreaResolução:
- Quilómetro Quadrado
- Hectómetro Quadrado
- QuadradoDecametro
- Medidor Quadrado
- Quadrado Decimetro
- Centímetro quadrado
- Milímetro Quadrado
- Polegada quadrada
- Pé Quadrado
- Milha Quadrada
- Pátio Quadrado
- Acre
InformaçãoResolução:
- Pouco
- Kilobit
- Megabit
- Gigabit
- Terabit
- Petabit
- Byte
- Kilobyte
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
ComprimentoResolução:
- Quilómetro
- Hectómetro
- Decámetro
- Metro
- Decímetro
- Centímetro
- Milímetro
- Micrometer
- Nanômetro
- Pícometer
- Milha
- Quintal
- Polegada
- Pé
- Ano luz
- Pt
SpeedResolution:
- MetrosPerSecond
- QuilômetrosPerHora
- QuilómetrosPerMinuto
- QuilómetrosPerSegundo
- MilhasPerHour
- Nó
- FootPerSecond
- FootPerMinute
- QuintaisPerMinute
- QuintaisPerSecond
- MetrosPerMillisecond
- CentímetrosPerMillisecond
- QuilômetrosPerMillisecond
VolumeResolution:
- CubicMeter
- CubicCentímetro
- CubicMillimiter
- Hectoliter
- Decaliter
- Litro
- Decilitro
- Centiliter
- Mililitro
- CubicYard
- CubicInch
- CubicFoot
- CubicMile
- Onça Fluida
- Colher de chá
- Colher de sopa
- Cerveja
- Quart
- Taça
- Gill
- Pinça
- FluidDram
- Barril
- Mínimo
- Cordão
- Peck
- Alqueire
- Cabeça de porco
WeightResolution:
- Quilograma
- Grama
- Miligrama
- Micrograma
- Galão
- MetricTon
- Tonelada
- Libra
- Onça
- Granulação
- Peso poejo
- LongTonBritânico
- ShortTonUS
- ShortHundredweightUS
- Pedra
- Carrinho de bebé
Número
Exemplos: "27", "cento e três", "38,5", "2/3", "33%"
"resolutions": [
{
"resolutionKind": "NumberResolution",
"numberKind": "Integer",
"value": 27
}
]
Valores possíveis para "numberKind":
- Número inteiro
- Decimal
- Fração
- Power
- Percentagem
Ordinal
Exemplos: "3º", "primeiro", "último"
"resolutions": [
{
"resolutionKind": "OrdinalResolution",
"offset": "3",
"relativeTo": "Start",
"value": "3"
}
]
Valores possíveis para "relativeTo":
- Iniciar
- Fim
Temperatura
Exemplos: "88 graus fahrenheit", "vinte e três graus celsius"
"resolutions": [
{
"resolutionKind": "TemperatureResolution",
"unit": "Fahrenheit",
"value": 88
}
]
Valores possíveis para "unidade":
- Celsius
- Fahrenheit
- Kelvin
- Rankine