agentic platform

منصة الذكاء الاصطناعي في متناول اليد (مشروع بحثي)

ملحوظة

كان AI in Hand Platform عبارة عن مشروع بحثي يستكشف سير العمل متعدد الوكلاء. لا تتم صيانته بشكل نشط حاليًا.

AI in Hand Platform عبارة عن واجهة برمجة تطبيقات مفتوحة المصدر وتطبيق ويب لإدارة سير العمل متعدد الوكلاء المعتمد على LLM. بناءً على واجهة برمجة تطبيقات المساعدين الخاصة بـ OpenAI، فإنه يوفر بيئة تعاونية لتطوير فرق الذكاء الاصطناعي واختبارها ونشرها. تم إنشاء النظام الأساسي باستخدام FastAPI وهو مستوحى من مشروعين مفتوحي المصدر: Agency-Swarm من VRSEN لتجريدات الواجهة الخلفية المفيدة، وAutoGen Studio UI من Microsoft لتخطيط واجهة المستخدم والمكونات القابلة للتخصيص.

الميزات الرئيسية

• إدارة التكوين : إدارة التكوينات مركزيًا للوكالات والوكلاء والمهارات.
• المهارات المخصصة : قم بتزويد عملاء الذكاء الاصطناعي بالمهارات المتخصصة.
• الثبات والتخزين المؤقت : استخدم Firestore لاستمرار التكوين.
• API وWebSocket : تفاعل مع النظام الأساسي من خلال نقاط نهاية API وWebSocket للاتصال في الوقت الفعلي.
• الأمان : مصادقة المستخدمين باستخدام مصادقة Firebase وتشفير متغيرات المستخدم.

ابدء

لإعداد AI in Hand Platform محليًا، اتبع الخطوات التالية:

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

    git clone https://github.com/bonk1t/agentic-platform.git
   

2. إعداد الواجهة الخلفية:

   • انتقل إلى الدليل backend .
   • تثبيت التبعيات المطلوبة:

     pip install -r requirements.txt

     أو لأغراض التطوير:

     poetry install

   • قم بإعداد متغيرات البيئة الضرورية (راجع .env.testing ، وأعد تسميته إلى .env ).
   • تشغيل التطبيق:

     uvicorn main:app --reload

   • يمكن الوصول إلى واجهة برمجة التطبيقات الخلفية على http://localhost:8000 .

3. إعداد الواجهة الأمامية:

   • انتقل إلى دليل frontend .
   • تثبيت التبعيات اللازمة:

     npm install

   • قم بإعداد متغيرات البيئة (راجع .env.default ، وأعد تسميته إلى .env.development ).
   • قم بإعداد مصادقة Firebase وFirestore وقم بتحديث ملف الواجهة الأمامية/src/firebase/firebaseConfig.json بتكوين مشروع Firebase الخاص بك.
   • ابدأ خادم التطوير:

     yarn start

   • سيكون تطبيق الواجهة الأمامية متاحًا على http://localhost:3000 .

لمزيد من التفاصيل حول تشغيل وتطوير الواجهة الخلفية والواجهة الأمامية، راجع ملفات README الخاصة بكل منها:

• التمهيدي الخلفي
• الملف التمهيدي للواجهة الأمامية

الخلفية

تم إنشاء الواجهة الخلفية لـ AI in Hand Platform باستخدام FastAPI وتوفر وظائف متنوعة، بما في ذلك إدارة الوكالات والوكلاء والمهارات والجلسات ومتغيرات المستخدم. إنه يتكامل مع قاعدة بيانات Google Firestore لاستمرار التكوين.

للحصول على معلومات مفصلة حول الواجهة الخلفية، بما في ذلك هيكل المشروع ووثائق واجهة برمجة التطبيقات (API) والمهارات المخصصة وإرشادات المساهمة، يرجى الرجوع إلى ملف README الخاص بالواجهة الخلفية.

الواجهة الأمامية

تم تصميم الواجهة الأمامية لمنصة AI in Hand باستخدام React وتوفر واجهة سهلة الاستخدام للتفاعل مع النظام الأساسي. فهو يستفيد من Gatsby للإعداد السريع والتكوينات الغنية، وTailwindCSS للتصميم، وAnt Design لمكونات واجهة المستخدم.

للحصول على معلومات تفصيلية حول الواجهة الأمامية، بما في ذلك تشغيل واجهة المستخدم في وضع التطوير، ونظرة عامة على قاعدة التعليمات البرمجية، وعناصر التصميم، وتعديل واجهة المستخدم، وإضافة الصفحات، والاتصال بالواجهة الخلفية، يرجى الرجوع إلى الملف التمهيدي للواجهة الأمامية.

المساهمة

نرحب بمساهمات المجتمع لتحسين منصة الذكاء الاصطناعي في اليد. للمساهمة:

1. شوكة المستودع.
2. أنشئ فرعًا جديدًا لميزتك أو لإصلاح الأخطاء.
3. قم بإجراء تغييراتك وألزمها برسائل وصفية.
4. ادفع تغييراتك إلى مستودعك المتشعب.
5. أرسل طلب سحب إلى المستودع الرئيسي.

يرجى التأكد من أن التعليمات البرمجية الخاصة بك تتبع معايير ترميز المشروع وتتضمن اختبارات لأي وظيفة جديدة.

رخصة

تم ترخيص منصة AI in Hand الأساسية بموجب ترخيص Affero General Public License (AGPL)، مما يعزز التحسينات التي يقودها المجتمع بموجب نفس الترخيص من أجل خلق جو تطوير مفتوح وتعاوني.

المحتوى الذي ينشئه المستخدم (UGC):

• مهارات بايثون : سيتم المساهمة بكود بايثون لمهارات وكيل الذكاء الاصطناعي في مستودع كود المصدر بموجب AGPL بعد مراجعة أمنية، حيث يتم تنفيذ هذه المهارات من جانب الخادم.
• مساعد الذكاء الاصطناعي وتكوينات الفريق وبيانات المستخدم الأخرى : تظل التكوينات وبيانات المستخدم ملكًا للمستخدمين، ما لم يتم نشرها طوعًا. وهذا يحافظ على حقوق ملكية المستخدمين أثناء الاستفادة من ميزات النظام الأساسي مفتوحة المصدر.

تنصل

هذا مشروع مفتوح المصدر قيد التطوير النشط. بينما نسعى جاهدين لتحقيق الجودة، قد تكون هناك أخطاء أو مشكلات. استخدم على مسؤوليتك الخاصة.

إذا كانت لديك أية أسئلة أو كنت بحاجة إلى المساعدة، فلا تتردد في التواصل مع فريقنا من خلال أداة موقعنا الإلكتروني أو عن طريق إنشاء مشكلة أو مناقشة في هذا المستودع. ترميز سعيد!