Vercel يكشف لك سر بناء AI Coding Agent Harness من الصفر — دورة المحترفين لتحقيق الدخل

Vercel يكشف لك سر بناء AI Coding Agent Harness من الصفر — دورة المحترفين لتحقيق الدخل
RichardsonVercel Academy أطلقت للتو دورة كاملة بعنوان “Build Your Own AI Coding Agent Harness”، تشرح بالتفصيل كيف تبني من الصفر إطار عمل لـ AI Coding Agent قادر على تنفيذ مهام حقيقية. هذي مو دورة سطحية تعلمك تستدعي 3 APIs وتشغّل Demo، هذي دورة تاخذك لعمق حلقات الأدوات، تقليم السياق، تفويض الوكلاء الفرعيين، وإدارة دورة الحياة.
بالنسبة للمهندسين اللي يبون يطلعون دخل من خدمات الذكاء الاصطناعي، هذي الدورة علامة فاصلة: أي شخص يقدر يكتب كود بـ Cursor موجود بالآلاف، لكن اللي يقدر يسلم “إطار Agent مخصص” يقدر يفرض أسعار أعلى بكثير من الفريلانسر العادي.
أول شي: وش هو Agent Harness بالضبط؟
Agent Harness هو هيكل يخلّي الـ AI يشتغل لحاله، يدير السياق لحاله، ويأمن نفسه لحاله — يعني كأنه مدير مشروع + مسؤول أمان + دفتر ملاحظات للـ AI. بدون Harness، الـ AI مجرد نموذج يحكي؛ مع Harness، الـ AI يصير موظف مبتدئ يستلم مهام، ينفذها، يبلّغ عنها، ويرجع للإنسان لما يطيح.
الدورة تستخدم ثلاث أدوات بتقسيم واضح:
- AI SDK: يخلي الـ AI يتكلم (يستدعي النماذج ويولّد النصوص)
- Vercel Sandbox: يخلي الـ AI يشتغل (ينفذ الأوامر في بيئة معزولة)
- just-bash: يخلي الـ AI يطيع (واجهة أدوات موحدة تتحكم بسلوك الـ Agent)
الثلاثة مع بعض يصنعون مصنع Agent متكامل.
المشكلة: ليش الـ Agent اللي تكتبه يبقى على مستوى Demo؟
Joel Hooks في بداية الدورة فضح واقع الصناعة المحرج: “حلقة أدوات بثلاث أدوات مجرد Demo، المشكلة تطلع لما تاخذه لمهام حقيقية”. تخلّي الـ Agent يقرأ ملف 5000 سطر، يحطه كامل في السياق، وما يقدر يطلع نتيجة؛ تعطيه صلاحيات bash، فينفذ rm -rf على بيئة الإنتاج؛ تخلّيه ينفذ عشرين خطوة متتالية، فينسى وش يسوي عند الخطوة العاشرة.
العميل ما يدفع للقشرة، يدفع لأن الـ Agent يشتغل فعلاً. 90% من “دورات مساعد البرمجة بالذكاء الاصطناعي” تعلمك تغلّف البرومبت، توصل GPT API، وتسوي واجهة أمامية فخمة. لكن الشركات تدفع فعلياً لأن الـ Agent يقدر ينفذ سلسلة مهام كاملة بأمان — هذي مشكلة معمارية، مو مشكلة ضبط معاملات.
طموح دورة Vercel واضح: تعامل مع Agent Harness كمنتج هندسي جدي، مو سكريبت لعبة.
الفرصة: مهندس الـ Agent صار أندر مورد في سوق الفريلانس
سوق الفريلانس اليوم فيه انقسام واضح. طرف أول “مستخدمين AI” يعرفون يكملون كود بـ Cursor بأسعار رخيصة؛ طرف ثاني مهندسين يقدرون يسلّمون “حلول AI Agent مخصصة” بأسعار أعلى بكثير، والعملاء يستنون عندهم.
ليش؟ لأن الشركات تبي “سير عمل تلقائي”، مو “إكمال كود”. تاجر إلكترونيات يبي Agent يسحب أسعار المنافسين تلقائياً، يولّد نصوص Listings، يشغّل A/B Testing، ويطلع تقارير — مو يكتب له سكريبت Python. هذا النوع من الشغل ما يقدر يسويه إلا اللي يفهم معمارية Agent Harness.
⚠️ حسب المصدر، متوسط أسعار مشاريع “AI agent customization” على Upwork بآلاف الدولارات، لكن ما تم التحقق منه بشكل مستقل.
المسار الأول: استوعب وحدات الدورة الأساسية، وابنِ ميزة تنافسية تقنية
أغلى الوحدات في المنهج، لازم تستوعبها وحدة وحدة. كل وحدة نشرحها بثلاث جمل: المشكلة → الحل → التشبيه:
حلقة الأدوات (Tool Loop): قلب الـ Agent النابض.
- المشكلة: استدعاء الأدوات يفشل، يعلّق، أو يصير تعارض عند التشغيل المتوازي فينهار الـ Agent.
- الحل: AI SDK يستخدم شرط
stopWhenللتحكم بنهاية الحلقة، معmaxStepsلتحديد أقصى عدد خطوات، ومعالجة تلقائية لإعادة المحاولة. - التشبيه: مثل منظم إيقاع خط الإنتاج في المصنع، أي خطأ يوقف الخط وما يخلّي المنتج المعيب يعدي للمرحلة الجاية.
تصميم الأدوات (Tool Design): دقة الأدوات تحدد سقف قدرات الـ Agent.
- المشكلة: دقة خشنة تخلي الـ Agent ما يسوي شغل دقيق، دقة ناعمة تضيعه في متاهة استدعاءات الأدوات.
- الحل: فكّك “التعامل مع الملفات” لخمس أدوات ذرية: read، write، edit، glob، grep، بدل ما تعطيه bash شامل.
- تشبيه: مثل ما تعطي الموظف أدوات متخصصة (مفتاح، مفك، مثقاب)، بدل ما تعطيه المراب كامل.
تجريد الـ Sandbox: مفتاح الأمان.
- المشكلة: الـ Agent لو وصل لـ bash يقدر ينفذ
rm -rfعلى قاعدة بيانات الإنتاج. - الحل: Vercel Sandbox يوفر بيئة تنفيذ معزولة، الـ Agent يتخبط فيها بدون ما يأثر على الجهاز المضيف.
- تشبيه: مثل خزانة الشفط في مختبر الكيمياء — اللي ينفجر الخزانة، مو المبنى كامل.
تقليم السياق (Context Pruning): ملف 5000 سطر ما ينحط كامل في البرومبت.
- المشكلة: الـ AI لما يقرأ 5000 سطر ينفجر دماغه، والمحادثات القديمة تلوّث القرارات الجديدة.
- الحل: استخدم خطاف
prepareStepلقص السياق قبل كل خطوة، احتفظ بآخر N خطوات + ملخص مضغوط للمحتوى القديم. - تشبيه: مثل ما ترتّب غرفتك، تحط الأشياء اللي ما تحتاجها في المخزن، وتخلي على الطاولة بس اللي تحتاجه اليوم.
تفويض الوكلاء الفرعيين (Subagent Delegation): المهام المعقدة لازم تنقسم.
- المشكلة: وكيل واحد يتعامل مع مهام متعددة السياقات ينفجر، وتختلط مسؤولياته.
- الحل: الوكيل الرئيسي يخطط، الوكلاء الفرعيين ينفذون وحدات محددة، والنتائج ترجع للرئيسي.
- تشبيه: مثل مدير المشروع يوزع الشغل على فرونت إند، باك إند، تيستنق، وهو يراقب التقدم والمخاطر بس.
إدارة دورة الحياة (Lifecycle Management): الـ Agent من التشغيل، التشغيل، الإيقاف المؤقت، الاستئناف، للإنهاء — كل حالة تحتاج إدارة دقيقة.
- المشكلة: مهمة طويلة تنقطع في النص، المستخدم يلغي، النموذج يعلّق — حالة الـ Agent تضيع كلها.
- الحل: خزّن كل حالة بشكل متسلسل (serialized)، يدعم الاستئناف من النقطة والتدخل البشري.
- تشبيه: مثل حفظ اللعبة — تموت وترجع من أقرب نقطة حفظ، بدل ما تبدأ من الصفر.
المسار الثاني: استخدم حزمة تقنيات الدورة في الفريلانس، وابنِ مشاريع نموذجية
تعلّم الدورة مو النهاية، هذي البداية. لازم فوراً تستخدم Vercel AI SDK + Vercel Sandbox + just-bash، وتاخذ أول مشروع حقيقي.
أسرع طريق للدخل: انشر خدمتك على Fiverr و Upwork: “أخصص لك AI Agent بتقنيات Vercel”. أول ثلاث عملاء ممكن تشتغل بنص السعر أو مجاناً مقابل Case Study وتقييم.
⚠️ حسب المصدر، تنفيذ ثلاث مشاريع مجانية ياخذ من أيام لأسابيع حسب تعقيد الـ Agent، ما تم التحقق منه بشكل مستقل؛ جدوى هذا يعتمد على قدرتك تحوّل الحالات لعملاء يدفعون لاحقاً.
اختيار المشاريع النموذجية له فن. لا تقبل “سوّ لي شات بوت” — طلبات رخيصة ومنتشرة. اقبل “أتمت سير عملي التشغيلي” — طلبات عالية القيمة. أمثلة:
- لبائع تجارة إلكترونية: Agent يراقب تقييمات Amazon تلقائياً، يستخرج كلمات التقييمات السلبية، يولّد اقتراحات تحسين، ويرسلها لـ Slack.
- لصانع محتوى على Lemon8: Agent يسحب منشورات الحسابات المنافسة، يحلل أنماط المحتوى الفيروسي، ويولّد قائمة مواضيع تلقائياً.
- لمطور مستقل: Agent يراقب GitHub Issues، يصنّفها حسب الأولوية، ويولّد مسودات PR تلقائياً.
⚠️ حسب المصدر، أسعار هذا النوع من المشاريع بآلاف الدولارات، ما تم التحقق منه بشكل مستقل.
بداية باردة: ما عندك شبكة عملاء؟
أغلب الناس يبدأون بدون شبكة. ثلاث قنوات عملية:
- انشر في المجتمعات: انشر حالات في Vibe Coding، Substack، Lemon8، بقالب عنوان: “سويت Agent بـ Vercel AI SDK لمجال XX، وفّرت XX ساعة شهرياً”، مع فيديو عرض 30 ثانية. لما يجي الترافيك العملاء يبونك أنت.
- شغل مجاني مقابل شهادة: من عميل يعرفه صديق، خذ أول مشروع بـ 500 ريال/درهم/دينار بس بشرط يكتب لك توصية + يسمح لك تنشر الحالة.
- استراتيجية التسعير المتدرج: من 500 وحدة صغيرة (Agent وحدة واحدة) → 3000 وحدة متوسطة (سير عمل متعدد الوحدات) → 30,000 وحدة كبيرة (حل مخصص كامل + صيانة 6 شهور). كل قفزة تحتاج دعم من حالات المستوى السابق.
المسار الثالث: أعد تدوير محتوى الدورة في自媒体، واصنع دخل من المحتوى
دورة Vercel بالإنجليزي، ومستواها عالي. هذي بالضبط فجوتك المعلوماتية.
قطّع الدورة لـ 10-15 حلقة، وانشرها على Lemon8، TikTok، Substack. عناوين مقترحة: “تسريب من دورة Vercel الداخلية: كيف تكتب إطار AI Agent”، “حلقة ثلاث أدوات مجرد لعبة، الـ Agent الحقيقي يحتاج خمس وحدات”، “تقليم السياق: التقنية اللي تخلي الـ Agent ما ينسى”.
كل فيديو 5-8 دقائق، يشرح نقطة تقنية وحدة، مع عرض كود. خطة تنفيذية:
- الحلقة الأولى: حلقة الأدوات، مع 3 مقاطع كود (إعداد
generateText+toolsفي AI SDK، استخدامstopWhen، مثالprepareStepلتقليم السياق)، المدة 7 دقائق. - اختبار A/B للعناوين: جرّب “تسريب من دورة Vercel الداخلية” مقابل “دليل كتابة إطار AI Agent” بحملة إعلانية صغيرة، شوف معدل النقر (CTR)، وكرّر القالب الفائز.
ثلاث طبقات للدخل: الطبقة الأولى إعلانات تعليم برمجي؛ الطبقة الثانية بيع دورة “مهندس AI Agent عملي”؛ الطبقة الثالثة استشارات عليا تساعد الشركات تبني فرق Agent. ⚠️ حسب المصدر، حساب بـ 10 آلاف متابع يقدر ياخذ إعلان تعليم برمجي واحد بآلاف الوحدات المحلية، ما تم التحقق منه بشكل مستقل.
دليل اختيار المسار: أي مسار يناسبك؟
- مبرمج موظف يبي دخل جانبي: المسار الثاني + نسخة خفيفة من الثالث. استخدم عطلة نهاية الأسبوع لمشروع أو مشروعين، وسجّل العملية كفيديوهات قصيرة على Lemon8، هدفك 5-10 آلاف وحدة شهرياً.
- فريلانسر يبي 50 ألف وحدة شهرياً: تعمّق في المسار الثاني. 3 شهور بداية باردة، أول 3 شهور ما ترفض أي عميل بس تكدّس حالات، من الشهر الرابع ابدأ انتقِ عملاء عالي القيمة، متوسط سعر المشروع 30,000+.
- طالب / شخص يبي يغير مساره: ابدأ بالمسار الأول واستوعب الدورة، اطلع 5 مشاريع Demo على GitHub، بعد 6 شهور فكّر بالفريلانس.
حالة: دورة Joel Hooks نفسها نموذج جاهز
Joel Hooks مؤلف الدورة في Vercel Academy، والمقدم الرئيسي لـ “Build Your Own AI Coding Agent Harness”. هو نفسه حالة حية لـ “مهندس Agent يطلّع دخل” — ببناء محتوى تقني عالي الجودة، بنى علامة شخصية قوية في مجتمع المطورين، ودورته تنتشر بشكل واسع.
أسلوبه قابل للتطبيق: التقنية الأساسية Vercel AI SDK، والمخرجات “نظام Agent قابل للتشغيل” مو “مقتطفات كود”. هذا بالضبط أندر عرض في سوق فريلانس الـ Agent اليوم.
⚠️ بخصوص بيانات دخل مطورين مستقلين محددة (مثل 50 ألف دولار شهرياً، 120 ألف متابع في 6 شهور)، ما توفرت مصادر قابلة للتحقق في المواد، فما نورد أرقام محددة.
مسار المبتدئ الكامل
لو ما لمست Node.js / TypeScript من قبل، اتبع هذا الترتيب:
- الشهر الأول: أساسيات Node.js + قواعد TypeScript + مفاهيم LLM الأساسية (وش هو token، وش هو prompt، وش هو function calling). مصادر مقترحة بالعربي: دورة TypeScript من مصادر معروفة، “دليل مهندس الذكاء الاصطناعي”.
- الشهر الثاني: ركّز على وحدة “حلقة الأدوات” من الدورة، مع Quickstart الرسمي لـ AI SDK شغّل Demo.
- الشهر الثالث: أضف وحدة “تجريد Sandbox”، واصنع Agent يرتّب ملفات تلقائياً.
- من الشهر الرابع: ابدأ تجربة المسار الثاني أو الثالث للدخل.
توقع واقعي: الشهر الأول ركّز على وحدة “حلقة الأدوات” بس، لا تحاول تستوعب كل شي مرة وحدة. ساعتين يومياً، بعد 30 يوم تقدر تبني أصغر سلسلة Agent قابلة للتشغيل.
دعوة للعمل: افتح Vercel Academy الليلة
دورة Vercel Academy مجانية ومفتوحة، ما تحتاج حساب مدفوع. روح لـ vercel.com/academy وابحث عن “Build Your Own AI Coding Agent Harness”، ادخل صفحة الدورة، وابدأ من أول وحدة.
لا تحاول تستوعبها كلها مرة وحدة. ساعتين يومياً، استوعب وحدة “حلقة الأدوات” و”تجريد Sandbox” أول شي، وبعدين فوراً ابني أصغر منتج قابل للتشغيل — حتى لو مجرد Agent يرتّب ملفات تلقائياً.
لما تقدر في 30 دقيقة تبني سلسلة Agent كاملة: “يقرأ ملف → يحلل المحتوى → يولّد تقرير → يكتبه في ملف جديد”، وقتها تكون تجاوزت 90% من “طلاب دورات البرمجة بالذكاء الاصطناعي”. في هذي المرحلة، الفريلانس، فيديوهات المحتوى، وكتابة المقالات كلها تصير بمخرجات حقيقية.
افتح Vercel Academy الليلة، وابدأ بوحدة “حلقة الأدوات” — بعد 30 يوم بتشكر نفسك.






