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

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

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

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

מידע על פלייבוקים

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

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

יצירת סוכן

כדי ליצור נציג:

  1. נכנסים לכתובת https://conversational-agents.cloud.google.com.
  2. אם עדיין לא עשיתם את זה, בוחרים פרויקט או יוצרים פרויקט חדש.
  3. לוחצים על Create agent.
  4. לוחצים על יצירת קהל משלך.
  5. בשם הנציג, מזינים "Shirt Ordering - Playbooks".
  6. מזינים מיקום.
  7. מזינים אזור זמן.
  8. מזינים שפת ברירת מחדל.
  9. באפשרות תחילת השיחה, בוחרים באפשרות פלייבוק.
  10. לוחצים על יצירה.
  11. ממשק המשתמש יעביר אתכם לפלייבוק שמוגדר כברירת מחדל, שנקרא 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. בוחרים באפשרות Task playbook.
  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. לוחצים על חזרה כדי לחזור לרשימת הפלייבוקים.

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

הפלייבוק פועל, אבל כדאי לספק דוגמאות כדי להבטיח תשובות איכותיות.

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

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

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

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

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

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

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

  1. סגירה או ביטול של כל חלונית בצד שמאל של המסך.
  2. אם צריך, מאפסים את השיחה באמצעות הלחצן איפוס restart_alt.
  3. בוחרים את הפלייבוק של המידע בתפריט הפעלת משאב בסימולטור.
  4. מקלידים Where are you located? ולוחצים על Enter.
  5. בתפריט הפעלות, בוחרים את הפלייבוק של המידע.
  6. לוחצים על שמירה כדוגמה.
  7. מזינים את השם Location בתור שם הדוגמה.
  8. צריך למחוק את הפעולה שמכילה את Where are you located? כי רק דוגמאות לפלייבוק שמוגדרות כברירת מחדל יכולות להתחיל בפעולת משתמש.
  9. מרחיבים את הקטע Summary of the preceding conversation ומזינים את הערך The customer asked "Where are you located?" בשדה Starts example with input information.
  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.