פלייבוקים

הערה: התכונה Playbook לא נכללת ב-Dialogflow CX SLA.

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

מגבלות

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

• נציגים שמשתמשים בפלייבוקים לא תומכים בשליחת הודעת SMS של Call Companion מהנתיב Default Welcome Intent ב-Default Start Flow, אבל אפשר להפעיל את האפשרות של הודעת SMS של Call Companion בתהליכים רגילים.
• פלייבוקים לא תומכים בקלט DTMF ממערכות טלפון.

שפות

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

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

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

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

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

• בוחרים את מודל ה-LLM ברמת הנציג:
  • במסוף כלי ליצירת סוכנים בממשק שיחה, בקטע Agent setting ‏> בינה מלאכותית גנרטיבית ‏> Playbook, בוחרים מודל לפי השם המוצג שלו מרשימת המודלים הזמינים.
  • כשמשתמשים ב-API כדי לעדכן את הגדרות הנציג, צריך לציין את שם המודל בשדה GenerativeSettings.llm_model_settings.model. אפשר לעיין במאמר GenerativeSettings.
• שינוי בחירת המודל ברמת הבקשה:
  • בסימולטור של מסוף כלי ליצירת סוכנים בממשק שיחה, בוחרים מודל לפי השם המוצג שלו מהרשימה כשבודקים playbook.
  • כשמשתמשים ב-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-3.1-flash-lite	Gemini 3.1 flash lite	GA
gemini-3.5-flash-lite	Gemini 3.5 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 להבין אילו משימות הפלייבוק מטפל בהן.
• יעדים: תיאור כללי של מה שהפלייבוק אמור להשיג.
• ‫Instructions (הוראות): השלבים בתהליך שהסוכן צריך לבצע כדי להשיג את המטרה.
• דוגמאות: שיחות לדוגמה שמשמשות כהנחיות עם כמה דוגמאות (few-shot prompts) ל-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. מבצע הקריאה החוזרת (caller) מפעיל את הנמען (callee).
2. הגורם שמבצע את הקריאה מספק את פרמטרי הקלט הנדרשים לגורם שמקבל את הקריאה.
3. הפונקציה הנקראת מעבדת את המידע הזה, מבצעת את הפונקציה שהוקצתה לה ומחזירה פרמטרים של פלט.
4. המתקשר מקבל פרמטרים מהנמען.

כל פלייבוק לתרחיש חוזר או למשימה יכול להפעיל פלייבוק אחר למשימה, אבל פלייבוק למשימה לא יכול להפעיל פלייבוק אחר לתרחיש חוזר.

פלייבוקים לתרחישים חוזרים

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

ברשימה הבאה מוצג מעבר מפלייבוק לתרחיש חוזר א' לפלייבוק לתרחיש חוזר ב', ואז מעבר לתהליך ג':

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

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

הפרמטרים של פלייבוקים לתרחישים חוזרים מנוהלים באופן הבא:

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

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

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

פלייבוק ברירת המחדל

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

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

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

יצירת פלייבוק

כדי ליצור פלייבוק:

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

איך משתמשים ב-AI כדי ליצור פלייבוק

כשיוצרים פלייבוק, נפתחת חלונית של AI גנרטיבי. כך אפשר ליצור נתונים של פלייבוק.

ייבוא וייצוא של פלייבוקים

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

כדי לייצא פלייבוק:

1. עוברים לרשימת הפלייבוקים.
2. בוחרים את הפלייבוק שרוצים לייצא ולוחצים על ייצוא.
3. בוחרים את אפשרויות הייצוא ולוחצים על ייצוא.

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

1. עוברים לרשימת הפלייבוקים.
2. בוחרים את הפלייבוק שרוצים לייבא ולוחצים על ייבוא.
3. בוחרים אפשרויות ייבוא ולוחצים על ייבוא.