ניהול הגדרות AI Companion

עדכון תצורת AI Companion, החלפת ספקים, שינוי הגדרות וניהול עוזר ה-AI אחרי ההגדרה הראשונית.

גישה להגדרות

1. התחבר ללוח הבקרה של SupportRetriever
2. נווט ל-AI Companion מההגדרות או גלוש ל-/ai-companion
3. צפה בתצורה הנוכחית

דף ההגדרות מציג:

• מתג סטטוס – הפעלה או כיבוי של AI Companion
• פרטי תצורה – שם, ספק, מפתח API, בסיס ידע, MCP (אופציונלי)
• אפשרויות ניהול – עריכה, מחיקה, עדכון הגדרות

מתג הפעלה/כיבוי

השהה או המשך את AI Companion במהירות:

1. מצא את מתג Status בראש סעיף התצורה
2. לחץ למעבר בין Active ל-Paused
3. השינויים נכנסים לתוקף מיד

מושהה:

• לא נוצרות הצעות חדשות
• הצעות קיימות נשארות גלויות
• התצורה נשמרת
• קל להמשיך מאוחר יותר

כשפעיל:

• הצעות נוצרות אוטומטית
• עובד כרגיל לכל השיחות

עריכת תצורה

עריכה inline

רוב השדות תומכים בעריכה inline:

1. לחץ על אייקון העריכה (עיפרון) ליד כל שדה
2. בצע את השינויים
3. לחץ סימן V לשמירה או X לביטול

שינוי שם ה-Companion

1. לחץ עריכה על AI שם
2. הזן שם חדש (עד 50 תווים)
3. שמור שינויים

השם החדש מופיע בכותרת ההצעות מיד.

החלפת ספקים

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

עדכון מפתח API

1. לחץ עריכה על API Key
2. הזן מפתח API חדש
3. שמור שינויים

מפתח ה-API מוצפן לפני האחסון. התצוגה המקדימה מציגה גרסה מוסווית (למשל sk-proj-...abc123).

מתי לעדכן:

• המפתח פג תוקף או בוטל
• רוטציית אבטחה (שיטה מומלצת שנתית)
• החלפת ספק
• המפתח נחשף

שינוי כתובת בסיס ידע

1. לחץ עריכה על Knowledge Base URL
2. הזן כתובת חדשה או השאר ריק להסרה
3. שמור שינויים

הצעות חדשות משתמשות מיד בבסיס הידע המעודכן.

הגדרת MCP

אופציונלי: אפשר להוסיף endpoint MCP (Model Context Protocol) כדי שה-AI יוכל לשלוף הקשר נוסף (למשל נתוני משתמש או חשבון) בעת יצירת הצעות. לחץ עריכה ליד MCP, ואז הזן את כתובת ה-endpoint (HTTPS), מפתח סוד וסכמת JSON ל-body של הבקשה. מפה כל property בסכמה לשם לקוח, אימייל לקוח או מפתח metadata משליחות טופס. לשלבים מלאים ודוגמאות, ראה הגדרת MCP.

מחיקת תצורה

הסרת תצורת AI Companion לצמיתות:

1. גלול לתחתית סעיף התצורה
2. לחץ מחק Configuration
3. אשר מחיקה בחלון
4. התצורה מוסרת לצמיתות

מה קורה אחרי מחיקה:

• התצורה מוסרת לצמיתות
• מפתח API מוצפן נמחק
• לא נוצרות הצעות חדשות
• הצעות קיימות נשארות גלויות
• אפשר להגדיר שוב בכל עת

שיטות עבודה מומלצות

מעקב אחר חיוב הספק

הגדר התראות שימוש בחשבון ספק ה-AI:

• OpenAI: מגבלות שימוש והתראות בהגדרות החשבון
• Anthropic: התראות חיוב בקונסול
• Grok: מעקב שימוש בלוח הבקרה
• Gemini: מגבלות מכסה ב-Google Cloud Console

