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

Статья
12/19/2023

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

В настоящее время компоненты метаданных обрабатывают разрешения в стандартном формате для сущности. Сущности могут быть выражены в различных формах, а разрешения предоставляют стандартные прогнозируемые форматы для общих количественных типов. Например, "восемьдесят" и "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 включает несколько разных подтипов, возвращающих разные объекты ответа.

Дата

Конкретные дни.

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

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

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

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

Time

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

Примеры: "9:39:33 AM", "семь утра", "20:03"

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

Datetime

Конкретные сочетания даты и времени.

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

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

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

"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:00 по 25 апреля 2022 г.", "между понедельником и четвергом", "июнь", "выходные дни"

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

"metadata": {
                "duration": "PT2702H",
                "begin": "2022-01-03 06:00:00",
                "end": "2022-04-25 20:00:00"
            }

Присвойте параметру

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

Примеры: "каждый понедельник в 18:00", "каждый четверг", "каждый уик-энд"

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

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

Измерения

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

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

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

Для измерений:
- SquareKilometer
- Квадратный гектометр
- Квадратный экаметр
- Квадратный метр
- Квадратныйdecimeter
- Квадратный середина
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- Квадратный двор
- Acre
Для получения сведений:
- bit
- Килобит
- Мегабит
- Гигабитная
- Терабит
- Петабит
- Byte
- Килобайт
- Мегабайт
- ГБ
- Терабайт
- Петабайт
Для параметра Длина, ширина, высота:
- Километр
- Гектометр
- Декаметр
- средство измерения.
- Дециметр
- Сантиметр
- Миллиметр
- Micrometer
- Нанометр
- Пикометр
- Миля
- Двор
- Дюймовый
- Ноги
- Светлый год
- Pt
Для параметра Скорость:
- MeterPerSecond
- КилометровПерЧур
- КилометрыПерМинут
- КилометровПерСекунд
- MilesPerHour
- Узел
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MeterPerMillisecond
- СантиметрыPerMillisecond
- KilometersPerMillisecond
Для тома:
- Кубический метр
- Кубическийcentimeter
- CubicMillimiter
- Гектолит
- Декалитер
- Литр
- Децилитер
- Центилитер
- Миллилитр
- Кубический двор
- CubicInch
- Кубическийфут
- Кубическая миля
- FluidOunce
- Чайной ложки
- Столовая ложка
- Пинта
- Кварта
- Кубок
- Джилл
- Сжатие
- FluidDram
- Ствола
- Миним
- Шнур
- Пек
- Бушель
- Бочку
Для веса:
- Килограмм
- Грамм
- Миллиграмм
- Микрограмм
- Галлон
- MetricTon
- Тонна
- Фунт
- Унция
- Зерна
- Пеннивес
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Камень
- Драм

Порядковый номер

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

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

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

Начать
Конец

температура;

Примеры: "88 градусов по цельсию", "двадцать три градуса по Цельсию"

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