aisyah ai

؟ aisyah ai؟

Aisyah AI هو روبوت برقية قوي تم تصميمه مع عمال CloudFlare يجمع بين قدرات AI المتعددة. يمكنه تصفح الويب ، وتعيين تذكيرات ، والتحدث ، والتنبؤ بالطقس ، وتحليل الصور ، وفهم الرسائل الصوتية. يحافظ الروبوت على السياق في المحادثات من خلال Redis ، مما يجعله مثاليًا لكل من الدردشات الخاصة والتفاعلات الجماعية.

؟ لقطات الشاشة والتوضيح

سمات

• ؟ قدرات الذكاء الاصطناعي المتقدمة

  • فهم اللغة الطبيعية مع نماذج GPT
  • تحليل الصور والتعرف على الكائنات
  • تحويل الكلام إلى النص وتحويل النص إلى كلام
  • محادثات مدركة للسياق في كل من الدردشة الخاصة والمجموعة

• الأدوات الذكية

  • تصفح الويب واسترجاع المعلومات
  • توقعات الطقس في الوقت الحقيقي
  • تذكيرات المهام والإشعارات
  • دعم الدردشة الجماعية مع الاحتفاظ بالسياق

• ☁ الهندسة المعمارية الحديثة

  • بنيت على عمال CloudFlare لارتفاع التوسع
  • بنية الخدمات المجهرية للنموذج
  • تاريخ الدردشة التي تعمل بنظام Redis
  • نشر الخادم غير الفعال من حيث التكلفة

• ؟ تكامل API

  • Openai GPT لمعالجة اللغة
  • بحث مخصص Google عن تصفح الويب
  • OpenWeatherMap لبيانات الطقس
  • Telegram BOT API للرسائل
  • supabase لتخزين الملفات
  • خدمات إضافية لتحسين القدرات

؟ لماذا Openai فقط؟

لقد اخترنا دعم نماذج Openai بشكل حصري (وخاصة GPT-3.5-TURBO و GPT-4O-MINI) لعدة أسباب:

1. اتساق النموذج : توفر نماذج Openai الاستجابات الأكثر اتساقًا وعالية الجودة عبر لغات مختلفة وحالات الاستخدام.
2. فعالية التكلفة : يوفر GPT-4O-Mini توازنًا ممتازًا بين جودة الإخراج والتسعير.
3. القدرة متعددة اللغات : بعد اختبار مكثف ، أظهرت نماذج Openai أداءً فائقًا في التعامل مع لغات متعددة بشكل طبيعي.
4. بساطة التنفيذ : في حين أن خدمات مثل OpenRouter توفر الوصول إلى نماذج مختلفة ، فإن دعمها ستقدم تعقيدًا إضافيًا في تعيينات اسم النموذج ومعالجة الاستجابة.

ملاحظة: نحن نفهم الاهتمام بالنماذج والمقدمين البديلين (مثل OpenRouter ، الأنثروبور ، إلخ). ومع ذلك ، للحفاظ على بساطة الكود وضمان سلوك روبوت ثابت ، قررنا التركيز على عروض Openai. إذا كنت بحاجة إلى استخدام نماذج مختلفة ، فستحتاج إلى تغطية المشروع وتعديل تكوينات النموذج وفقًا لذلك.

الاستخدام

الأوامر الأساسية

• /start - ابدأ التفاعل مع الروبوت
• /settings - تكوين إعدادات الروبوت (نموذج LLM ، شخصية ، صوت ، إلخ)
• /help - احصل على مساعدة حول الأوامر المتاحة

ملاحظة : هذا مشروع شخصي مصمم لأغراض التعلم والتجريب.

هيكل المشروع

تم تنظيم المشروع في عدة خدمات microservices:

• aisyah-ai-telegraph : أوركستور رئيسي يتولى تفاعلات التلقية
• aisyah-ai-agent : Core AI Agent الذي يعالج الطلبات
• aisyah-ai-explorer : إمكانية تصفح الويب
• aisyah-ai-reminder : إدارة التذكير
• aisyah-ai-sonata : خدمة نص إلى كلام
• aisyah-ai-storm : التنبؤ بالطقس
• aisyah-ai-vision : تحليل الصور
• aisyah-ai-whisper : خدمة الكلام إلى النص

بداية سريعة

المتطلبات الأساسية

• Node.js (أوصى إصدار LTS)
• الغزل (v4.3.1 أو أحدث)
• حساب CloudFlare (أعمال الطبقة المجانية)
• Telegram BOT TOKEN
• مفتاح API Openai
• redis مثيل لتاريخ الدردشة (يمكنك استخدام طبقة خالية من Upstash)

تثبيت

1. استنساخ المستودع:

   git clone https://github.com/husniadil/aisyah-ai.git
   cd aisyah-ai

2. تثبيت التبعيات:

   yarn install

