آموزش Vercel: ساخت Agent Harness کدنویسی AI، مسیر پولساز برنامه‌نویسان

Vercel Academy تازه یک دوره کامل منتشر کرده به اسم «Build Your Own AI Coding Agent Harness». این دوره از صفر نشون میده چطور یک فریم‌ورک Agent کدنویسی AI بسازی که واقعاً کار کنه. خبری از آموزش سه‌تا API و دموی ساده نیست؛ اینجا باید حلقه ابزار، هرس زمینه، تفویض به زیرعامل و مدیریت چرخه حیات رو جون بکنی.

برای برنامه‌نویس‌هایی که می‌خوان با AI پروژه بگیرن و درآمد دلاری داشته باشن، این دوره یک نقطه عطفه. آدم‌هایی که با Cursor کد می‌زنن فراوونن، ولی کسی که «فریم‌ورک Agent سفارشی» تحویل بده، قیمت‌های بالاتری می‌گیره.

اول بفهم: Agent Harness چیه

Agent Harness یک داربسته که به AI اجازه میده خودش کار کنه، زمینه رو مدیریت کنه و امنیت رو رعایت کنه — مثل اینه که به AI یک مدیر پروژه + یک نگهبان + یک دفتر یادداشت بدی. بدون Harness، AI فقط یک مدل چت‌گره؛ با Harness، AI مثل یک کارمند جونیور وظیفه می‌گیره، اجرا می‌کنه، گزارش میده و وقتی خطا می‌خوره برمی‌گرده سراغ آدم.

سه ابزار اصلی دوره تقسیم کار واضحی دارن:

  • AI SDK: مسئول حرف زدن AI (صدا زدن مدل، تولید متن)
  • Vercel Sandbox: مسئول دست به کار شدن AI (اجرای امن دستور در محیط ایزوله)
  • just-bash: مسئول فرمان‌برداری AI (رابط ابزار استاندارد برای کنترل رفتار shell)

این سه تا با هم یک کارخانه Agent کامل می‌سازن.

دردسر: چرا Agent تو همیشه در حد دمو می‌مونه

Joel Hooks در ابتدای دوره یک واقعیت تلخ رو می‌گه: «یک حلقه ابزار سه‌تایی فقط یک دموئه، مشکل وقتی خودش رو نشون میده که ببریش سراغ کار واقعی». به Agent بگو یک فایل ۵۰۰۰ خطی بخونه، کل محتوا رو می‌ریزه تو زمینه و دیگه چیزی بیرون نمیاد؛ دسترسی bash بدی، با یک rm -rf کل production رو پاک می‌کنه؛ بیست مرحله کار پشت سر هم بدی، مرحله دهم یادش رفته اصلاً دنبال چی بوده.

مشتری پوسته نمی‌خره، می‌خره که Agent واقعاً کار کنه. ۹۰٪ آموزش‌های «دستیار کدنویسی AI» فقط prompt رو بسته‌بندی می‌کنن، GPT API رو وصل می‌کنن و یک رابط کاربری شیک می‌سازن. ولی پول واقعی رو وقتی می‌دن که Agent بتونه یک زنجیره وظیفه رو امن اجرا کنه — این یک مشکل معماریه، نه یک پارامتر قابل تنظیم.

Vercel با این دوره یک پیام روشن میده: Agent Harness یک محصول مهندسی جدیه، نه یک اسکریپت اسباب‌بازی.

فرصت: مهندس Agent کمیاب‌ترین منبع پروژه‌ست

بازار فریلنسری الان دو قطبی شده. یک سرش «کاربر AI» که فقط با Cursor کد کامل می‌کنه و با قیمت پایین پروژه می‌گیره؛ سر دیگرش مهندسی که «راه‌حل سفارشی AI Agent» تحویل میده و مشتری باید تو صف منتظر بمونه.

