התקנה והגדרת שער הקול
מתקינים את שער הקול לצד הסוכן, בוחרים שפה וקול ובודקים במצב פרטי לפני פרסום מספר.
ארבעת המקומות שבהם נשמרות הגדרות
הפורטל שומר הגדרות חשבון ומספר; config.json הוא משטח התפעול המקומי; קובצי ההקשר מגדירים מה הסוכן יודע; ו-.env שומר סודות וזהות פריסה.
- אל תשמרו secrets ב-config.json
- הבדילו בין ערך שמגיע מהענן לערך מקומי
- תעדו מי הבעלים של כל הגדרה
התקנה ראשונה
מתקינים את שער הקול לצד הסוכן, מתחברים לפורטל ומפעילים שיחת בדיקה פרטית לפני שמפרסמים מספר.
- ודאו שהסוכן המקומי זמין
- בחרו מספר, שפה וקול
- בדקו קבצים שנוצרו בדיסק
- שמרו את המספר האישי שלכם כ-Owner phone
config.json
זה הקובץ העיקרי לשינוי מצב שיחה, pipeline קולי, מקורות הקשר ויכולות gateway. ערכו רק שדות מתועדים והפעילו מחדש לאחר שינוי.
- audio: כוונון השהיה, VAD ועיבוד
- context: אילו קובצי workspace נטענים
- features: אילו יכולות וכלים זמינים
- mode: פרטי או ציבורי
כיוון אודיו והקשר
שנו פרמטר אחד בכל פעם והשוו לאותה שיחת בדיקה. אם ההקשר ארוך, הסירו מקורות שאינם נחוצים לכל שיחה במקום לקצר מידע חשוב באופן אקראי.
- בדקו רעש, קטיעות וזמן עד תחילת תשובה
- שמרו MEMORY.md רק כאשר הוא באמת נדרש
- אל תעתיקו מידע לקוח ל-prompt קבוע
סנכרון ענן וסודות
סנכרון מהפורטל עשוי לעדכן מספר, קול ושדות מנוהלים. הגדרות מקומיות מתועדות נשארות מקומיות. .env אינו מקום לעריכה ידנית שגרתית ואסור להעלות אותו ל-Git.
- אמתו אילו שדות נדרסים לפני sync
- שמרו גיבוי של config.json
- החליפו secret שנחשף מיד
החלת שינויים ופתרון תקלות
לאחר עריכה מפעילים מחדש, בודקים לוג אתחול ומריצים שיחה קצרה. אם שינוי לא חל, ודאו שנערך הקובץ של הפריסה הפעילה ושלא נדרס בסנכרון.
- בדקו syntax ונתיב קובץ
- חפשו אזהרות על ערך לא מוכר
- בדקו שהשירות אכן הופעל מחדש
- ב-A/B test שמרו גרסה אחת לכל ניסוי
בדיקת בטיחות
לפני Publish אמתו חתימות, הרשאות, מסלול אנושי ופעולות שמשנות מידע.