סוכן מוכן מראש של עוזר אישי לשופינג

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

דוגמה לדו-שיח

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

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

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

הטקסט של המשתמש	התשובה של הסוכן
תראה לי סארי מסורתי
	[מציג מוצרים] אחד מהמוצרים האלה מעניין אותך, או שחיפשת אפשרויות אחרות?
הראשון נראה טוב
	בחירה מצוינת! הסארי ההודי היפהפה הזה, עם עיצוב עצמי והדפס אופנתי מבד ג'ורג'ט, הוא פריט מדהים. לסארי יש בדרך כלל מידה אחת, אז הוא יתאים לך בול. רוצה להוסיף אותו לעגלת הקניות?
יש לך נעלי עקב שמתאימות לה?
	[מציג מוצרים] אחד מהמוצרים האלה מעניין אותך, או שחיפשת אפשרויות אחרות?
כן, אבל אתה יכול לעבור על ביקורות הלקוחות ולבחור את הטובה ביותר מביניהן?
	הדירוג הממוצע של נעלי העקב לנשים של 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 במידה 6. רוצה להוסיף עוד משהו לעגלת הקניות?

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

1. המשתמש מעיין בקטלוג המוצרים.
2. הסוכן מציג המלצות על סמך הבקשה של המשתמש.
3. אחרי כמה חיפושים, המשתמש מוצא פריט לרכישה.
4. הסוכן מאשר את המידה והכמות של הפריט לרכישה, ואת תאריך המסירה המשוער.
5. המשתמש מבקש תאריך משלוח אחר שלא זמין, ומסכים לתאריך המשלוח המקורי.
6. הנציג מאשר את פרטי המשלוח, התשלום ויצירת הקשר שרשומים במערכת.
7. המשתמש מעדכן את פרטי המשלוח ומאשר.
8. הנציג מבצע את ההזמנה ומוסר למשתמש את מספר ההזמנה.

הטקסט של המשתמש	התשובה של הסוכן
מתחיל להיות קר. יש לך סוודרים טובים?
	[מציג מוצרים]. אחד מהמוצרים האלה מעניין אותך, או שחיפשת אפשרויות אחרות?
הסוודר לנשים מתאים לאשתי, אבל אני מחפש סוודר לבנים
	[מציג מוצרים]. אחד מהמוצרים האלה מעניין אותך, או שחיפשת אפשרויות אחרות?
תוסיף את הסוודר הראשון לנשים לעגלת הקניות
	איזו מידה את רוצה לסוודר Nineteen Solid Round Neck Casual Women's Sweater? יש לנו מידות מ-XS עד XL.
בינוני
	מעולה! סוודר קז'ואל לנשים של Nineteen, בצבע אחיד, עם צווארון עגול, במידה מדיום, נוסף לעגלת הקניות בכמות של פריט אחד. רוצה להוסיף עוד משהו לעגלת הקניות?
לא
	התאריך הכי מוקדם שבו נוכל לספק לך את הסוודר לנשים Nineteen Solid Round Neck Casual הוא 29 באפריל 2024. מתאים לך?
אפשר לקבל את המשלוח ב-28 באפריל?
	מצטערים, אבל לא נוכל לספק את הסוודר היומיומי לנשים עם צווארון עגול של Nineteen ב-28 באפריל 2024. התאריך הכי מוקדם שבו נוכל לספק את ההזמנה הוא 29 באפריל 2024.
בסדר, לא צריך לשנות את תאריך המסירה
	בסדר, סוודר Nineteen Solid Round Neck Casual לנשים יימסר ב-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 בוצעה בהצלחה. מזהה ההזמנה הוא ee6b4cc7. הוא אמור להגיע ב-29 באפריל 2024.
תודה
	ההזמנה בוצעה בהצלחה. רוצה עזרה בעניין אחר?
לא, תודה
	שמחתי לעזור. אם אי פעם תצטרך משהו מ-Cymbal Apparel, אני במרחק קליק אחד.\

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

1. המשתמש מבקש לבדוק את הסטטוס של הזמנה.
2. הנציג אוסף את מספר ההזמנה ומאחזר את פרטי ההזמנה.
3. הנציג מספק פרטים על הפריטים בהזמנה ועל תאריך המסירה הצפוי.

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

החזרת הזמנה

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

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

הגדרה בסיסית

כדי להגדיר את הנציג:

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

הגדרת הכלי

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

1. יוצרים מסד נתונים ב-Firestore בשם apparel-db.
2. יוצרים Integration Connector של Firestore.
3. מורידים את Application Integration של Shopping Assistant.
4. מחליפים את כל ההפניות ל-projects/customermod-genai-sa/locations/us-central1/connections/firestore במזהה של המחבר שנוצר בשלב 2.
5. מעלים את השילוב ומפרסמים אותו.
6. מקצים את התפקיד Cloud Functions Invoker לסוכן השירות של Dialogflow.
7. פועלים לפי השלבים להגדרת קטלוג Retail.
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. מקצים לפונקציית Cloud Run שפרסתם את התפקיד Retail Viewer ב-IAM.
13. בכלים הבאים: get-order-status,‏ order-lookup,‏ place-order ו-return-order, מעדכנים את המאפיין paths כך שיפנה לשילוב שיצרתם בשלב 5 במפרטי OpenAPI, ובוחרים באפשרות Service Account authentication עם חשבון שירות שהקציתם לו את התפקיד Application Integration Invoker.
14. מעדכנים את מאפיין כתובת ה-URL של השרת לפונקציית Cloud Run שפרסתם לכלים הנותרים.

הכלי "חיפוש מוצרים"

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

הכלי "קבלת פרטי מוצר"

הכלי get-product-details מאחזר את פרטי המוצר מקטלוג המוצרים באמצעות AI Commerce Search 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 מאחזר את הסטטוס של הזמנה, ואם ההזמנה נשלחת, עוקב אחריה באמצעות ה-API של DHL. הוא מספק הודעות מתאימות על סמך סטטוס ההזמנה.

הושלמה

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