将实体解析为标准格式

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

可以使用 NER 方案来实施操作或检索更多信息。 例如,您的服务可以提取日期/时间实体,用于提取并提供给会议计划系统的日期和时间。

重要

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

注释

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

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

年龄

示例:“十岁”、“23个月大”、“60 Y.O”。

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

“unit”的可能值:

  • 年份
  • 月份
  • 星期

货币

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

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

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

日期/时间

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

日期

特定日期。

示例:“1995 年 1 月 1 日”、“12 月 12 日”、“2022 年 10 月 7 日”、“明天”

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

每当提供歧义的日期时,系统都会提供不同的解析选项。 例如“4 月 12 日”可以指任何年份的日期。 解析提供本年和下一年作为选项。 timexXXXX 表示未在查询中指定年份。

"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 AM”、“20:03”

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

日期/时间

特定的日期和时间组合。

示例:“明天下午 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 日上午 3 点到 4 月 25 日,”星期一到星期四“、”6 月“、”周末”

“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 km/hr”、“44平方米”、“66千字节”

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

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

  • AreaResolution

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

    • Bit
    • Kilobit
    • Megabit
    • Gigabit
    • Terabit
    • Petabit
    • 字节(Byte)
    • Kilobyte
    • Megabyte
    • GB
    • Terabyte
    • Petabyte
  • LengthResolution

    • Kilometer
    • Hectometer
    • Decameter
    • 计量
    • Decimeter
    • Centimeter
    • Millimeter
    • Micrometer
    • Nanometer
    • Picometer
    • Mile
    • Yard
    • Inch
    • Foot
    • 光年
    • 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
    • Barrel
    • Minim
    • Cord
    • Peck
    • Bushel
    • Hogshead
  • WeightResolution

    • Kilogram
    • Gram
    • Milligram
    • Microgram
    • Gallon
    • MetricTon
    • Ton
    • Ounce
    • Grain
    • 佩妮重量
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Stone
    • Dram

编号

示例:“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”的可能值:

  • Start
  • 结束

温度

示例:“88 deg fahrenheit”、“23摄氏度”

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

“unit”的可能值:

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine