Метаданные сущности

Статья
11/21/2024

Объект метаданных сущностей записывает необязательные дополнительные сведения об обнаруженных сущностях, предоставляя разрешения специально для числовых и темпоральных сущностей. Этот атрибут заполняется только при наличии дополнительных данных, повышая полноту обнаруженных сущностей. Компонент метаданных включает разрешения, предназначенные для числовых и темпоральных сущностей. Важно обрабатывать случаи, когда атрибут метаданных может быть пустым или отсутствующим, так как его присутствие не гарантируется для каждой сущности.

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

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

Примечание.

Метаданные сущности поддерживаются только начиная с api-version=2023-04-15-preview. Для более старых версий API можно проверить статью "Разрешения сущностей".

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

Числовые сущности

Возраст

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

"metadata": {
                "unit": "Year",
                "value": 10
            }

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

Год
месяц
Неделя
День

Валюта

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

"metadata": {
                "unit": "Egyptian pound",
                "ISO4217": "EGP",
                "value": 30
            }

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

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

Сущности Datetime и Темпоральные сущности

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

Дата

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

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

"metadata": {
                "dateValues": [
                    {
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]
            }

Всякий раз, когда указана неоднозначная дата, вы предлагаете различные варианты разрешения. Например, "12 апреля" может ссылаться на любой год. Решение предоставляется в этом году и далее в качестве вариантов. Значение timex XXXX указывает, что в запросе не указан год.

"metadata": {
                "dateValues": [
                    {
                        "timex": "XXXX-04-12",
                        "value": "2022-04-12"
                    },
                    {
                        "timex": "XXXX-04-12",
                        "value": "2023-04-12"
                    }
                ]
            }

Неоднозначность может возникать даже в течение определенного дня недели. Например, говоря "понедельник" может ссылаться на прошлый понедельник или в этот понедельник. timex Снова значение указывает, что год или месяц не указан, и использует день идентификатора недели (W) для указания первого дня недели.

"metadata" :{
                "dateValues": [
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-03"
                    },
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-10"
                    }
                ]
            }

Время

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

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

"metadata": {
                "timex": "T09:39:33",
                "value": "09:39:33"
            }

Datetime

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

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

"metadata": {
                "timex": "2022-10-07T18",
                "value": "2022-10-07 18:00:00"
            }

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

"metadata": {
                 "dateValues": [ 
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2022-05-03 12:00:00"
                       },
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2023-05-03 12:00:00"
                       }
                  ]
              }

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

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

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

Параметр "длительность" указывает время, прошедшее в секундах (S), минутах (M), часах (H) или днях (D). Этот параметр возвращается только в том случае, если явное время начала и окончания находятся в запросе. "На следующей неделе" возвращается только с параметрами begin и end на неделю.

"metadata": {
                "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 вечера.

"metadata": {
                "timex": "XXXX-WXX-1T18",
                "value": "not resolved"
            }

Измерения

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

"metadata": {
                "unit": "KilometersPerHour",
                "value": 24
            }

Возможные значения полей unit:

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

Порядковый

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

"metadata": {
                "offset": "3",
                "relativeTo": "Start",
                "value": "3"
            }

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

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

Температура

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

"metadata": {
                "unit": "Fahrenheit",
                "value": 88
            }