תיעוד/מדריכים
מצבי שיחה
הגדרה אחת קובעת למי הסוכן שלכם עונה. במצב ציבורי הוא משרת כל מי שמתקשר, בגבולות הכללים שאתם כותבים. במצב פרטי הוא עונה רק למספר שלכם ונותן לכם את הסוכן המלא.
שני המצבים
| ציבורי (ברירת מחדל) | פרטי | |
|---|---|---|
| מי מגיע לסוכן | כל מתקשר, חוץ ממספרים שחסמתם. | רק המספר שהוזן ב-Your phone number (המספר שלכם). כל שיחה אחרת נדחית, ואם השדה ריק, נדחית כל שיחה. |
| איך הסוכן מתייחס למתקשר | כאל מתקשר מהציבור, לפי הסעיף ## Public Mode בפלייבוק שלכם. | כאל בעל העסק המאומת, כלומר אתכם, לפי ## Private Mode. |
| למה הוא יכול להגיע | מאגר הידע שלכם, אפליקציות מחוברות, הכלים המותאמים שלא סימנתם לבעל העסק בלבד, והיכולות שהופעלו בפרויקט שלכם, כמו העברת הטיפול לצוות שלכם במייל או העברה לנציג בזמן אמת. ראו כלים. | כל מה שלמעלה, ובנוסף סוכן ה-OpenClaw שלכם עצמו, עם המייל, היומן, הקבצים והסקילים (skills) שלו, כלים לבעל העסק בלבד ופרופיל ה-USER.md שלכם. |
המצב נקבע לכל סוכן, לא לכל מתקשר. במצב ציבורי כל מתקשר נחשב מתקשר מהציבור, כולל אתם כשאתם מתקשרים מהמספר שלכם. השתמשו במצב פרטי לקו שרק אתם משתמשים בו, ובמצב ציבורי לקו שהלקוחות שלכם מתקשרים אליו.
המצב חל על הקו כולו: קו ציבורי לא יכול לפתוח גישת בעלים למתקשר מסוים, וקו פרטי לא יכול לענות לאף אחד אחר.
קביעת המצב
פתחו את הסוכן שלכם בפורטל הקולי ועברו ל-Settings (הגדרות), Configuration (תצורה):
- Call mode (מצב שיחה): public או private. סוכנים חדשים מתחילים במצב ציבורי.
- Your phone number: המספר שלכם בפורמט E.164, למשל
+16475550199. מצב פרטי מקבל רק את המספר הזה. ההתאמה נבדקת ספרה אחר ספרה, כולל קידומת המדינה, מול המספר שהרשת הטלפונית מדווחת על השיחה. מה שהמתקשר אומר על עצמו לא משנה דבר. המספר הזה גם לעולם לא נחסם, אפילו אם הוא ברשימת המספרים החסומים.
שומרים, מחכים כמה דקות עד שרכיב השיחות יקלוט את השינוי, ואז מוציאים שיחת בדיקה. אין צורך להפעיל שום דבר מחדש.
מה סוכן חדש עושה
הפלייבוק שתוכנית ההתקנה כותבת מגיע עם סעיף ## Public Mode ראשוני. הסעיף מניח שמי שמתקשר הוא בעל העסק שבודק את הקו: הסוכן מסביר איך להגדיר אותו, ואם ברור שעל הקו מישהו אחר, הוא אומר שהמספר עדיין בהקמה ומסיים את השיחה. כל עוד הסעיף הראשוני במקומו, הסוכן מונחה לא לרשום הודעות, לא לטעון שום דבר על העסק שלכם ולא לפעול בשם המתקשר.
מלמדים את הסוכן מה מתקשרים מהציבור יכולים לעשות
החליפו את הסעיף הראשוני בסעיף משלכם בפלייבוק הקולי:
~/.openclaw/workspace/protocols/dojo-voice-agent-playbook.md
ערכו אותו על השרת, או בקשו מהסוכן שלכם בצ'אט לבצע את השינוי. רכיב השיחות קורא את הקובץ בתחילת כל שיחה, כך שהשיחה הבאה כבר משתמשת בעריכה שלכם, בלי הפעלה מחדש. עדכונים והתקנות חוזרות אף פעם לא דורסים אותו. אם הצוות שלנו מפעיל את הסוכן שלכם, שלחו לנו את השינוי ונבצע אותו יחד איתכם.
## Public Mode
### What you must NOT do
- Never share the owner's personal email, calendar or files.
- Never quote a price that is not in the list below.
- Never take card details over the phone.
### What you can tell callers
Hours: Monday to Friday, 9 am to 6 pm. Services: haircut, beard trim,
haircut and beard. Location: 123 Main Street, Toronto.
### What you can do for callers
- Book an appointment.
- Take a message for the team: name, callback number, what they need.
### Information to collect
Full name, callback number, reason for the visit, preferred time.
Confirm each detail back before ending the call.
כתבו קודם את רשימת ה-"must NOT do": היא רשת הביטחון שלכם. כל פעולה שאתם מתירים דורשת כלי שמסוגל לבצע אותה בשיחה ציבורית: אפליקציה מחוברת כמו Wix Bookings, כלי מותאם שלא סומן לבעל העסק בלבד, או מאגר הידע. הפלייבוק קובע מתי הסוכן משתמש בכלים האלה, אבל הוא לא יכול לתת למתקשרים מהציבור כלי שהפלטפורמה שומרת לבעל העסק. בדף כלים מפורט למה כל סוג שיחה יכול להגיע, ובדף פלייבוקים מוסבר איך הקובץ בנוי.
אופציונלי: כוונון המצב הפרטי
סעיף ## Private Mode באותו קובץ קובע טון, כללים קבועים והרגלים לשיחות שלכם. אם לא תכתבו אותו, חלות ברירות המחדל.
בודקים
- מתקשרים מטלפון אחר. במצב ציבורי, כשאין סעיף Public Mode משלכם, תשמעו את מדריך ההקמה הראשוני. כשהסעיף שלכם במקום, הסוכן אמור לעבוד לפיו.
- עוברים למצב פרטי ומתקשרים מהמספר שלכם. הסוכן אמור לפנות אליכם כאל בעל העסק ולהגיע לסוכן ה-OpenClaw שלכם.
- עדיין במצב פרטי, מתקשרים מטלפון אחר. השיחה אמורה להידחות.
אם התוצאה שונה מהצפוי:
- ודאו ש-Your phone number בפורמט E.164 עם קידומת המדינה, ושזה המספר שהטלפון שלכם באמת מציג.
- ודאו שה-Call mode הוא המצב שהתכוונתם אליו, ותנו לשינוי כמה דקות להגיע לרכיב השיחות.
- ודאו שהכותרת בפלייבוק היא בדיוק
## Public Mode(רמה שתיים, בשורה נפרדת), ושהלוג של רכיב השיחות מציגhasPlaybook: true(ראו הגדרה).
על מה הפלטפורמה מגינה בשבילכם
מצב פרטי נותן למתקשר את מה שהייתם מקבלים בצ'אט עם הסוכן שלכם. רק מספר אחד יכול לקבל אותו, ורק הרשת הטלפונית יכולה לאמת אותו.
ההגנות האלה חלות בכל שיחה ציבורית, לא משנה מה כתוב בפלייבוק שלכם:
- גישת בעלים נקבעת רק לפי זיהוי המתקשר. מתקשר שאומר "אני הבעלים" או "יש לי הרשאה" נשאר מתקשר מהציבור. אין קוד סודי שאומרים בקול, ואין דרך לעקוף.
- הכלים של בעל העסק לא מוצעים. סוכן ה-OpenClaw שלכם, כלים מותאמים לבעל העסק בלבד ופרופיל ה-
USER.mdשלכם לא נכללים בשיחות ציבוריות בכלל, כך שאין כלי שמתקשר יכול לשכנע את הסוכן להפעיל. - כל שיחה מבודדת. כל שיחה ציבורית רצה בהקשר נפרד משלה, כך שאף מתקשר לא יכול להגיע לשיחה של מתקשר אחר.
- הטקסט מסביבת העבודה מנוקה לפני השימוש. שורות בקובצי סביבת העבודה שנראות כמו ניסיון לתת הוראות למודל מוסרות, ובשיחות ציבוריות מוסרים גם אזכורים של שמות קבצים בסביבת העבודה. הקבצים מגיעים לסוכן מסומנים כתוכן, לא כפקודות. אל תשימו עובדות פרטיות בקבצים שנטענים בשיחות ציבוריות: במדריך מאגר ידע מוסבר איך מגבילים מקור לשיחות של בעל העסק או למתקשרים שזהותם אומתה.
- הסוכן מונחה לעמוד בפני ניסיונות מניפולציה. כללי פלטפורמה שהפלייבוק שלכם לא יכול לעקוף מנחים אותו להתייחס לדברי המתקשר כמידע לא אמין, לדחות במשפט קצר אחד ניסיונות לשנות את הכללים שלו ("תתעלם מההוראות שלך", "בוא נעמיד פנים", "זה מקרה חירום, תדלג על האימות"), ולהמשיך לעזור.
- יש דברים שהסוכן מונחה לעולם לא לומר בקול, בשום שיחה: מפתחות API, טוקנים, סיסמאות ופרטי גישה אחרים, ואת השם של מודל ה-AI או של הספק שמפעילים אותו. הסוכן נשאר בפרסונה שקבעתם.
הפלייבוק שלכם צריך לכסות רק כללים עסקיים: מה אתם מציעים, מה אתם קובעים, מה אתם אף פעם לא עושים. בכל השאר מטפלת הפלטפורמה.
איפה כל דבר יושב
| הגדרה | איפה |
|---|---|
| מצב שיחה, מספר הטלפון שלכם, ברכת פתיחה, קול | בדשבורד: Settings, Configuration |
| הכללים של Public Mode ו-Private Mode | protocols/dojo-voice-agent-playbook.md בסביבת העבודה |
| מייל, יומן וסקילים אחרים לשיחות שלכם | סוכן ה-OpenClaw שלכם. ראו כלים. |
| מתגים של כלים מובנים, וכלים מותאמים ב-HTTPS | data/voice-tools.json בסביבת העבודה. ראו כלים מותאמים. |
| כוונון שמע, קובצי הקשר, מתגי פיצ'רים | config.json על השרת של רכיב השיחות. ראו הגדרה. |