Agen bawaan berbasis playbook asisten belanja menyediakan kueri produk retail, pemesanan, status pesanan, dan pembatalan pesanan. Agen ini menggunakan Vertex AI Search for Retail dan payload pemenuhan kustom, yang memberikan pengalaman visual yang kaya.
Contoh dialog
Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh agen bawaan ini.
Perbandingan produk dan ulasan
Pengguna meminta untuk melihat-lihat saree tradisional. Agen menampilkan beberapa opsi populer dan pengguna memilih opsi pertama. Pengguna meminta sepatu yang cocok. Agen menampilkan opsi populer dan pengguna meminta untuk membandingkan ulasan serta memilih opsi dengan rating tertinggi. Agen bertanya tentang ukuran dan mengonfirmasi bahwa sepatu telah ditambahkan ke keranjang.
| Input pengguna | Respons agen |
|---|---|
| tampilkan saree tradisional | |
| [Menampilkan produk] Apakah ada produk ini yang menarik minat Anda, atau Anda mencari opsi lain? | |
| yang pertama terlihat bagus | |
| Pilihan bagus! Saree Georgette Fashion Cetak Desain Sendiri yang indah adalah produk yang cantik. Karena saree biasanya berukuran satu ukuran, saree ini akan pas. Apakah Anda ingin menambahkannya ke keranjang? | |
| apakah Anda punya sepatu hak tinggi yang cocok? | |
| [Menampilkan produk] Apakah ada produk ini yang menarik minat Anda, atau Anda mencari opsi lain? | |
| ya, tapi bisakah Anda melihat ulasan pelanggan dan memilih yang terbaik dari produk ini | |
| Sepatu Hak Tinggi Wanita Flat n Heels memiliki rating rata-rata 4 dari 5 bintang, sedangkan Sepatu Hak Tinggi Wanita Glitzy Galz memiliki rating rata-rata 4,5 dari 5 bintang. Pelanggan yang membeli Sepatu Hak Tinggi Wanita Flat n Heels memberikan ulasan yang beragam, dengan beberapa pelanggan merasa nyaman saat pertama kali memakainya, tetapi tidak nyaman setelah beberapa jam, sementara pelanggan lain memuji kenyamanannya. Di sisi lain, Sepatu Hak Tinggi Wanita Glitzy Galz menerima ulasan yang sebagian besar positif, dengan pelanggan memuji kesesuaian, kualitas, dan desainnya. Yang mana yang ingin Anda tambahkan ke keranjang? | |
| yang memiliki ulasan dan rating terbaik | |
| Sepatu Hak Tinggi Wanita Glitzy Galz memiliki rating tertinggi, yaitu 4,5 dari 5 bintang. Ukuran berapa yang Anda inginkan untuk Sepatu Hak Tinggi Wanita Glitzy Galz? Kami memiliki ukuran mulai dari 5 hingga 11. | |
| 6 | |
| Sempurna! Sepatu Hak Tinggi Wanita Glitzy Galz ukuran 6 telah ditambahkan ke keranjang Anda dengan jumlah 1. Apakah ada hal lain yang ingin Anda tambahkan ke keranjang? |
Pengalaman belanja menyeluruh
Pengguna melihat-lihat katalog produk. Agen menampilkan rekomendasi berdasarkan permintaan pengguna. Setelah beberapa kali penelusuran, pengguna menemukan item untuk dibeli. Agen mengonfirmasi ukuran dan jumlah item yang akan dibeli, serta perkiraan tanggal pengantaran. Pengguna meminta tanggal pengantaran lain, yang tidak tersedia, dan menyetujui tanggal pengantaran 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 |
|---|---|
| Cuaca semakin dingin. Apakah Anda punya sweter yang bagus | |
| [Menampilkan produk]. Apakah ada produk ini yang menarik minat 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 ini yang menarik minat Anda, atau Anda mencari opsi lain? | |
| tambahkan sweter wanita pertama ke keranjang | |
| Ukuran berapa yang Anda inginkan untuk Sweter Kasual Wanita Nineteen Solid Round Neck? Kami memiliki ukuran mulai dari sangat kecil hingga sangat besar. | |
| sedang | |
| Sempurna! Sweter Kasual Wanita Nineteen Solid Round Neck ukuran sedang telah ditambahkan ke keranjang Anda dengan jumlah 1. Apakah ada hal lain yang ingin Anda tambahkan ke keranjang? | |
| tidak | |
| Sweter Kasual Wanita Nineteen Solid Round Neck dapat kami kirimkan paling cepat pada 29 April 2024. Apakah Anda bersedia? | |
| bisakah Anda mengirimkannya pada 28 April? | |
| Maaf, tetapi kami tidak dapat mengirimkan Sweter Kasual Wanita Nineteen Solid Round Neck pada 28 April 2024. Kami dapat mengirimkannya paling cepat pada 29 April 2024. | |
| oke, pertahankan tanggal pengantaran seperti semula | |
| Oke, Sweter Kasual Wanita Nineteen Solid Round Neck Anda akan dikirimkan pada 29 April 2024. Sekarang, mari 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 Sweter Kasual Wanita Nineteen Solid Round Neck telah berhasil dilakukan dengan ID pesanan ee6b4cc7. Pengiriman dijadwalkan pada 29 April 2024. | |
| terima kasih | |
| Pesanan Anda telah berhasil dilakukan. Apakah ada hal lain yang bisa saya bantu? | |
| tidak, terima kasih | |
| Saya senang dapat membantu Anda. Jika Anda memerlukan sesuatu dari Cymbal Apparel, saya siap membantu Anda. |
Memeriksa status pesanan
Pengguna meminta untuk memeriksa status pesanan. Agen mengumpulkan nomor pesanan dan mengambil informasi pesanan. Agen memberikan detail tentang item dalam pesanan, serta status saat ini dan perkiraan tanggal pengantaran.
| Input pengguna | Respons agen |
|---|---|
| Hai | |
| Silakan pilih dari opsi di atas, atau cukup ketikkan 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 kepada saya? | |
| ee6b4cc7 | |
| Pesanan telah dikonfirmasi. Pesanan Anda saat ini sedang diproses. Berikut pesanan Anda: Sweter Kasual Wanita Nineteen Solid Round Neck Ukuran: Sedang Jumlah: 1 Perkiraan Pengiriman: 29 April 2024 Apakah ada hal lain yang bisa saya bantu? |
|
| Tidak, terima kasih | |
| Saya senang dapat membantu Anda. Jika Anda memerlukan sesuatu dari Cymbal Apparel, saya siap membantu Anda. |
Mengembalikan pesanan
Pengguna ingin mengembalikan pesanan. Agen mengumpulkan nomor pesanan, mengambil detail pesanan, dan mengonfirmasi item yang akan dikembalikan. Agen kemudian memulai proses pengembalian dan memberikan label pengembalian barang untuk dicetak dan ditempelkan pada paket oleh pengguna.
| Input pengguna | Respons agen |
|---|---|
| Hai | |
| Silakan pilih dari opsi di atas, atau cukup ketikkan apa yang Anda cari dan saya akan membantu Anda. | |
| Saya ingin mengembalikan pesanan saya | |
| Saya siap membantu Anda dalam proses pengembalian. Untuk memulai, dapatkah Anda memberikan nomor pesanan Anda kepada saya? | |
| 0fc77d64 | |
| Terima kasih telah memberikan nomor pesanan Anda. Saya telah menemukan pesanan Anda yang dilakukan pada 12 April 2024. Pesanan tersebut berisi Kaus Lengan Pendek Anak Laki-Laki Cetak YK Berkerah Bulat Warna Biru Tua ukuran kecil. Apakah item tersebut yang ingin Anda kembalikan? | |
| ya | |
| Oke, saya telah memulai proses pengembalian. Anda akan menemukan label pengembalian yang terlampir di bawah. Cetak label tersebut dan tempelkan pada paket Anda sebelum mengirimkannya kembali. Apakah ada hal lain yang bisa saya bantu? | |
| Tidak, terima kasih | |
| Saya senang dapat membantu Anda. Jika Anda memerlukan sesuatu dari Cymbal Apparel, saya siap membantu Anda. |
Penyiapan dasar
Untuk menyiapkan agen bawaan ini:
- Impor agen bawaan.
- Konfigurasi alat yang disediakan dengan layanan eksternal Anda, 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 Integrasi Firestore.
- Unduh Application Integration untuk Asisten Belanja.
- Ganti semua referensi ke
projects/customermod-genai-sa/locations/us-central1/connections/firestoredengan ID konektor yang dibuat pada langkah 2. - Unggah dan publikasikan integrasi.
- Berikan peran
Cloud Functions Invokerke 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 cabang default.
- Download Cloud Run Function yang tersedia
di sini
dan perbarui
config.toml. - Ikuti langkah-langkah untuk men-deploy Cloud Run Function.
- Berikan peran IAM
Retail Viewerke Cloud Run Function yang Anda deploy. - Untuk alat berikut:
get-order-status,order-lookup,place-orderdanreturn-order, perbarui propertipathsuntuk mereferensikan integrasi yang Anda buat pada langkah 5 dalam spesifikasi OpenAPI dan pilih autentikasi Akun Layanan dengan akun layanan yang Anda berikan peranApplication Integration Invoker. - Perbarui properti URL server ke Cloud Run Function yang Anda deploy untuk alat yang tersisa.
Penelusuran Produk
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 yang kaya.
Detail Produk
Alat get-product-details mengambil detail produk dari katalog produk menggunakan Retail API.
Detail produk yang diambil kemudian diubah dan ditampilkan dalam format yang disederhanakan, yang digunakan oleh agen untuk menjawab pertanyaan tentang produk yang telah ditunjukkan kepada pengguna
Ulasan Produk
Alat get-reviews digunakan untuk mengambil ulasan produk.
Alat ini memerlukan daftar produk yang ditampilkan dan mengambil ulasan untuk setiap produk.
Ulasan yang dihasilkan diubah menjadi format template kustom (review_template) yang cocok untuk ditampilkan di antarmuka pengguna yang kaya.
Produk Sejenis
Alat similar-products memfasilitasi penemuan produk yang serupa dengan produk tertentu menggunakan Retail Recommendation API.
Alat ini menerima ID produk dan menggunakan Retail Recommendation API untuk memprediksi produk serupa dari katalog produk.
Tanggal Pengiriman
Alat store-delivery-date bertanggung jawab untuk menyimpan tanggal pengantaran pilihan pengguna untuk item di keranjang belanja yang harus dibandingkan dengan perkiraan tanggal pengantaran paling awal.
Alat get-delivery-date bertanggung jawab untuk memperkirakan tanggal pengantaran item di keranjang belanja.
Detail Pengguna
Alat get-user-info mengambil informasi pribadi pengguna, termasuk alamat pengiriman, informasi pembayaran, nomor telepon, dan email, sedangkan alat update-user-info bertanggung jawab untuk memperbarui informasi pengguna.
Pengelolaan Pesanan
Alat place-order menangani proses melakukan pemesanan untuk item keranjang belanja.
Alat ini menyimpan pesanan di Firestore dengan data pesanan yang mencakup ID pesanan, status, stempel waktu pembuatan, dan daftar produk.
Alat ini menampilkan nomor pesanan ke agen.
Alat order-lookup mengambil data pesanan dari database Firestore berdasarkan ID pesanan yang diberikan.
Alat return-order memperbarui status pesanan menjadi 'return_pending' di database Firestore, yang menunjukkan bahwa pengembalian telah dimulai dari pelanggan, dan pesanan sedang menunggu pengembalian.
Alat get-order-status bertanggung jawab untuk mengambil status pesanan dan, jika pesanan telah dikirim, melacaknya menggunakan DHL API.
Alat ini memberikan pesan yang sesuai berdasarkan status pesanan.
Selesai
Agen dan integrasinya kini telah disiapkan dan siap diuji.