Skip to content

OPENAI_SETUP.md

Latest commit

 

History

History
247 lines (181 loc) · 5.87 KB

OPENAI_SETUP.md

File metadata and controls

247 lines (181 loc) · 5.87 KB

🤖 دليل ربط الذكاء الاصطناعي (OpenAI API)

📋 المتطلبات

لتفعيل المحادثة الذكية، تحتاج إلى:

  1. ✅ حساب OpenAI
  2. ✅ API Key من OpenAI
  3. ✅ رصيد في الحساب ($5 على الأقل)

🔑 الخطوة 1: الحصول على API Key

1. إنشاء حساب OpenAI

  1. اذهب إلى: https://platform.openai.com
  2. اضغط "Sign Up"
  3. سجل باستخدام:
    • البريد الإلكتروني
    • أو حساب Google
    • أو حساب Microsoft
  4. أكد البريد الإلكتروني

2. إضافة رصيد

  1. اذهب إلى: https://platform.openai.com/settings/organization/billing
  2. اضغط "Add payment method"
  3. أضف بطاقة ائتمان
  4. اشحن $5 على الأقل (يكفي لآلاف المحادثات!)

3. إنشاء API Key

  1. اذهب إلى: https://platform.openai.com/api-keys
  2. اضغط "Create new secret key"
  3. اختر اسم (مثل: "Chinese Bot")
  4. انسخ المفتاح فوراً! (لن تراه مرة أخرى)
  5. احفظه في مكان آمن

مثال على API Key:

sk-proj-abc123xyz456...

⚙️ الخطوة 2: إضافة API Key للبوت

على Render.com:

  1. اذهب إلى Render Dashboard
  2. اختر خدمة البوت
  3. اضغط "Environment" من القائمة اليسرى
  4. اضغط "Add Environment Variable"
  5. أضف المتغير: 
    Key: OPENAI_API_KEY
Value: sk-proj-abc123xyz456... (مفتاحك)
  6. احفظ التغييرات
  7. Render سيعيد النشر تلقائياً

محلياً (للاختبار):

  1. افتح ملف .env (أو أنشئه)
  2. أضف السطر: 
    OPENAI_API_KEY=sk-proj-abc123xyz456...
  3. احفظ الملف
  4. شغّل البوت: 
    python bot_enhanced.py

🧪 الخطوة 3: اختبار المحادثة الذكية

1. افتح البوت على تليجرام

2. أرسل الأمر:

/ai_chat

3. اختر الوضع:

  • 🎓 معلم - للتعلم والتصحيح
  • 💬 محادثة - للممارسة
  • 🔤 مترجم - للترجمة

4. ابدأ الكتابة!

مثال:

أنت: 你好
البوت: 你好！很高兴见到你！
       (مرحباً! سعيد برؤيتك!)

5. إنهاء المحادثة:

/stop_ai

💰 التكلفة

الأسعار (GPT-4o-mini):

  • المدخلات: $0.15 لكل مليون token
  • المخرجات: $0.60 لكل مليون token

ترجمة عملية:

  • محادثة واحدة (10 رسائل): ~$0.001 (أقل من سنت!)
  • 100 محادثة: ~$0.10 (10 سنت)
  • 1000 محادثة: ~$1 (دولار واحد)

$5 تكفي لـ ~5000 محادثة! 🎉

🔒 الأمان

⚠️ احذر:

  1. لا تشارك API Key مع أحد
  2. لا تنشره على GitHub (استخدم .env)
  3. فعّل حد الإنفاق في OpenAI

تفعيل حد الإنفاق:

  1. اذهب إلى: https://platform.openai.com/settings/organization/limits
  2. اضغط "Usage limits"
  3. حدد الحد الأقصى (مثل: $10 شهرياً)
  4. احفظ

🛠️ استكشاف الأخطاء

خطأ: "Invalid API Key"

الحل:

  • تأكد من نسخ المفتاح كاملاً
  • تحقق من عدم وجود مسافات زائدة
  • أنشئ مفتاح جديد

خطأ: "Insufficient quota"

الحل:

  • أضف رصيد في حساب OpenAI
  • تحقق من حد الإنفاق

خطأ: "Rate limit exceeded"

الحل:

  • انتظر دقيقة
  • قلل عدد الرسائل المتزامنة

البوت لا يرد في وضع AI

الحل:

  • تحقق من وجود OPENAI_API_KEY
  • شاهد logs في Render
  • جرب /stop_ai ثم /ai_chat مرة أخرى

📊 مراقبة الاستخدام

في OpenAI Dashboard:

  1. اذهب إلى: https://platform.openai.com/usage
  2. شاهد:
    • عدد الطلبات
    • التكلفة اليومية
    • الاستخدام الشهري

🎯 الإعدادات المتقدمة

تغيير النموذج:

في ملف ai_chat_feature.py، يمكنك تغيير:

model="gpt-4o-mini"  # رخيص وسريع (موصى به)
# أو
model="gpt-4o"       # أذكى لكن أغلى
# أو  
model="gpt-3.5-turbo"  # أرخص لكن أقل ذكاءً

تغيير درجة الحرارة (الإبداع):

temperature=0.7  # متوازن (افتراضي)
# أو
temperature=0.3  # أكثر دقة، أقل إبداع
# أو
temperature=1.0  # أكثر إبداعاً، أقل دقة

✅ قائمة التحقق

  • إنشاء حساب OpenAI
  • إضافة رصيد ($5+)
  • إنشاء API Key
  • إضافة المفتاح إلى Render
  • إعادة نشر البوت
  • اختبار /ai_chat
  • تفعيل حد الإنفاق

🎉 بعد الإعداد

البوت الآن يدعم:

  • ✅ محادثة ذكية بالصينية
  • ✅ تصحيح الأخطاء تلقائياً
  • ✅ شرح القواعد
  • ✅ ترجمة فورية
  • ✅ 3 أوضاع مختلفة

استمتع بالمحادثة الذكية! 🤖✨

📞 الدعم

إذا واجهت مشاكل:

  1. راجع هذا الدليل
  2. شاهد logs في Render
  3. تحقق من OpenAI Dashboard
  4. اتصل بالمشرفين

🔗 روابط مفيدة

ملاحظة: المحادثة الذكية اختيارية! البوت يعمل بدونها، لكنها تضيف ميزة رائعة للمتعلمين. 🌟