Разрешение сущностей в стандартных форматах

Статья
04/11/2024

Разрешение — это стандартный формат для сущности. Сущности можно выразить в различных формах и разрешениях, предоставляя стандартные прогнозируемые форматы для распространенных квантификируемых типов. Например, "80" и "80" должны разрешаться в целочисленное число 80.

Разрешения NER можно использовать для реализации действий или получения дополнительных сведений. Например, служба может извлекать сущности datetime для извлечения дат и времени, которые будут предоставлены системе планирования собраний.

Внимание

Начиная с версии 2023-04-15-preview функция разрешения сущностей заменяется метаданными сущности

Примечание.

Ответы на разрешение сущностей поддерживаются только начиная с api-version=2022-10-01-preview и modelVersion: "2022-10-01-preview".

В этой статье описаны объекты разрешения, возвращаемые для каждой категории сущности или подкатегории.

Возраст

Примеры: "10 лет", "23 месяца", "шестьдесят Y.O".

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

Возможные значения для "unit":

Year
месяц
Неделя
День

Валюта

Примеры: "30 египетских фунтов", "77 долларов США"

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

Возможные значения для "unit" и "ISO4217":

Справочник по ISO 4217.

Datetime

Datetime включает несколько различных подтипов, возвращающих различные объекты ответа.

Дата

Определенные дни.

Примеры: "1 января 1995 года", "12 апреля", "7 октября 2022 года", "завтра"

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

Всякий раз, когда указана неоднозначная дата, вы предлагаете различные варианты разрешения. Например, "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"
                    }
                ]

Время

Определенное время.

Примеры: "9:39:33", "семь am", "20:03"

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

Datetime

Определенные сочетания даты и времени.

Примеры: "6 вечера завтра", "8 вечера 3 января", "1 19:30"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "timex": "2022-10-07T18",
                        "value": "2022-10-07 18:00:00"
                    }
                ]

Как и даты, у вас могут быть неоднозначные сущности datetime. Например, "3 мая полудня" может ссылаться на любой год. Решение предоставляется в этом году и далее в качестве вариантов. Значение timexXXXX указывает, что год не указан.

"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"
                    }
                ]

Диапазоны даты и времени

Диапазон дат — это период с начальной и конечной датой, временем или датой.

Примеры: "с 3 января 6 утра до 25 апреля 8 вечера 2022", "между понедельником и четвергом", "июнь", "выходные"

Параметр "длительность" указывает время, прошедшее в секундах (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"
                    }
                ]

Set

Набор — это повторяющийся период даты и времени. Наборы не разрешают точные значения, так как они не указывают точное время даты и времени.

Примеры: "каждый понедельник в 6 вечера", "каждый четверг", "каждый выходные"

Для "каждый понедельник в 6 вечера", timex значение не указывает на указанный год с начальным XXXX, а затем каждый понедельник по WXX-1 , чтобы определить первый день каждой недели, и, наконец , T18 , чтобы указать 6 вечера.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Set",
                        "timex": "XXXX-WXX-1T18",
                        "value": "not resolved"
                    }
                ]

Измерения

Примеры: "24 км/ч", "44 квадратных метров", "6 килобайт"

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

Возможные значения "resolutionKind" и их "unit":

AreaResolution:
- Квадратный Километр
- Квадратный Хектометр
- SquareDecameter
- SquareMeter
- КвадратныйDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- Квадратный двор
- Акр
InformationResolution:
- бит
- Килобит
- Мегабит
- Гигабитное
- Терабит
- Петабит
- Байт
- Килобайт
- Мегабайт
- ГБ
- Терабайт
- Петабайт
LengthResolution:
- Километр
- Гектометр
- Декаметр
- средство измерения.
- Дециметр
- Сантиметр
- Миллиметр
- Micrometer
- Нанометр
- Пикометр
- Миля
- Двор
- Дюймовый
- Ноги
- Световый год
- Pt
SpeedResolution:
- МетрыPerSecond
- КилометровыйPerHour
- КилометровыйPerMinute
- КилометровыйPerSecond
- MilesPerHour
- Узел
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- СчетчикиPerMillisecond
- СантиметрыPerMillisecond
- КилометровыйPerMillisecond
VolumeResolution:
- Кубометр
- CubicCentimeter
- Кубимитер
- Hectoliter
- Декалитер
- Литры
- Декилитер
- Centiliter
- Миллилитр
- Кубическая ярд
- CubicInch
- CubicFoot
- Кубиля
- FluidOunce
- Чайной ложки
- Столовая ложка
- Пинта
- Кварта
- Кубок
- Gill
- Сжатие
- FluidDram
- Ствола
- Миним
- Шнур
- Пек
- Бушель
- Бочку
WeightResolution:
- Килограмм
- Грамм
- Миллиграмм
- Микрограмм
- Галлон
- MetricTon
- Ton
- Фунт
- Унция
- Интервал
- Пеннивес
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Камень
- Драм

Число

Примеры: "27", "сто и три", "38,5", "2/3", "33%"

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

Возможные значения для numberKind:

Целое число
Decimal
Fraction
Power
Процент

Порядковый

Примеры: "3rd", "first", "last"

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

Возможные значения для "relativeTo":

Запустить
По правому краю

Температура

Примеры: "88 deg fahrenheit", "двадцать три градуса цельсия"

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

Возможные значения для "unit":

По Цельсию
Фаренгейта
Кельвин
Ранкина

Разрешение сущностей в стандартных форматах

Возраст

Валюта

Datetime

Дата

Время

Datetime

Диапазоны даты и времени

Set

Измерения

Число

Порядковый

Температура

Дополнительные ресурсы