Komponen bawaan pengumpulan alamat mengumpulkan alamat dari pelanggan dan memvalidasi alamat menggunakan Google Address Validation API.
Batasan
Selain batasan komponen bawaan umum, komponen bawaan ini mencakup batasan berikut:
- Hanya mendukung alamat dari negara yang tercantum dalam detail cakupan Address Validation API.
Fitur tambahan
Fitur tambahan berikut disediakan oleh komponen bawaan ini:
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.
Validasi alamat lengkap
Pengguna memberikan alamat lengkap, dan komponen pengumpulan alamat memverifikasinya.
| Input Pengguna | Respons Agen |
|---|---|
| Beri tahu saya alamat lengkap Anda untuk memulai. | |
| 1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA | |
| Saya telah mengumpulkan alamat akhir; nomor jalan adalah 1600, rutenya adalah Amphitheatre Parkway, kotanya adalah Mountain View, wilayah administratifnya adalah CA, kode posnya adalah 94043, negaranya adalah USA. Apakah itu benar? Ucapkan ya atau tidak. | |
| ya | |
| Bagus, saya sudah mengumpulkan alamatnya. |
Alamat valid sebagian dengan elemen yang disimpulkan
- Pengguna memberikan alamat yang tidak lengkap.
- Agen menebak bagian yang hilang dan memverifikasinya setelah konfirmasi dari pengguna.
| Input Pengguna | Respons Agen |
|---|---|
| Beri tahu saya alamat lengkap Anda untuk memulai. | |
| 1600 Amphitheatre Parkway | |
| Saya telah menebak beberapa bagian alamat, kotanya adalah Mountain View, kode posnya adalah 94043, wilayah administratifnya adalah CA, negaranya adalah USA. Saya telah mengumpulkan alamat akhir; nomor jalannya adalah 1600, rutenya adalah Amphitheatre Parkway, kotanya adalah Mountain View, wilayah administratifnya adalah CA, kode posnya adalah 94043, negaranya adalah USA. Apakah itu benar? Ucapkan ya atau tidak. |
|
| Ya | |
| Bagus, saya sudah mengumpulkan alamatnya. |
Alamat valid sebagian dengan elemen yang diberikan pengguna
- Pengguna memberikan alamat yang tidak lengkap.
- Pengguna menolak bagian yang ditebak dan memberikan inputnya sendiri.
- Agen menerima input yang diberikan pengguna dan meminta konfirmasi ulang.
- Pengguna menerima alamat akhir.
| Input Pengguna | Respons Agen |
|---|---|
| Beri tahu saya alamat lengkap Anda untuk memulai. | |
| 1600 Amphitheatre Parkway | |
| Saya telah menebak beberapa bagian alamat, kotanya adalah Mountain View, kode posnya adalah 94043, wilayah administratifnya adalah CA, negaranya adalah USA. Saya telah mengumpulkan alamat akhir; nomor jalannya adalah 1600, rutenya adalah Amphitheatre Parkway, kotanya adalah Mountain View, wilayah administratifnya adalah CA, kode posnya adalah 94043, negaranya adalah USA. Apakah itu benar? Ucapkan ya atau tidak. |
|
| Tidak | |
| Oke. Beri tahu saya bagian alamat mana yang perlu diubah. | |
| Kode Pos | |
| Bisakah Anda menyebutkan kode posnya? | |
| 94044 | |
| Saya sudah selesai melakukan pembaruan ini. Apakah ada hal lain yang perlu diubah? Ucapkan ya atau tidak. | |
| tidak | |
| Setelah validasi, saya telah mengganti kode pos menjadi 94043. Saya telah mengumpulkan alamat akhir; nomor jalan adalah 1600, rutenya adalah Amphitheatre Parkway, kotanya adalah Mountain View, wilayah administratifnya adalah CA, kode posnya adalah 94043, negaranya adalah USA. Apakah itu benar? Ucapkan ya atau tidak. |
|
| ya | |
| Bagus, saya sudah mengumpulkan alamatnya. |
Input tidak dikenali
Komponen keluar dari alur setelah pengguna memberikan input yang tidak dikenali sebanyak tiga kali.
| Input Pengguna | Respons Agen |
|---|---|
| Beri tahu alamat lengkap Anda untuk memulai. | |
| Tidak apa-apa | |
| Maaf, saya tidak mengerti. Beri tahu alamat lengkap Anda untuk memulai. | |
| bagus | |
| Hmm, saya masih belum bisa memahaminya. Beri tahu alamat lengkap Anda untuk memulai. | |
| hebat | |
| Maaf, saya kesulitan memahami respons Anda. |
Alamat tidak didukung
Komponen keluar dari alur setelah pengguna memberikan alamat yang tidak didukung oleh Address Validation API.
| Input Pengguna | Respons Agen |
|---|---|
| Beri tahu saya alamat lengkap Anda untuk memulai. | |
| India | |
| Maaf, kami tidak dapat memvalidasi alamat di wilayah tersebut. |
Validasi alamat
Untuk mengetahui informasi selengkapnya tentang cara komponen pengumpulan alamat memvalidasi alamat, lihat Ringkasan Address Validation API.
Komponen pengumpulan alamat menangkap input pengguna menggunakan entity sistem @sys.address dan mengirimkan alamat yang diambil ke Address Validation API untuk mengekstrak elemen alamat untuk pemrosesan lebih lanjut.
Address Validation API menampilkan elemen alamat berikut, yang dapat Anda gunakan untuk mengumpulkan dan memvalidasi alamat lengkap:
administrative_area_level_1archipelagocountrylocalitypostal_coderoutestreet_number
Anda dapat mencoba Demo Validasi Alamat Google dengan alamat apa pun dari wilayah yang didukung.
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Component Name] | Pengumpulan Alamat |
| Intent Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_address_collection_locality |
| Parameter | [param_name] | user_provided_address |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_address_collection:address_validation |
Parameter input
Parameter input mengonfigurasi perilaku tertentu dari komponen. Satu atau beberapa kondisi dalam alur menggunakan parameter ini untuk menentukan perilaku komponen. Anda harus menetapkan parameter cakupan alur di halaman awal komponen. Anda dapat menetapkan parameter cakupan sesi menggunakan alur panggilan atau di halaman awal komponen ini.
Pengguna dapat mengonfigurasi elemen alamat yang diperlukan oleh komponen ini dengan mengubah preset parameter di halaman awal alur.
Komponen bawaan ini menerima parameter input berikut:
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $flow.zip_code | Jika elemen alamat kode pos diperlukan, tetapkan ke true; jika tidak, tetapkan ke false. |
boolean |
| $flow.city | Jika elemen alamat kota diperlukan, tetapkan ke true; jika tidak, tetapkan ke false. |
boolean |
| $flow.admin_area | Jika elemen alamat wilayah administratif diperlukan, tetapkan ke true; jika tidak, tetapkan ke false. |
boolean |
| $flow.street_number | Jika elemen alamat nomor jalan diperlukan, tetapkan ke true; jika tidak, tetapkan ke false. |
boolean |
| $flow.route | Jika elemen alamat rute diperlukan, tetapkan ke true; jika tidak, tetapkan ke false. |
boolean |
| $flow.country | Jika elemen alamat negara diperlukan, tetapkan ke true; jika tidak, tetapkan ke false. |
boolean |
| $flow.island | Jika elemen alamat pulau diperlukan, tetapkan ke true; jika tidak, tetapkan ke false. |
boolean |
| $flow.retry_num | Menetapkan batas percobaan ulang maksimum untuk panggilan webhook Maps Address Validation API. | integer |
Untuk mengonfigurasi parameter input untuk komponen ini, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Flows.
- Klik Start Page di bagian Pages.
- Klik Route true di Start Page.
- Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
- Klik Simpan.
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 menyediakan parameter output berikut:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| address_collection_address | Parameter ini menampilkan objek alamat jika alamat diambil oleh komponen | { |
| address_collection_status | Parameter ini menampilkan status alamat yang dikumpulkan. Nilai yang ditampilkan adalah salah satu dari berikut ini:VALID_ADDRESS: alamat dikumpulkan dan divalidasi oleh Address Validation API.INVALID_ADDRESS: alamat dikonfirmasi oleh pengguna, tetapi satu atau beberapa elemen tidak divalidasi atau ditandai sebagai UNCONFIRMED_BUT_PLAUSIBLE oleh Address Validation API.MAPS_API_ERROR: alamat tidak dikumpulkan karena error Address Validation API.COUNTRY_NOT_SUPPORTED: alamat tidak dikumpulkan karena Address Validation API tidak mendukung wilayah tersebut.NO_USER_CONFIRMATION: alamat tidak dikonfirmasi karena pengguna tidak mengonfirmasi alamat. |
string |
Penyiapan dasar
Untuk menyiapkan komponen bawaan ini:
- Impor komponen bawaan.
- Aktifkan Address Validation API.
- Konfigurasikan webhook fleksibel yang disediakan dengan kunci Maps API Anda. Untuk mengetahui informasi selengkapnya, lihat bagian Penyiapan webhook.
Penyiapan webhook
Untuk memvalidasi alamat dengan Address Validation API, konfigurasikan webhook fleksibel yang disediakan dengan kredensial yang benar.
Webhook Address Validation
Webhook ini melakukan tindakan berikut:
- Memproses parameter Dialogflow CX yang diambil, membentuk permintaan, dan memverifikasi alamat menggunakan Address Validation API.
- Mengekstrak elemen alamat yang dikonfirmasi, belum dikonfirmasi, tidak ada, dan disimpulkan dari respons Address Validation API.
Perbarui setelan webhook dengan kunci Maps API yang benar untuk mengonfigurasi webhook untuk komponen ini.
Untuk mengambil kunci API, buka Google Cloud Console > APIs & Services > Credentials, pilih kunci Maps API, lalu salin kolom kunci API.
Untuk mengonfigurasi webhook:
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhooks.
- Pilih webhook
prebuilt_components_address_collection:address_validation. - Ganti URL di kolom URL webhook Dialogflow CX dengan URL yang menyertakan kunci Maps API Anda:
https://addressvalidation.googleapis.com/v1:validateAddress?key=<var>MAPS_API_KEY</var>. - Di setelan Authentication, konfigurasikan Username sebagai
key, dan tetapkan sandi untuk kunci Maps API Anda. - Klik Simpan.
Selesai
Komponen bawaan dan webhook-nya kini telah disiapkan dan siap diuji.