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

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

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

לפני שתקראו את המדריך הזה:

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

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

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

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

יצירת הסוכן

כדי ליצור את הסוכן:

1. עוברים למסוף של הצ'אט בוטים:

   מסוף של כלי ליצירת סוכנים בממשק שיחה

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. לוחצים על ספר ההדרכה שמוגדר כברירת מחדל. הכוכב ב-Playbook הזה מודגש.

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 the user 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. שימו לב שההפניות למדריך מודגשות כי עדיין אין דוגמאות. הם יתווספו בקטע הבא.

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

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

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

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

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

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

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

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

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

1. סוגרים או מבטלים כל חלונית שמופיעה בצד שמאל של המסך.
2. אם צריך, מאפסים את השיחה באמצעות לחצן האיפוס restart_alt.
3. בתפריט הנפתח של הסימולטור Start Resource בוחרים את מדריך המידע.
4. מזינים את ההודעה: Where are you located?.
5. המדריך ישיב עם מיקום.
6. בוחרים את מדריך המידע בתפריט הנפתח הפעלות.
7. לוחצים על הלחצן שמירה כדוגמה.
8. מזינים את שם הדוגמה: Location.
9. לפני ששומרים את השיחה הזו כדוגמה, צריך למחוק את הפעולה שמכילה את השאלה 'איפה אתה נמצא'. רק דוגמאות של מחזורי הפעלה שמוגדרים כברירת מחדל יכולים להתחיל בפעולת משתמש.
10. כדי לספק את הדוגמה עם ההקשר שהתחיל את השיחה, מרחיבים את הקטע סיכום השיחה הקודמת... ומזינים את הטקסט הבא בשדה דוגמה שמתחילה בפרטי קלט: The customer asked "Where are you located?".
11. כדי לספק את הדוגמה עם ההקשר שמשלים את השיחה, מרחיבים את הקטע סיכום של הפעלת תוכנית הפעולה... ומזינים את הטקסט הבא בשדה סיום הדוגמה עם פרטי הפלט:The store is located at 1007 Mountain Drive, Gotham City, NJ..
12. לוחצים על סמל השמירה.

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

1. בדומה לשלבים שלמעלה, מזינים את ההודעה: What are your hours? ונותנים שם לדוגמה: Hours.

הוספת דוגמה לבחירה בפלייבוק של ההזמנה:

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

   • I want to buy a shirt
   • Large
   • Green
   • Yes

בדיקת הנציג

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

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

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