چرا؟ چون شرکت‌ها «اتوماسیون گردش کار» می‌خوان، نه «تکمیل کد». یک فروشنده آنلاین نمی‌خواد براش اسکریپت پایتون بنویسی؛ می‌خواد Agent داشته باشه که خودش قیمت رقبا رو رصد کنه، خودش متن لیست محصول رو بنویسه، خودش A/B تست اجرا کنه، خودش گزارش بده. این کار رو فقط کسی می‌تونه بکنه که معماری 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 Abstraction): کلید امنیت.

  • مشکل: Agent با دسترسی bash می‌تونه با rm -rf دیتابیس production رو نابود کنه.
  • راه‌حل: Vercel Sandbox یک محیط اجرای ایزوله میده؛ Agent هرچقدر هم خراب‌کاری کنه، به سرور اصلی نمی‌رسه.
  • تشبیه: مثل هود آزمایشگاه شیمی؛ منفجره هود، نه کل ساختمان.

هرس زمینه (Context Pruning): فایل ۵۰۰۰ خطی رو نمی‌شه همه‌اش ریخت تو prompt.

  • مشکل: AI با خوندن فایل بزرگ حافظه‌اش پر میشه و گفت‌وگوهای قدیمی تصمیم جدید رو آلوده می‌کنه.
  • راه‌حل: با هوک prepareStep قبل از هر قدم، زمینه رو هرس کن؛ فقط N قدم آخر نگه‌دار و خلاصه قدم‌های قدیمی رو جایگزین کن.
  • تشبیه: مثل مرتب کردن اتاق؛ چیزای دم‌دستی رو بذار رو میز، بقیه رو بفرست انباری.

تفویض به زیرعامل (Subagent Delegation): وظیفه پیچیده باید شکسته بشه.

  • مشکل: یک Agent تنها با چند ماژول، زمینه‌اش ترکیده و نقش‌هاش قاطی میشه.
  • راه‌حل: عامل اصلی برنامه‌ریزی می‌کنه، زیرعامل‌ها ماژول خاص رو اجرا می‌کنن و نتیجه رو برمی‌گردونن.
  • تشبیه: مثل مدیر پروژه که کار رو بین فرانت‌اند، بک‌اند و تست تقسیم می‌کنه و فقط پیشرفت و ریسک رو رصد می‌کنه.

مدیریت چرخه حیات (Lifecycle Management): Agent از شروع، اجرا، توقف، ازسرگیری تا خاتمه، هر state نیاز به مدیریت دقیق داره.

  • مشکل: وسط کار طولانی اینترنت قطع میشه، کاربر کنسل می‌کنه، مدل تایم‌اوت میشه و state کامل از دست می‌ره.
  • راه‌حل: هر state رو سریالایز کن و ذخیره کن تا بشه از نقطه قطع ادامه داد یا دخالت انسانی کرد.
  • تشبیه: مثل سیو بازی؛ مردی از آخرین سیو ادامه میده، نه از اول.

مسیر دوم: با استک دوره پروژه بگیر و نمونه کار بساز

تموم کردن دوره آخر خط نیست، اول خطه. باید فوری با ترکیب Vercel AI SDK + Vercel Sandbox + just-bash بری سراغ اولین پروژه واقعی.

سریع‌ترین مسیر کسب درآمد: تو Fiverr، Upwork و فریلنسرها یک سرویس آویزون کن: «با استک Vercel برات Agent سفارشی می‌سازم». سه مشتری اول رو حتی نیم‌بها یا رایگان بزن، فقط به‌خاطر نمونه کار و نظر مشتری.

⚠️ طبق پست منبع، زمان تقریبی انجام سه پروژه رایگان بسته به پیچیدگی Agent از چند روز تا چند هفته متغیر است و به‌طور مستقل تأیید نشده؛ ارزشش به این بستگی داره که بتونی نمونه کار رو به مشتری پولی بعدی تبدیل کنی.

انتخاب نمونه کار مهمه. سراغ «یک چت‌بات برام بساز» نرو. دنبال «اتوماسیون گردش کار» با ارزش بالا برو. مثلاً:

  • برای فروشنده Amazon یک Agent بساز که خودش نظرات رو رصد کنه، کلمات کلیدی نظرات منفی رو استخراج کنه، پیشنهاد بهبود بده و به Slack بفرسته.
  • برای بلاگر Lemon8 یک Agent بساز که خودش پست‌های اکانت‌های مرجع رو بکشه، الگوی پست‌های وایرال رو تحلیل کنه و لیست موضوع پیشنهاد بده.
  • برای توسعه‌دهنده مستقل یک Agent بساز که خودش Issueهای GitHub رو رصد کنه، اولویت‌بندی کنه و PR پیش‌نویس بزنه.

