次の方法で共有


エンティティを標準形式に解決する

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

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

重要

バージョン 2023-04-15-preview 以降、エンティティ解決機能はエンティティ メタデータに置き換えられました

Note

エンティティ解決応答は、api-version=2022-10-01-preview および "modelVersion": "2022-10-01-preview" 以降でのみサポートされます。

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

Age

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

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

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

  • Month
  • 日間

通貨

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

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

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

Datetime

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

Date

特定の日。

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

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

あいまいな日付が指定されるたびに、解決のためのさまざまなオプションが提供されます。 たとえば、"4 月 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"
                    }
                ]

あいまいさは、特定の曜日でも発生する可能性があります。 たとえば、"Monday" と言えば、先週の月曜日または今週の月曜日を参照できます。 もう一度、 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"
                    }
                ]

Time

特定の時刻。

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

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

Datetime

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

例: "明日午後6時 "、"午後8時1月3日"、"11月1日 19:30"

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

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

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

Datetime 範囲

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

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

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

"resolutions": [
                    {
                        "resolutionKind": "TemporalSpanResolution",
                        "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 時を示します。

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

Dimensions

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

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

"resolutionKind" とその "ユニット" 値に使用できる値:

  • AreaResolution:

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

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

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

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

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

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

Number

例: "27"、"103"、"38.5"、"2/3"、"33%"

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

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

  • Integer
  • Decimal
  • Fraction
  • Power
  • Percent

Ordinal

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

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

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

  • 開始
  • End

気温

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

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

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

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