Agen bawaan berbasis playbook Asisten Belanja menyediakan kueri produk retail, pemesanan, status pesanan, dan pembatalan pesanan. Agen ini menggunakan Agent Search for Retail dan payload fulfillment kustom untuk memberikan pengalaman visual yang kaya.
Contoh dialog
Contoh dialog ini menunjukkan skenario umum yang ditangani oleh agen bawaan ini.
Perbandingan produk dan ulasan
- Pengguna meminta untuk melihat-lihat sari tradisional.
- Agen menampilkan beberapa opsi populer dan pengguna memilih opsi pertama.
- Pengguna meminta sepatu yang cocok.
- Agen menyajikan beberapa opsi populer dan pengguna meminta untuk membandingkan ulasan dan memilih opsi dengan rating tertinggi.
- Agen menanyakan ukuran dan mengonfirmasi bahwa sepatu telah ditambahkan ke keranjang.
| Input Pengguna | Respons Agen |
|---|---|
| tampilkan sari tradisional | |
| [Menampilkan produk] Apakah ada produk yang menarik minat Anda, atau Anda mencari opsi lain? | |
| Yang pertama terlihat bagus | |
| Pilihan bagus! Sari Georgette Fashion Bermotif, Desain Sendiri dari Indian beauty adalah produk yang indah. Karena sari biasanya berukuran satu ukuran, sari akan pas dipakai. Ingin menambahkannya ke keranjang? | |
| apakah Anda memiliki sepatu hak tinggi yang cocok dengan gaun itu? | |
| [Menampilkan produk] Apakah ada produk yang menarik minat Anda, atau Anda mencari opsi lain? | |
| ya, tetapi bisakah Anda memeriksa ulasan pelanggan dan memilih yang terbaik dari ulasan tersebut | |
| Flat n Heels Women Heels memiliki rating rata-rata 4 dari 5 bintang, sedangkan Glitzy Galz Women Heels memiliki rating rata-rata 4,5 dari 5 bintang. Pelanggan yang membeli Flat n Heels Women Heels memberikan ulasan yang beragam. Beberapa merasa nyaman pada awalnya, tetapi tidak nyaman setelah beberapa jam, sementara yang lain memuji kenyamanannya. Di sisi lain, Glitzy Galz Women Heels menerima ulasan yang sebagian besar positif, dengan pelanggan memuji ukuran, kualitas, dan desainnya. Mana yang ingin Anda tambahkan ke keranjang? | |
| mana yang memiliki ulasan dan rating terbaik | |
| Glitzy Galz Women Heels memiliki rating tertinggi, yaitu 4,5 dari 5 bintang. What size would you like to go with the Glitzy Galz Women Heels? Kami memiliki ukuran mulai dari 5 hingga 11. | |
| 6 | |
| Sempurna! The Glitzy Galz Women Heels ukuran 37 telah ditambahkan ke keranjang Anda dengan jumlah 1. Apakah ada hal lain yang ingin Anda tambahkan ke keranjang? |
Pengalaman belanja menyeluruh
- Pengguna menjelajahi katalog produk.
- Agen menyajikan rekomendasi berdasarkan permintaan pengguna.
- Setelah beberapa kali melakukan penelusuran, pengguna menemukan item yang akan dibeli.
- Agen mengonfirmasi ukuran dan jumlah item yang akan dibeli, serta perkiraan tanggal pengiriman.
- Pengguna meminta tanggal pengiriman yang berbeda, yang tidak tersedia, dan menyetujui tanggal pengiriman awal.
- Agen mengonfirmasi informasi pengiriman, pembayaran, dan kontak yang tercatat.
- Pengguna memperbarui informasi pengiriman dan mengonfirmasi.
- Agen melakukan pemesanan dan memberikan nomor pesanan kepada pengguna.
| Input Pengguna | Respons Agen |
|---|---|
| Udara mulai dingin. Apakah Anda memiliki sweater yang bagus | |
| [Menampilkan produk]. Apakah ada produk yang menarik perhatian Anda, atau Anda mencari opsi lain? | |
| Saya suka sweter wanita untuk istri saya, tetapi saya mencari sweter anak laki-laki | |
| [Menampilkan produk]. Apakah ada produk yang menarik perhatian Anda, atau Anda mencari opsi lain? | |
| tambahkan sweter perempuan pertama ke keranjang | |
| Ukuran apa yang Anda inginkan untuk Nineteen Solid Round Neck Casual Women's Sweater? Kami memiliki ukuran mulai dari ekstra kecil hingga ekstra besar. | |
| sedang | |
| Sempurna! Sweater Kasual Wanita Nineteen Solid Round Neck ukuran medium telah ditambahkan ke keranjang Anda dengan jumlah 1. Apakah ada hal lain yang ingin Anda tambahkan ke keranjang? | |
| tidak | |
| Kami dapat mengirimkan Nineteen Solid Round Neck Casual Women's Sweater paling cepat pada 29 April 2024. Apakah Anda bersedia? | |
| can you deliver it on April 28? | |
| Maaf, kami tidak dapat mengirimkan Nineteen Solid Round Neck Casual Women's Sweater pada 28 April 2024. Kami dapat mengirimkannya paling cepat pada 29 April 2024. | |
| oke, pertahankan tanggal pengiriman sebagaimana adanya | |
| Oke, Nineteen Solid Round Neck Casual Women's Sweater akan dikirimkan pada 29 April 2024. Sekarang, mari kita tinjau detail profil Anda untuk memastikan semuanya sudah yang terbaru:\ | |
| Alamat Pengiriman: 638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| Info Pembayaran: Visa dengan nomor akhir 4111 Nomor Kontak: 416-555-5555 Email: email@example.com Tinjau detail ini. Jika semuanya sudah benar, cukup konfirmasi. Jika Anda perlu melakukan perubahan, beri tahu saya. |
|
| alamat saya telah berubah menjadi 371 Talbot Street Carmichael, CA 95608 | |
| Alamat pengiriman Anda telah berhasil diperbarui menjadi 371 Talbot Street, Carmichael, CA 95608. Apakah ada hal lain yang ingin Anda ubah? | |
| tidak | |
| Pesanan Anda untuk Nineteen Solid Round Neck Casual Women's Sweater telah berhasil dilakukan dengan ID pesanan ee6b4cc7. Pengiriman dijadwalkan pada 29 April 2024. | |
| terima kasih | |
| Pesanan Anda berhasil dibuat. Apakah ada hal lain yang bisa saya bantu? | |
| lain kali | |
| Saya senang dapat membantu Anda. Jika Anda memerlukan sesuatu dari Cymbal Apparel, saya siap membantu.\ |
Memeriksa status pesanan
- Pengguna meminta untuk memeriksa status pesanan.
- Agen mengumpulkan nomor pesanan dan mengambil informasi pesanan.
- Agen memberikan detail tentang item dalam pesanan dan perkiraan tanggal pengirimannya.
| Input Pengguna | Respons Agen |
|---|---|
| Hai | |
| Silakan pilih dari opsi di atas, atau cukup ketik apa yang Anda cari dan saya akan membantu Anda. | |
| Saya ingin memeriksa status pesanan saya | |
| Tentu, saya bisa membantu Anda soal itu. Untuk memulai, dapatkah Anda memberikan ID pesanan Anda? | |
| ee6b4cc7 | |
| Pesanan Anda telah dikonfirmasi. Saat ini pesanan sedang diproses. Berikut pesanan Anda: Nineteen Solid Round Neck Casual Women's Sweater Ukuran: Medium Jumlah: 1 Perkiraan Pengiriman: 29 April 2024 Ada hal lain yang bisa saya bantu? |
|
| Lain kali | |
| Saya senang dapat membantu Anda. Jika Anda memerlukan sesuatu dari Cymbal Apparel, saya siap membantu. |
Mengembalikan pesanan
- Pengguna ingin mengembalikan pesanan.
- Agen mengumpulkan nomor pesanan, mengambil detail pesanan, dan mengonfirmasi item yang akan dikembalikan.
- Agen memulai proses pengembalian barang dan memberikan label pengembalian barang untuk dicetak dan ditempelkan pengguna pada paket.
| Input Pengguna | Respons Agen |
|---|---|
| Hai | |
| Silakan pilih dari opsi di atas, atau cukup ketik apa yang Anda cari dan saya akan membantu Anda. | |
| Saya ingin mengembalikan pesanan saya | |
| Saya siap membantu Anda melakukan pengembalian. Untuk memulai, bisakah Anda memberikan nomor pesanan Anda kepada saya? | |
| 0fc77d64 | |
| Terima kasih telah memberikan nomor pesanan Anda. Saya menemukan pesanan Anda yang dibuat pada 12 April 2024. Pesanan berisi Kaos Biru Tua Kerah Bulat Anak Laki-Laki Bermotif YK dalam ukuran kecil. Apakah itu item yang ingin Anda kembalikan? | |
| ya | |
| Baik, saya telah memulai proses pengembalian. Anda akan menemukan label pengembalian barang yang dilampirkan di bawah. Cetak dan lampirkan ke paket Anda sebelum mengirimkannya kembali. Apakah ada hal lain yang bisa saya bantu? | |
| Lain kali | |
| Saya senang dapat membantu Anda. Jika Anda memerlukan sesuatu dari Cymbal Apparel, saya siap membantu. |
Penyiapan dasar
Untuk menyiapkan agen bawaan ini:
- Impor agen bawaan.
- Konfigurasikan alat yang disediakan dengan layanan eksternal Anda. Untuk mengetahui informasi selengkapnya, lihat Penyiapan alat.
Penyiapan alat
Agen ini mencakup alat yang digunakan untuk berintegrasi dengan layanan eksternal. Untuk mengonfigurasi alat ini, ikuti langkah-langkah berikut:
- Buat database Firestore bernama
apparel-db. - Buat konektor Firestore Integration.
- Download Application Integration untuk Shopping Assistant.
- Ganti semua referensi ke
projects/customermod-genai-sa/locations/us-central1/connections/firestoredengan ID konektor yang dibuat di langkah 2. - Upload dan publikasikan integrasi.
- Berikan peran
Cloud Functions Invokerkepada Agen Layanan Dialogflow Anda. - Ikuti langkah-langkah untuk menyiapkan katalog Retail Anda.
- Perbarui kontrol atribut agar kolom berikut dapat diambil: ageGroups, availability, categories, colorFamilies, colors, conditions, cost, currencyCode, description, discount, images, materials, patterns, price, sizes, title, URI.
- Impor katalog contoh ke cabang 1 katalog Anda dan jadikan sebagai cabang default.
- Download Cloud Run Function dan update
config.toml. - Ikuti langkah-langkah untuk men-deploy Fungsi Cloud Run.
- Berikan peran IAM
Retail Viewerke Cloud Run Function yang Anda deploy. - Untuk alat berikut:
get-order-status,order-lookup,place-order, danreturn-order, perbarui propertipathsuntuk merujuk ke integrasi yang Anda buat di langkah 5 dalam spesifikasi OpenAPI dan pilih Service Account authentication dengan akun layanan yang Anda beri peranApplication Integration Invoker. - Perbarui properti URL server ke Cloud Run Function yang Anda deploy untuk alat yang tersisa.
Alat Search Products
Alat search-products mengambil produk yang paling cocok berdasarkan
kueri penelusuran dan nilai offset dari katalog produk. Alat ini menampilkan
respons payload kustom yang menyertakan detail produk. Payload kustom ini
digunakan oleh UI untuk menampilkan produk dalam bentuk konten lengkap.
Alat Dapatkan Detail Produk
Alat get-product-details mengambil detail produk dari katalog produk
menggunakan AI Commerce Search API. Sistem kemudian mengubah dan menampilkan
detail produk yang diambil dalam format yang disederhanakan, yang digunakan agen untuk menjawab
pertanyaan tentang produk yang telah ditampilkan kepada pengguna.
Alat Dapatkan Ulasan
Alat get-reviews mengambil ulasan untuk produk. Fungsi ini mengharapkan daftar produk yang ditampilkan dan mengambil ulasan untuk setiap produk. Ulasan yang dihasilkan
diubah menjadi format template kustom (review_template) yang sesuai untuk
ditampilkan di antarmuka pengguna yang lengkap.
Alat Produk Serupa
Alat similar-products memfasilitasi penemuan produk yang mirip dengan produk tertentu menggunakan Retail Recommendation API. API ini menerima ID produk dan menggunakan Retail Recommendation API untuk memprediksi produk serupa dari katalog produk.
Alat Tanggal Pengiriman
Alat store-delivery-date bertanggung jawab untuk menyimpan tanggal pengiriman pilihan pengguna untuk item di keranjang belanja yang harus dibandingkan dengan perkiraan tanggal pengiriman paling awal.
Alat get-delivery-date memperkirakan tanggal pengiriman untuk item di keranjang belanja.
Alat Get User Info
Alat get-user-info mengambil informasi pribadi pengguna, termasuk
alamat pengiriman, informasi pembayaran, nomor telepon, dan email. Alat
update-user-info memperbarui informasi pengguna.
Alat Place Order
Alat place-order melakukan pemesanan untuk item keranjang belanja. Alat ini menyimpan data pesanan di Firestore, termasuk ID pesanan, status, stempel waktu pembuatan, dan daftar produk, lalu menampilkan nomor pesanan ke agen.
Alat Pencarian Pesanan
Alat order-lookup mengambil data pesanan dari database Firestore
menggunakan ID pesanan yang diberikan dan menampilkan informasi pesanan ke agen.
Alat Pesanan Pengembalian
Alat return-order memperbarui status pesanan menjadi "return_pending" di database Firestore, yang menunjukkan bahwa pengembalian telah dimulai dan sedang menunggu keputusan.
Alat Get Order Status
Alat get-order-status mengambil status pesanan dan, jika pesanan
dikirim, melacaknya menggunakan DHL API. Alat ini memberikan pesan yang sesuai berdasarkan
status pesanan.
Selesai
Agen Anda dan integrasinya kini seharusnya sudah disiapkan dan siap diuji.