دليل Friday: بناء وكيل ذكاء اصطناعي شخصي لتشغيل المهام تلقائياً مع موافقة بشرية
AI personal operations platform for supervised, evidence-backed automation.
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو Friday؟
- من يحتاج Friday ومن لا؟
- المميزات الرئيسية
- المتطلبات الأساسية
- تركيب Friday خطوة بخطوة
- شرح ملف .env والإعدادات
- تشغيل Friday واستخدامه
- أخطاء شائعة وحلولها
- استخدامات عملية (أمثلة للمطور السعودي)
- هل يستحق التجربة؟
- بدائل مشابهة
- أسئلة شائعة
قبل أن تطبق
الفكرة التي تمنع التسرع
تخيل أن لديك مساعداً ذكياً لا ينفذ أي مهمة دون موافقتك، ويوثق كل خطوة، ويمكنك التراجع عن أي إجراء. هذا هو Friday.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل تحتاج إلى أتمتة مهام متكررة مع تحكم كامل وموافقة بشرية؟
- هل تفضل تشغيل الأداة محلياً للحفاظ على خصوصية بياناتك؟
- هل لديك معرفة أساسية بـ Node.js أو Docker لتثبيت الأداة؟
- هل تبحث عن حل مجاني ومفتوح المصدر بدلاً من الاشتراكات الشهرية؟
- هل تحتاج إلى سجل إثبات لكل خطوة ينفذها الوكيل؟
- هل تخطط لاستخدام Friday مع API حكومي أو خدمات خارجية؟
- هل تريد إشعارات وتحكم عن بعد عبر Telegram؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت تبحث عن وكيل ذكاء اصطناعي ينفذ المهام تحت إشرافك، مع سجل إثبات لكل خطوة، فFriday هو الحل. هذا المشروع مفتوح المصدر يتيح لك بناء مساعد شخصي يعمل محلياً، يوافق على المهام قبل تنفيذها، ويحتفظ بسجل يمكنك الرجوع إليه. في هذا الدليل، ستتعلم تركيبه واستخدامه عملياً مع أمثلة تناسب المطور العربي وصاحب المشروع الصغير.
ما هو Friday؟
Friday هو منصة تشغيل ذكاء اصطناعي شخصية (Personal AI Operations Platform) مفتوحة المصدر. يسمح لك بإعطاء أهداف (Goals) للوكيل، فيقوم باستخدام أدواته المتاحة لتنفيذها، مع طلب الموافقة على كل خطوة حساسة. النتيجة موثقة وقابلة للتراجع. يعمل محلياً (Local-first) ولا يرسل بياناتك لسحابات خارجية إلا إذا سمحت بذلك.
من يحتاج Friday ومن لا؟
يناسب: المطورين الذين يريدون أتمتة مهام متكررة (نسخ احتياطي، نشر، مراقبة) مع تحكم كامل. أصحاب المشاريع الصغيرة الذين يحتاجون مساعداً ذكياً دون اشتراكات شهرية. صانعي المحتوى التقني الذين يريدون تجربة أدوات جديدة.
لا يناسب: المبتدئين تماماً في البرمجة (يحتاج معرفة أساسية بـ Node.js أو Docker). من يريد حلاً سحابياً جاهزاً دون إعداد. من لا يحتاج أتمتة معقدة أو يفضل أدوات مثل Zapier.
المميزات الرئيسية
- مفتوح المصدر (MIT License) – مجاني بالكامل.
- يعمل محلياً – بياناتك على جهازك.
- الموافقة البشرية إلزامية – لا ينفذ شيئاً دون إذنك.
- سجل إثبات (Evidence) – كل خطوة موثقة.
- قابلية التراجع (Rollback) – يمكنك إلغاء الإجراءات.
- يدعم Docker و npm – خيارات تركيب متعددة.
- تكامل مع Telegram – إشعارات وتحكم عن بعد.
- قابل للتوسع – يمكن إضافة أدوات جديدة.
المتطلبات الأساسية
- Node.js 18+ (لتركيب npm)
- Docker و Docker Compose (لتركيب Docker)
- مفتاح API من OpenAI (أو مزود آخر مدعوم)
- نظام تشغيل: Linux, macOS, Windows (مع WSL2)
- معرفة أساسية بسطر الأوامر
تركيب Friday خطوة بخطوة
الخيار 1: التركيب عبر npm
npm install -g @thesongzhu/fridayبعد التثبيت، قم بإعداد ملف .env (انظر القسم التالي). ثم شغل الأمر:
friday startالخيار 2: التركيب عبر Docker
git clone https://GitHub.com/thesongzhu/Friday.git
cd Friday
docker compose -f docker/docker-compose.yml up --buildهذا الخيار يشمل جميع الخدمات المساعدة (قاعدة بيانات، إلخ).
شرح ملف .env والإعدادات
أنشئ ملف .env في المجلد الرئيسي للمشروع. المحتوى النموذجي:
OPENAI_API_KEY=sk-xxxx
FRIDAY_LOG_LEVEL=info
FRIDAY_PORT=3000
TELEGRAM_BOT_TOKEN= (اختياري)OPENAI_API_KEY: مفتاح API من OpenAI (مطلوب).FRIDAY_LOG_LEVEL: مستوى التسجيل (debug, info, warn, error).FRIDAY_PORT: المنفذ المحلي (الافتراضي 3000).TELEGRAM_BOT_TOKEN: توكن بوت تيليغرام (اختياري للإشعارات).
تشغيل Friday واستخدامه
بعد التركيب والإعداد، شغل Friday. افتح المتصفح على http://localhost:3000. ستظهر واجهة بسيطة. اكتب هدفك (Goal) مثل: "انسخ قاعدة البيانات MySQL المحلية إلى مجلد /backup كل يوم". Friday سيطلب موافقتك على كل خطوة. يمكنك رؤية السجل والإثباتات في الواجهة.
أخطاء شائعة وحلولها
استخدامات عملية (أمثلة للمطور السعودي)
مثال 1: نسخ احتياطي تلقائي لقاعدة بيانات مع إشعار Telegram
الهدف: "انسخ قاعدة بيانات MySQL المحلية إلى مجلد /backup كل يوم الساعة 2 صباحاً، وأرسل تأكيداً عبر Telegram". Friday سينفذ بعد موافقتك الأولى، ثم يعمل تلقائياً.
مثال 2: أتمتة نشر تحديثات موقع ويب
الهدف: "عند تحديث مستودع GitHub، اسحب التغييرات، شغل الاختبارات، ثم انشر على السيرفر بعد موافقتي".
مثال 3: تكامل مع API حكومي سعودي
الهدف: "أرسل رسالة واتساب عبر واجهة وزارة الاتصالات لكل عميل جديد في قاعدة البيانات". (يتطلب تكويد الأداة المخصصة).
هل يستحق التجربة؟
نعم، إذا كنت تبحث عن أتمتة ذكية مع تحكم كامل وخصوصية. العيوب: يحتاج بعض الإعداد، لا يدعم كل اللغات بشكل كامل، يعتمد على OpenAI حالياً. لكنه مجاني ومفتوح المصدر، ويوفر ميزة الموافقة البشرية التي تفتقر لها أدوات أخرى.
بدائل مشابهة
- n8n: أتمتة سير عمل، لكن بدون ذكاء اصطناعي مدمج.
- AutoGPT: وكيل ذكاء اصطناعي، لكن بدون موافقة بشرية إلزامية.
- Zapier: سحابي ومغلق المصدر، باشتراك شهري.
- CrewAI: لتنسيق عدة وكلاء، لكن أكثر تعقيداً.
أسئلة شائعة
هل Friday مجاني بالكامل؟
نعم، المشروع مفتوح المصدر برخصة MIT. قد تحتاج لدفع مقابل استخدام OpenAI API.
هل يمكن استخدام Friday مع نماذج ذكاء اصطناعي غير OpenAI؟
حالياً يدعم OpenAI فقط، لكن المشروع يخطط لدعم مزودين آخرين.
كيف أضمن أمان بياناتي؟
Friday يعمل محلياً، ولا يرسل بياناتك خارجياً إلا إذا استخدمت أدوات تتطلب ذلك (مثل API خارجي).
هل يدعم Friday اللغة العربية؟
الواجهة بالإنكليزية، لكن يمكن إعطاء الأهداف بالعربية إذا كان النموذج يدعمها (GPT-4 يدعم العربية).
ماذا أفعل إذا واجهت خطأ في التركيب؟
راجع قسم الأخطاء الشائعة أعلاه، أو افتح issue في GitHub.
هل يمكن تشغيل Friday على سيرفر خاص؟
نعم، يمكن تشغيله على أي سيرفر يدعم Docker أو Node.js.
ما الفرق بين Friday وأدوات مثل n8n أو Zapier؟
Friday يركز على الذكاء الاصطناعي والموافقة البشرية، بينما n8n و Zapier يركزان على سير العمل بدون ذكاء اصطناعي.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
تثبيت المتطلبات الأساسية
لماذا؟ Friday يحتاج إلى Node.js 18+ أو Docker ليعمل، ومفتاح API من OpenAI للذكاء الاصطناعي.
كيف؟ تأكد من تثبيت Node.js 18+ (node -v) أو Docker و Docker Compose. احصل على مفتاح API من OpenAI.
الناتج: بيئة جاهزة للتثبيت.
تثبيت Friday عبر npm أو Docker
لماذا؟ طريقتان للتثبيت تناسب أنظمة مختلفة.
كيف؟ للتركيب عبر npm: npm install -g @thesongzhu/friday. للتركيب عبر Docker: git clone https://github.com/thesongzhu/Friday.git ثم cd Friday ثم docker compose -f docker/docker-compose.yml up --build
الناتج: Friday مثبت وجاهز للتشغيل.
إعداد ملف .env
لماذا؟ يحتوي على الإعدادات الأساسية مثل مفتاح API ومستوى التسجيل.
كيف؟ أنشئ ملف .env في مجلد المشروع وأضف: OPENAI_API_KEY=sk-xxxx FRIDAY_LOG_LEVEL=info FRIDAY_PORT=3000 (اختياري TELEGRAM_BOT_TOKEN=...)
الناتج: Friday مهيأ للتشغيل.
تشغيل Friday وفتح الواجهة
لماذا؟ لبدء الخدمة والتفاعل مع الوكيل.
كيف؟ شغل الأمر: friday start (npm) أو تأكد من تشغيل Docker. افتح المتصفح على http://localhost:3000
الناتج: واجهة Friday تعمل.
إعطاء هدف للوكيل
لماذا؟ الهدف هو المهمة التي سينفذها الوكيل بموافقتك.
كيف؟ اكتب هدفاً مثل: 'انسخ قاعدة البيانات MySQL المحلية إلى مجلد /backup كل يوم' ثم انتظر طلب الموافقة.
الناتج: الوكيل يبدأ بتنفيذ المهمة خطوة بخطوة.
مراجعة السجل والإثباتات
لماذا؟ للتأكد من صحة التنفيذ وإمكانية التراجع.
كيف؟ في الواجهة، راجع سجل الخطوات والإثباتات (Evidence). استخدم خيار التراجع إذا لزم الأمر.
الناتج: تنفيذ موثق وقابل للتراجع.
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=sk-xxxx FRIDAY_LOG_LEVEL=info FRIDAY_PORT=3000 # TELEGRAM_BOT_TOKEN=your_telegram_bot_token
انسخ قاعدة البيانات MySQL المحلية إلى مجلد /backup كل يوم الساعة 2 صباحاً، وأرسل تأكيداً عبر Telegram.
عند تحديث مستودع GitHub، اسحب التغييرات، شغل الاختبارات، ثم انشر على السيرفر بعد موافقتي.
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت مطوراً وتريد أتمتة مهام متكررة مع تحكم كامل
إذن: Friday مناسب لك، جرب التثبيت عبر npm.
إذا: إذا كنت صاحب مشروع صغير وتحتاج مساعداً ذكياً دون اشتراكات
إذن: Friday مناسب، استخدم Docker للتثبيت السهل.
إذا: إذا كنت مبتدئاً تماماً في البرمجة
إذن: قد لا يناسبك Friday، ابدأ بأدوات أبسط مثل Zapier.
إذا: إذا كنت تفضل حلاً سحابياً جاهزاً
إذن: Friday ليس مناسباً، استخدم Zapier أو n8n السحابي.
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت المتطلبات (Node.js/Docker) والحصول على مفتاح OpenAI API.
- اليوم 2: تثبيت Friday عبر npm أو Docker.
- اليوم 3: إعداد ملف .env وتشغيل Friday.
- اليوم 4: تجربة هدف بسيط (مثل نسخ ملف) ومراجعة السجل.
- اليوم 5: تجربة هدف معقد (مثل نسخ احتياطي لقاعدة بيانات) مع إشعار Telegram.
- اليوم 6: اختبار التراجع عن إجراء والتأكد من سجل الإثبات.
- اليوم 7: توثيق التجربة ومشاركتها مع المجتمع.
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. Friday هو مشروع مفتوح المصدر برخصة MIT.
2. يعمل محلياً ولا يرسل بياناتك لسحابات خارجية إلا إذا سمحت.
3. الموافقة البشرية إلزامية لكل خطوة حساسة.
4. يحتفظ بسجل إثبات (Evidence) لكل خطوة.
5. يدعم التراجع (Rollback) عن الإجراءات.
6. يمكن تركيبه عبر npm أو Docker.
7. يتكامل مع Telegram للإشعارات والتحكم عن بعد.
8. يتطلب Node.js 18+ أو Docker و Docker Compose.
9. يدعم حالياً OpenAI API فقط.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
برنامج يعمل بتقنية الذكاء الاصطناعي ينفذ مهام محددة بناءً على أهداف يحددها المستخدم، مع إمكانية الموافقة البشرية.
توثيق لكل خطوة ينفذها الوكيل، يمكن الرجوع إليه للتحقق من صحة التنفيذ.
إلزامية موافقة المستخدم قبل تنفيذ أي إجراء حساس من قبل الوكيل.
إمكانية إلغاء الإجراءات التي نفذها الوكيل والعودة إلى الحالة السابقة.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من متلقٍ لأخبار التقنية إلى مطبق عملي يركب ويستخدم وكيل ذكاء اصطناعي بنفسه.
- إدارة المشاريع: يمكن استخدام Friday لأتمتة مهام项目管理.
- التسويق: أتمتة نشر المحتوى على وسائل التواصل.
- العمليات: نسخ احتياطي ومراقبة الأنظمة.
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
Friday يمنحك تحكماً كاملاً في أتمتة المهام مع ذكاء اصطناعي. جربه اليوم، وشارك تجربتك مع المجتمع العربي. لا تنسَ مراجعة المصادر الرسمية على GitHub لأحدث التحديثات.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحديث مفتاح OpenAI API إذا انتهت صلاحيته.
- مراجعة إصدار Friday الجديد على GitHub كل شهر.
- تحديث ملف .env عند تغيير الإعدادات.
- إضافة أدوات جديدة مخصصة حسب الحاجة.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