⚠️ طبق پست منبع، بازه قیمت این پروژه‌ها در سطح چند ده میلیون تومان است؛ این عدد به‌طور مستقل تأیید نشده.

شروع سرد: نداشتن مشتری چطور حل میشه

نداشتن شبکه مشتری سازمانی واقعیت اکثر آدم‌هاست. سه کانال مشخص:

  1. پست در کامیونیتی: تو Vibe Coding، Reddit، لینکدین و Lemon8 پست نمونه کار بذار. قالب عنوان: «با Vercel AI SDK برای صنعت X یک Agent ساختم، ماهانه XX ساعت صرفه‌جویی». یک ویدیوی ۳۰ ثانیه‌ای دمو هم کنارش بذار. وقتی ترافیک بیاد، مشتری خودش پیام میده.
  2. نمونه کار رایگان در ازای testimonial: از طریق آشنا یک مشتری کوچک پیدا کن، اولین پروژه فقط ۵۰۰ هزار تومان بگیر ولی شرط کن یک متن توصیه‌نامه بنویسه و اجازه بده نمونه کار رو عمومی کنی.
  3. استراتژی قیمت پلکانی: از پروژه ۵۰۰ هزار تومانی (Agent تک‌ماژول) شروع کن → ۳ میلیون تومان (گردش کار چندماژولی) → ۳۰ میلیون تومان (راه‌حل سفارشی کامل + شش ماه پشتیبانی). هر پله باید با نمونه کار پله قبل پشتیبانی بشه.

مسیر سوم: محتوای دوره رو بازفرآوری کن و تولید محتوا کن

دوره Vercel انگلیسیه و سطح ورودی بالایی داره. دقیقاً همین شکاف اطلاعاتی فرصت توئه.

دوره رو بشکن به ۱۰ تا ۱۵ قسمت آموزشی و بذار تو Lemon8، TikTok، یوتیوب و Substack. عنوان‌هایی مثل: «دوره داخلی Vercel لو رفت: فریم‌ورک Agent واقعاً چطور نوشته میشه»، «حلقه سه‌ابزاری فقط اسباب‌بازیه، Agent واقعی این پنج ماژول رو لازم داره»، «هرس زمینه: تکنیکی که Agent رو از فراموشی نجات میده».

هر ویدیو ۵ تا ۸ دقیقه، یک نکته فنی با دموی کد. پیشنهاد اجرایی:

  • قسمت اول حلقه ابزار، با سه تکه کد (تنظیم generateText + tools در AI SDK، کاربرد stopWhen، نمونه هرس زمینه با prepareStep)، زمان ۷ دقیقه.
  • تست A/B عنوان: «دوره داخلی Vercel لو رفت» در مقابل «راهنمای دستی Agent» رو با ۱۰۰ هزار تومان بودجه تبلیغ تست کن، بعد از دیدن CTR، قالب برنده رو تکرار کن.

زنجیره درآمد سه لایه داره: لایه اول تبلیغات آموزش برنامه‌نویسی؛ لایه دوم فروش دوره، بسته‌بندی همین سری به‌عنوان «دوره عملی مهندس Agent»؛ لایه سوم مشاوره سطح‌بالا برای ساخت تیم Agent در شرکت‌ها. ⚠️ طبق پست منبع، نرخ تبلیغ آموزش برنامه‌نویسی برای اکانت ۱۰ هزار فالوئری در سطح میلیون تومان است؛ این عدد به‌طور مستقل تأیید نشده.

