Converter 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 corresponder ao inteiro número 80.

Pode usar NER resoluções para implementar ações ou obter mais informações. Por exemplo, o seu serviço pode extrair entidades de data-hora para extrair datas e horários fornecidos a um sistema de agendamento de reuniões.

Importante

Com a versão 2023-04-15-preview e daqui em diante, os metadados da entidade substituem o recurso de resolução 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.

Idade

Exemplos: "Dez anos", "23 meses", "60 anos."

"resolutions": [
                    {
                        "resolutionKind": "AgeResolution",
                        "unit": "Year",
                        "value": 10
                    }
                ]

Valores possíveis para "unidade":

  • Ano
  • Mês
  • 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":

Data e hora

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," "sete da manhã", "20:03"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Time",
                        "timex": "T09:39:33",
                        "value": "09:39:33"
                    }
                ]

Data e hora

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

Exemplos: "18h de amanhã", "20h de 3 de janeiro", "1 de novembro: 19:30"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "timex": "2022-10-07T18",
                        "value": "2022-10-07 18:00:00"
                    }
                ]

Semelhante às datas, pode-se ter entidades de data e hora 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 de data e hora é um período com uma data de início e fim, uma hora ou uma data e hora.

Exemplos: "de 3 de janeiro das 6h às 25 de abril às 20h de 2022", "de segunda a 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). 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 "início" e "fim" para a semana.

"resolutions": [
                    {
                        "resolutionKind": "TemporalSpanResolution",
                        "duration": "PT2702H",
                        "begin": "2022-01-03 06:00:00",
                        "end": "2022-04-25 20:00:00"
                    }
                ]

Conjunto

Um conjunto é um período recorrente de data e hora. 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 valor timex indica nenhum ano especificado com o início XXXX, depois todas as segundas-feiras através de 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 os seus respetivos valores de "unit".

  • Área Resolução:

    • Quilómetro Quadrado
    • Hectómetro Quadrado
    • Decâmetro Quadrado
    • Metro Quadrado
    • Decímetro Quadrado
    • Centímetro quadrado
    • Milímetro Quadrado
    • Polegada quadrada
    • Pés Quadrados
    • SquareMile
    • SquareYard
    • Acre
  • InformaçãoResolução:

    • Pouco
    • Kilobit
    • Megabite
    • Gigabit
    • Terabit
    • Petabit
    • Byte
    • Kilobyte
    • Megabyte
    • Gigabyte
    • Terabyte
    • Petabyte
  • ComprimentoResolução:

    • Quilómetro
    • Hectómetro
    • Decámetro
    • Metro
    • Decímetro
    • Centímetro
    • Milímetro
    • Micrómetro
    • Nanômetro
    • Picómetro
    • Milha
    • Jardim
    • Polegada
    • Ano luz
    • Pt
  • SpeedResolution:

    • MetrosPorSegundo
    • QuilômetrosPerHora
    • QuilómetrosPerMinuto
    • QuilómetrosPerSegundo
    • Milhas por Hora
    • FootPerSecond
    • FootPerMinute
    • JardasPorMinuto
    • JardasPorSegundo
    • MetrosPorMilissegundo
    • CentímetrosPorMilissegundo
    • QuilómetrosPorMilissegundo
  • VolumeResolution:

    • CubicMeter
    • Centímetro Cúbico
    • CubicMillimiter
    • Hectolitro
    • Decalitro
    • Litro
    • Decilitro
    • Centilitro
    • Mililitro
    • CubicYard
    • CubicInch
    • CubicFoot
    • CubicMile
    • Onça Fluida
    • Colher de chá
    • Colher de sopa
    • Pinta
    • 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 (unidade de medida)
    • Grão
    • Peso de um cêntimo
    • LongTonBritânico
    • ShortTonUS
    • ShortHundredweightUS
    • Pedra
    • Medida de líquido

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
  • Poder
  • 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