פלייבוקים

הערה: התכונה Playbook לא נכללת בהסכם רמת השירות (SLA) של Dialogflow CX.

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

מגבלות

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

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

שפות

אפשר לעיין בעמודה Playbooks בהפניה לשפה. השפות שסומנו להוספה לחוברות ההדרכה נבדקו מבחינת איכות באמצעות מודלים של gemini-2.0-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).

שם הדגם	מפרט הדגם	שלב ההשקה
gemini-2.5-flash	‫Gemini 2.5 Flash	GA
gemini-2.5-flash-lite	‫Gemini 2.5 flash lite	GA
gemini-2.0-flash-001	‫Gemini 2.0 flash	GA
gemini-2.0-flash-lite-001	‫Gemini 2.0 flash lite	GA

תמיכה באזור

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

• global
• asia-south1
• asia-southeast1
• asia-southeast2
• asia-northeast1
• australia-southeast1
• eu (במספר אזורים)
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• northamerica-northeast1
• us (במספר אזורים)
• us-central1
• us-east1
• us-west1

נתונים מ-Playbook

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

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

הנחיית LLM

בכל תור בשיחה, מערכת Dialogflow CX משתמשת בנתוני תוכנית הפעולה של זמן העיצוב ובנתוני השיחה של זמן הריצה כדי ליצור הנחיה ל-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 שגרתי יוצא, הוא יוצר ערכים לפרמטרים של הפלט שלו ומקצה אותם לפרמטרים של הסשן עם אותו שם.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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