סוכן מוכן מראש של עוזר שופינג עם חיפוש מבוסס-Vertex AI לריטייל

הסוכן המובנה מראש שמבוסס על תרחישי שימוש של העוזר הדיגיטלי לקניות מספק תשובות לשאילתות לגבי מוצרים קמעונאיים, הזמנות, סטטוס הזמנות וביטול הזמנות. הוא משתמש ב-חיפוש מבוסס-Vertex AI לריטייל ובמטענים ייעודיים (payloads) של נתוני מימוש הזמנות מותאמים אישית, ומספק חוויה חזותית עשירה.

דוגמאות לתיבות דו-שיח

בתיבות הדו-שיח לדוגמה הבאות מוצגים תרחישים נפוצים שטופלו על ידי הסוכן המובנה הזה.

השוואה בין מוצרים וביקורות

המשתמש מבקש לעיין בסארי מסורתי. הסוכן מציג כמה אפשרויות פופולריות והמשתמש בוחר באפשרות הראשונה. המשתמש מבקש למצוא נעליים תואמות. הסוכן מציג אפשרויות פופולריות והמשתמש מבקש להשוות בין הביקורות ובוחר באפשרות עם הדירוג הכי גבוה. הסוכן שואל על המידה ומאשר שהנעליים נוספו לעגלת הקניות.

קלט של משתמשים	התשובה של הסוכן
תראה לי סארי מסורתי
	[מציג מוצרים] האם אחד מהמוצרים האלה מעניין אותך, או שאתה מחפש אפשרויות אחרות?
הראשון נראה טוב
	בחירה מצוינת! שמלת הסארי ההודית Self Design, Printed Fashion Georgette היא פריט יפהפה. מכיוון שסארי מגיע בדרך כלל במידה אחת, הוא יתאים בצורה מושלמת. רוצה להוסיף אותו לעגלת הקניות?
יש לך עקבים תואמים?
	[מציג מוצרים] האם אחד מהמוצרים האלה מעניין אותך, או שאתה מחפש אפשרויות אחרות?
כן, אבל אפשר לעבור על הביקורות של הלקוחות ולבחור את הטובה ביותר מביניהן?
	נעלי העקב לנשים Flat n Heels קיבלו דירוג ממוצע של 4 מתוך 5 כוכבים, ואילו נעלי העקב לנשים Glitzy Galz קיבלו דירוג ממוצע של 4.5 מתוך 5 כוכבים. הלקוחות שרכשו את נעלי העקב לנשים של Flat n Heels כתבו ביקורות מעורבות. חלקם ציינו שהן נוחות בהתחלה אבל אחרי כמה שעות הן כבר לא נוחות, ואחרים שיבחו את הנוחות שלהן. לעומת זאת, נעלי העקב לנשים Glitzy Galz קיבלו בעיקר ביקורות חיוביות, והלקוחות שיבחו את ההתאמה, האיכות והעיצוב שלהן. איזה פריט תרצו להוסיף לעגלת הקניות?
המלון עם הביקורות והדירוגים הכי טובים
	נעלי העקב לנשים Glitzy Galz קיבלו את הדירוג הכי גבוה – 4.5 מתוך 5 כוכבים. מה המידה שתרצי להזמין של נעלי העקב לנשים של Glitzy Galz? המידות שלנו הן מ-5 עד 11.
6
	מעולה! הפריט Glitzy Galz Women Heels במידה 6 נוסף לעגלת הקניות בכמות 1. יש עוד משהו שתרצה להוסיף לעגלת הקניות?

חוויית קניות מקצה לקצה

המשתמש מעיין בקטלוג המוצרים. הסוכן מציג המלצות על סמך הבקשה של המשתמש. אחרי כמה חיפושים, המשתמש מוצא פריט לקנייה. הסוכן מאשר את הגודל והכמות של הפריט לרכישה, וגם את מועד המסירה הצפוי. המשתמש מבקש מועד מסירה אחר, שלא זמין, ומסכים למועד המסירה המקורי. הנציג מאשר את פרטי המשלוח, התשלום ופרטי הקשר שרשומים בחשבון. המשתמש מעדכן את פרטי המשלוח ומאשר. הסוכן מבצע את ההזמנה ומספק למשתמש את מספר ההזמנה.

