Entitas bawaan DatetimeV2 untuk aplikasi LUIS

  • Artikel

Penting

LUIS akan dihentikan pada 1 Oktober 2025 dan mulai 1 April 2023 Anda tidak akan dapat membuat sumber daya LUIS baru. Sebaiknya migrasikan aplikasi LUIS Anda ke pemahaman bahasa percakapan untuk mendapatkan manfaat dari dukungan produk berkelanjutan dan kemampuan multibahasa.

Entitas bawaan datetimeV2 mengekstrak nilai tanggal dan waktu. Nilai-nilai ini diselesaikan dalam format standar untuk digunakan program klien. Bila sebuah ucapan memiliki tanggal atau waktu yang belum selesai, LUIS menyertakan nilai masa lalu dan masa depan dalam respons titik akhir. Karena entitas ini sudah dilatih, Anda tidak perlu menambahkan contoh ucapan yang berisi datetimeV2 ke niat aplikasi.

Jenis datetimeV2

DatetimeV2 dikelola dari repositori GitHub Pengenal teks.

Contoh JSON

Ucapan berikut dan respons JSON sebagian yang ditunjukkan di bawah ini.

8am on may 2nd 2019

"entities": {
    "datetimeV2": [
        {
            "type": "datetime",
            "values": [
                {
                    "timex": "2019-05-02T08",
                    "resolution": [
                        {
                            "value": "2019-05-02 08:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Subtipe dari datetimeV2

Entitas bawaan datetimeV2 memiliki subtipe berikut, dan contoh masing-masing disediakan dalam tabel berikut:

  • date
  • time
  • daterange
  • timerange
  • datetimerange

Nilai resolusi

  • Array memiliki satu elemen jika tanggal atau waktu dalam ucapan ditentukan sepenuhnya dan tidak ambigu.
  • Array memiliki dua elemen jika nilai datetimeV2 ambigu. Ambiguitas mencakup kurangnya tahun, waktu, atau rentang waktu tertentu. Lihat Tanggal ambigu untuk contoh. Ketika waktunya bersifat ambigu untuk A.M. atau P.M., kedua nilai tersebut disertakan.
  • Array memiliki empat elemen jika ucapan memiliki dua elemen dengan ambiguitas. Ambiguitas ini mencakup elemen yang memiliki:
    • Tanggal atau rentang tanggal yang ambigu dengan tahun
    • Rentang waktu atau waktu yang bersifat ambigu untuk A.M. atau P.M. Misalnya, 3 April 3:00.

Setiap elemen array values mungkin memiliki bidang berikut:

Nama properti Deskripsi properti
timex waktu, tanggal, atau rentang tanggal yang dinyatakan dalam format TIMEX yang mengikuti standar ISO 8601 dan atribut TIMEX3 untuk anotasi menggunakan bahasa TimeML.
mod istilah yang digunakan untuk menjelaskan cara menggunakan nilai seperti before, after.
jenis Subtipe, yang dapat berupa salah satu item berikut: datetime, date, time, daterange, timerange, datetimerange, duration, set.
value Opsional. Objek tanggalwaktu dalam Format yyyy-MM-dd (tanggal), HH:mm:ss (waktu) yyyy-MM-dd HH:mm:ss (tanggalwaktu). Jika type adalah duration, nilainya adalah jumlah detik (durasi)
Hanya digunakan jika type adalah datetime atau date, time, atau `durasi.

Nilai tanggal yang valid

datetimeV2 mendukung tanggal antara rentang berikut:

Min Maks
1 Januari 1900 31 Desember 2099

Tanggal ambigu

Jika tanggal bisa di masa lalu atau masa depan, LUIS memberikan kedua nilai tersebut. Contohnya adalah ucapan yang mencantumkan bulan dan tanggal tanpa tahun.

Misalnya, diberikan ucapan berikut:

May 2nd

  • Jika tanggal hari ini adalah 3 Mei 2017, LUIS memberikan "02-05-2017" dan "02-05-2018" sebagai nilai.
  • Jika tanggal hari ini adalah 1 Mei 2017, LUIS memberikan nilai "02-05-2016" dan "02-05-2017".

Contoh berikut menunjukkan resolusi entitas "2 mei". Resolusi ini mengasumsikan bahwa tanggal hari ini adalah antara tanggal 2 Mei 2017 dan 1 Mei 2018. Bidang dengan X di bidang timex adalah bagian dari tanggal yang tidak ditentukan secara eksplisit dalam ucapan.

Contoh resolusi tanggal

Ucapan berikut dan respons JSON sebagian yang ditunjukkan di bawah ini.

May 2nd

"entities": {
    "datetimeV2": [
        {
            "type": "date",
            "values": [
                {
                    "timex": "XXXX-05-02",
                    "resolution": [
                        {
                            "value": "2019-05-02"
                        },
                        {
                            "value": "2020-05-02"
                        }
                    ]
                }
            ]
        }
    ]
}

Contoh resolusi rentang tanggal untuk tanggal numerik

Entitas datetimeV2 mengekstrak rentang tanggal dan waktu. Bidang start dan end menentukan awal dan akhir rentang. Untuk ucapan May 2nd to May 5th, LUIS memberikan nilai daterange untuk tahun saat ini dan tahun berikutnya. Di bidang timex, nilai XXXX menunjukkan ambiguitas tahun. P3D menunjukkan jangka waktu tiga hari.

Ucapan berikut dan respons JSON sebagian yang ditunjukkan di bawah ini.

May 2nd to May 5th


"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-05-02,XXXX-05-05,P3D)",
                    "resolution": [
                        {
                            "start": "2019-05-02",
                            "end": "2019-05-05"
                        },
                        {
                            "start": "2020-05-02",
                            "end": "2020-05-05"
                        }
                    ]
                }
            ]
        }
    ]
}

Contoh resolusi rentang tanggal untuk hari dalam seminggu

Contoh berikut menunjukkan bagaimana LUIS menggunakan datetimeV2 untuk menyelesaikan ucapan Tuesday to Thursday. Dalam contoh ini, tanggal saat ini adalah 19 Juni. LUIS menyertakan nilai daterange untuk kedua rentang tanggal yang mendahului dan mengikuti tanggal saat ini.

Ucapan berikut dan respons JSON sebagian yang ditunjukkan di bawah ini.

Tuesday to Thursday

"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-WXX-2,XXXX-WXX-4,P2D)",
                    "resolution": [
                        {
                            "start": "2019-10-08",
                            "end": "2019-10-10"
                        },
                        {
                            "start": "2019-10-15",
                            "end": "2019-10-17"
                        }
                    ]
                }
            ]
        }
    ]
}

Waktu yang ambigu

Array nilai memiliki dua elemen waktu jika waktu, atau rentang waktu ambigu. Ketika ada waktu yang ambigu, nilai memiliki waktu A.M. dan P.M.

Contoh resolusi rentang waktu

Respons JSON DatetimeV2 telah berubah di API V3. Contoh berikut menunjukkan bagaimana LUIS menggunakan datetimeV2 untuk menyelesaikan ucapan yang memiliki rentang waktu.

Perubahan dari API V2:

  • datetimeV2.timex.type properti tidak lagi dikembalikan karena dikembalikan pada tingkat induk, datetimev2.type.
  • Properti datetimeV2.value telah diubah namanya menjadi datetimeV2.timex.

Ucapan berikut dan respons JSON sebagian yang ditunjukkan di bawah ini.

from 6pm to 7pm

JSON berikut dengan verbose parameter diatur menjadi false:


"entities": {
    "datetimeV2": [
        {
            "type": "timerange",
            "values": [
                {
                    "timex": "(T18,T19,PT1H)",
                    "resolution": [
                        {
                            "start": "18:00:00",
                            "end": "19:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Contoh resolusi waktu

Ucapan berikut dan respons JSON sebagian yang ditunjukkan di bawah ini.

8am

"entities": {
    "datetimeV2": [
        {
            "type": "time",
            "values": [
                {
                    "timex": "T08",
                    "resolution": [
                        {
                            "value": "08:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Datetime bawaan yang tidak digunakan lagi

datetime Entitas bawaan tidak digunakan lagi dan digantikan oleh datetimeV2.

Untuk mengganti datetime dengan datetimeV2 di aplikasi LUIS Anda, selesaikan langkah-langkah berikut:

  1. Buka panel Entitas antarmuka web LUIS.
  2. Hapus entitas bawaan datetime.
  3. Pilih Tambahkan entitas bawaan
  4. Pilih datetimeV2 dan klik Simpan.

Langkah berikutnya

Pelajari tentang dimensi, entitas surel, dan angka.