GreenHomeBack/src/GreenHome.AI.DeepSeek/QUICKSTART.md

🚀 راهنمای سریع شروع - 5 دقیقه!

مرحله 1: دریافت API Key (2 دقیقه)

1. به https://platform.deepseek.com بروید
2. روی "Sign Up" کلیک کنید (یا Login اگر قبلاً ثبت‌نام کرده‌اید)
3. وارد Dashboard شوید
4. از منوی سمت چپ، گزینه "API Keys" را انتخاب کنید
5. روی "Create API Key" کلیک کنید
6. یک نام برای کلید انتخاب کنید (مثلاً "GreenHome")
7. کلید را کپی کنید ⚠️ (فقط یک بار نمایش داده می‌شود!)

مرحله 2: تنظیم API Key (1 دقیقه)

فایل appsettings.json را باز کنید و API Key را جایگزین کنید:

{
  "DeepSeek": {
    "ApiKey": "اینجا-کلید-خود-را-بگذارید"
  }
}

مرحله 3: اجرای برنامه (1 دقیقه)

cd GreenHome.Api
dotnet run

مرحله 4: تست API (1 دقیقه)

با Swagger:

1. مرورگر را باز کنید: http://localhost:5000/swagger
2. endpoint /api/ai/ask را باز کنید
3. روی "Try it out" کلیک کنید
4. این را در Body بگذارید:

{
  "question": "سلام! آیا کار می‌کنی؟"
}

5. روی "Execute" کلیک کنید
6. پاسخ را ببینید! ✅

با Curl:

curl -X POST http://localhost:5000/api/ai/ask \
  -H "Content-Type: application/json" \
  -d '{"question":"سلام! آیا کار می‌کنی؟"}'

با Postman:

1. Postman را باز کنید
2. یک درخواست POST جدید بسازید
3. URL: http://localhost:5000/api/ai/ask
4. Headers: Content-Type: application/json
5. Body (raw JSON):

{
  "question": "سلام! آیا کار می‌کنی؟"
}

6. Send را بزنید!

🎉 تبریک! شما آماده‌اید!

اکنون می‌توانید از AI در پروژه خود استفاده کنید.

مثال‌های آماده برای تست:

1. سوال درباره خانه هوشمند:

{
  "question": "چگونه می‌توانم مصرف برق خانه را کاهش دهم؟"
}

2. دریافت پیشنهاد:

Endpoint: POST /api/ai/suggest

{
  "deviceContext": "دمای اتاق: 28 درجه، رطوبت: 65%، ساعت: 14:00"
}

3. سوال با زمینه خاص:

{
  "question": "بهترین دمای کولر برای خواب چیست؟",
  "systemPrompt": "شما یک متخصص خانه هوشمند و بهینه‌سازی انرژی هستید."
}

❓ مشکل دارید؟

خطا: 401 Unauthorized

• ✅ بررسی کنید API Key را صحیح کپی کرده‌اید
• ✅ فاصله اضافی ندارد
• ✅ در appsettings.json به درستی قرار دارد

خطا: Connection Refused

• ✅ مطمئن شوید برنامه اجرا شده است (dotnet run)
• ✅ پورت صحیح است (معمولاً 5000 یا 5001)

خطا: 429 Too Many Requests

• ✅ کمی صبر کنید (1-2 دقیقه)
• ✅ تعداد درخواست‌های شما زیاد بوده است

📚 مستندات بیشتر

• مستندات کامل: README.md
• راهنمای استفاده: USAGE_FA.md
• خلاصه پروژه: SUMMARY.md

🎯 مرحله بعدی

اکنون می‌توانید:

1. ✅ از AI در Controller های خود استفاده کنید
2. ✅ پیشنهادات هوشمند برای کاربران ارائه دهید
3. ✅ تحلیل داده‌های سنسورها را انجام دهید
4. ✅ چت‌بات هوشمند بسازید

موفق باشید! 🚀