將實體解析為標準格式
解析是實體的標準格式。 實體可以各種格式表示，而解析則為常見的可量化類型提供標準可預測格式。 例如，「八十」和「80」都解析為整數 80。
您可以使用具名實體辨識 (NER) 解析來實作動作，或擷取更多資訊。 例如，您的服務可以擷取日期時間實體，以擷取要提供給會議排程系統的日期和時間。
重要
從 2023-04-15 預覽版開始，實體解析功能會由實體中繼資料所取代
注意
只支援從 api-version=2022-10-01-preview 和"modelVersion": "2022-10-01-preview"開始的實體解析回應。
本文記載每個實體類別或子類別傳回的解析物件。
年齡
範例：「10 歲」、「23 個月大」、「60 Y.O.」
"resolutions": [
{
"resolutionKind": "AgeResolution",
"unit": "Year",
"value": 10
}
]
「單位」的可能值：
- Year
- 月
- 週
- Day
貨幣
範例：「30 埃及鎊」、「77 美元」
"resolutions": [
{
"resolutionKind": "CurrencyResolution",
"unit": "Egyptian pound",
"ISO4217": "EGP",
"value": 30
}
]
「單位」和「ISO4217」的可能值：
Datetime
日期時間包含會傳回不同回應物件的數個不同的子類型。
Date
特定日期。
範例：「1995 年 1 月 1 日」、「4 月 12 日」、「2022 年 10 月 7 日」、「明天」
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "1995-01-01",
"value": "1995-01-01"
}
]
在提供不明確的日期時，解析會提供不同的選項。 例如，「4 月 12 日」可以是在任何年份。 解析會提供今年和明年作為選項。 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」、「上午 7 點」、「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"
}
]
與日期類似，您也可能會有不明確的日期時間實體。 例如，「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"
}
]
日期時間範圍
日期時間範圍是一段期間，包含開始和結束日期、時間或日期時間的期間。
範例：「2022 年 1 月 3 日上午 6 點到 4 月 25 日下午 8 點」、「星期一到星期四」、「六月」、「週末」
「期間」參數以秒 (S)、分 (M)、小時 (H) 或天 (D) 來表示過去的時間。 只有查詢中明確指定開始和結束的日期時間，才會傳回此參數。 「下週」只會傳回一週的「開始」和「結束」參數。
"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" 的可能值和其「單位」值：
AreaResolution：
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- Acre
InformationResolution：
- 位元
- 千位元
- 百萬位元
- Gigabit
- 兆位元
- 千萬億位元
- Byte
- KB
- MB
- GB
- TB
- PB
LengthResolution：
- 公里
- 一百公尺
- 十公尺
- 計量
- 公寸
- 公分
- 公釐
- Micrometer
- 奈米
- 皮米
- 英里
- 碼
- 英寸
- 英尺
- 光年
- Pt
SpeedResolution：
- MetersPerSecond
- KilometersPerHour
- KilometersPerMinute
- KilometersPerSecond
- MilesPerHour
- 每小時 1 海里
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MetersPerMillisecond
- CentimetersPerMillisecond
- KilometersPerMillisecond
VolumeResolution：
- CubicMeter
- CubicCentimeter
- CubicMillimiter
- 百公升
- 十公升
- 公升
- 十分之一公升
- 厘升
- 毫升
- CubicYard
- CubicInch
- CubicFoot
- CubicMile
- FluidOunce
- 茶匙
- 湯匙
- 品脫
- 夸脫
- 杯
- Gill
- 捏合
- FluidDram
- 桶
- 量滴
- 考得
- 配克
- 蒲式耳
- 拱桶
WeightResolution：
- Kilogram
- Gram
- Milligram
- Microgram
- 加侖
- MetricTon
- 噸
- 磅
- 盎司
- 粒紋
- Penyweight
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- 英石
- 打蘭
數字
範例：「27」、「一百零三」、「38.5」、「2/3」、「33%」
"resolutions": [
{
"resolutionKind": "NumberResolution",
"numberKind": "Integer",
"value": 27
}
]
"numberKind" 的可能值：
- 整數
- Decimal
- Fraction
- Power
- Percent
序數
範例：「第三」、「第一」、「最後」
"resolutions": [
{
"resolutionKind": "OrdinalResolution",
"offset": "3",
"relativeTo": "Start",
"value": "3"
}
]
"relativeTo" 的可能值：
- 啟動
- 尾端
溫度
範例：「華氏 88 度」、「攝氏 23 度」
"resolutions": [
{
"resolutionKind": "TemperatureResolution",
"unit": "Fahrenheit",
"value": 88
}
]
「單位」的可能值：
- 攝氏
- 華氏
- 凱氏
- 蘭氏