vibe-coding-college-specs/chapters/15-product-evolution/06-lesson-building-agentic-workflows/spec.md

مشخصات درس‌نامه: ساخت گردش‌کارهای ایجنتیک خودکار (Agentic Workflows) و الگوهای چندایجنت

• شناسه در سیلابس: L15.7
• فصل: فصل ۱۵: تکامل محصول با AI (Ch 15)
• نوع محتوا: 📘 درس‌نامه متنی
• زمان تقریبی مطالعه: ۱۸ دقیقه
• پیش‌نیازهای مستقیم: L15.6 (تزریق قابلیت‌های پیشرفته هوش مصنوعی)

---

۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)

دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:

• درک کند (Understand): تفاوت بنیادین میان «پرامپت تک‌مرحله‌ای ساده» (یک سوال \rightarrow یک جواب) با «گردش‌کارهای ایجنتیک چندمرحله‌ای» (برنامه‌ریزی \rightarrow فراخوانی ابزارها \rightarrow بازخورد و خودارزیابی \rightarrow تصمیم‌گیری خودمختار) را شرح دهد.
• تحلیل/ارزیابی کند (Evaluate): چهار الگوی کلیدی طراحی سیستم‌های ایجنتیک (بازتاب و خودانتقادی Reflection، استفاده از ابزارها Tool Use، برنامه‌ریزی Planning، و همکاری چندایجنت Multi-Agent Collaboration) را تحلیل کند.
• به‌کار ببندد (Apply): یک گردش‌کار خودکار «پاسخ‌گویی هوشمند به درخواست همکاری» طراحی کند که با دریافت پیام کارفرما، سوابق پروژه‌های مرتبط را از دیتابیس استخراج کرده و پیش‌نویس یک پروپوزال رسمی را برای تایید ادمین آماده سازد.
• ایجاد کند (Create): یک مکانیسم ایمن نظارت انسانی (Human-in-the-Loop) پیاده کند تا هیچ ایمیل یا تصمیم حساسی بدون تایید نهایی شخص سازنده برای مخاطب ارسال نشود.

---

۲. محدوده و مرزهای محتوا (Scope & Boundaries)

آنچه باید پوشش داده شود (In-Scope):

1. گذار از دستیار چت به سیستم‌های خودمختار همکار:
   • چرا دیگر دوره چت‌های معمولی گذشته و سیستم‌هایی که زنجیره‌ای از کارها را پشت سر هم انجام می‌دهند آینده نرم‌افزار هستند.
2. الگوهای ۴ گانه اندرو ان‌جی (Andrew Ng) برای سیستم‌های ایجنتیک:
   • الگوی ۱: بازتاب و بازبینی خودکار (Reflection)؛ ایجنت خروجی خود را نقد و عیب‌یابی می‌کند.
   • الگوی ۲: استفاده از ابزارها (Tool / Function Calling)؛ ایجنت می‌تواند وب را بگردد، دیتابیس را بخواند یا تابع بفرستد.
   • الگوی ۳: برنامه‌ریزی گام‌به‌گام (Planning)؛ شکستن هدف کلی به تسک‌های خرد ترتیبی.
   • الگوی ۴: همکاری چند ایجنت تخصصی (Multi-Agent Collaboration)؛ کار گروهی ایجنت محقق، ایجنت نویسنده و ایجنت بازرس.
3. مطالعه موردی در پروژه پورتفولیو: گردش‌کار خودکار پروپوزال‌ساز:
   • سناریو: کارفرما در فرم تماس می‌نویسد: «ما یک پلتفرم فروشگاهی با Next.js و درگاه زرین‌پال می‌خواهیم».
   • گام ۱ (ایجنت محقق): جستجو در دیتابیس پورتفولیو برای یافتن پروژه‌های مرتبط قبلی دانشجو.
   • گام ۲ (ایجنت برآورد): تخمین بازه زمانی و محدوده پروژه بر اساس نمونه‌های گذشته.
   • گام ۳ (ایجنت نویسنده): تدوین پیش‌نویس شکیل یک ایمیل پاسخ حرفه‌ای شامل نمونه‌کارها و دعوت به جلسه مشاوره.
   • گام ۴ (داشبورد ادمین): نمایش پیش‌نویس در پنل ادمین با دو دکمه «تایید و ارسال ایمیل» یا «ویرایش دستی».
