יצירת סוכן באמצעות מדריכים

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

לפני שמתחילים

אם עדיין לא עשיתם את זה, אתם צריכים לפעול לפי ההוראות להגדרה.

מידע על מדריכים

סוכן מורכב מחוברת הפעלה אחת או יותר. לכל מדריך יש היקף מוגדר ומוגבל. בטבלה הבאה מתוארים הנתונים ב-Playbook:

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

יצירת סוכן

כדי ליצור סוכן:

1. עוברים אל https://conversational-agents.cloud.google.com.
2. אם עדיין לא עשיתם זאת, בוחרים פרויקט קיים או יוצרים פרויקט חדש.
3. לוחצים על יצירת סוכן.
4. לוחצים על Build your own (יצירת תוכנית משלכם).
5. מזינים את שם הסוכן Shirt Ordering - Playbooks (הזמנת חולצות – תוכניות פעולה).
6. מזינים מיקום.
7. מזינים אזור זמן.
8. מזינים שפת ברירת מחדל.
9. בוחרים באפשרות Playbook (פלייבוק) בשדה Conversation start (התחלת שיחה).
10. לוחצים על יצירה.
11. ממשק המשתמש מעביר אתכם ל-Playbook שמוגדר כברירת מחדל ושמו Default Generative Playbook.
12. לוחצים על חזרה כדי לחזור לרשימת מדריכי ההפעלה.

יצירת מדריך הפעלה להזמנה

ההזמנות של חולצות מנוהלות באמצעות ספר ההפעלה Order.

כדי ליצור את תוכנית הפעולה:

1. לוחצים על יצירה.
2. בוחרים באפשרות מדריך למשימות.
3. מזינים את שם המדריך: Order.

4. מזינים את היעד הבא:

   You are a shirt store ordering assistant. Help customers purchase shirts.
   Help the customer choose a size and color.
   The shirts come in small, medium, and large.
   The shirts can be red, green, or blue.
   

5. מזינים את ההוראות הבאות:

   - If the customer has not provided a size, ask them to choose a size.
   - If the customer has not provided a color, ask them to choose a color.
   - Once the customer has selected a size and color for the shirt,
     repeat the selection to the customer, and ask them to confirm the selection.
   - Once the customer has confirmed their selection,
     let them know that the shirt is now ordered.
   - Do not provide prices or collect payment.
   - Do not collect the customer's name or address.
   

6. לוחצים על Save.

7. לוחצים על חזרה כדי לחזור לרשימת מדריכי ההפעלה.

יצירת מדריך מידע

במדריך מידע יש תשובות לשאלות על החנות.

כדי ליצור את תוכנית הפעולה:

1. לוחצים על יצירה.
2. בוחרים באפשרות מדריך למשימות.
3. מזינים את שם המדריך: Information.

4. מזינים את היעד הבא:

   You provide information about a shirt store.
   The store is open between 8 AM and 6 PM every day.
   The store is located at 1007 Mountain Drive, Gotham City, NJ.
   

5. מזינים את ההוראות הבאות:

   - If the customer asks for the store location, provide them with the address.
   - If the customer asks for the store hours, provide them with the hours.
   

6. לוחצים על Save.

7. לוחצים על חזרה כדי לחזור לרשימת מדריכי ההפעלה.

עדכון חוברת ההדרכה שמוגדרת כברירת מחדל

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

כדי לעדכן את חוברת ההדרכה:

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

2. מזינים את היעד הבא:

   You are an assistant for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other playbooks based on the customer's questions.
   

3. מזינים את ההוראות הבאות:

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask how you can help.
   - If the customer wants information about the store,
     route them to ${PLAYBOOK: Information}
   - If the customer wants to purchase a shirt,
     route them to ${PLAYBOOK: Order}
   

4. לוחצים על Save.

5. שימו לב שההפניות ל-Playbook מודגשות כי עדיין אין דוגמאות. תוסיפו אותן בקטע הבא.

6. לוחצים על חזרה כדי לחזור לרשימת מדריכי ההפעלה.

הוספת דוגמאות

המדריך הזה פועל, אבל דוגמאות מבטיחות תשובות איכותיות.

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

שיחה ב-Playbook כברירת מחדל היא קצרה. המדריך הזה צריך להפנות את השיחה למדריך אחר.

כדי לנהל שיחה עם תוכנית הפעולה שמוגדרת כברירת מחדל:

1. סוגרים או מבטלים את כל החלוניות שמופיעות בצד שמאל של המסך.
2. מקישים על לחצן הסימולטור בשורת הניווט העליונה.
3. בקטע 'משאב', בוחרים את פלייבוק ברירת המחדל.
4. אפשר להשתמש במודל ברירת המחדל או לבחור מודל חלופי.
5. בשדה Enter user input (הזנת קלט של משתמשים), מזינים Hello ומקישים על Enter.
6. המדריך יגיב עם ברכה.

כדי לשמור את השיחה הזו כדוגמה:

1. בוחרים את ספר ההפעלה שמוגדר כברירת מחדל ברשימה Invocations.
2. לוחצים על שמירה כדוגמה.
3. בחלונית העריכה של הדוגמה, מוסיפים, עורכים, מוחקים או מסדרים מחדש פעולות.
4. מזינים את השם Greeting לדוגמה.
5. מעדכנים את התשובות ב-playbook לפי הצורך.
6. בקטע End example with output information, מזינים את הערך The user is greeted. בשדה Summary.
7. לוחצים על Save.

הוספת דוגמה למיקום למדריך המידע:

1. סוגרים או מבטלים את החלונית בצד שמאל של המסך.
2. במקרה הצורך, מאפסים את השיחה באמצעות הלחצן איפוס restart_alt.
3. בתפריט Start Resource (הפעלת משאב) בסימולטור, בוחרים את מדריך המידע.
4. מקלידים Where are you located? ומקישים על Enter.
5. בתפריט Invocations (הפעלות), בוחרים את מדריך המידע.
6. לוחצים על שמירה כדוגמה.
7. מזינים את השם Location לדוגמה.
8. צריך למחוק את הפעולה שמכילה את Where are you located? כי רק דוגמאות של תרחישי שימוש שמוגדרים כברירת מחדל יכולות להתחיל בפעולת משתמש.
9. מרחיבים את הקטע סיכום השיחה הקודמת ומזינים את הערך The customer asked "Where are you located?" בשדה דוגמה להתחלה עם מידע קלט.
10. מרחיבים את הקטע Summary of the playbook execution (סיכום של הפעלת חוברת ההדרכה) ומזינים את הערך The store is located at 1007 Mountain Drive, Gotham City, NJ. בשדה End example with output information (סיום הדוגמה עם פרטי הפלט).
11. לוחצים על Save.

הוספת דוגמה של שעות למדריך המידע:

1. בוחרים את מדריך המידע בסימולטור.
2. מזינים את ההודעה What are your hours?.
3. שומרים את השיחה כדוגמה בשם Hours.

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

1. נותנים לדוגמה את השם Selection.
2. בוחרים את מדריך ההזמנה.
3. שולחים את ההודעות הבאות:
   • I want to buy a shirt
   • Large
   • Green
   • Yes

בדיקת הסוכן

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

אינטראקציה עם הסוכן באמצעות ה-API

מידע נוסף על אינטראקציה עם ה-API זמין במאמר אינטראקציות עם ה-API.