צ'אטבוט AI
מדריך מקיף לשימוש בצ'אטבוט AI בעברית עם תמיכה במספר מודלים
תכונות הצ'אטבוט
תמיכה מלאה בעברית
ממשק RTL מלא, תשובות בעברית טבעית, תמיכה בניקוד ובמונחים מקצועיים.
החלפת מודלים
בחירה בין Claude, GPT, ו-Gemini באמצע השיחה. כל מודל עם יתרונות שונים.
היסטוריית שיחות
כל השיחות נשמרות ב-DB. חזרה לשיחות קודמות, חיפוש, ומחיקה.
Quick Replies
תגובות מהירות מוגדרות מראש לשאלות נפוצות. ניתן להתאמה אישית.
System Prompts
הגדרת אישיות ה-AI, הנחיות מערכת, ו-context מותאם אישית.
קבצים מצורפים
העלאת מסמכים, תמונות, וקבצים לניתוח על ידי ה-AI.
Quick Replies
Quick Replies הן תגובות מהירות שניתן להגדיר מראש. לחיצה עליהן שולחת את ההודעה מיד:
ניהול Quick Replies
// יצירת Quick Reply חדש
POST /api/chatbot/quick-replies
{
"label": "📊 הצג סטטיסטיקות",
"message": "הצג לי את הסטטיסטיקות של היום",
"category": "דוחות",
"order": 1
}
// קבלת כל ה-Quick Replies
GET /api/chatbot/quick-replies
// עדכון
PUT /api/chatbot/quick-replies/1
{
"label": "📊 סטטיסטיקות יומיות",
"order": 2
}
// מחיקה
DELETE /api/chatbot/quick-replies/1
API שיחות
Endpoints עיקריים
/api/chatbot/conversations
קבלת רשימת שיחות
/api/chatbot/conversations
יצירת שיחה חדשה
/api/chatbot/conversations/{id}/messages
קבלת הודעות בשיחה
/api/chatbot/conversations/{id}/messages
שליחת הודעה חדשה
דוגמת שימוש
// יצירת שיחה חדשה
const response = await fetch('/api/chatbot/conversations', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
title: 'שאלות על מוצרים',
model_id: 1 // Claude Sonnet 4
})
});
const conversation = await response.json();
// שליחת הודעה
const messageResponse = await fetch(
`/api/chatbot/conversations/${conversation.id}/messages`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
content: 'מה המוצר הכי נמכר החודש?',
role: 'user'
})
}
);
// התגובה תכלול את תשובת ה-AI
const result = await messageResponse.json();
console.log(result.assistant_message.content);
System Prompts
System Prompt מגדיר את ההתנהגות והאישיות של ה-AI. ניתן ליצור templates שונים לשימושים שונים:
שירות לקוחות
אתה נציג שירות לקוחות אדיב ומקצועי. ענה בעברית, בצורה תמציתית וברורה. הצע פתרונות מעשיים.
אנליסט עסקי
אתה אנליסט עסקי מנוסה. נתח נתונים, זהה מגמות, והצע תובנות עסקיות מבוססות.
ניהול Prompts
// יצירת System Prompt
POST /api/chatbot/prompts
{
"name": "שירות לקוחות",
"description": "Prompt לנציג שירות",
"content": "אתה נציג שירות לקוחות אדיב...",
"category": "support",
"is_default": false,
"variables": ["customer_name", "company_name"]
}
// שימוש ב-Prompt בשיחה
POST /api/chatbot/conversations
{
"title": "תמיכה בלקוח",
"prompt_id": 1,
"prompt_variables": {
"customer_name": "יוסי",
"company_name": "TechLab"
}
}
מעקב אחר Tokens
המערכת עוקבת אחר צריכת ה-tokens בכל הודעה:
| שדה | תיאור |
|---|---|
input_tokens |
מספר ה-tokens בהודעה שנשלחה |
output_tokens |
מספר ה-tokens בתשובה |
total_cost |
עלות ההודעה בדולרים |
response_time_ms |
זמן התגובה במילישניות |
// דוגמת תגובה עם מידע על tokens
{
"success": true,
"assistant_message": {
"id": 123,
"content": "התשובה של ה-AI...",
"role": "assistant",
"input_tokens": 150,
"output_tokens": 280,
"total_cost": 0.0013,
"response_time_ms": 1250
}
}
טיפים ו-Best Practices
✅ כדאי
- השתמש ב-System Prompt מותאם למשימה
- הגדר Quick Replies לשאלות נפוצות
- עקוב אחר צריכת Tokens
- השתמש ב-Claude לעברית
- שמור שיחות חשובות
❌ להימנע
- שליחת מידע רגיש (סיסמאות, כ"א)
- הודעות ארוכות מדי (tokens יקרים)
- בקשות שאינן קשורות לעסק
- ציפייה ל-100% דיוק
- התעלמות מהתראות תקציב