ניהול פרומפטים (Prompt Management)

מערכת הפרומפטים מאפשרת להתאים את התנהגות הצ'אטבוט, להגדיר הנחיות מערכת, הקשרים שונים ותבניות תגובה - הכל דרך ממשק גרפי נוח או API.

סוגי פרומפטים
System Prompt
פרומפט מערכת

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

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

מידע ספציפי לשיחה נוכחית - קונטקסט של לקוח, חשבונית או תיקון פעיל.

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

תבניות מוכנות לתגובות נפוצות עם משתנים דינמיים.

  • תגובות ברכה
  • תשובות שגיאה
  • סיכומי מידע
  • הנחיות למשתמש
פרומפט מערכת - דוגמה מלאה
System Prompt פעיל
אתה עוזר AI חכם של מערכת TechLabs - מערכת ניהול עסק לחנות מחשבים וסלולר. תפקידך: - לסייע לעובדים ולמנהלים בשאילתות על לקוחות, חשבוניות, תיקונים ומלאי - לספק מידע מדויק ומעודכן מהמערכת - לענות בעברית בסגנון מקצועי וידידותי יכולות: 1. לקוחות: חיפוש לקוחות, בדיקת יתרה, היסטוריית רכישות 2. חשבוניות: פרטי חשבונית, חשבוניות פתוחות, סיכומים 3. תיקונים: סטטוס תיקון, תור תיקונים, היסטוריה 4. מלאי: בדיקת מלאי, מחירים, מוצרים חסרים 5. דוחות: סיכום יומי, מכירות, לקוחות מובילים הנחיות: - ענה תמיד בעברית - השתמש בפורמט ברור עם emoji מתאימים - אם חסר מידע - בקש הבהרה - אל תמציא מידע - רק מידע מהמערכת - הצע עזרה נוספת בסוף כל תשובה פורמט תגובות: - השתמש ב-bullet points לרשימות - הדגש מספרים וסכומים - הוסף קו מפריד בין חלקים
משתנים זמינים:
{{business_name}} {{current_date}} {{user_name}} {{user_role}} {{available_functions}}
פרומפטי הקשר (Context Prompts)

פרומפטי הקשר מוזרקים אוטומטית כאשר השיחה מקושרת ללקוח, חשבונית או תיקון ספציפי:

הקשר לקוח
השיחה הנוכחית מתייחסת ללקוח: - שם: {{customer_name}} - טלפון: {{customer_phone}} - יתרה: {{customer_balance}} ₪ - תיקונים פתוחים: {{open_repairs}} - לקוח מאז: {{customer_since}}
הקשר חשבונית
השיחה מתייחסת לחשבונית: - מספר: {{invoice_number}} - לקוח: {{invoice_customer}} - סכום: {{invoice_total}} ₪ - סטטוס: {{invoice_status}} - תאריך: {{invoice_date}}
תבניות תגובה (Response Templates)

תבניות מוכנות לתגובות נפוצות:

שם תבנית שימוש דוגמת תבנית
greeting ברכה ראשונית שלום {{user_name}}! 👋 איך אפשר לעזור?
customer_balance יתרת לקוח 💰 יתרת {{customer_name}}: {{balance}} ₪
repair_status סטטוס תיקון 🔧 תיקון {{repair_id}}: {{status_text}}
not_found לא נמצא ❌ לא נמצא {{entity_type}} עם {{search_term}}
error שגיאה ⚠️ אירעה שגיאה. נסה שוב או פנה לתמיכה.
help_offer הצעת עזרה 💡 עוד משהו שאוכל לעזור בו?
ניהול פרומפטים דרך API
רשימת כל הפרומפטים
GET /api/mcp-chatbot/prompts
// Response { "success": true, "prompts": [ { "id": 1, "name": "system_default", "type": "system", "content": "אתה עוזר AI חכם...", "is_active": true, "variables": ["business_name", "user_name"] } ] }
יצירת פרומפט חדש
POST /api/mcp-chatbot/prompts
// Request { "name": "custom_greeting", "type": "response", "content": "שלום וברוכים הבאים ל-{{business_name}}! 🌟\nאני כאן לעזור לך ב:\n• חיפוש לקוחות\n• בדיקת חשבוניות\n• סטטוס תיקונים\n\nאיך אפשר לעזור?", "is_active": true } // Response { "success": true, "prompt": { "id": 5, "name": "custom_greeting", "type": "response", "created_at": "2024-11-24T10:30:00Z" } }
עדכון פרומפט
PUT /api/mcp-chatbot/prompts/{id}
// Request { "content": "תוכן מעודכן...", "is_active": true }
מחיקת פרומפט
DELETE /api/mcp-chatbot/prompts/{id}
משתנים זמינים (Variables)

משתנים שניתן להשתמש בהם בתוך פרומפטים:

משתנה תיאור דוגמת ערך זמינות
{{business_name}} שם העסק TechLabs תמיד
{{current_date}} תאריך נוכחי 24/11/2024 תמיד
{{current_time}} שעה נוכחית 14:30 תמיד
{{user_name}} שם המשתמש המחובר ישראל ישראלי תמיד
{{user_role}} תפקיד המשתמש מנהל / עובד תמיד
{{customer_name}} שם הלקוח בהקשר משה כהן הקשר לקוח
{{customer_phone}} טלפון הלקוח 0501234567 הקשר לקוח
{{customer_balance}} יתרת הלקוח 2,500 הקשר לקוח
{{invoice_number}} מספר חשבונית 12345 הקשר חשבונית
{{invoice_total}} סכום חשבונית 1,170 הקשר חשבונית
{{repair_id}} מספר תיקון R-2024-001 הקשר תיקון
{{repair_status}} סטטוס תיקון בתיקון הקשר תיקון
שיטות עבודה מומלצות
כתיבת פרומפט מערכת
  • הגדר את התפקיד והיכולות בברור
  • ציין את השפה והסגנון הרצוי
  • הגדר מה הבוט לא צריך לעשות
  • תן דוגמאות לפורמט תגובות
  • השאר מקום לגמישות במקרי קצה
שימוש במשתנים
  • השתמש במשתנים במקום hardcoded values
  • בדוק שהמשתנה זמין בהקשר הנדרש
  • הוסף ערכי ברירת מחדל למקרה שחסר
  • תעד את כל המשתנים שבשימוש
  • נסה את הפרומפט עם ערכים שונים
נקודות לתשומת לב
  • אל תכלול מידע רגיש (סיסמאות, API keys) בפרומפטים
  • בדוק היטב לפני הפעלת פרומפט חדש בייצור
  • שמור גרסאות קודמות לפני עדכון
  • הגבל את מספר הפרומפטים הפעילים למניעת בלבול
ניהול דרך ממשק המשתמש

ניתן לנהל פרומפטים גם דרך ממשק הגדרות הצ'אטבוט:

  1. היכנס לעמוד הצ'אטבוט (/mcp-chatbot)
  2. לחץ על כפתור הגדרות
  3. בחר בלשונית פרומפטים
  4. ערוך את הפרומפט הרצוי ולחץ שמור
Prompt Settings UI