Open in
מדריך סגנון להנחיות
כיצד לכתוב ולערוך הנחיה של סוכן קולי של ThunderPhone: ההנחיות בודקות סקירת הנחיות, עם המזהים שאליהם מתייחסים הממצאים שלהן.
מדריך זה מיועד לכל מי שכותבים או עורכים הנחיה של סוכן קולי: אדם בונה, Copilot או סוכן תכנות שעובד דרך ה-API. כלי בדיקת ההנחיה משתמש בו כבסיס להערכה ומפנה למזהי ההנחיות שלו (P1, W2 וכן הלאה).
מתקשר שומע את הסוכן פעם אחת, בקצב דיבור, ואינו יכול לגלול לאחור. הסוכן קורא את ההנחיה בכל תור ומעתיק את הניסוח שלה בקפדנות. שתי העובדות האלה מעצבות את כל מה שמופיע להלן.
מבנה
P1. כתבו זאת כפי שאדם היה מתדרך נציג/ת קבלה חדש/ה. פתיחה קצרה מציינת מי הסוכן ולמי הוא עובד. לאחר מכן, השיחה מתקדמת לפי הסדר שבו היא מתרחשת: כיצד היא נפתחת, מה לברר, מה לאשר, וכיצד היא מסתיימת. כל כלל מופיע בחלק של השיחה שבו הוא רלוונטי. הקוראים צריכים להיות מסוגלים לשאול על כל פסקה: "האם אדם שמנהל את העסק הזה יכול היה לכתוב זאת?" מה שיש לברר כולל את מה שהעסק צריך כדי לטפל בבקשה, ולא רק את זהות המתקשרים ואת פרטי ההתקשרות איתם.
P2. כותרות פשוטות, טקסט מתחתיהן. כותרות כגון "מי אתם", "השיחה", "עובדות" ו"העברה לנציג" מועילות. מבנה בסגנון מכונה אינו מועיל: מדריכי כללים ממוספרים, כותרות camelCase או כותרות דמויות קוד, רשימות ארוכות של כללים עם תבליטי מקף, הפניה לכלים בתחילת ההנחיה והפניות צולבות כגון "ראו סעיף 4 בהמשך". רשימות מתאימות לנתונים שהסוכן מחפש בהם מידע (שעות פעילות, מחירים, כתובת).
P3. אופן הדיבור פעם אחת, בקצרה. האופן שבו הסוכן מדבר לאורך כל השיחה (משפטים קצרים בגוף ראשון, מילים חמות ופשוטות; ראו S2) מתאים לפסקה קצרה אחת סמוך להתחלה. כל דבר שספציפי לשלב מסוים מופיע באותו שלב.
P4. הפרידו בין עובדות להתנהגות. שעות פעילות, מחירים, מיקומים, מדיניות ועובדות אחרות שייכים לחלק העובדות בהנחיה או לבסיס ידע, ולא מפוזרים לאורך זרימת השיחה. קטלוגים ארוכים ושאלות נפוצות שייכים לבסיס ידע. הסוכן רשאי לומר רק עובדות שנמסרו לו.
תוכן
C1. עקרונות ועובדות, לא תסריטים. תארו מה הסוכן מנסה להשיג ומה עליו לדעת. השמיטו הסתעפויות של "אם המתקשר אומר X, אמרו Y", תשובות מתוסרטות לשאלות צפויות ומשפטים מוכנים מראש. ברכת הפתיחה המוגדרת היא הרכיב המתוסרט היחיד.
C2. תיקון מציג את העיקרון הכללי. כאשר שינוי בהנחיה מגיב לכשל שנצפה, השינוי מוסיף עיקרון כללי או עובדה חסרה, ולא תיקון נקודתי למקרה הזה. הפרטים של השיחה שנכשלה — השמות, המספרים והמילים המדויקות שלה — אינם נכנסים להנחיה.
C3. העדיפו להסיר על פני להוסיף. כאשר כשל נובע מכלל קיים שהוא ספציפי מדי, רחב מדי או ממוקם בצורה גרועה, שנו או הסירו את הכלל במקום להוסיף לידו כלל נגדי.
C4. הגדרות קובעות חלק מהדברים, לא ההנחיה. אלה הגדרות של הסוכן, וטקסט בהנחיה לגביהן מתעלמים ממנו או שהוא מתנגש איתן: מה נאמר בזמן הפעלת כלי (משפט פתיחת כלי, משפטי מילוי), בדיקות לאחר שתיקה והפעולה הסופית לאחר שתיקה, קצב ההקראה החוזרת, סגנון החלפת השפה, הודעת ההקלטה, והאם הסוכן או המתקשר מדברים ראשונים. הפנו את ההנחיה לתוצאה במקום זאת ("אשרו את כתובת האימייל לפני שתשמרו אותה"), והגדירו את ההגדרה. ברכת הפתיחה עצמה נכתבת בהנחיה.
C5. דוגמאות הן משפטים שהסוכן יאמר. הסוכן מעתיק את ניסוח הדוגמאות כמעט מילה במילה, לכן כל דוגמה היא משפט מדובר מלא וטבעי, וכמה דוגמאות מגוונות עדיפות על אחת. הציגו אותן כדוגמאות ("לדוגמה, אפשר לומר ..."), ולא כמשפט הנדרש. תגיות מקוצרות כמו "עדיין מדויק?" נשמעות תמציתיות מדי כשהן נאמרות.
C6. אין דוגמאות משיחות של הלקוחות שלנו. דוגמאות מתארות את סוג המצב במונחים כלליים או משתמשות בעסק מומצא.
C7. הפרומפט מיועד למתקשרים, ולא עוסק בתהליך הבנייה. המתקשרים שומעים כל מה שהפרומפט אומר לאחר שהוא עולה לאוויר, לכן הוא אינו כולל הערות על בנייה, בדיקות או סטטוס תאימות ("גרסה זו מיועדת לבדיקה", "TEST" בשם ההזמנה, "עד שההסכמים ייחתמו"). הוא גם אינו כולל כתבי ויתור, הסתייגויות מאחריות וסיכומי סיום שהעסק לא ביקש, כגון מה שקבלת תוכנית אינה מבססת או סיכום של מה שעדיין לא אושר. הסוכן עונה על מה שהמתקשר ביקש ועוצר; העסק מוסיף הסתייגות כאשר הוא רוצה בכך. עובדה חסרה או מגבלת מערכת מנוסחת כפעולה שהסוכן מבצע ("למחירים, הציעו שיחה חוזרת מהמשרד"), ולא כהערה על כך שהמידע לא סופק או על אופן תיעוד הבקשות, ולא נשאר דבר משלב הניסוח, כגון שם או כותרת שנותרו בטעות.
ניסוח
W1. אמרו מה לעשות, בפשטות, פעם אחת. תארו את ההתנהגות הרצויה כהנחיה במילים רגילות: "הקריאו את מספר ההזמנה ספרה אחר ספרה כדי שהמתקשר יוכל לתקן אותו." אמרו זאת פעם אחת, במקום שבו ההנחיה חלה.
W2. בלי הדגשה. אין תוויות "חשוב", "הערה" או "קריטי", אין מילים באותיות גדולות לצורך הדגשה, אין סימני קריאה, אין צמדי "רע:" ו"טוב:", ואין מקטעים של מה לא לעשות. גם מילים כמו "לעולם לא", "תמיד" ו"חייבים" שמשמשות להדגשה שייכות לכאן. הדגשה מושכת את תשומת הלב של המודל לכלל אחד ומחמירה את ביצועיו בשאר השיחה. כאשר הסוכן מתעלם מהוראה, הבהירו אותה, הפכו אותה לספציפית יותר או מקמו אותה טוב יותר, ולא רועשת יותר.
W3. תקנו את המבנה שגורם להתנהגות. לפני שמוסיפים כלל נגד דבר שהסוכן עושה, מצאו את הניסוח או המבנה שמובילים אותו לשם: תבנית שהמודל ממלא באופן מילולי, מונח שמשמעותו שני דברים, ענף אם-אחרת שמודל מהיר קורא באופן רופף. שנו את זה.
W4. ספציפי עדיף על כללי. "הציעו את שני המועדים הפנויים המוקדמים ביותר, ואז שאלו מה מתאים" עדיף על "סייעו בתזמון". הוראות מעורפלות יוצרות התנהגות מעורפלת.
W5. בדקו זאת לפני שאתם שואלים על כך. כאשר המתקשר מציין דבר שכלי חיפוש לקריאה בלבד יכול לבדוק (מוצר, הזמנה או הזמנה קיימת), הסוכן בודק באמצעות המילים שהמתקשר מסר, ואז שואל שאלת המשך רק אם התוצאה מצריכה זאת. "בדקו את המלאי של המוצר שהמתקשר מציין וספרו לו מה מצאתם" עדיף על "הבהירו את המותג, הגודל והווריאנט, ואז בדקו את המלאי": סוכן שקיבל הנחיה להבהיר תחילה ממשיך לשאול והבדיקה לעולם אינה מתבצעת. זה חל על חיפושים בלבד. לפני שימוש בכלי שקובע, משנה, מבטל או שומר משהו, הסוכן עדיין מאשר את הפרטים עם המתקשר.
דיבור
S1. שאלה אחת בכל תור, והשאלה מסיימת את התור. כל דבר שנאמר אחרי שאלה מדבר מעל לתשובת המתקשר. הציבו כל הסבר לפני השאלה.
S2. תורים קצרים, במשפטים מלאים המדוברים בקול. משפט קצר אחד או שניים, אלא אם המתקשר מבקש פירוט. האפשרויות הנאמרות בקול מוגבלות למספר קטן. קצר פירושו מעט מילים, לא משפטים קטועים: הסוכן מדבר כפי שפקידת קבלה טובה מדברת בטלפון, במשפטים מלאים בגוף ראשון, למשל "אקבע לכם את זה עכשיו" או "רשמתי אתכם ליום שני בעשר." קטעים בסגנון הערות ("אקבע לכם את זה.", "בוצע.", "נרשם.") נשמעים קצרים וקרים כשהם נאמרים בקול, וניסוחים של אימייל ("שימו לב ש...", "אנא...", "אני מקווה שזה עוזר") נשמעים מוקראים במקום מדוברים. הפסקה בהנחיה שמתארת את אופן הדיבור מבקשת זאת במפורש, למשל: "הקפידו שכל תור יהיה באורך של משפט או שניים, ודברו בגוף ראשון, כפי שפקידת קבלה הייתה מדברת בטלפון."
S3. כתבו עבור האוזן. בדברים שהסוכן אומר, הימנעו מ-Markdown, מסמלים ומסימונים שהקול יקרא באופן מוזר (לוכסנים, אמפרסנד, "@", ".com", מפרידי אלפים, מספרי טלפון ללא רווחים). עובדות וערכים שהסוכן מעביר לכלי, כגון כתובת אימייל או מספר חשבון, נשארים בצורתם הכתובה המדויקת; כאשר צריך גם לומר אותם בקול, הוסיפו לידם את אופן ההגייה במקום לשכתב אותם. כתבו כיצד הוגים שמות או ראשי תיבות חריגים, והאזינו למונחים חדשים בקולו של הסוכן לפני שתשאירו אותם.
S4. אשרו מידע שטעות בו עלולה לעלות ביוקר. מספרים, כתובות אימייל, כתובות וקודים מוקראים בחזרה בצורה שבה נמסרו, פעם אחת, בתשובה שמיד לאחר שהמתקשר מוסר אותם ולפני השאלה הבאה, ערך אחד בכל הקראה חוזרת. כברירת מחדל, שם מתקבל כפי שנאמר, ללא הקראה חוזרת, והסוכן מבקש את איותו רק כשהוא חריג או לא ברור, ופעם אחת בלבד. כאשר העסק זקוק לשם מדויק, למשל כדי להתאים אותו לרשומות שלו או לצורך הזמנה תחת אותו שם, ההנחיה מציינת זאת והסוכן מאיית את השם בחזרה. הקראה חוזרת היא ההזדמנות של המתקשר לתקן ערך, ולא תנאי להמשך: מתקשר שעונה עם הפרט הבא או ממשיך בלי לתקן אותו קיבל את הערך, וערך שהתקבל אינו נשאל שוב. מספר טלפון שהעסק יתקשר אליו או ישלח אליו הודעת טקסט הוא החריג: ההקראה החוזרת שלו מסיימת את התור וממתינה לתשובת המתקשר. הנחיה שמבקשת להקריא ספרה אחר ספרה מציינת רק את הערכים שמוקראים כך (מספר טלפון, קוד); מספר בית, מחיר, שעה או תאריך נאמרים כפי שאנשים אומרים אותם. ההנחיה מציינת מה לאשר; הפלטפורמה קובעת את קצב ההקראה החוזרת.
איטרציה
I1. בדקו לפני שאתם משאירים שינוי. הריצו מחדש את מערך הפיתוח של הסוכן על הטיוטה הערוכה והשוו אותה לגרסה הנוכחית: אילו דוגמאות השינוי תיקן ואילו הוא פגע בהן. קראו את התשובות כפי שמתקשר היה שומע אותן. כל דבר שמתקשר היה מבחין בו הוא בעיה, לא פרט.
I2. מערך ההחזקה נבדק פעם אחת. כווננו על מערך הפיתוח בלבד. הריצו את מערך הבדיקה כאשר שינוי מוכן, ודווחו על התוצאה שלו כפי שהיא. שינוי שנעשה לאחר שראיתם תוצאות בדיקה דורש דוגמאות בדיקה חדשות.
I3. בצעו ארגון מחדש כאשר תיקונים מצטברים. פרומפט שאסף תיקונים קטנים רבים סוטה מ-P1: כללים חוזרים על עצמם, מתנגשים, או נמצאים רחוק מהשלב שהם מגדירים. לאחר מכן, כתבו אותו מחדש במבנה הזה, תוך שמירה על כל התנהגות שהוא מבקש. רשמו כל התנהגות כנשמרה, מוזגה, נוסחה מחדש או הוסרה, ואל תסירו דבר בשקט. הריצו מחדש את מערך הפיתוח לפני ואחרי; ארגון מחדש אמור לשנות ניסוח, לא התנהגות.
I4. בדקו את התצורה לפני ההנחיה. חלק מהכשלים אינם קשורים להנחיה: שמיעה שגויה של אותיות שנאמרות באיות היא מגבלת שמיעה (נסו את רמת השמיעה Plus), ותגובה איטית עשויה לנבוע מרמת האינטליגנציה או השמיעה, או מהגדרת זיהוי סוף הדיבור. שללו בעיות תצורה לפני שתשכתבו את הטקסט.