Komponen bawaan pengumpulan tanggal lahir

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.

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

  1. Pengguna memberikan tanggal lahir lengkap dalam satu giliran.
  2. 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

  1. Pengguna memberikan tanggal lahir dengan mengucapkan bulan terlebih dahulu, diikuti dengan tanggal dan tahun.
  2. 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:

  1. Pengguna memberikan tanggal lahir di masa mendatang.
  2. 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

  1. Pengguna memberikan tanggal lahir yang tidak valid, misalnya, 30 Februari 1999, atau 31 April 1999.
  2. 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.
{
"year": integer,
"month": integer,
"day": integer
}

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini, Anda dapat Mengimpor komponen bawaan.

Selesai

Komponen bawaan kini telah disiapkan dan siap diuji.