Komponen bawaan ini mengambil dan memvalidasi tanggal lahir dengan mengumpulkan bulan, tanggal, dan tahun.
Batasan
Selain batasan komponen bawaan umum, komponen bawaan ini mencakup batasan berikut:
- Komponen ini tidak mendukung verifikasi tanggal lahir pengguna dengan membandingkannya dengan tanda pengenal pengguna.
Setelan agen yang direkomendasikan
Aktifkan DTMF agar pengguna dapat memasukkan nilai numerik menggunakan keypad telepon.
Fitur tambahan
Komponen bawaan ini menyediakan fitur tambahan berikut:
Contoh dialog
Contoh dialog menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Mereka menunjukkan perilaku saat pengguna memanggil komponen menggunakan telepon, yang memicu Intent Sambutan Default dan respons agen pertama di awal percakapan.
Tanggal lahir lengkap
- Pengguna memberikan tanggal lahir lengkap dalam satu giliran.
- Agen berhasil menerimanya.
| Input Pengguna | Respons Agen |
|---|---|
| Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan hari lahir, lalu tahun lahir Anda. | |
| 9 September 1995 | |
| Oke, tanggal lahir Anda adalah 9 September 1995. Apakah itu benar? | |
| ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. |
Tanggal lahir sebagian
- Pengguna memberikan tanggal lahir dengan mengucapkan bulan terlebih dahulu, diikuti dengan tanggal dan tahun.
- Agen berhasil menerimanya.
| Input Pengguna | Respons Agen |
|---|---|
| Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan hari lahir, lalu tahun lahir Anda. | |
| Maret | |
| Pada hari apa Anda lahir? | |
| 12 | |
| Tahun berapa Anda lahir? | |
| 1999 | |
| Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar? | |
| ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. |
Validasi tanggal mendatang
Skenario ini mengasumsikan bahwa tanggal saat ini adalah 22 Maret 2023:
- Pengguna memberikan tanggal lahir di masa mendatang.
- Agen memvalidasinya dan meminta pengguna untuk memberikan tanggal lahir yang benar.
| Input Pengguna | Respons Agen |
|---|---|
| Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan hari lahir, lalu tahun lahir Anda. | |
| 9 September 2023 | |
| Tahun berapa Anda lahir? | |
| 2023 | |
| Oke, tanggal lahir Anda adalah 9 September 2023. Apakah itu benar? | |
| ya | |
| Maaf, Anda telah memberikan tanggal yang akan datang. Mari kita mulai lagi. Pada bulan apa Anda lahir? |
|
| Maret | |
| Pada hari apa Anda lahir? | |
| 12 | |
| Tahun berapa Anda lahir? | |
| 1999 | |
| Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar? | |
| ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. |
Tanggal tidak valid
- Pengguna memberikan tanggal lahir yang tidak valid, misalnya, 30 Februari 1999, atau 31 April 1999.
- Agen memvalidasinya dan meminta pengguna untuk memberikan tanggal lahir yang benar.
| Input Pengguna | Respons Agen |
|---|---|
| Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan hari lahir, lalu tahun lahir Anda. | |
| 30 Februari 1999 | |
| Oke, tanggal lahir Anda adalah 30 Februari 1999. Apakah itu benar? | |
| ya | |
| Tanggal yang Anda berikan tidak valid. Mari kita mulai lagi. Pada bulan apa Anda lahir? |
|
| Maret | |
| Pada hari apa Anda lahir? | |
| 12 | |
| Tahun berapa Anda lahir? | |
| 1999 | |
| Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar? | |
| ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. |
Input tidak dikenali
Komponen keluar dari alur setelah pengguna memberikan input yang tidak dikenali sebanyak tiga kali.
| Input Pengguna | Respons Agen |
|---|---|
| Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan hari lahir, lalu tahun lahir Anda. | |
| Tidak apa-apa | |
| Maaf, saya tidak mengerti. Bisakah Anda mengucapkan atau memasukkan tanggal lahir Anda lagi? | |
| bagus | |
| Maaf, kami tidak mendapatkan tanggal lahir Anda. Mari kita mulai dengan bulan. Sebutkan bulan kelahiran Anda. | |
| good | |
| Maaf, saya tidak mengerti. Bisa ucapkan atau masukkan nomor bulan lagi? | |
| bagus | |
| Hmm, saya masih belum bisa memahaminya. Pastikan Anda mengucapkan bulan. Jika saya kesulitan mendengar Anda, Anda juga dapat menggunakan keypad untuk memasukkan nomor bulan. | |
| bagus | |
| Maaf, saya kesulitan memahami respons Anda. |
Validasi tanggal lahir
Komponen bawaan ini menggunakan fungsi sistem IS_DATE dan IS_FUTURE_DATE untuk memeriksa apakah tanggal yang dikumpulkan valid dan berada di masa lalu.
Selain itu:
- Input seperti "bulan ini", "bulan depan", atau "bulan lalu" dikonversi menjadi bulan yang sesuai. Misalnya, jika Anda berinteraksi dengan agen pada bulan Maret, "bulan ini", "bulan depan", dan "bulan lalu" akan dikonversi menjadi "Maret", "April", dan "Februari".
- Komponen memvalidasi bahwa tahun memiliki empat digit. Jika input tahun hanya berisi dua digit, komponen akan mengonversinya menjadi tahun empat digit. Misalnya, "98" dikonversi menjadi "1998".
- Input seperti "Kamis ini", "Kamis lalu", dan "Kamis depan" akan ditangkap sebagai bulan dan hari yang sesuai, dan agen akan meminta Anda untuk memberikan tahun. Misalnya, jika Anda berinteraksi dengan agen pada 22 Maret 2023, yang merupakan hari Rabu, maka "Kamis ini", "Kamis lalu", dan "Kamis depan" akan dikonversi menjadi "23 Maret", "16 Maret", dan "30 Maret".
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Component Name] | Pengumpulan Tanggal Lahir |
| Intent Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_dob_collection_collect_month |
| Parameter | [param_name] | dob |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_dob_collection_dob_day |
Parameter output
Parameter output adalah parameter sesi yang tetap aktif setelah keluar dari komponen. Parameter ini berisi informasi penting yang dikumpulkan oleh komponen.
Komponen bawaan ini memberikan nilai untuk parameter output berikut:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| dob_collection_dob | Menampilkan objek yang berisi elemen tanggal lahir: hari, bulan, dan tahun. | { |
Penyiapan dasar
Untuk menyiapkan komponen bawaan ini, Anda dapat Mengimpor komponen bawaan.
Selesai
Komponen bawaan kini telah disiapkan dan siap diuji.