4. اصل حیاتی انسان در چرخه تصمیم (Human-in-the-Loop - HITL):
   • چرا نباید ارسال ایمیل یا تراکنش‌های مالی را کاملاً خودمختار و بدون نظارت انسانی رها کرد.
5. معرفی ابزارهای پیاده‌سازی گردش‌کارها (اسکریپت‌های تایپ‌اسکریپت، n8n، LangChain):
   • سادگی ساخت زنجیره‌ها با توابع سرورلس در Next.js بدون نیاز به زیرساخت‌های غول‌پیکر.
6. کال‌اوت‌های آموزشی و هشدار کوئرا:
   • کال‌اوت بنفش (<details class="violet">): خطر حلقه‌های بی‌پایان ایجنت (Infinite Loops)؛ لزوم تعیین سقف تعداد گام‌ها (مثلاً حداکثر ۵ مرحله) برای جلوگیری از سوختن توکن‌ها.
   • کال‌اوت سبز (<details class="green">): شگفتی از صرفه‌جویی ساعت‌ها وقت روزانه در پاسخ به ایمیل‌های کاری و تهیه پروپوزال‌های تخصصی.
   • کال‌اوت قرمز (<details class="red">): هرگز به ایجنت‌ها اختیار حذف رکوردهای دیتابیس یا برداشت از حساب بانکی را به عنوان Tool بدون تایید مستقیم ندهید!

آنچه نباید وارد آن شویم (Out-of-Scope):

• مباحث فلسفی هوش عمومی مصنوعی (AGI).
• فریم‌ورک‌های ارکستراسیون پیچیده سازمانی نظیر AutoGen روی خوشه‌های سرور اختصاصی.

---

۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)

اصطلاح انگلیسی	معادل فارسی مصوب	توضیح یک‌خطی ساده
Agentic Workflow	گردش‌کار ایجنتیک	زنجیره پیوسته‌ای از مراحل تفکر، ابزارورزی و ارزیابی خودکار توسط هوش مصنوعی برای انجام تسک‌های پیچیده
Tool Use / Function Calling	فراخوانی ابزارها	توانایی مدل در انتخاب و اجرای توابع برنامه‌نویسی برای خواندن دیتابیس، فراخوانی API یا محاسبات
Reflection	بازتاب و خودانتقادی	مکانیزمی که در آن مدل هوش مصنوعی خروجی مرحله قبل خود را ارزیابی و نقایص آن را اصلاح می‌کند
Human-in-the-Loop (HITL)	انسان در چرخه تصمیم	الگوی طراحی که در آن اقدامات حیاتی و پرریسک نیازمند تایید یا بازبینی مستقیم ناظر انسانی هستند
Multi-Agent Collaboration	همکاری چندایجنت	تقسیم وظایف میان چندین ایجنت تخصصی با پرامپت‌ها و اختیارات مجزا برای رسیدن به خروجی فاخر

---

۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)

راهنمای ایجنت نویسنده: تمام تصاویر باید در پوشهٔ images/ ذخیره شده و در جدول تک‌خانه‌ای وسط‌چین درج شوند:

1. تصویر کاور درس: images/cover.png
   • موضوع: زنجیره‌ای نئونی از ربات‌های هوشمند با مهارت‌های مختلف که دست به دست هم یک نامه اداری و فاکتور را پردازش و تحویل می‌دهند.
2. الگوهای ۴ گانه سیستم‌های ایجنتیک اندرو ان‌جی: images/four-agentic-patterns-infographic.png
   • موضوع: اینفوگرافیک ۴ بخشی: بازتاب (آینه نقد)، ابزارها (آچار و پیچ‌گوشتی)، برنامه‌ریزی (نقشه راه)، و چندایجنت (تیم کاری).
3. چرخه گردش‌کار پروپوزال‌ساز خودکار در پورتفولیو: images/proposal-drafter-workflow-flow.png
   • موضوع: فلوچارت: پیام کارفرما \rightarrow استخراج دیتای پروژه‌ها از Supabase \rightarrow نگارش پیش‌نویس توسط ایجنت \rightarrow نمایش در پنل ادمین \rightarrow تایید با یک کلیک انسان \rightarrow ارسال ایمیل با لیارا.