3. إعداد CloudFlare: أولاً ، احصل على رمز CloudFlare API:

   1. انتقل إلى https://dash.cloudflare.com/profile/api-tokens
   2. حدد موقع "تحرير العمال CloudFlare" ، ثم "استخدام القالب"
   3. املأ القواعد
   4. انقر فوق "تابع إلى الملخص" وإنشاء الرمز المميز
   5. قم بتصدير الرمز المميز كمتغير للبيئة:

       export CLOUDFLARE_API_TOKEN=your_api_token_here

   6. للتكوين المستمر ، أضفه إلى ملف تعريف shell الخاص بك (~/.zshrc ، ~/.bashrc ، إلخ):

       echo ' export CLOUDFLARE_API_TOKEN=your_api_token_here ' >> ~ /.zshrc

   ملاحظة: لا تستخدم wrangler login لأنه يتعارض مع طريقة مصادقة الرمز المميز API.

4. تكوين ملفات البيئة:

    # Copy Cloudflare configuration files
   cp packages/aisyah-ai-agent/wrangler.toml.example packages/aisyah-ai-agent/wrangler.toml
   cp packages/aisyah-ai-explorer/wrangler.toml.example packages/aisyah-ai-explorer/wrangler.toml
   cp packages/aisyah-ai-reminder/wrangler.toml.example packages/aisyah-ai-reminder/wrangler.toml
   cp packages/aisyah-ai-sonata/wrangler.toml.example packages/aisyah-ai-sonata/wrangler.toml
   cp packages/aisyah-ai-storm/wrangler.toml.example packages/aisyah-ai-storm/wrangler.toml
   cp packages/aisyah-ai-telegraph/wrangler.toml.example packages/aisyah-ai-telegraph/wrangler.toml
   cp packages/aisyah-ai-vision/wrangler.toml.example packages/aisyah-ai-vision/wrangler.toml
   cp packages/aisyah-ai-whisper/wrangler.toml.example packages/aisyah-ai-whisper/wrangler.toml
   
   # Copy environment variables
   cp packages/aisyah-ai-agent/.dev.vars.example packages/aisyah-ai-agent/.dev.vars
   cp packages/aisyah-ai-explorer/.dev.vars.example packages/aisyah-ai-explorer/.dev.vars
   cp packages/aisyah-ai-reminder/.dev.vars.example packages/aisyah-ai-reminder/.dev.vars
   cp packages/aisyah-ai-sonata/.dev.vars.example packages/aisyah-ai-sonata/.dev.vars
   cp packages/aisyah-ai-storm/.dev.vars.example packages/aisyah-ai-storm/.dev.vars
   cp packages/aisyah-ai-telegraph/.dev.vars.example packages/aisyah-ai-telegraph/.dev.vars
   cp packages/aisyah-ai-vision/.dev.vars.example packages/aisyah-ai-vision/.dev.vars
   cp packages/aisyah-ai-whisper/.dev.vars.example packages/aisyah-ai-whisper/.dev.vars

5. تكوين إعدادات الحزمة الخاصة:

   مساحات أسماء CloudFlare KV

   قم بإنشاء مساحات أسماء KV المطلوبة وقم بتدوين معرفاتها:

    # For settings storage
   yarn w aisyah-ai-agent wrangler kv:namespace create SETTINGS
   
   # For chat history
   yarn w aisyah-ai-telegraph wrangler kv:namespace create CHAT_HISTORY
   
   # For reminders
   yarn w aisyah-ai-reminder wrangler kv:namespace create REMINDERS

   تكوينات خاصة الحزمة

   أيزيه آي تليجراف (الروبوت الرئيسي)

    # In packages/aisyah-ai-telegraph/.dev.vars
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   TELEGRAM_BOT_TOKEN=your_telegram_bot_token
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

   Aisyah-AAI-Agent (Core AI)

    # In packages/aisyah-ai-agent/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   LANGCHAIN_API_KEY=your_langchain_api_key
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   AGENT_PERSONA_AISYAH_DEFAULT=your_system_prompt_for_persona_default
   AGENT_PERSONA_AISYAH_JAWIR=your_system_prompt_for_persona_jawir
   AGENT_PERSONA_PERSONAL_ASSISTANT=your_system_prompt_for_persona_personal_assistant

   Aisyah-AA-Rises (تحليل الصور)

    # In packages/aisyah-ai-vision/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   أيزيه آي وايسبر (خطاب إلى نص)

    # In packages/aisyah-ai-whisper/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   أيزيه آي سوناتا (نص إلى كلام)

    # In packages/aisyah-ai-sonata/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   # Get from https://supabase.io
   SUPABASE_URL=your_supabase_project_url
   SUPABASE_KEY=your_supabase_storage_key
   # Get from https://elevenlabs.io
   ELEVENLABS_API_KEY=your_elevenlabs_api_key

   عيسى آي-سايف (الطقس)

    # In packages/aisyah-ai-storm/.dev.vars
   OPEN_WEATHER_MAP_API_KEY=your_openweathermap_api_key

   Aisyah-Ai-explorer (متصفح الويب)

    # In packages/aisyah-ai-explorer/.dev.vars
   # Get from https://programmablesearchengine.google.com/
   GOOGLE_SEARCH_API_KEY=your_google_api_key
   GOOGLE_SEARCH_ENGINE_ID=your_search_engine_id

   أيزيه آي ريميندر (تذكير)

    # In packages/aisyah-ai-reminder/.dev.vars
    REMINDERS_APP_ID=your_reminders_app_id
    REMINDERS_API_KEY=your_reminders_api_key

   تحديث ملفات wrangler.toml

   قم بتحديث wrangler.toml من كل حزمة مع معرفات مساحة اسم KV المقابلة من الخطوة السابقة:

    # In packages/aisyah-ai-telegraph/wrangler.toml
   kv_namespaces = [
     { binding = " CHAT_HISTORY " , id = " your_chat_history_namespace_id " }
   ]
   
   # In packages/aisyah-ai-agent/wrangler.toml
   kv_namespaces = [
     { binding = " SETTINGS " , id = " your_settings_namespace_id " }
   ]
   
   # In packages/aisyah-ai-reminder/wrangler.toml
   kv_namespaces = [
     { binding = " REMINDERS " , id = " your_reminders_namespace_id " }
   ]

