Share via


엔터티 메타데이터

엔터티 메타데이터 개체는 검색된 엔터티에 대한 선택적 추가 정보를 캡처하여 숫자 및 temporal 엔터티에 대한 해상도를 제공합니다. 이 특성은 추가 데이터를 사용할 수 있는 경우에만 채워져 검색된 엔터티의 포괄성을 개선합니다. 메타데이터 구성 요소는 숫자 엔터티와 temporal 엔터티 모두를 위해 설계된 해상도를 포함합니다. 일부 엔터티에 대해서는 없는 경우도 있기 때문에 메타데이터 특성이 비어 있거나 없는 경우를 처리하는 것이 중요합니다.

현재 메타데이터 구성 요소는 엔터티의 표준 형식에 대한 해상도를 처리합니다. 엔터티는 다양한 형식으로 표현할 수 있으며 해상도는 공통의 정량적 형식에 대한 예측 가능한 표준 형식을 제공합니다. 예를 들어 "eighty" 및 "80"은 모두 정수 80으로 확인되어야 합니다.

NER 해상도를 사용하여 작업을 구현하거나 추가 정보를 검색할 수 있습니다. 예를 들어 서비스는 날짜/시간 엔터티를 추출하여 모임 일정 시스템에 제공되는 날짜 및 시간을 추출할 수 있습니다.

참고 항목

엔터티 메타데이터는 api-version=2023-04-15-preview부터만 지원됩니다. 이전 API 버전의 경우 엔터티 해상도 문서를 확인하면 됩니다.

이 문서는 메타데이터 개체의 각 엔터티 범주 또는 하위 범주에 대해 반환된 해상도 개체를 문서화한 것입니다.

숫자 엔터티

나이

예: "10세", "23개월", "60 Y.O."

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

"unit"의 가능한 값은 다음과 같습니다.

  • Year
  • Month
  • 요일

통화

예: "30 이집트 파운드", "77 USD"

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

"unit" 및 "ISO4217"의 가능한 값은 다음과 같습니다.

날짜/시간/Temporal 엔터티

Datetime에는 서로 다른 응답 개체를 반환하는 여러 가지 하위 형식이 포함되어 있습니다.

날짜

특정 날짜

예: "1995년 1월 1일", "4월 12일", "2022년 10월 7일", "내일"

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

모호한 날짜가 제공될 때마다 해상도를 위한 다양한 옵션이 제공됩니다. 예를 들어 "4월 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", "오전 7시", "20:03"

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

DateTime

특정 날짜 및 시간 조합

예: "내일 오후 6시", "1월 3일 오후 8시", "11월 1일 19:30"

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

날짜와 마찬가지로 날짜/시간 엔터티가 모호할 수 있습니다. 예를 들어 "5월 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"
                       }
                  ]
              }

날짜/시간 범위

날짜/시간 범위는 시작 및 종료 날짜, 시간 또는 날짜/시간으로 된 기간입니다.

예: "2022년 1월 3일 오전 6시부터 4월 25일 오후 8시까지", "월요일부터 목요일 사이", "6월", "주말"

"duration" 매개 변수는 경과된 시간을 초(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"
            }

차원

예: "24km/hr", "44평방미터", "66킬로바이트"

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

"unit" 필드 값에 사용할 수 있는 값은 다음과 같습니다.

  • 측정:

    • SquareKilometer
    • SquareHectometer
    • SquareDecameter
    • SquareMeter
    • SquareDecimeter
    • SquareCentimeter
    • SquareMillimeter
    • SquareInch
    • SquareFoot
    • SquareMile
    • SquareYard
    • Acre
  • 정보:

    • bit
    • Kilobit
    • Megabit
    • 기가비트
    • Terabit
    • Petabit
    • Byte
    • Kilobyte
    • Megabyte
    • 기가바이트
    • Terabyte
    • Petabyte
  • 길이, 너비, 높이:

    • 킬로미터
    • Hectometer
    • Decameter
    • 미터
    • Decimeter
    • 센티미터
    • 밀리미터
    • 마이크로미터
    • Nanometer
    • Picometer
    • 마일
    • Yard
    • Inch
    • Foot
    • Light year
    • Pt
  • 속도:

    • MetersPerSecond
    • KilometersPerHour
    • KilometersPerMinute
    • KilometersPerSecond
    • MilesPerHour
    • Knot
    • FootPerSecond
    • FootPerMinute
    • YardsPerMinute
    • YardsPerSecond
    • MetersPerMillisecond
    • CentimetersPerMillisecond
    • KilometersPerMillisecond
  • 부피:

    • 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
  • 무게:

    • 킬로그램
    • 그램
    • 밀리그램
    • Microgram
    • Gallon
    • MetricTon
    • Ton
    • 파운드
    • Ounce
    • Grain
    • Pennyweight
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Dram

서수

예: "세 번째", "첫 번째", "마지막"

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

"relativeTo"의 가능한 값은 다음과 같습니다.

  • 시작

온도

예: "화씨 88도", "섭씨 23도"

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

"unit"의 가능한 값은 다음과 같습니다.

  • 섭씨
  • Fahrenheit
  • Kelvin
  • Rankine