4. پیش‌نمایش کارت پیش‌نویس پروپوزال در پنل مدیریت: images/admin-proposal-draft-ui.png
   • موضوع: اسکرین‌شات از پنل ادمین با متن آماده پاسخ به کارفرما، دکمه بنفش «تایید و ارسال» و دکمه خاکستری «ویرایش متن».

---

۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (README.md)

1. تیتر اصلی: # ساخت گردش‌کارهای ایجنتیک خودکار (Agentic Workflows) و الگوهای چندایجنت
2. مقدمه: چرا به جای اینکه هر بار دستی به چت‌بات پرامپت بدهید، یک تیم خودمختار از ایجنت‌ها نسازید که کارهای تکراری شما را خودکار انجام دهند؟
3. جدول کاور درس
4. استعاره خط تولید کارخانه در برابر کار تک‌نفره:
   • در یک خط تولید، هر ایستگاه کاری وظیفه‌ای مشخص دارد؛ قطعه از یک ایجنت به ایجنت دیگر پاس داده می‌شود.
5. چهار الگوی طلایی طراحی سیستم‌های ایجنتیک:
   • بازتاب و خودانتقادی، جعبه ابزارها (Tools)، برنامه‌ریزی، و تیم‌های چندایجنت.
6. معماری عملی گردش‌کار هوشمند پورتفولیو:
   • تحلیل پیام کارفرما \rightarrow جستجوی سوابق در دیتابیس \rightarrow تولید پیش‌نویس پروپوزال رسمی.
7. کدنویسی زنجیره ابزارها در Server Actions:
   • پیاده‌سازی گام‌به‌گام با ابزار Tool Calling در مدل‌های OpenAI / OpenRouter.
8. اصل طلایی Human-in-the-Loop:
   • چرا نباید اجازه دهید هوش مصنوعی بدون تایید شما با کارفرما مکاتبه کند؟ طراحی گیت تایید در داشبورد.
9. جعبه پرامپت طلایی: طراحی گردش‌کار پروپوزال‌ساز با ایجنت:
   • پرامپت دقیق:

     «من می‌خواهم یک گردش‌کار خودکار در Next.js بسازم. هنگامی که کارفرمایی پیام ارسال می‌کند، یک تابع سرور باید: ۱) نیازهای اصلی پروژه را از متن پیام استخراج کند، ۲) با یک کوئری به جدول پروژه‌های پورتفولیو مرتبط‌ترین نمونه‌کار را پیدا کند، ۳) یک پیش‌نویس پاسخ مودبانه به همراه معرفی آن پروژه بنویسد و ۴) این پیش‌نویس را در جدول پیام‌های ادمین برای تایید و ارسال با یک کلیک ذخیره کند.»

10. باکس نکته Quera (<details class="violet">): مهار حلقه‌های بی‌پایان؛ همیشه یک شمارنده maxIterations = 3 در کدهای گردش‌کار قرار دهید تا ایجنت در چرخه گیر نکند.
11. باکس هشدار Quera (<details class="red">): دسترسی به ابزارهای ویرانگر؛ ابزارهای حذف دیتا یا ارسال ایمیل مستقیم را هرگز به صورت خودکار بدون تایید انسان اجرا نکنید.
12. باکس رضایت‌بخش Quera (<details class="green">): تست ارسال یک پیام در فرم تماس و ورود به پنل ادمین و دیدن پیش‌نویس آماده یک ایمیل پروپوزال فوق‌العاده حرفه‌ای در عرض ۵ ثانیه.
13. جمع‌بندی درس‌نامه: تسلط بر گردش‌کارهای ایجنتیک؛ ورود به ایستگاه اتوماسیون نگهداری، تست و اسکریپت‌های خودترمیم در درس بعدی.

---

۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)

• تفاوت پرامپت ساده با سیستم‌های ایجنتیک چندمرحله‌ای تشریح گردد.
• الگوهای چهارگانه طراحی سیستم‌های ایجنتیک اندرو ان‌جی با مثال‌های ملموس تبیین شود.
• گردش‌کار عملی پروپوزال‌ساز خودکار به همراه اصل Human-in-the-Loop پیاده‌سازی شود.
• کدهای زنجیره‌سازی ابزارها و تدابیر پیشگیری از لوپ‌های بی‌پایان لحاظ گردند.