פלייבוקים

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

מגבלות

ההגבלות הבאות חלות:

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

שפות

אפשר לעיין בעמודה Playbooks בהפניה לשפה. השפות שסומנו להוספה לחוברות ההדרכה נבדקו מבחינת איכות באמצעות מודלים של gemini-2.5-flash.

כשמשתמשים בשפות אחרות חוץ מאנגלית:

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

תמיכה במודלים

אפשר לבחור את מודל ה-LLM שבו משתמשים ב-Playbook במקומות הבאים:

• בוחרים את מודל ה-LLM ברמת הסוכן.

  • במסוף של סוכני שיחה, בהגדרה Agent -> Generative AI -> Playbook, בוחרים מודל לפי שם התצוגה מתוך התפריט הנפתח של כל המודלים הזמינים.
  • אם משתמשים ב-API כדי לעדכן את הגדרות הסוכן, צריך לציין את שם המודל בשדה GenerativeSettings.llm_model_settings.model (ראו GenerativeSettings).

• שינוי ברירת המחדל של בחירת המודל ברמת הבקשה.

  • בסימולטור של מסוף הסוכנים הדיגיטליים, בוחרים מודל לפי שם התצוגה מהתפריט הנפתח כשבודקים תוכנית פעולה.
  • אם אתם בודקים סוכן באמצעות API, צריך לציין את שם המודל בשדה DetectIntentRequest.query_params.llm_model_settings.model (ראו DetectIntentRequest).

תמיכה באזור

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

• global
• asia-south1
• asia-southeast1
• asia-southeast2
• asia-northeast1
• australia-southeast1
• ‫eu (multi-region)
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• northamerica-northeast1
• ‫us (multi-region)
• us-central1
• us-east1
• us-west1

נתונים מ-Playbook

הנתונים שמרכיבים את תוכנית הפעולה הם:

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

פרומפט ל-LLM

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

# INTERNAL_SYSTEM_PROMPT
<you cannot see or edit this>

# INTERNAL_SYSTEM_EXAMPLES
<you cannot see or edit this>

# AVAILABLE_TOOLS_TO_CURRENT_PLAYBOOK
<tool names and schemas, for example...>

## Tool: my_datastore
   description: blah
   input: blah
   output: blah

## Tool: some_other_custom_tool
   description: blah
   input: blah
   output: blah

# PLAYBOOK
<verbatim Goal and Instructions that you provide in the console>

# PLAYBOOK_EXAMPLES
<as many Examples for the current Playbook as can fit in the prompt>

## Example 1

## Example 2
..
..
..
## Example N (up to the input token limit)

# CURRENT_CONVERSATION
<the conversation up to this point w/ some caveats...>

* Caveat 1: If there was a transition from Playbook A -> Playbook B, the
  Conversation that happened in Playbook A is summarized and provided as context
* Caveat 2: If there was a transition from Flow A -> Playbook A, the
  Conversation that happened prior to the entry of Playbook A is summarized and
  provided to the Playbook

סוגי מדריכים

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

מדריכים למשימות

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

בדוגמה הבאה מוצג פלייבוק של משימה (הצד שקורא) שמפעיל פלייבוק אחר של משימה (הצד שנקרא):

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

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

מדריכים לתרחישים

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

התרשים הבא מציג תרחיש שבו מתבצע מעבר מתוכנית פעולה שגרתית (A) לתוכנית פעולה שגרתית אחרת (B), ואז מעבר לזרימת עבודה (C):

1. תרחיש אוטומטי A יכול לקרוא פרמטרים של סשן כשהוא מתחיל ולכתוב פרמטרים של סשן ממש לפני שהוא מסתיים.
2. מדריך ההפעלה השגרתי א' מסתיים ועובר למדריך ההפעלה השגרתי ב'.
3. תרחיש B יכול לקרוא פרמטרים של סשן כשהוא מתחיל ולכתוב פרמטרים של סשן ממש לפני שהוא מסתיים.
4. התרחיש B מסתיים ועובר לזרימה C.
5. במסלול C אפשר לקרוא ולכתוב פרמטרים של סשנים.

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

התנהגות ניהול הפרמטרים ב-Playbooks של תרחישים:

• כשמזינים תוכנית פעולה שגרתית, מוקצים לפרמטרים של הקלט שלה ערכים ששווים לפרמטרים של הסשן עם אותו שם.
• כש-Playbook שגרתי יוצא, הוא יוצר ערכים לפרמטרים של הפלט שלו ומקצה אותם לפרמטרים של הסשן עם אותו שם.

השוואה בין סוגים של פלייבוקים

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

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

ה-Playbook שמוגדר כברירת מחדל הוא נקודת ההתחלה של השיחות, ולכן יש לו כמה הבדלים חשובים מ-Playbooks אחרים:

• ה-playbook שמוגדר כברירת מחדל לא מקבל סיכום של תפניות השיחה הקודמות.
• אי אפשר להגדיר או לקבל פרמטרים של קלט ב-playbook שמוגדר כברירת מחדל.

יצירת ספר הפעלה

כדי ליצור מדריך הפעלה:

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

שימוש ב-AI גנרטיבי ליצירת תוכנית פעולה

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

ייבוא וייצוא של ספרי הפעלה

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

1. עוברים לרשימת תוכניות הפעולה.
2. לוחצים על לחצן הייצוא של תוכנית הפעולה שרוצים לייצא.
3. בוחרים אפשרויות ייצוא.
4. לוחצים על ייצוא.

כדי לייבא פלייבוק שייצאתם בעבר:

1. עוברים לרשימת תוכניות הפעולה.
2. לוחצים על Import.
3. בוחרים אפשרויות ייבוא.
4. לוחצים על Import.