החלף מפתחות API מדי שנה

לשיטות אבטחה מומלצות:

1. צור מפתח API חדש מהספק
2. עדכן בהגדרות AI Companion
3. בטל את המפתח הישן בחשבון הספק
4. וודא שהמפתח החדש עובד

שמור על בסיס ידע מעודכן

עדכן את כתובת בסיס הידע באופן קבוע:

• כשהתיעוד עובר
• כשהמבנה משתנה
• כשמוסיפים תוכן חדש
• כדי להבטיח מידע עדכני

סקור איכות ההצעות

סקור מעת לעת את איכות ההצעות:

• בדוק דיוק
• אמת שהטון תואם למותג
• וודא שבסיס הידע בשימוש
• שקול החלפת ספק אם נדרש

פרטי תצורה

סטטוס נוכחי

דף ההגדרות מציג:

• AI שם – שם ה-Companion
• Provider – ספק ה-AI הנוכחי
• API Key תצוגה מקדימה – גרסה מוסווית של המפתח המוצפן
• Knowledge Base URL – כתובת התיעוד (אם הוגדר)
• MCP – endpoint אופציונלי ומפת סכמה (אם הוגדר)
• Status – Active או Paused

אינדיקטורי סטטוס

• Active – מתג ירוק, הצעות נוצרות
• Paused – מתג אפור, הצעות מושהה
• Not Configured – מוצג אשף ההגדרה

פתרון בעיות בהגדרות

שינויים לא נשמרים

בדוק:

• חיבור אינטרנט
• קונסול הדפדפן לשגיאות
• פורמט מפתח API (אם מעדכן)
• פורמט כתובת (אם מעדכן בסיס ידע)

פתרון:

• רענן את הדף ונסה שוב
• אמת פורמטי שדות
• בדוק קונסול הדפדפן

מפתח API לא עובד אחרי עדכון

בדוק:

• המפתח נכון (ללא רווחים מיותרים)
• הספק תואם לספק שנבחר
• לחשבון יש קרדיט/מכסה
• המפתח לא פג תוקף

פתרון:

• אמת את המפתח בקונסול הספק
• בדוק עם מפתח חדש
• בדוק סטטוס חשבון הספק

בסיס הידע לא מתעדכן

בדוק:

• הכתובת נכונה ונגישה
• הפורמט כולל https://
• הדומיין נגיש לציבור

פתרון:

• בדוק את הכתובת בדפדפן
• אמת גישה ציבורית
• בדוק פורמט כתובת

הגדרה מחדש אחרי מחיקה

אם מחקת את התצורה ורוצה להגדיר שוב:

1. עבור להגדרות AI Companion
2. לחץ Get Started
3. עקוב אחר אשף ההגדרה
4. הזן תצורה חדשה

אפשר להגדיר עם אותו ספק או ספק אחר, שם ובסיס ידע.

תצורה מתקדמת

הגדרות ספציפיות לספק

חלק מהספקים מציעים הגדרות נוספות בקונסול:

• מגבלות שימוש – הגדרת מקסימום קריאות API
• מגבלות קצב – שליטה בתדירות הבקשות
• בחירת מודל – בחירת מודלים ספציפיים (אם זמין)

הגדר אלה בקונסול הספק, לא ב-SupportRetriever.

אופטימיזציית בסיס ידע

לשיפור שימוש בבסיס הידע:

• שמור על תיעוד מעודכן
• השתמש בתוכן ברור ובר-חיפוש
• ארגן תוכן לוגית
• וודא נגישות ציבורית

נושאים קשורים

• הגדרת AI Companion – מדריך הגדרה ראשונית
• בחירת ספק AI – השוואת ספקים
• הגדרת בסיס ידע – הגדרת בסיס ידע
• הגדרת MCP – endpoint MCP אופציונלי ומפת שדות
• אבטחה ופרטיות של AI Companion – פרטי אבטחה
• פתרון בעיות ב-AI Companion – בעיות נפוצות