راهنمای انتخاب مسیر: کدوم به درد تو می‌خوره

  • برنامه‌نویس شاغل که دنبال درآمد جانبیه: مسیر دوم + نسخه سبک مسیر سوم. آخر هفته ۱-۲ پروژه کوچک بزن، همزمان فرایند رو ضبط کن و بذار Lemon8. هدف ماهی ۵ تا ۱۰ میلیون تومان.
  • فریلنسر با هدف ماهی ۵۰ میلیون تومان: مسیر دوم با تمرکز کامل. سه ماه اول فقط نمونه کار جمع کن، از ماه چهارم سراغ مشتری با ارزش بالا برو، قیمت متوسط هر پروژه بالای ۳۰ میلیون تومان.
  • دانشجو / تغییر رشته‌ای: اول مسیر اول رو کامل کن، ۵ پروژه دمو بذار GitHub و رزومه بساز، بعد از ۶ ماه سراغ پروژه گرفتن برو.

نمونه: خود دوره Joel Hooks یک الگوئه

Joel Hooks نویسنده دوره Vercel Academy و مدرس «Build Your Own AI Coding Agent Harness» خودش نمونه زنده «درآمدزایی مهندس Agent» است. با تولید آموزش فنی باکیفیت، برند شخصی قوی تو کامیونیتی توسعه‌دهنده‌ها ساخته و محتوای دوره‌اش بارها بازنشر شده.

روشش قابل کپی‌برداریه: استک فنی حول Vercel AI SDK، خروجی «سیستم Agent قابل اجرا» نه «تکه کد». دقیقاً همین کمیاب‌ترین عرضه در بازار پروژه‌های Agent امروزه.

⚠️ درباره داده‌های درآمدی سایر توسعه‌دهندگان مستقل (مثل درآمد ماهانه ۵۰ هزار دلاری یا رشد ۱۲۰ هزار فالوئر در شش ماه)، منبع قابل تأییدی در بسته محتوا موجود نیست و عدد مشخصی ذکر نمیشه.

مسیر صفر تا یک برای مبتدی

اگه حتی Node.js و TypeScript هم نزدیه، این ترتیب رو برو:

  1. ماه اول: Node.js پایه + سینتکس TypeScript + مفاهیم پایه LLM (token چیه، prompt چیه، function calling چیه). منبع فارسی: مستندات رسمی TypeScript، کتاب «دستی مهندس AI».
  2. ماه دوم: فقط ماژول «حلقه ابزار» دوره رو بخون، با quickstart رسمی AI SDK یک دمو راه بنداز.
  3. ماه سوم: ماژول «انتزاع سندباکس» رو اضافه کن، یک Agent بساز که خودش فولدر مرتب کنه.
  4. از ماه چهارم: مسیر دوم یا سوم رو برای کسب درآمد شروع کن.

انتظار واقع‌بینانه: ماه اول فقط ماژول حلقه ابزار، سعی نکن همه‌چیز رو یکجا بخوری. روزی ۲ ساعت وقت بذار، بعد از ۳۰ روز یک زنجیره Agent حداقلی قابل اجرا ساختی.

فراخوان عمل: امشب Vercel Academy رو باز کن

دوره Vercel Academy رایگانه و نیاز به ثبت‌نام پولی نداره. برو به vercel.com/academy و دنبال «Build Your Own AI Coding Agent Harness» بگرد، از اولین ماژول شروع کن.

سعی نکن یکجا تمومش کنی. روزی ۲ ساعت، اول ماژول حلقه ابزار و سندباکس رو حسابی بفهم، بعدش فوری یک محصول حداقلی بساز — حتی اگه فقط یک Agent مرتب‌کننده فولدر باشه.

وقتی بتونی تو ۳۰ دقیقه یک زنجیره کامل «خوندن فایل → تحلیل محتوا → تولید گزارش → نوشتن فایل جدید» بسازی، از ۹۰٪ شرکت‌کننده آموزش‌های AI جلو زدی. از اینجا به بعد، چه بری پروژه بگیری، چه ویدیو ضبط کنی، چه Newsletter بنویسی، محتوای واقعی برای ارائه داری.

امشب Vercel Academy رو باز کن، از ماژول حلقه ابزار شروع کن — ۳۰ روز بعد از خودت امروزی تشکر می‌کنی.