Stevia Store MCP Server

# 🤖 ChatGPT Integration Guide מדריך לחיבור שרת ה-MCP של חנות הסטיביה ל-ChatGPT דרך OpenAI Agents SDK. ## 🎯 סקירה כללית לאחר שOpenAI הודיעה על תמיכה ב-MCP במרץ 2025, כעת ניתן לחבר את שרת ה-MCP שלנו לChatGPT בצורה ישירה דרך OpenAI Agents SDK. ## 📋 דרישות מקדימות ### התקנות נדרשות ```bash # OpenAI Agents SDK pip install openai-agents # תלויות שרת הסטיביה pip install -r requirements.txt # ניהול משתני סביבה pip install python-dotenv ``` ### מפתח API - צריך מפתח OpenAI API מ-[platform.openai.com](https://platform.openai.com) - מודל GPT-4 או GPT-3.5-turbo ## 🚀 הגדרה מהירה ### שלב 1: הכנת הסביבה ```bash # העתקת קובץ הגדרות הדוגמה cp .env.example .env # עריכת הקובץ עם המפתח שלכם nano .env ``` עדכנו את `.env`: ```bash OPENAI_API_KEY=sk-your-actual-openai-api-key-here OPENAI_MODEL=gpt-4 DATABASE_PATH=./stevia_store.db ``` ### שלב 2: אתחול מסד הנתונים ```bash # הרצת סקריפט האתחול python scripts/init_database.py ``` ### שלב 3: הרצת הסוכן ```bash # הרצה אינטראקטיבית python examples/chatgpt_stevia_agent.py # או דוגמה בסיסית python examples/openai_agent_example.py ``` ## 💬 דוגמאות שימוש ### צ'אט בסיסי ```python from examples.chatgpt_stevia_agent import SteviaChatGPTAgent agent = SteviaChatGPTAgent() response = await agent.chat("מה המוצרים שיש לכם?") print(response) ``` ### שאלות נפוצות שהסוכן יכול לטפל בהן: **🛍️ ניהול מוצרים:** - "תראה לי את כל מוצרי הסטיביה" - "מה המחיר של הסטיביה הטבעית?" - "איזה מוצר הכי מתאים לאפיה?" **👥 ניהול לקוחות:** - "רישום לקוח חדש: יוסי כהן, yossi@example.com" - "מה ההיסטוריה של הלקוח מספר 5?" **📦 ניהול מלאי:** - "בדוק איזה מוצרים חסרים במלאי" - "הוסף 50 יחידות למוצר מספר 1" **🛒 עיבוד הזמנות:** - "צור הזמנה ללקוח 3 עם 2 יחידות מוצר 1" - "מה סטטוס ההזמנה 15?" **💊 ייעוץ בריאותי:** - "האם סטיביה בטוחה לסוכרתיים?" - "כמה סטיביה מומלץ לקחת ביום?" **📊 דוחות ואנליטיקה:** - "תן לי סיכום מכירות לשבוע האחרון" - "מה המוצרים הנמכרים ביותר?" ## 🔧 הגדרות מתקדמות ### סינון כלים ```python agent = Agent( model="gpt-4", mcp_servers=[stevia_mcp_server], mcp_tool_filter={ "allowed_tool_names": [ "get_products", "add_customer", "create_order" ], "blocked_tool_names": [ "delete_customer" # למעלה אם רוצים להגביל ] } ) ``` ### הגדרת הוראות מותאמות אישית ```python custom_instructions = """ אתה מומחה סטיביה שמתמחה במכירה ללקוחות דתיים. - תמיד ודא כשרות המוצרים - הזכר שהמוצרים פרווה - הציע חלופות לחגים יהודיים """ ``` ## 🏗️ ארכיטקטורה טכנית ```mermaid graph TD A[ChatGPT/GPT-4] --> B[OpenAI Agents SDK] B --> C[MCP Client] C --> D[MCP Server - Stevia Store] D --> E[SQLite Database] D --> F[Business Logic] F --> G[Product Management] F --> H[Customer Service] F --> I[Order Processing] F --> J[Inventory Control] ``` ## 🔐 אבטחה ורישיונות ### הרשאות API - וודאו שה-API key מוגבל לשימוש הנדרש - השתמשו במשתני סביבה, לא בקוד ### הגנת מידע - מסד הנתונים מקומי ומוגן - אל תשתפו פרטי לקוחות במודל ## 🐛 פתרון בעיות ### שגיאות נפוצות **"OpenAI API key not found"** ```bash export OPENAI_API_KEY=sk-your-key-here # או עדכון בקובץ .env ``` **"MCP server connection failed"** ```bash # בדוק שהשרת רץ python src/stevia_store_server.py # ווידוי נתיב למסד הנתונים ls -la stevia_store.db ``` **"Database not found"** ```bash # אתחל מסד נתונים python scripts/init_database.py ``` ### רישום בעיות (Debugging) ```python import logging logging.basicConfig(level=logging.DEBUG) # הפעל את הסוכן עם לוגים מפורטים agent = SteviaChatGPTAgent() ``` ## 📈 ביצועים ואופטימיזציה ### המלצות למהירות - השתמש ב-GPT-3.5-turbo למענים מהירים - השתמש ב-GPT-4 לניתוח מורכב - אחסן תשובות נפוצות במטמון ### ניהול עלויות - הגבל מספר כלים זמינים - השתמש ב-tool filtering - נטר שימוש ב-OpenAI Dashboard ## 🚀 שלבים הבאים 1. **בדיקות מקצועיות** - הרצה במספר תרחישים 2. **שילוב UI** - יצירת ממשק משתמש 3. **מונטרינג** - מעקב ביצועים וטעויות 4. **הרחבות** - הוספת תכונות מתקדמות --- **נזכר להוסיף ⭐ לריפוזיטורי אם המדריך עזר לכם!**