קלט של משתמשים	התשובה של הסוכן
מתחיל להיות קר. Do you have good sweaters
	‫[Presents products] (מציג מוצרים). יש מוצרים שמעניינים אותך מתוך הרשימה הזו, או שאתה מחפש אפשרויות אחרות?
אהבתי את הסוודר לנשים לאשתי, אבל אני מחפש סוודר לבנים
	‫[Presents products] (מציג מוצרים). יש מוצרים שמעניינים אותך מתוך הרשימה הזו, או שאתה מחפש אפשרויות אחרות?
מוסיף את הסוודר הראשון לנשים לעגלת הקניות
	מה המידה שאת רוצה בסוודר היומיומי לנשים Nineteen Solid Round Neck? המידות שלנו נעות בין קטן במיוחד לגדול במיוחד.
בינוני
	מעולה! הסוודר היומיומי לנשים Nineteen Solid עם צווארון עגול במידה M נוסף לעגלת הקניות בכמות 1. יש עוד משהו שתרצה להוסיף לעגלת הקניות?
לא
	התאריך המוקדם ביותר שבו נוכל לספק לך את סוודר הנשים Nineteen Solid Round Neck Casual הוא 29 באפריל 2024. מתאים לך?
יש אפשרות לקבל את המשלוח ב-28 באפריל?
	מצטערים, אבל אין לנו אפשרות לספק את Nineteen Solid Round Neck Casual Women's Sweater ב-28 באפריל 2024. התאריך המוקדם ביותר שבו נוכל לספק את המוצר הוא 29 באפריל 2024.
אוקיי, מועד המסירה יישאר כמו שהוא
	אוקיי, סוודר Nineteen Solid Round Neck Casual Women's יימסר ב-29 באפריל 2024. עכשיו נבדוק את פרטי הפרופיל שלך כדי לוודא שהכול מעודכן:\
כתובת למשלוח: 638 Maple Street, Apt 11, Cupertino, CA 95014\
	פרטי תשלום: כרטיס ויזה שמסתיים ב-4111 מספר טלפון ליצירת קשר: 416-555-5555 אימייל: [e-mail] כדאי לבדוק את הפרטים האלה. אם כל הפרטים נכונים, פשוט מאשרים. אם צריך לבצע שינויים, אפשר להודיע לי.
הכתובת שלי השתנתה ל-371 Talbot Street Carmichael, CA 95608
	הכתובת למשלוח עודכנה בהצלחה לכתובת 371 Talbot Street, Carmichael, CA 95608. יש עוד משהו שתרצה לשנות?
לא
	ההזמנה שלך של Nineteen Solid Round Neck Casual Women's Sweater (סוודר קז'ואל לנשים עם צווארון עגול) בוצעה בהצלחה עם מזהה ההזמנה ee6b4cc7. המשלוח מתוכנן ל-29 באפריל 2024.
תודה
	ההזמנה בוצעה בהצלחה. רוצה עזרה בעניין אחר?
לא, תודה
	שמחתי לעזור. אם תצטרך עזרה מ-Cymbal Apparel, אפשר פשוט ללחוץ על הקישור הזה.

בדיקת הסטטוס של הזמנה

המשתמש מבקש לבדוק את הסטטוס של הזמנה. הסוכן אוסף את מספר ההזמנה ומאחזר את פרטי ההזמנה. הנציג מספק פרטים על הפריטים בהזמנה, על הסטטוס הנוכחי שלה ועל מועד המסירה הצפוי.

קלט של משתמשים	התשובה של הסוכן
שלום
	אפשר לבחור מבין האפשרויות שלמעלה, או פשוט להקליד את מה שאתם מחפשים ואעזור לכם.