6. نشر العمال:

   yarn deploy

7. قم بإعداد روبوت Telegram:

   • إنشاء روبوت جديد مع botfather
   • اضبط عنوان URL لـ WebHook على نقطة نهاية عامل CloudFlare الخاص بك
   • قم بتكوين إعدادات BOT من خلال واجهة دردشة Telegram

تطوير

البرامج النصية المتاحة

• yarn w : تشغيل الأوامر الخاصة بمساحة العمل
• yarn deploy : نشر جميع العمال
• yarn types : إنشاء أنواع typescript
• yarn format : رمز التنسيق باستخدام Biome

إضافة ميزات جديدة

1. قم بإنشاء حزمة جديدة في دليل packages
2. قم بتنفيذ الميزة الخاصة بك باستخدام عمال CloudFlare
3. أضف التكوين في wrangler.toml
4. قم بتسجيل القدرة الجديدة في aisyah-ai-agent

؟ إعداد إضافي

تكوين redis

1. قم بإعداد مثيل redis:

   • قم بإنشاء قاعدة بيانات Redis مجانية في Upstash
   • احصل على url url url redis وتفاصيل المصادقة

2. تكوين redis في بيئتك:

    # Add to packages/aisyah-ai-telegraph/.dev.vars
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

مفاتيح API المطلوبة

تأكد من الحصول على مفاتيح API وتكوينها:

• مفتاح API Openai لـ LLM وقدرات الرؤية
• مفتاح Langchain API لمعالجة اللغة المحسنة
• مفتاح API OpenWeatherMap لتوقعات الطقس
• مشروع Supabase ومفاتيح التخزين لمعالجة الملفات

أضفها إلى ملفات .dev.vars في كل حزمة.

❗ استكشاف الأخطاء وإصلاحها

القضايا المشتركة

1. فشل نشر العمال

   • تأكد من أن الرمز المميز لـ CloudFlare API لديه أذونات صحيحة
   • تحقق مما إذا كانت أسماء العمال في wrangler.toml فريدة من نوعها
   • تحقق من صحة ارتباطات مساحة الاسم KV

2. الروبوت لا يستجيب

   • تأكيد تم تعيين url webhook بشكل صحيح
   • تحقق من صحة رمز Telegram Bot
   • تحقق من اتصال Redis يعمل

3. ميزات لا تعمل

   • تأكد من أن جميع مفاتيح واجهة برمجة التطبيقات المطلوبة صالحة وتكوينها بشكل صحيح
   • تحقق من سجلات العمال المقابلة في لوحة معلومات CloudFlare
   • تحقق من ضبط متغيرات البيئة بشكل صحيح

وضع التصحيح

تمكين وضع التصحيح عن طريق الإعداد:

 # Add to .dev.vars
DEBUG_MODE=true

سيوفر هذا سجلات أكثر تفصيلاً في وحدة التحكم في العمال.

الحصول على المساعدة

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

1. تحقق من صفحة المشكلات
2. مراجعة سجلات العمال CloudFlare
3. تمكين وضع التصحيح لمزيد من التسجيل التفصيلي

رخصة

تم ترخيص هذا المشروع بموجب ترخيص معهد ماساتشوستس للتكنولوجيا - راجع ملف الترخيص للحصول على التفاصيل.