MCP Integration

ה-MCP Chatbot נמצא בכתובת: /mcp-chatbot

מה זה MCP?

Model Context Protocol (MCP) הוא פרוטוקול שמאפשר ל-AI לבצע פעולות במערכת בצורה מבוקרת ומאובטחת.

פונקציות זמינות

להלן הפונקציות שה-AI יכול להפעיל:

{
    "name": "search_customers",
    "parameters": {
        "query": "יוסי כהן",
        "limit": 10
    }
}

{
    "name": "create_customer",
    "parameters": {
        "name": "יוסי כהן",
        "phone": "050-1234567",
        "email": "yossi@example.com"
    }
}

{
    "name": "search_repairs",
    "parameters": {
        "customer_id": 123,
        "status": "in_progress"
    }
}

{
    "name": "update_repair_status",
    "parameters": {
        "repair_id": 456,
        "status": "completed",
        "notes": "תיקון הושלם בהצלחה"
    }
}

{
    "name": "check_inventory",
    "parameters": {
        "item_name": "מסך iPhone 14",
        "warehouse_id": 1
    }
}

{
    "name": "create_invoice",
    "parameters": {
        "customer_id": 123,
        "repair_id": 456,
        "items": [
            {"description": "החלפת מסך", "price": 500}
        ]
    }
}

{
    "name": "get_daily_report",
    "parameters": {
        "date": "2025-12-01",
        "type": "sales"
    }
}

System Prompts למודולים

לכל מודול יש System Prompt ייעודי שמכוון את ה-AI:

# System Prompt - מודול לקוחות

אתה עוזר חכם למערכת TechLab.
כשמבקשים ממך לחפש לקוח, השתמש בפונקציה search_customers.
כשמבקשים ממך ליצור לקוח, השתמש בפונקציה create_customer.

## פונקציות זמינות:
- search_customers(query, limit) - חיפוש לקוחות
- get_customer(id) - קבלת פרטי לקוח
- create_customer(name, phone, email) - יצירת לקוח
- update_customer(id, data) - עדכון לקוח

## הנחיות:
1. תמיד אשר עם המשתמש לפני יצירת רשומות חדשות
2. הצג תוצאות בפורמט ברור
3. אם אין תוצאות, הצע חלופות

ניהול Prompts

// קבלת כל ה-Prompts
GET /api/mcp-chatbot/prompts

// יצירת Prompt חדש
POST /api/mcp-chatbot/prompts
{
    "module": "customers",
    "name": "חיפוש לקוחות",
    "content": "אתה עוזר חכם...",
    "is_active": true
}

// עדכון Prompt
PUT /api/mcp-chatbot/prompts/1
{
    "content": "תוכן מעודכן..."
}

Knowledge Base

ה-Knowledge Base מכיל מידע שה-AI יכול להשתמש בו לתשובות:

// הוספת ידע
POST /api/mcp-chatbot/knowledge
{
    "category": "faq",
    "question": "מה שעות הפעילות?",
    "answer": "אנחנו פתוחים א'-ה' 9:00-18:00, ו' 9:00-13:00",
    "tags": ["שעות", "פעילות", "זמינות"]
}

// חיפוש בידע
GET /api/mcp-chatbot/knowledge/search?q=שעות פעילות

יומן פעולות (Action Logs)

כל פעולה שה-AI מבצע נרשמת ביומן:

// קבלת יומן פעולות
GET /api/mcp-chatbot/actions?conversation_id=1&limit=50

// תגובה
{
    "actions": [
        {
            "id": 1,
            "function_name": "search_customers",
            "parameters": {"query": "יוסי"},
            "result": {"found": 3, "customers": [...]},
            "status": "success",
            "executed_at": "2025-12-01T12:30:45"
        }
    ]
}

אבטחה והרשאות

רמות הרשאה

הגבלות

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