פלייבוקים

מה זה פלייבוק

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

~/.openclaw/workspace/protocols/dojo-voice-agent-playbook.md

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

הפלייבוק קובע מה הסוכן עושה בשיחות. מי הסוכן (שם, אישיות, רקע) נקבע ב-SOUL.md וב-IDENTITY.md, ואותה פרסונה משרתת גם שיחות נכנסות וגם שיחות יוצאות. עובדות על העסק עדיף לשמור במאגר הידע.

סעיפים

רכיב השיחות ממיין את הקובץ לפי כותרות ה-## שלו. שלוש כותרות קשורות לסוג מסוים של שיחה. כל השאר משותף ונכנס לכל שיחה.

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

עריכת הפלייבוק

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

nano ~/.openclaw/workspace/protocols/dojo-voice-agent-playbook.md

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

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

כתיבת Public Mode

סעיף ציבורי טוב עונה על ארבע שאלות, בסדר הזה:

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

## Public Mode

### Never
- Never quote a delivery date the order system has not confirmed.
- Never discuss other customers or the owner's personal details.

### You can tell callers
- Opening hours, the returns policy, which areas we deliver to.
  For anything detailed, search the knowledge base.

### You can do
- Look up an order once the caller gives the order number and the
  email on the order.
- Take a message for the team: name, callback number, what they need.

### Before the call ends
- Confirm the caller's name and the best number to reach them.

ברכת פתיחה

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

## Greeting

The call just connected. You speak first.

- If the Caller Profile shows a confirmed name: greet them by name.
- Otherwise: "Thanks for calling Northwind Supply, this is Alex.
  How can I help?"

Keep it to one or two short sentences.

שיחות יוצאות ופרופילי תסריט

הסעיף ## Outbound Mode קובע איך מתנהלות השיחות שהסוכן מוציא. כל שיחה מגיעה עם מטרה ועובדות משלה, והפלייבוק קובע איך לנהל אותה. תחת תת-הסעיף ### Script profiles אפשר להגדיר פרופילים עם שמות, כל אחד תחת כותרת ####:

### Script profiles

#### appointment-confirmation
Brief and direct. Say who you are, state the appointment from the Facts,
ask whether it still works, note the answer, thank them, end the call.

#### payment-reminder
Polite and clear. Name the invoice and amount from the Facts and ask for
a payment date. If they dispute it, do not argue: say the team will
follow up, then end the call.

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

הפלייבוק והתסריטים בדשבורד

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

שימוש בקובץ פלייבוק אחר

כדי לנסות גרסה עונתית או להשוות בין שתי גרסאות, הפנו את רכיב השיחות לקובץ אחר ב-config.json והפעילו מחדש:

"context": {
  "files": ["SOUL.md", "IDENTITY.md", "USER.md"],
  "voicePlaybook": "protocols/holiday-playbook.md"
}

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

מגבלות ומלכודות

• 30 KB לפלייבוק. קובץ גדול יותר לא נחתך אלא נדחה, והסוכן עובד לפי ההנחיות המובנות עד שתקצרו אותו. כך גם עם קישור סימבולי. אחרי עריכה גדולה, חפשו hasPlaybook: true בלוג.
• תקציב כולל להנחיות של השיחה. קובצי הפרסונה, הפלייבוק, העובדות וכללי הפלטפורמה חולקים כ-44 KB. כששיחה חורגת, רכיב השיחות חותך בסדר הזה: קודם העובדות שנטענות תמיד, אחר כך ## Learned Patterns, ואז סוף הפלייבוק. שימו את מה שהכי חשוב קרוב להתחלה.
• כללי הפלטפורמה באים אחרי הפלייבוק, והפלייבוק לא יכול לעקוף אותם. חסימת התחזות, הגנה מפני הזרקת פרומפטים והפרדה בין מתקשרים חלות לא משנה מה כתוב בפלייבוק. גם הפלייבוק עצמו מטופל כתוכן, לא כפקודות שמשנות את הכללים האלה.
• כתבו לדיבור. הסוכן אומר את מה שהוא קורא. משפטים קצרים ומילים פשוטות עובדים. טבלאות וקישורים לא.
• הסוכן מעתיק דוגמאות. הוא מתייחס לשורות דוגמה כתבניות לעבוד לפיהן. אל תכניסו לכללים עובדות לדוגמה (מחירים, תאריכים, שמות) אלא אם הן נכונות.