אני רוצה לבדוק את סטטוס ההזמנה שלי
	בטח, אוכל לעזור. כדי להתחיל, אפשר לקבל את מספר ההזמנה שלך?
ee6b4cc7
	ההזמנה שלך אושרה! ההזמנה שלך נמצאת כרגע בתהליך. הנה מה שהזמנת: סוודר נשים יומיומי עם צווארון עגול, דגם Solid Round Neck מידה: M כמות: 1 תאריך משלוח משוער: 29 באפריל 2024 יש עוד משהו שאוכל לעזור לך בו?
לא תודה
	שמחתי לעזור. אם תצטרך עזרה מ-Cymbal Apparel, אפשר פשוט ללחוץ על הקישור הזה.

החזרת הזמנה

המשתמש רוצה להחזיר הזמנה. הנציג אוסף את מספר ההזמנה, מאחזר את פרטי ההזמנה ומאשר את הפריט שיוחזר. הסוכן יתחיל את תהליך ההחזרה ויספק למשתמש תווית החזרה להדפסה ולהדבקה על החבילה.

קלט של משתמשים	התשובה של הסוכן
שלום
	אפשר לבחור מבין האפשרויות שלמעלה, או פשוט להקליד את מה שאתם מחפשים ואעזור לכם.
אני רוצה להחזיר את ההזמנה שלי
	אני כאן כדי לעזור לך בתהליך ההחזרה. כדי להתחיל, אפשר בבקשה לשתף איתי את מספר ההזמנה?
0fc77d64
	תודה שסיפקת את מספר ההזמנה. מצאתי את ההזמנה שלך מ-12 באפריל 2024. ההזמנה כוללת חולצת טישרט כחולה כהה עם צווארון עגול לילדים של YK Printed במידה Small. האם זה הפריט שברצונך להחזיר?
כן
	בסדר, התחלתי את תהליך ההחזרה. תווית המשלוח להחזרה מצורפת למטה. צריך להדפיס את התווית ולצרף אותה לחבילה לפני ששולחים אותה בחזרה. רוצה עזרה בעניין אחר?
לא תודה
	שמחתי לעזור. אם תצטרך עזרה מ-Cymbal Apparel, אפשר פשוט ללחוץ על הקישור הזה.

הגדרה בסיסית

כדי להגדיר את הסוכן המובנה הזה:

1. ייבוא הסוכן המובנה.
2. מגדירים את הכלים שסופקו עם השירותים החיצוניים שלכם. אפשר לעיין במאמר הגדרת כלים.

הגדרת כלי

הסוכן הזה כולל כלים שמשמשים לשילוב עם שירותים חיצוניים. כדי להגדיר את הכלים האלה, צריך לבצע את השלבים הבאים:

1. יוצרים מסד נתונים ב-Firestore בשם apparel-db.
2. יוצרים מחבר של שילוב Firestore.
3. מורידים את Application Integration של Shopping Assistant.
4. מחליפים את כל ההפניות אל projects/customermod-genai-sa/locations/us-central1/connections/firestore במזהה של המחבר שנוצר בשלב 2.
5. מעלים את השילוב ומפרסמים אותו.
6. מקצים את התפקידים Cloud Functions Invoker לסוכן השירות של Dialogflow.
7. פועלים לפי השלבים להגדרת קטלוג מוצרים של מוצרי קמעונאות.
8. מעדכנים את אמצעי הבקרה של המאפיינים כדי שיהיה אפשר לאחזר את השדות הבאים: ageGroups, ‏ availability,‏ categories, ‏ colorFamilies, ‏ colors, ‏ conditions, ‏ cost, ‏ currencyCode,‏ description, ‏ discount, ‏ images, ‏ materials, ‏ patterns, ‏ price, ‏ sizes, ‏ title, ‏ uri.
9. מייבאים את קטלוג הדוגמה לענף 1 בקטלוג ומגדירים אותו כענף ברירת המחדל.
10. מורידים את פונקציית Cloud Run שזמינה כאן ומעדכנים את config.toml.
11. פועלים לפי השלבים לפריסת פונקציית Cloud Run.
12. מקצים את התפקיד Retail Viewer ב-IAM לפונקציית Cloud Run שפרסתם.
13. בכלים הבאים: get-order-status,‏ order-lookup,‏ place-order ו-return-order, מעדכנים את המאפיין paths כך שיפנה לשילוב שיצרתם בשלב 5 במפרטי OpenAPI, ובוחרים באפשרות אימות חשבון שירות עם חשבון שירות שהקציתם לו את התפקיד Application Integration Invoker.
14. מעדכנים את מאפיין כתובת ה-URL של השרת לפונקציית Cloud Run שפרסתם עבור שאר הכלים.

