Mengatasi entitas ke format standar

Resolusi adalah format standar untuk entitas. Entitas dapat dinyatakan dalam berbagai bentuk dan resolusi menyediakan format standar yang dapat diprediksi untuk jenis umum yang dapat diukur. Misalnya, "delapan puluh" dan "80" keduanya harus diselesaikan ke bilangan bulat 80.

Anda dapat menggunakan resolusi NER untuk menerapkan tindakan atau mengambil informasi lebih lanjut. Misalnya, layanan Anda dapat mengekstrak entitas tanggalwaktu untuk mengekstrak tanggal dan waktu yang akan disediakan untuk sistem penjadwalan rapat.

Penting

Mulai dari pratinjau versi 2023-04-15, fitur resolusi entitas digantikan oleh metadata entitas

Catatan

Respons resolusi entitas hanya didukung mulai dari api-version=2022-10-01-preview dan "modelVersion": "2022-10-01-preview".

Artikel ini mendokuensikan objek resolusi yang dikembalikan untuk setiap kategori entitas atau subkategori.

Usia

Contoh: "10 tahun", "23 bulan", "enam puluh Y.O."

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

Nilai yang mungkin untuk "unit":

  • Tahun
  • Month
  • Minggu
  • Hari

Mata Uang

Contoh: "30 pound Mesir", "77 USD"

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

Nilai yang mungkin untuk "unit" dan "ISO4217":

Tanggalwaktu

Tanggalwaktu mencakup beberapa subjenis berbeda yang mengembalikan objek respons yang berbeda.

Tanggal

Hari-hari tertentu.

Contoh: "1 Januari 1995", "12 april", "7 Oktober 2022", "besok"

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

Setiap kali tanggal ambigu disediakan, Anda ditawarkan berbagai opsi untuk resolusi Anda. Misalnya, "12 April" dapat merujuk ke tahun apa pun. Resolusi menyediakan tahun ini dan berikutnya sebagai opsi. Nilai timexXXXX menunjukkan tidak ada tahun yang ditentukan dalam kueri.

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

Ambiguitas dapat terjadi bahkan untuk hari tertentu dalam seminggu. Misalnya, mengatakan "Senin" dapat merujuk ke Senin lalu atau Senin ini. Sekali lagi timex nilai menunjukkan tidak ada tahun atau bulan yang ditentukan, dan menggunakan hari dalam seminggu pengidentifikasi (W) untuk menunjukkan hari pertama dalam seminggu.

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

Waktu

Waktu tertentu.

Contoh: "09:39:33 AM", "seven AM", "20:03"

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

Tanggalwaktu

Kombinasi tanggal dan waktu tertentu.

Contoh: "18.00 besok", "20.00 pada 3 Januari", "1 November 19:30"

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

Mirip dengan tanggal, Anda dapat memiliki entitas tanggalwaktu yang ambigu. Misalnya, "3 Mei siang" dapat merujuk ke tahun apa pun. Resolusi menyediakan tahun ini dan berikutnya sebagai opsi. Nilai timexXXXX menunjukkan tidak ada tahun yang ditentukan.

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

Rentang tanggalwaktu

Rentang tanggalwaktu adalah periode dengan tanggal, waktu, atau tanggalwaktu awal dan akhir.

Contoh: "dari 3 Januari 06:00 hingga 25 April 2022", "antara Senin hingga Kamis", "Juni", "akhir pekan"

Parameter "durasi" menunjukkan waktu yang dilewatkan dalam detik (S), menit (M), jam (H), atau hari (D). Parameter ini hanya dikembalikan ketika tanggalwaktu mulai dan berakhir eksplisit berada dalam kueri. "Minggu depan" hanya akan kembali dengan parameter "begin" dan "end" untuk minggu tersebut.

"resolutions": [
                    {
                        "resolutionKind": "TemporalSpanResolution",
                        "duration": "PT2702H",
                        "begin": "2022-01-03 06:00:00",
                        "end": "2022-04-25 20:00:00"
                    }
                ]

Set

Satu set adalah periode tanggalwaktu berulang. Set tidak diselesaikan ke nilai yang tepat, karena tidak menunjukkan tanggalwaktu yang tepat.

Contoh: "setiap Senin pukul 18.00", "setiap Kamis", "setiap akhir pekan"

Untuk "setiap Senin pukul 18.00", timex nilai menunjukkan tidak ada tahun yang ditentukan dengan XXXX awal, kemudian setiap Senin hingga WXX-1 untuk menentukan hari pertama setiap minggu, dan akhirnya T18 menunjukkan pukul 18.00.

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

Dimensi

Contoh: "24 km/jam", "44 meter persegi", "enam puluh enam kilobyte"

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

Nilai yang mungkin untuk "resolutionKind" dan nilai "unit" mereka:

  • AreaResolution:

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

    • Bit
    • Kilobit
    • Megabit
    • Gigabit
    • Terabit
    • Petabit
    • Byte
    • Kilobyte
    • Megabyte
    • GIGABYTE
    • Terabyte
    • Petabyte
  • LengthResolution:

    • Kilometer
    • Hectometer
    • Decameter
    • Optik
    • Desimeter
    • Sentimeter
    • Milimeter
    • Mikrometer
    • Nanometer
    • Picometer
    • Mil
    • Halaman
    • Inci
    • Kaki
    • Tahun cahaya
    • Pt
  • SpeedResolution:

    • MetersPerSecond
    • KilometersPerHour
    • KilometersPerMinute
    • KilometersPerSecond
    • MilesPerHour
    • Simpul
    • FootPerSecond
    • FootPerMinute
    • YardsPerMinute
    • YardsPerSecond
    • MetersPerMillisecond
    • CentimetersPerMillisecond
    • KilometersPerMillisecond
  • VolumeResolution:

    • KubikMeter
    • CubicCentimeter
    • CubicMillimiter
    • Hektoliter
    • Decaliter
    • Liter
    • Desiliter
    • Centiliter
    • Mililiter
    • CubicYard
    • CubicInch
    • CubicFoot
    • CubicMile
    • FluidOunce
    • Sendok teh
    • Sendok makan
    • Pint
    • Liter
    • Cangkir
    • Gill
    • Sejumput
    • FluidDram
    • Barel
    • Minim
    • Kabel
    • Mematuk
    • Bushel
    • Hogshead
  • WeightResolution:

    • Kilogram
    • Gram
    • Miligram
    • Mikrogram
    • Galon
    • MetricTon
    • Ton
    • Pound
    • Ons
    • Butir
    • Pennyweight
    • Bahasa LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Batu
    • Dram

Angka

Contoh: "27", "seratus tiga", "38,5", "2/3", "33%"

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

Nilai yang mungkin untuk "numberKind":

  • Bilangan bulat
  • Desimal
  • Fraksi
  • Power
  • Persen

Urut

Contoh: "ke-3", "pertama", "terakhir"

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

Nilai yang mungkin untuk "relativeTo":

  • Pangkal
  • End

Suhu

Contoh: "88 deg fahrenheit", "dua puluh tiga derajat celcius"

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

Nilai yang mungkin untuk "unit":

  • Celcius
  • Fahrenheit
  • Kelvin
  • Rankine