Komponen bawaan pengumpulan alamat

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:

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

  1. Pengguna memberikan alamat yang tidak lengkap.
  2. 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

  1. Pengguna memberikan alamat yang tidak lengkap.
  2. Pengguna menolak bagian yang ditebak dan memberikan inputnya sendiri.
  3. Agen menerima input yang diberikan pengguna dan meminta konfirmasi ulang.
  4. 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_1
  • archipelago
  • country
  • locality
  • postal_code
  • route
  • street_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.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Build.
  5. Klik komponen yang diimpor di bagian Flows.
  6. Klik Start Page di bagian Pages.
  7. Klik Route true di Start Page.
  8. Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
  9. 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
{
"admin-area": string,
"city": string,
"country": string,
"island": string,
"route": string,
"zip-code": string,
"street-number": string
}
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:

  1. Impor komponen bawaan.
  2. Aktifkan Address Validation API.
  3. 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:

  1. Memproses parameter Dialogflow CX yang diambil, membentuk permintaan, dan memverifikasi alamat menggunakan Address Validation API.
  2. 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:

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhooks.
  6. Pilih webhook prebuilt_components_address_collection:address_validation.
  7. 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>.
  8. Di setelan Authentication, konfigurasikan Username sebagai key, dan tetapkan sandi untuk kunci Maps API Anda.
  9. Klik Simpan.

Selesai

Komponen bawaan dan webhook-nya kini telah disiapkan dan siap diuji.