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