Risolvere le entità in formati standard

Una risoluzione è un formato standard per un'entità. Le entità possono essere espresse in varie forme e risoluzioni che forniscono formati prevedibili standard per tipi quantificabili comuni. Ad esempio, "ottanta" e "80" devono essere entrambi risolti nel numero intero 80.

È possibile usare le risoluzioni del riconoscimento di entità denominate (NER) per implementare azioni o recuperare ulteriori informazioni. Ad esempio, un servizio può estrarre entità datetime per estrarre date e ore fornite a un sistema di pianificazione riunioni.

Importante

A partire dalla versione 2023-04-15-preview, la funzionalità di risoluzione delle entità viene sostituita da metadati entità

Nota

Le risposte alla risoluzione delle entità sono supportate solo a partire da api-version=2022-10-01-preview e "modelVersion": "2022-10-01-preview".

Questo articolo illustra gli oggetti risoluzione restituiti per ogni categoria o sottocategoria.

Età

Esempi: "10 anni", "23 mesi", "sessanta anni"

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

Valori possibili per "unit":

  • Anno
  • Mese
  • Settimana
  • Giorno

Valuta

Esempi: "30 sterline egiziane", "77 USD"

"resolutions": [
                    {
                        "resolutionKind": "CurrencyResolution",
                        "unit": "Egyptian pound",
                        "ISO4217": "EGP",
                        "value": 30
                    }
                ]

Valori possibili per "unit" e "ISO4217":

Datetime

Datetime include diversi sottotipi che restituiscono oggetti risposta diversi.

Data

Giorni specifici.

Esempi: "1 gennaio 1995", "12 aprile", "7 ottobre 2022", "domani"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]

Ogni volta che viene specificata una data ambigua, vengono offerte opzioni diverse per la risoluzione. Ad esempio, "12 aprile" può fare riferimento a qualunque anno. La risoluzione fornisce quest'anno e il prossimo come opzioni. Il valore timex XXXX indica che non è stato specificato alcun anno nella query.

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

L'ambiguità può verificarsi anche per un determinato giorno della settimana. Ad esempio, "Lunedì" potrebbe fare riferimento all'ultimo lunedì o a questo lunedì. Ancora una volta il valore timex indica che non è stato specificato alcun anno o mese e usa un giorno dell'identificatore della settimana (W) per indicare il primo giorno della settimana.

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

Ora

Ore specifiche.

Esempi: "9:39:33", "le sette", "20:03"

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

Datetime

Combinazioni di data e ora specifiche.

Esempi: "le 18 di domani", "le 20 del 3 gennaio", "19:30 del 1° novembre"

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

Analogamente alle date, è possibile avere entità datetime ambigue. Ad esempio, "mezzogiorno del 3 maggio" può fare riferimento a qualunque anno. La risoluzione fornisce quest'anno e il prossimo come opzioni. Il valore timex XXXX indica che non è stato specificato alcun anno.

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

Intervalli datetime

Un intervallo datetime è un periodo con data, ora o datetime di inizio e fine.

Esempi: "dal 3 gennaio alle 6:00 alle 20:00 del 25 aprile 2022", "tra lunedì e giovedì", "giugno", "fine settimana"

Il parametro "duration" indica il tempo trascorso in secondi (S), minuti (M), ore (H) o giorni (D). Questo parametro viene restituito solo quando la query contiene un valore datetime di inizio e di fine esplicito. “La prossima settimana” restituirà solo i parametri "begin" e "end" per la settimana.

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

Set

Un set è un periodo datetime ricorrente. I set non vengono risolti in valori esatti, in quanto non indicano un valore datetime esatto.

Esempi: "ogni lunedì alle 18:00", "ogni giovedì", "ogni fine settimana"

Per "ogni lunedì alle 18:00", il valore timex indica che non è specificato alcun anno con XXXX iniziale, quindi ogni lunedì fino a WXX-1 per determinare il primo giorno di ogni settimana e infine T18 per indicare le 18:00.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Set",
                        "timex": "XXXX-WXX-1T18",
                        "value": "not resolved"
                    }
                ]

Dimensioni

Esempi: "24 km/h", "44 metri quadrati", "sessantasei kilobyte"

"resolutions": [
                    {
                        "resolutionKind": "SpeedResolution",
                        "unit": "KilometersPerHour",
                        "value": 24
                    }
                ]

Valori possibili per "resolutionKind" e i relativi valori "unit":

  • AreaResolution:

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

    • Bit
    • Kilobit
    • Megabit
    • Gigabit
    • Terabit
    • Petabit
    • Byte
    • Kilobyte
    • Megabyte
    • Gigabyte
    • Terabyte
    • Petabyte
  • LengthResolution:

    • Chilometro
    • Hectometer
    • Decameter
    • Metro
    • Decimeter
    • Centimeter
    • Millimeter
    • Micrometer
    • Nanometer
    • Picometer
    • Miglio
    • Yard
    • Inch
    • Piedi
    • Light year
    • Pt
  • SpeedResolution:

    • MetersPerSecond
    • KilometersPerHour
    • KilometersPerMinute
    • KilometersPerSecond
    • MilesPerHour
    • Knot
    • FootPerSecond
    • FootPerMinute
    • YardsPerMinute
    • YardsPerSecond
    • MetersPerMillisecond
    • CentimetersPerMillisecond
    • KilometersPerMillisecond
  • VolumeResolution:

    • CubicMeter
    • CubicCentimeter
    • CubicMillimiter
    • Hectoliter
    • Decaliter
    • litro
    • Deciliter
    • Centiliter
    • Milliliter
    • CubicYard
    • CubicInch
    • CubicFoot
    • CubicMile
    • FluidOunce
    • Teaspoon
    • Tablespoon
    • Pint
    • Quart
    • Cup
    • Gill
    • Avvicinamento delle dita
    • FluidDram
    • Barrel
    • Minim
    • Cord
    • Peck
    • Bushel
    • Hogshead
  • WeightResolution:

    • Kilogram
    • Gram
    • Milligram
    • Microgram
    • Gallon
    • MetricTon
    • Ton
    • Pound
    • Ounce
    • Intervallo
    • Pennyweight
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Pietra
    • Dram

Numero

Esempi: "27", "cento e tre", "38,5", "2/3", "33%"

"resolutions": [
                    {
                        "resolutionKind": "NumberResolution",
                        "numberKind": "Integer",
                        "value": 27
                    }
                ]

Valori possibili per "numberKind":

  • Intero
  • Decimal
  • Fraction
  • Power
  • Percentuale

Ordinale

Esempi: "terzo", "primo", "ultimo"

"resolutions": [
                    {
                        "resolutionKind": "OrdinalResolution",
                        "offset": "3",
                        "relativeTo": "Start",
                        "value": "3"
                    }
                ]

Valori possibili per "relativeTo":

  • Avvio
  • Fine

Temperatura

Esempi: "88 gradi Fahrenheit", "ventitré gradi Celsius"

"resolutions": [
                    {
                        "resolutionKind": "TemperatureResolution",
                        "unit": "Fahrenheit",
                        "value": 88
                    }
                ]

Valori possibili per "unit":

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine