Beri nama komponen bawaan koleksi

Komponen bawaan ini menangkap nama depan, nama belakang, dan nama tengah opsional beserta spasi, tanda hubung, atau tanda petik.

Batasan

Selain batasan umum komponen bawaan, komponen bawaan ini memiliki batasan berikut:

  • Nama yang memiliki karakter khusus di luar spasi, tanda petik, dan tanda hubung tidak didukung oleh komponen ini.

Fitur tambahan

Fungsi tambahan berikut disediakan oleh komponen bawaan ini:

Contoh dialog

Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Contoh dialog menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Intent Sambutan Default dan respons agen pertama di awal percakapan.

Nama lengkap

Pengguna akhir memberikan nama lengkap pada giliran pertama; agen berhasil menerimanya.

Input pengguna Respons agen
Siapa nama lengkap Anda? Beri tahu nama depan, nama belakang, dan nama tengah Anda, jika ada.
Sundar Pichai
Untuk mengonfirmasi, nama depan Anda adalah Sundar, dan nama belakang Anda adalah Pichai. Apakah saya mengeja nama lengkap Anda dengan benar?
Ya
Apakah Anda memiliki nama tengah?
tidak
Terima kasih, Sundar.

Nama lengkap dalam beberapa bagian

Pengguna akhir tidak dapat memberikan nama lengkap pada percobaan pertama. Kemudian, pengguna akhir memberikan nama depan, nama belakang, dan nama tengahnya dalam giliran terpisah; agen berhasil menerimanya.

Input pengguna Respons agen
Siapa nama lengkap Anda? Beri tahu nama depan, nama belakang, dan nama tengah Anda, jika ada.
bagus
Maaf, saya tidak mengerti. Mari kita mulai menangkap nama lagi.
Sebelum menangkap nama Anda, dapatkah Anda membantu saya mengonfirmasi apakah Anda memiliki tanda hubung, spasi tambahan, atau tanda petik dalam nama Anda?
Tidak
Mari kita mulai dengan menangkap nama depan Anda.
Siapa nama depan Anda?
Lawrence
Lawrence. Apakah saya mengeja nama depan Anda dengan benar?
ya
Siapa nama belakang Anda?
Page
Page. Apakah saya mengeja nama belakang Anda dengan benar?
ya
Apakah Anda memiliki nama tengah?
ya
Siapa nama tengah Anda?
Edward
Edward. Apakah saya mengeja nama tengah Anda dengan benar?
ya
Terima kasih, Lawrence.

Karakter khusus

Pengguna akhir tidak dapat memberikan nama lengkap pada percobaan pertama. Kemudian, pengguna akhir memberikan nama depan, nama belakang, dan nama tengahnya dalam giliran terpisah dengan karakter khusus; agen berhasil menerimanya.

Input pengguna Respons agen
Siapa nama lengkap Anda? Beri tahu nama depan, nama belakang, dan nama tengah Anda, jika ada.
bagus
Maaf, saya tidak mengerti. Mari kita mulai menangkap nama lagi.
Sebelum menangkap nama Anda, dapatkah Anda membantu saya mengonfirmasi apakah Anda memiliki tanda hubung, spasi tambahan, atau tanda petik dalam nama Anda?
Ya, saya punya
Oke. Apakah karakter khusus ini ada di nama depan, nama tengah, atau nama belakang Anda?
Nama depan
Beri tahu saya bagian pertama nama depan Anda sebelum karakter khusus apa pun.
Evan
Evan. Apakah saya mengeja bagian pertama dengan benar?
ya
Beri tahu saya bagian berikutnya: spasi, tanda petik, atau tanda hubung.
tanda hubung
"tanda hubung". Apakah saya menangkap pemisah nama setelah bagian pertama nama depan Anda dengan benar?
ya
Eja bagian berikutnya dari nama depan Anda, setelah tanda hubung. Ucapkan hurufnya saja, misalnya J-O-H-N.
James
James. Beri tahu saya jika ada yang salah, jika sudah selesai, atau, apa bagian berikutnya: spasi, tanda petik, atau tanda hubung.
Saya selesai
Siapa nama belakang Anda?
Mady
Mady. Apakah saya mengeja nama belakang Anda dengan benar?
ya
Apakah Anda memiliki nama tengah?
tidak
Terima kasih, Evan-James.

Tidak ada input

Komponen keluar dari alur setelah pengguna akhir tidak memberikan input sebanyak tiga kali.

Input pengguna Respons agen
Siapa nama lengkap Anda? Beri tahu nama depan, nama belakang, dan nama tengah Anda, jika ada.
[Tidak ada input]
Maaf, saya tidak dapat mendengar Anda. Siapa nama lengkap Anda?
[Tidak ada input]
Hmm, saya masih tidak dapat mendengar Anda. Coba bicara lebih keras atau pindah ke area yang lebih tenang.
[Tidak ada input]
Maaf, saya kesulitan memahami respons Anda.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur Format Contoh
Alur [Nama Komponen] Pengumpulan Nama
Intent Khusus Komponen prebuilt_components_[component_name]_[intent_name] prebuilt_components_name_collection_special_characters_decider
Jenis Entitas prebuilt_components_[component_name]_[entity_type_name] prebuilt_components_name_collection_first_name
Parameter [param_name] user_provided_first_name

Parameter output

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
name_collection_first_name Parameter ini menampilkan nama depan yang diberikan pengguna dan ditangkap oleh komponen string
name_collection_last_name Parameter ini menampilkan nama belakang yang diberikan pengguna dan ditangkap oleh komponen string
name_collection_middle_name Parameter ini menampilkan nama tengah yang diberikan pengguna dan ditangkap oleh komponen. Jika tidak ada nama tengah yang dikumpulkan, parameter akan berupa string kosong string

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

  1. Impor komponen bawaan.

Selesai

Agen Anda kini harus disiapkan dan siap untuk diuji.