将实体解析为标准格式

项目
04/15/2024

解析是实体的标准格式。可以用各种格式表示实体，解析为常见的可量化类型提供标准可预测格式。例如，“八十”和“80”都应解析为整数 80。

可以使用 NER 解析来实现操作或检索详细信息。例如，服务可以提取日期/时间实体，以提取要提供给会议安排系统的日期和时间。

重要

从版本 2023-04-15-preview 开始，实体解析功能被实体元数据取代

注意

仅从“api-version=2022-10-01-preview”和“modelVersion”：“2022-10-01-preview”开始支持实体解析响应。

本文阐述了为每个实体类别或子类别返回的解析对象。

Age

示例：“10 岁”、“23 个月大”、“六十岁”

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

“unit”的可能值：

年龄
Month
Week
日期

货币

示例：“30 埃及镑”、“77 美元”

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

“unit”和“ISO4217”的可能值：

ISO 4217 参考。

datetime

Datetime 包括多个不同的子类型，这些子类型返回不同的响应对象。

日期

特定日期。

示例：“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"
                    }
                ]

时间

特定时间。

示例：“9:39:33 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"
                    }
                ]

与日期类似，可能会出现歧义的日期/时间实体。例如“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 点”、“星期一至星期四”、“六月”、“周末”

“duration”参数表示已经过的时间，单位为秒 (S)、分钟 (M)、小时 (H) 或天 (D)。仅当查询中包含显式的开始和结束日期/时间时，才返回此参数。指定“下周”只会返回该周的“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 平方米”、“六十六千字节”

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

“resolutionKind”的可能值及其“unit”值：

AreaResolution：
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- 阿克里州
InformationResolution：
- bit
- Kilobit
- Megabit
- 千兆位
- Terabit
- Petabit
- Byte
- Kilobyte
- Megabyte
- GB
- Terabyte
- Petabyte
LengthResolution：
- Kilometer
- Hectometer
- Decameter
- 计量
- Decimeter
- 厘米
- 毫米
- Micrometer
- Nanometer
- Picometer
- Mile
- Yard
- Inch
- Foot
- Light year
- Pt
SpeedResolution：
- MetersPerSecond
- KilometersPerHour
- KilometersPerMinute
- KilometersPerSecond
- MilesPerHour
- Knot
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MetersPerMillisecond
- CentimetersPerMillisecond
- KilometersPerMillisecond
VolumeResolution：
- CubicMeter
- CubicCentimeter
- CubicMillimiter
- Hectoliter
- Decaliter
- Liter
- Deciliter
- Centiliter
- Milliliter
- CubicYard
- CubicInch
- CubicFoot
- CubicMile
- FluidOunce
- Teaspoon
- Tablespoon
- Pint
- Quart
- Cup
- Gill
- 捏放
- FluidDram
- 笔筒
- Minim
- Cord
- Peck
- Bushel
- Hogshead
WeightResolution：
- 千克
- 克
- 毫克
- 微克
- Gallon
- MetricTon
- Ton
- Pound
- Ounce
- Grain
- Pennyweight
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Stone
- Dram

Number

示例：“27”、“一百零三”、“38.5”、“2/3”、“33%”

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

“numberKind”的可能值：

Integer
小数
Fraction
强力
百分比

Ordinal

示例：“第 3 个”、“第一个”、“最后一个”

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

“relativeTo”的可能值：

开始
结束

温度

示例：“88 华氏度”、“二十三摄氏度”

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

“unit”的可能值：

摄氏温度
Fahrenheit
Kelvin
Rankine

通过

将实体解析为标准格式

Age

货币

datetime

日期

时间

datetime

日期/时间范围

设置

维度

Number

Ordinal

温度

其他资源