將實體解析為標準格式
解析是實體的標準格式。 實體可以以各種形式表示,而且解析度可為一般可量化類型提供標準可預測格式。 例如,「八十」 和 「80」 兩者都應該解析為整數 80
。
您可以使用 NER 解析度來實作動作或擷取進一步的資訊。 例如,您的服務可以擷取 datetime 實體,以擷取將提供給會議排程系統的日期和時間。
重要
從2023-04-15-preview版開始,實體解析功能會由 實體元數據取代
注意
從 api-version=2022-10-01-preview 和 “modelVersion”開始,才支持實體解析回應:“2022-10-01-preview”。
本文記載針對每個實體類別或子類別所傳回的解析物件。
年齡
範例:「10 歲」、“23 個月大”、“60 Y.O”。
"resolutions": [
{
"resolutionKind": "AgeResolution",
"unit": "Year",
"value": 10
}
]
“unit” 的可能值:
- Year
- 月
- 週
- Day
貨幣
範例:“30 埃及英鎊”、“77 美元”
"resolutions": [
{
"resolutionKind": "CurrencyResolution",
"unit": "Egyptian pound",
"ISO4217": "EGP",
"value": 30
}
]
“unit” 和 “ISO4217” 的可能值:
Datetime
Datetime 包含數個不同的子類型,這些子類型會傳回不同的響應物件。
Date
特定天數。
範例:“1995 年 1 月 1 日”、“12 月 12 日”、“2022 年 10 月 7 日”、“明天”
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "1995-01-01",
"value": "1995-01-01"
}
]
每當提供模棱兩可的日期時,您就會提供不同的解決方案選項。 例如,“12 April” 可以參考任何年份。 解決方案提供今年和下一個作為選項。 值timex
XXXX
表示查詢中未指定年份。
"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"
}
]
模棱兩可甚至發生在一周的指定一天。 例如,說“星期一”可以參考最後一個星期一或這個星期一。 再次指出 timex
未指定年份或月份的值,並使用星期標識碼 (W) 的一天來表示一周的第一天。
"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"
}
]
Time
特定時間。
範例:“9:39:33 AM”、“七 AM”、“20:03”
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Time",
"timex": "T09:39:33",
"value": "09:39:33"
}
]
Datetime
特定日期和時間組合。
範例:“明天下午 6 點”、“1 月 3 日下午 8 點”、“11 月 1 日 19:30”
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"timex": "2022-10-07T18",
"value": "2022-10-07 18:00:00"
}
]
類似於日期,您可以有模棱兩可的 datetime 實體。 例如,「5 月 3 日中午」可能指任何一年。 解決方案提供今年和下一個作為選項。 timex
XXXX 值表示未指定年份。
"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"
}
]
Datetime 範圍
datetime 範圍是具有開始和結束日期、時間或日期時間的期間。
範例:“從 2022 年 1 月 3 日上午 3 點到 4 月 25 日下午 8 點”、“星期一到星期四之間”、“6 月”、“週末”
“duration” 參數表示以秒 (S)、分鐘 (M)、小時 (H) 或天 (D) 傳遞的時間。 只有在查詢中明確開始和結束日期時間時,才會傳回此參數。 “Next week” 只會傳回當周的 “begin” 和 “end” 參數。
"resolutions": [
{
"resolutionKind": "TemporalSpanResolution",
"duration": "PT2702H",
"begin": "2022-01-03 06:00:00",
"end": "2022-04-25 20:00:00"
}
]
設定
集合是週期性的日期時間期間。 集合不會解析為確切的值,因為它們不會指出確切的日期時間。
範例:“每個星期一下午 6 點”、“每個星期四”、“每個週末”
針對「每個星期一下午 6 點」,值timex
表示沒有指定年份的 XXXX,然後每個星期一到 WXX-1 決定每周的第一天,最後 T18 表示下午 6 點。
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Set",
"timex": "XXXX-WXX-1T18",
"value": "not resolved"
}
]
維度
範例:“24 公里/小時”、“44 平方米”、“66 KB”
"resolutions": [
{
"resolutionKind": "SpeedResolution",
"unit": "KilometersPerHour",
"value": 24
}
]
“resolutionKind” 及其 “unit” 值的可能值:
AreaResolution:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- 平方計
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- 英畝
InformationResolution:
- 位元
- Kilobit
- Megabit
- 千兆
- Terabit
- Petabit
- 位元組
- K b
- 兆 位元組
- 技嘉
- Tb
- Petabyte
LengthResolution:
- 公里
- Hectometer
- Decameter
- 計量
- Decimeter
- 釐米
- 毫米
- 微米
- 納米
- Picometer
- 英里
- 院子 里
- 英寸
- 腳
- 淺年
- 鉑
SpeedResolution:
- MetersPerSecond
- KilometersPerHour
- KilometersPerMinute
- KilometersPerSecond
- MilesPerHour
- 結
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MetersPerMillisecond
- CentimetersPerMillisecond
- KilometersPerMillisecond
VolumeResolution:
- CubicMeter
- CubicCentimeter
- CubicMillimiter
- Hectoliter
- Decaliter
- 升
- Deciliter
- Centiliter
- 毫升
- CubicYard
- CubicInch
- CubicFoot
- CubicMile
- FluidOunce
- 茶匙
- 湯匙
- 品脫
- 誇脫
- 杯
- Gill
- 捏合
- FluidDram
- 桶
- 微量
- 線
- 啄
- 蒲 式 耳
- 霍格斯黑德
WeightResolution:
- Kilogram
- Gram
- Milligram
- Microgram
- 加侖
- MetricTon
- 噸
- 磅
- 盎司
- 粒紋
- Pennyweight
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- 石頭
- Dram
數字
範例:“27”、“一百三”、“38.5”、“2/3”、“33%”
"resolutions": [
{
"resolutionKind": "NumberResolution",
"numberKind": "Integer",
"value": 27
}
]
“numberKind” 的可能值:
- 整數
- Decimal
- 分數
- Power
- Percent
序數
範例:“3rd”、“first”、“last”
"resolutions": [
{
"resolutionKind": "OrdinalResolution",
"offset": "3",
"relativeTo": "Start",
"value": "3"
}
]
“relativeTo” 的可能值:
- 啟動
- 尾端
溫度
範例:“88 deg fahrenheit”、“二十三攝氏度”
"resolutions": [
{
"resolutionKind": "TemperatureResolution",
"unit": "Fahrenheit",
"value": 88
}
]
“unit” 的可能值:
- 攝氏
- 華 氏
- 開 爾 文
- Rankine