エンティティ メタデータ

  • [アーティクル]

エンティティ メタデータ オブジェクトは、検出されたエンティティに関するオプションの追加情報をキャプチャし、特に数値エンティティとテンポラル エンティティに対する解決を提供します。 この属性は、使用可能な補助データがある場合にのみ設定され、検出されたエンティティの包括性が強化されます。 メタデータ コンポーネントには、数値エンティティとテンポラル エンティティの両方向けに設計された解像度が含まれます。 メタデータの属性が空であるか、存在しない可能性があるケースを処理することが重要です。すべてのエンティティに存在しているわけではないからです。

現在、メタデータ コンポーネントは、エンティティの標準形式への解決を処理します。 エンティティはさまざまな形式で表現でき、解決は一般的な量指定可能な型に対して標準的な予測可能な形式を提供します。 たとえば、"八十" と "80" の両方が整数 80に解決されます。

NER 解決を使用してアクションを実装したり、追加情報を取得したりできます。 たとえば、サービスは datetime エンティティを抽出して、会議のスケジュール システムに提供される日付と時刻を抽出できます。

注意

エンティティ メタデータは、api-version=2023-04-15-preview 以降でのみサポートされます。 古い API バージョンの場合は、エンティティの解決に関する記事をチェックできます。

このアーティクルドキュメントでは、エンティティ カテゴリまたはメタデータ オブジェクトのサブカテゴリごとに返される解決オブジェクトについて説明します。

数値エンティティ

Age

例: "10 歳"、"23 か月前"、"60 才。"

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

"ユニット" に指定できる値:

  • 年
  • Month
  • 週
  • 日間

通貨

例: "30 エジプト ポンド"、"77 米国ドル"

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

"unit" と "ISO4217" に指定できる値:

Datetime/テンポラル エンティティ

Datetime には、異なる応答オブジェクトを返すいくつかの異なるサブタイプが含まれています。

Date

特定の日。

例: "1995 年 1 月 1 日"、"4 月 12 日"、"2022 年 10 月 7 日"、"明日"

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

あいまいな日付が指定されるたびに、解決のためのさまざまなオプションが提供されます。 たとえば、"4 月 12 日" は任意の年を参照できます。 解像度は、今年と次のオプションとして提供します。 このtimex値XXXXは、クエリで年が指定されていないことを示します。

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

あいまいさは、特定の曜日でも発生する可能性があります。 たとえば、"Monday" と言えば、先週の月曜日または今週の月曜日を参照できます。 もう一度、 timex 値は年または月が指定されていないことを示し、曜日識別子 (W) を使用して週の最初の日を示します。

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

Time

特定の時刻。

例: "午前9:39:33"、"午前７時"、"20:03"

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

Datetime

特定の日付と時刻の組み合わせ。

例: "明日午後6時 "、"午後8時１月３日"、"１１月１日 19:30"

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

日付と同様に、あいまいな datetime エンティティを持つことができます。 たとえば、"5 月 3 日の正午" は、任意の年を参照できます。 解像度は、今年と次のオプションとして提供します。 XXXX のtimex値は、年が指定されていないことを示します。

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

Datetime 範囲

datetime 範囲は、開始日と終了日の日付、時刻、または datetime を含む期間です。

例: "2022 年 1 月 3 日午前 3 時から 4 月 25 日午後 8 時まで"、"月曜日から木曜日の間"、"６月"、"週末"

"duration" パラメーターは、秒 (S)、分 (M)、時間 (H)、または日 (D) で渡されるtimeを示します。 このパラメーターは、明示的な開始日時と終了日時がクエリ内にある場合にのみ返されます。 "次週" は、週の "開始" パラメーターと "終了" パラメーターのみを返します。

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

オン

セットは定期的なdatetimeです。 セットは正確なdatetimeを示さないので、正確な値には解決されません。

例: "毎週月曜日の午後 6 時"、"毎週木曜日"、"毎週末"

"毎週月曜日の午後 6 時" の場合、 このtimex 値は、開始 XXXX で指定された年を示しません。毎週月曜日から WXX-1 まで、毎週の最初の日を決定し、最後に T18 は午後 6 時を示します。

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

Dimensions

例: "24 km/hr"、"44 平方メートル"、"66 キロバイト"

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

"unit" フィールド値に使用できる値:

  • 測定の場合:

    • スクエアキロメートル
    • スクエアヘクトメートル
    • スクエアデカメートル
    • スクエアメートル
    • スクエアデシメ―トル
    • スクエアセンチメートル
    • スクエアミリメートル
    • スクエアインチ
    • スクエアフィート
    • スクエアマイル
    • スクエアヤード
    • Acre

  • 情報の場合:

    • ビット
    • キロビット
    • メガビット
    • ギガビット
    • テラビット
    • ペタビット
    • Byte
    • キロバイト
    • メガバイト
    • ギガバイト
    • テラバイト
    • ペタバイト

  • 長さ、幅、高さの場合:

    • キロメートル
    • ヘクトメーター
    • デケーター
    • 測定
    • デシメーター
    • センチメートル
    • ミリメートル
    • Micrometer
    • ナノメートル
    • ピコメーター
    • マイル
    • ヤード
    • インチ
    • 1 フィート
    • ライトイヤー
    • Pt

  • 速度の場合:

    • メートル毎秒
    • キロメートル毎時
    • キロメートル毎時
    • キロメートル毎秒
    • マイル毎時
    • 結び目
    • フィート毎秒
    • フィート毎分
    • ヤード毎分
    • ヤード毎秒
    • メーター毎ミリセコンド
    • センチメーター毎ミリセコンド
    • キロメーター毎ミリセコンド

  • 体積の場合:

    • キュービックメーター
    • キュービックセンチメーター
    • キュービックミリメーター
    • ヘクトメーター
    • デカリットル
    • リットル
    • デカリッター
    • センチリットル
    • ミリリットル
    • キュービックヤード
    • キュービックインチ
    • キュービックフィート
    • キュービックマイル
    • 液体オンス
    • 小さじ
    • 大匙
    • パイント
    • クォート
    • カップ
    • グリル
    • ピンチ
    • 液体ドラム
    • Barrel
    • 最小
    • コード
    • ペック
    • ブッシェル
    • 大 だる

  • 重さの場合:

    • キログラム
    • グラム
    • ミリグラム
    • マイクログラム
    • ガロン
    • メトリックトン
    • トン
    • ポンド
    • オンス
    • グレイン
    • ペニーウェイト
    • イギリスロングトン
    • アメリカショートトン
    • アメリカショートハンドレットウェイト
    • ストン
    • ドラム

Ordinal

例: "3番目"、"最初"、"最後"

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

"relativeTo"の可能値は以下のとおりです:

  • 開始
  • End

気温

例: "88 度華氏"、"23°C"

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

"ユニット" に指定できる値:

  • 摂氏
  • ファラハイト
  • ケルビン
  • ランキン