Beberapa produk dan fitur sedang dalam proses penggantian nama. Fitur playbook dan alur generatif juga dimigrasikan ke satu konsol gabungan. Lihat detailnya.
Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh
komponen bawaan ini. Contoh dialog menunjukkan perilaku saat komponen
dipanggil melalui telepon, yang memicu Intent Selamat Datang Default dan respons
agen pertama di awal percakapan.
Tanggal lahir lengkap
Pengguna akhir 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 tanggal lahir, lalu tahun lahir Anda.
9 September 1995
Oke, tanggal lahir Anda adalah 9 September 1995. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.
Tanggal lahir sebagian
Pengguna akhir 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 tanggal lahir, lalu tahun lahir Anda.
Maret
Tanggal berapa Anda lahir?
12
Kamu lahir tahun berapa?
1999
Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.
Validasi tanggal mendatang
Skenario ini mengasumsikan bahwa tanggal saat ini adalah 22 Maret 2023. Pengguna akhir memberikan
tanggal lahir di masa mendatang; agen memvalidasinya dan meminta ulang pengguna akhir untuk memberikan
tanggal lahir yang benar.
Input pengguna
Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal lahir, lalu tahun lahir Anda.
9 September 2023
Kamu lahir tahun berapa?
2023
Oke, tanggal lahir Anda adalah 9 September 2023. Apakah itu benar?
ya
Maaf, Anda telah memberikan tanggal mendatang. Mari kita mulai lagi. Bulan apa Anda lahir?
Maret
Tanggal berapa Anda lahir?
12
Kamu lahir tahun berapa?
1999
Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.
Tanggal tidak valid
Pengguna akhir memberikan tanggal lahir yang tidak valid seperti 30 Februari 1999 atau 31 April
1999; agen memvalidasinya dan meminta ulang pengguna akhir untuk memberikan tanggal
lahir yang benar.
Input pengguna
Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal lahir, lalu tahun lahir Anda.
30 Februari 1999
Baik, tanggal lahir Anda adalah 30 Februari 1999. Apakah itu benar?
ya
Tanggal yang Anda berikan tidak valid. Mari kita mulai lagi. Bulan apa Anda lahir?
Maret
Tanggal berapa Anda lahir?
12
Kamu lahir tahun berapa?
1999
Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.
Input tidak dikenal
Komponen keluar dari alur setelah pengguna akhir memberikan input yang tidak dikenal tiga kali.
Input pengguna
Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal 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. Katakan bulan lahir Anda?
good
Maaf, saya tidak mengerti. Bisa ucapkan atau masukkan nomor bulan lagi?
bagus
Hmm, saya masih belum bisa mendapatkannya. Pastikan Anda mengucapkan bulan. Jika saya mengalami masalah saat 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 sudah berlalu. Selain itu:
Input seperti "bulan ini", "bulan depan", atau "bulan lalu" akan dikonversi menjadi bulan yang sesuai. Misalnya, jika pengguna akhir berinteraksi dengan agen pada bulan Maret, "bulan ini", "bulan depan", dan "bulan lalu" akan dikonversi menjadi "Maret", "April", dan "Februari".
Memvalidasi bahwa tahun harus terdiri dari 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 dicatat sebagai bulan dan hari yang sesuai, lalu agen akan meminta Anda untuk memberikan tahunnya. Misalnya, jika pengguna akhir berinteraksi dengan agen pada 22 Maret 2023, yang merupakan hari Rabu, maka "Kamis ini", "Kamis lalu", dan "Kamis depan" masing-masing akan dikonversi menjadi "23 Maret", "16 Maret", dan "30 Maret".
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
Parameter output adalah parameter sesi yang akan 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
Parameter ini menampilkan objek yang berisi elemen tanggal lahir: hari, bulan, dan tahun
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis prebuilt component is designed to collect and validate a user's date of birth, including the month, day, and year.\u003c/p\u003e\n"],["\u003cp\u003eThe component can handle complete or partial date inputs, as well as future or invalid dates, by re-prompting the user for correct information.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes system functions \u003ccode\u003eIS_DATE\u003c/code\u003e and \u003ccode\u003eIS_FUTURE_DATE\u003c/code\u003e to ensure date validity and checks that the date is in the past.\u003c/p\u003e\n"],["\u003cp\u003eThe prebuilt component is limited in that it does not offer ID verification to verify the user's date of birth, and uses specific naming conventions for flows, intents, parameters and entity types.\u003c/p\u003e\n"],["\u003cp\u003eThe component provides a \u003ccode\u003edob_collection_dob\u003c/code\u003e output parameter containing an object with the collected day, month, and year, and also offers repeat, waiting room, and playback functionalities.\u003c/p\u003e\n"]]],[],null,["# Date of birth collection prebuilt component\n\nThis\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\ncaptures and validates a date of birth by collecting month, date, and year.\n\nLimitations\n-----------\n\nIn addition to the\n[common prebuilt component limitations](/dialogflow/cx/docs/concept/prebuilt-component#limits),\nthis prebuilt component has the following limitations:\n\n- This component does not support verification of end-user's date of birth via ID verification.\n\nRecommended agent settings\n--------------------------\n\n[Enable DTMF](/dialogflow/cx/docs/concept/parameter#dtmf) to allow users to input numeric values using the telephone keypad.\n\nAdditional functionalities\n--------------------------\n\nThe following additional functionalities are provided by this prebuilt component:\n\n- [Repeat](/dialogflow/cx/docs/concept/prebuilt-component#repeat-functionality)\n- [Waiting room](/dialogflow/cx/docs/concept/prebuilt-component#waiting-room-functionality)\n- [Playback](/dialogflow/cx/docs/concept/prebuilt-component#playback-functionality)\n\nSample dialogs\n--------------\n\nThe following sample dialogs demonstrate common scenarios handled by this\nprebuilt component. The sample dialogs demonstrate behavior when the component is\ncalled via telephony, which triggers the Default Welcome Intent and the first\nagent response at the start of the conversation.\n\n### Full date of birth\n\nEnd-user provides complete date of birth in one turn; agent successfully accepts it.\n\n### Partial date of birth\n\nEnd-user provides date of birth by saying month first followed by date and year;\nagent successfully accepts it.\n\n### Future date validation\n\nThis scenario assumes the current date is March 22, 2023. End-user provides a\nfuture date of birth; agent validates it and re-prompts end-user to provide the\ncorrect date of birth.\n\n### Invalid date\n\nEnd-user provides an invalid date of birth such as February 30th 1999 or April\n31st 1999; agent validates it and re-prompts end-user to provide the correct\ndate of birth.\n\n### Unrecognized input\n\nComponent exits the flow after the end-user provides unrecognized input three times.\n\nDate of birth validation\n------------------------\n\nThis prebuilt component uses the [IS_DATE](/dialogflow/cx/docs/reference/system-functions#func-isdate)\nand [IS_FUTURE_DATE](/dialogflow/cx/docs/reference/system-functions#func-isfuturedate) system functions to\ncheck whether a collected date is valid and in the past. In addition:\n\n- Inputs such as \"this month\", \"next month\" or \"last month\" are converted into the appropriate months. For example, if the end-user is interacting with the agent in March, then \"this month\", \"next month\" and \"last month\" are converted into \"March\", \"April\" and \"February\" respectively.\n- Validates that the year should be four digits. If the year input contains only two digits, the component converts it into a four-digit year. For example, \"98\" is converted to \"1998\".\n- Input such as \"this Thursday\", \"last Thursday\", and \"next Thursday\" are captured as the appropriate month and day and the agent prompts to provide the year. For example, if end-user is interacting with the agent on March 22, 2023, which is a Wednesday, then \"this Thursday\", \"last Thursday\", and \"next Thursday\" are converted into \"March 23\", \"March 16\", and \"March 30\" respectively.\n\nNaming conventions\n------------------\n\nThis prebuilt component uses the following naming conventions:\n\nOutput parameters\n-----------------\n\nOutput parameters are session parameters that will remain active after exiting\nthe component. These parameters contain important information collected by the\ncomponent. This prebuilt component provides values for the following output\nparameters:\n\nBasic setup\n-----------\n\nTo set up this prebuilt component:\n\n1. [Import the prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component#import).\n\n### Complete\n\nYour agent and should now be set up and ready to test."]]
