Browser Copilot هو امتداد للمتصفح يسمح لك باستخدام مساعدي الذكاء الاصطناعي الحاليين أو المصممين خصيصًا لمساعدتك في مهام تطبيقات الويب اليومية.
الهدف هو توفير واجهة مستخدم متعددة الاستخدامات وإطار عمل بسيط لتنفيذ واستخدام مجموعة متزايدة باستمرار من مساعدي الطيارين (مساعدي الذكاء الاصطناعي). يمكن لمساعدي الطيارين المساعدة في مجموعة واسعة من المهام من خلال الاستفادة من إمكانيات امتداد المتصفح.
فيما يلي بعض الأمثلة على ما يمكن لمساعدي الطيارين القيام به:
manifest.json
.json و logo.png
، على سبيل المثال: http://localhost:8000
إذا كان وكيلك يعمل محليًا. يمكنك في أي وقت إغلاق مساعد الطيار لاستئناف المحادثة لاحقًا عن طريق رمز الامتداد أو النقر بزر الماوس الأيمن على الصفحة وتحديد Toggle Browser Copilot
.
إذا كنت لا تعرف أي عناوين URL لمساعد الطيار، فإن هذا المشروع يتضمن تنفيذًا بسيطًا لمساعد الطيار في مجلد الوكيل. يمكنك بدء تشغيله عن طريق نسخ agent/sample.env إلى agent/.env
وتغيير متغيرات البيئة عليه وتشغيل docker-compose up
(يلزم وجود عامل إرساء لهذا الغرض). بمجرد البدء، يمكنك تكوين الامتداد الخاص بك لاستخدامه عن طريق إضافة مساعد طيار بعنوان URL http://localhost:8000
.
عندما تقوم بتنشيط مساعد الطيار (انقر فوق قائمة مساعدي الطيارين)، سيطلب بعض بيانات الاعتماد. استخدم مستخدم test
وكلمة مرور test
لتسجيل الدخول.
في المستقبل، نخطط لإضافة قائمة بمساعدي الطيارين الذين ساهم بهم المجتمع. لذلك، إذا قمت بإنشاء مساعدين طيارين جدد، فيرجى إخبارنا بذلك حتى نتمكن من إدراجهم في الكتالوج الأولي.
لتطوير وكيل جديد، يمكنك الرجوع إلى مجلدات Agent-Mock أو Agent-Simple أو Agent-Extensive Folders. الأحدث هو الأكثر اكتمالًا مع التوثيق المناسب لنقاط النهاية manifest.json
.
بالنسبة لبيئة التطوير، يستخدم هذا المشروع devbox وdirenv.
لتثبيت جميع التبعيات المطلوبة (بعد تثبيت devbox وdirenv)، قم بتشغيل الأمر التالي:
devbox run install
بعد ذلك، قم بتعيين متغيرات البيئة المناسبة في agent-extended/.env
.
لتسريع التطوير، يمكنك التعليق على قسم Keycloak، لذلك لا تحتاج إلى المصادقة في كل مرة تريد فيها تجربة مساعد الطيار الخاص بك في الامتداد. إذا لم تقم بالتعليق على قسم Keycloak، فأنت بحاجة إلى تشغيل
devbox run keycloak
لتدوير Keycloak للمصادقة واستخدام بياناتtest
test
لتسجيل الدخول (عندما يطلبها ملحق المتصفح).
لتشغيل الوكيل في وضع التطوير، وتمكين إعادة التحميل السريع التلقائي عند اكتشاف أي تغييرات في ملفات مصدر الوكيل، قم بتنفيذ الأمر التالي:
devbox run agent
إذا كنت تريد تصحيح أخطاء الوكيل، فيمكنك بدء تشغيل الوكيل باستخدام IDE المفضل لديك، والإشارة إلى البيئة الافتراضية ذات الصلة التي أنشأها devbox، واستخدام إمكانات مصحح الأخطاء في IDE لتشغيل البرنامج النصي الرئيسي.
لمزيد من التفاصيل حول الوكيل، يرجى الرجوع إلى الملف التمهيدي الخاص به.
إذا كنت تخطط للمساهمة في تغييرات على ملحق المتصفح، فارجع إلى مجلد ملحق المتصفح.
لتشغيل متصفح Chrome مزود بإمكانيات إعادة التحميل السريع، استخدم الأمر التالي:
devbox run browser
لتعديل إعدادات المتصفح الافتراضية، راجع browser-extension/vite.config.ts.
لإنشاء التوزيع النهائي للامتداد، قم بتنفيذ الأمر التالي:
devbox run build
نحن نرحب بجميع أنواع المساهمات!