Google Product Search

הכלי search-products מאחזר את המוצרים שהכי מתאימים לשאילתת החיפוש ולערך ההיסט מתוך קטלוג המוצרים. הכלי מחזיר תגובה של מטען ייעודי (payload) מותאם אישית שכוללת פרטי מוצר. ממשק המשתמש משתמש במטען הייעודי (payload) הזה כדי להציג את המוצרים בפורמט של תוכן עשיר.

פרטי המוצר

הכלי get-product-details מאחזר פרטי מוצרים מקטלוג המוצרים באמצעות Retail API. פרטי המוצר שאוחזרו עוברים המרה ומוחזרים בפורמט פשוט. הסוכן משתמש בפרטים האלה כדי לענות על שאלות לגבי מוצרים שהוא הציג למשתמש.

ביקורות על מוצרים

הכלי get-reviews משמש לאחזור ביקורות על מוצרים. הוא מצפה לקבל רשימה של מוצרים שמוצגים ומביא ביקורות על כל מוצר. הביקורות שנוצרות מומרות לפורמט של תבנית בהתאמה אישית (review_template) שמתאים להצגה בממשק משתמש עשיר.

מוצרים דומים

הכלי similar-products מאפשר לגלות מוצרים דומים למוצר ספציפי באמצעות Retail Recommendation API. הוא מקבל מזהה מוצר ומשתמש ב-Retail Recommendation API כדי לחזות מוצרים דומים מקטלוג המוצרים.

תאריך המסירה

הכלי store-delivery-date אחראי לאחסון תאריך המסירה המועדף על המשתמש עבור פריטים בעגלת הקניות, שצריך להיות זהה לתאריך המסירה המשוער המוקדם ביותר.

הכלי get-delivery-date אחראי להערכת מועד המסירה של פריטים בעגלת הקניות.

פרטי המשתמש

הכלי get-user-info מאחזר את הפרטים האישיים של המשתמש, כולל כתובת למשלוח, פרטי תשלום, מספר טלפון וכתובת אימייל, והכלי update-user-info אחראי לעדכון פרטי המשתמש.

ניהול הזמנות

הכלי place-order מטפל בתהליך של ביצוע הזמנה של פריטים בעגלת הקניות. ההזמנה נשמרת ב-Firestore עם נתוני ההזמנה, כולל מזהה ההזמנה, סטטוס, חותמת זמן של היצירה ורשימת המוצרים. המספר הזה מוחזר לסוכן.

הכלי order-lookup מאחזר נתוני הזמנות ממסד נתונים של Firestore על סמך מזהה ההזמנה שצוין.

הכלי return-order מעדכן את הסטטוס של ההזמנה ל-return_pending במסד הנתונים של Firestore, כדי לציין שהלקוח יזם את ההחזרה וההזמנה ממתינה להחזרה.

הכלי get-order-status אחראי לאחזור הסטטוס של ההזמנה, ואם ההזמנה נשלחה, למעקב אחריה באמצעות DHL API. הוא מספק הודעות מתאימות על סמך סטטוס ההזמנה.

הושלמה

הסוכן והשילובים שלו אמורים להיות מוגדרים ומוכנים לבדיקה.