پروژهٔ پایانی: ساخت یک ایجنت واقعی و قابل‌اعتماد

نقشهٔ راه ایجنت‌ها و اتوماسیون از مفهوم ایجنت تا حافظه، ابزار و استقرار را پوشش می‌دهد. حالا وقت ساختن است — اما نه یک نمایش قشنگ که یک بار کار کند.

تفاوت اصلی این پروژه با تمرین‌های معمول، در یک کلمه است: قابل‌اعتماد. ایجنتی که در نمایش کار می‌کند زیاد است؛ ایجنتی که سی روز بدون دخالت تو کار می‌کند و وقتی می‌شکند خودش خبر می‌دهد، کمیاب است.

در پایان این پروژه یک ایجنت خواهی داشت که هر روز یک کار واقعی را برایت انجام می‌دهد.

بریف پروژه

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

• حداقل سه ابزار در اختیارش باشد (خواندن از جایی، پردازش، نوشتن به جایی).
• حافظه داشته باشد؛ یعنی بداند قبلاً چه کرده و کار تکراری انجام ندهد.
• به‌صورت خودکار اجرا شود، نه با فشار دادن دکمه.
• وقتی چیزی خراب شد، خودش خبر بدهد.
• حداقل هفت روز پیوسته اجرا شده باشد و گزارش اجراها موجود باشد.

ایده‌های مناسب

ایجنت	ابزارها	ارزش روزانه
خلاصه‌کنندهٔ اخبار حوزهٔ کاری	خواندن منبع، خلاصه، ارسال پیام	صرفه‌جویی ۳۰ دقیقه
دستیار صندوق ورودی	خواندن ایمیل، دسته‌بندی، پیش‌نویس	کاهش بار ذهنی
ناظر قیمت یا موجودی	خواندن صفحه، مقایسه، هشدار	فرصت‌های ازدست‌نرفته
گزارش‌ساز هفتگی	جمع‌آوری داده، تحلیل، ساخت گزارش	حذف یک کار ثابت
پیگیر وظایف معوق	خواندن لیست، تشخیص تأخیر، یادآوری	کاهش فراموشی
بایگانی‌کنندهٔ محتوا	خواندن لینک، استخراج، ذخیره با برچسب	پایگاه دانش شخصی

مرحلهٔ ۱ — تعریف دقیق کار (۳۰ دقیقه)

ایجنت‌ها وقتی شکست می‌خورند که وظیفه‌شان مبهم است. این سند را پر کن:

# ایجنت: [نام]

## چه کاری انجام می‌دهد
یک جمله: ...

## چه وقت اجرا می‌شود
هر [بازه]، ساعت [زمان]

## ورودی از کجا می‌آید
منبع: ...
اگر منبع در دسترس نبود: ...

## خروجی کجا می‌رود
مقصد: ...
قالب خروجی: ...

## چه تصمیم‌هایی خودش می‌گیرد
- ...

## چه تصمیم‌هایی باید از من بپرسد
- ...

## چه کاری را هرگز نباید انجام دهد
- ... (این بخش را مفصل بنویس)

دو بخش آخر مرز ایمنی ایجنت‌اند. ایجنتی که می‌تواند ایمیل بفرستد، باید بداند به چه کسی هرگز نباید بفرستد. ایجنتی که فایل پاک می‌کند، باید بداند کدام پوشه‌ها ممنوع‌اند.

مرحلهٔ ۲ — طراحی حلقه

هر ایجنت یک حلقهٔ ساده دارد: مشاهده، تصمیم، اقدام، ثبت. آن را روی کاغذ بنویس:

۱ مشاهده: چه داده‌ای جمع می‌کنم؟
   ← منبع الف: ...
   ← منبع ب: ...

۲ فیلتر:  چه چیزی را قبلاً دیده‌ام و باید رد کنم؟
   ← بررسی حافظه

۳ تصمیم:  با موارد جدید چه کنم؟
   ← اگر شرط الف: اقدام ۱
   ← اگر شرط ب: اقدام ۲
   ← در غیر این‌صورت: هیچ کاری نکن

۴ اقدام:  خروجی را کجا بفرستم؟

۵ ثبت:    چه چیزی را در حافظه بنویسم؟
   ← شناسهٔ موارد پردازش‌شده
   ← زمان اجرا و نتیجه

مرحلهٔ ۲ مهم‌ترین بخش است. ایجنتی که حافظه ندارد، هر بار همان کار را تکرار می‌کند و بعد از دو روز از کار می‌افتد یا تو را کلافه می‌کند.

حافظه: ساده شروع کن

برای نود درصد ایجنت‌های شخصی، یک فایل ساده کافی است:

{
  "processed_ids": ["a1b2", "c3d4"],
  "last_run": "2026-08-15T09:00:00",
  "run_count": 47,
  "last_error": null,
  "stats": { "success": 45, "failed": 2 }
}

سراغ پایگاه‌داده و بازیابی برداری نرو مگر واقعاً لازم باشد. پیچیدگی زودهنگام، رایج‌ترین دلیل نیمه‌کاره‌ماندن پروژه‌های ایجنت است.

مرحلهٔ ۳ — ساخت با یا بدون کد

مسیر	مزیت	محدودیت
ابزار بدون کد (مثل n8n)	سریع، بصری، اتصال آسان	منطق پیچیده سخت می‌شود
کد ساده با زمان‌بند	کنترل کامل، بدون محدودیت	نیاز به دانش کد
ترکیبی	منطق در کد، اتصال‌ها در ابزار	دو جا برای نگهداری

اگر تازه‌کاری، از مسیر بدون کد شروع کن — نمونهٔ عملی‌اش را در اولین ایجنت بدون کد با n8n داریم. اگر کد بلدی، مسیر دوم انعطاف بیشتری می‌دهد.

قاعدهٔ ساخت تدریجی

ایجنت را در چهار قدم بساز و بعد از هر قدم اجرا کن:

1. فقط مشاهده: داده را بخوان و چاپ کن. هیچ اقدامی نکن.
2. مشاهده + فیلتر: حافظه را اضافه کن. ببین موارد تکراری درست رد می‌شوند.
3. حالت تمرینی: تصمیم بگیرد و بگوید «می‌خواستم این کار را بکنم» — اما نکند.
4. حالت واقعی: حالا اجازهٔ اقدام بده.

قدم سوم را حذف نکن. حداقل دو روز در حالت تمرینی اجرایش کن. اگر ایجنتی که ایمیل می‌فرستد را مستقیم فعال کنی، اولین باگ می‌تواند بیست ایمیل اشتباه بفرستد.

مرحلهٔ ۴ — مقاوم‌سازی

اینجا جایی است که ایجنت اسباب‌بازی از ایجنت واقعی جدا می‌شود. چهار محافظ لازم داری:

۱. تلاش مجدد با فاصلهٔ فزاینده

برای هر تماس شبکه‌ای:
- تلاش اول: بلافاصله
- تلاش دوم: بعد از ۲ ثانیه
- تلاش سوم: بعد از ۸ ثانیه
- بعد از سه شکست: ثبت خطا و توقف امن

۲. سقف مصرف

حداکثر موارد پردازش‌شده در هر اجرا: ۲۰
حداکثر تماس با مدل در هر اجرا: ۳۰
اگر از سقف رد شد: توقف + هشدار

این محافظ، بیمه‌نامهٔ تو در برابر حلقهٔ بی‌نهایت است. بدون آن، یک باگ ساده می‌تواند شبانه هزاران درخواست بفرستد.

۳. هشدار خرابی

اگر دو اجرای متوالی شکست خورد → پیام هشدار بفرست
اگر ۲۴ ساعت هیچ اجرای موفقی نبود → پیام هشدار بفرست

ایجنتی که بی‌صدا می‌میرد، بدتر از ایجنتی است که وجود ندارد؛ چون تو فکر می‌کنی کار انجام می‌شود.

۴. گزارش اجرا

| زمان | موارد یافته | پردازش‌شده | رد‌شده | خطا | مدت |
|------|-------------|-----------|--------|-----|-----|

مرحلهٔ ۵ — ارزیابی کیفیت تصمیم‌ها

ایجنت شاید بدون خطا اجرا شود اما تصمیم‌های بدی بگیرد. هفت روز اجرا کن و بعد نمونه‌گیری کن:

از هفت روز اجرا، ۲۰ تصمیم تصادفی انتخاب کن و
هرکدام را دستی بررسی کن:

| # | ورودی | تصمیم ایجنت | تصمیم درست | مطابق؟ |
|---|-------|-------------|------------|--------|

نرخ دقت = تعداد مطابق ÷ ۲۰

نرخ دقت زیر هشتاد درصد یعنی ایجنت هنوز آمادهٔ اعتماد کامل نیست. برای کارهایی که خطایشان پرهزینه است (ارسال پیام به مشتری، حذف داده)، آستانه باید بالای نود و پنج درصد باشد.

تحلیل خطاها: برای هر تصمیم اشتباه بپرس علتش چه بود — پرامپت مبهم، دادهٔ ناکافی، یا شرط تصمیم غلط. معمولاً یک الگوی مشترک پیدا می‌کنی که با یک اصلاح، چند خطا را با هم حل می‌کند.

معیار ارزیابی پروژه

معیار	امتیاز
سند وظیفه با بخش «هرگز نباید انجام دهد»	۱۰
حافظه کار می‌کند؛ کار تکراری انجام نمی‌شود	۱۵
حداقل سه ابزار واقعی	۱۰
اجرای خودکار بدون دخالت دستی	۱۵
چهار محافظ (تلاش مجدد، سقف، هشدار، گزارش)	۲۰
حداقل هفت روز اجرای پیوسته با گزارش	۱۵
ارزیابی دقت روی ۲۰ نمونه با تحلیل خطا	۱۵

پرامپت داور

نقش: مهندس قابلیت اطمینان سیستم‌ها، بدبین حرفه‌ای.

زمینه: [سند وظیفه + کد یا گردش‌کار + گزارش هفت‌روزه
+ جدول ارزیابی دقت]

کار: این ایجنت را از نظر قابلیت اعتماد نقد کن.

۱) اگر منبع ورودی فردا ساختارش عوض شود، چه اتفاقی
   می‌افتد؟ آیا ایجنت بی‌صدا خطا می‌دهد؟
۲) کدام حالت خطا پیش‌بینی نشده؟ حداقل سه مورد نام ببر.
۳) آیا سقف‌های مصرف واقعاً جلوی حلقهٔ بی‌نهایت را
   می‌گیرند یا راه فراری وجود دارد؟
۴) در جدول ارزیابی دقت، آیا خطاها الگوی مشترکی دارند؟
۵) کدام تصمیمی که ایجنت خودش می‌گیرد، بهتر است
   به تأیید انسان نیاز داشته باشد؟
۶) اگر این ایجنت سه ماه بدون نگهداری رها شود،
   اول کدام بخشش می‌شکند؟

خروجی: نقد در شش بند + سه اصلاح به‌ترتیب اولویت.
ممنوع: تعریف کلی، بازنویسی کامل.

سه سطح دشواری

سطح	دامنه	زمان
مقدماتی	دو ابزار، حافظهٔ ساده، اجرای روزانه، سه روز	۶ ساعت
استاندارد	بریف کامل بالا	۱۴ ساعت
پیشرفته	به‌علاوهٔ: چند ایجنت که با هم کار می‌کنند، اتصال ابزارها با پروتکل استاندارد، و داشبورد وضعیت	۳۰ ساعت

پرسش‌های پرتکرار

ایجنت با اسکریپت زمان‌بندی‌شده چه فرقی دارد؟
اسکریپت مسیر ثابتی را طی می‌کند؛ ایجنت بر اساس آنچه می‌بیند تصمیم می‌گیرد. اگر برنامه‌ات هیچ تصمیمی نمی‌گیرد، اسکریپت است — که هیچ اشکالی هم ندارد و اغلب قابل‌اعتمادتر است.

هزینهٔ اجرای روزانه زیاد نمی‌شود؟
با سقف مصرف، قابل‌کنترل است. ضمناً برای کارهای ساده مثل دسته‌بندی، مدل‌های کوچک و ارزان کاملاً کافی‌اند؛ لازم نیست همه‌چیز را به بزرگ‌ترین مدل بسپاری.

چطور بفهمم ایجنت واقعاً ارزش دارد؟
زمان صرفه‌جویی‌شده در هفته را در نرخ ساعتی خودت ضرب کن و با هزینهٔ ساخت و نگهداری مقایسه کن. اگر بعد از دو ماه سربه‌سر نشد، احتمالاً کار اشتباهی را خودکار کرده‌ای.

ایجنت کاری کرد که نباید، چه کنم؟
اول برگردانش به حالت تمرینی. بعد ببین آن اقدام در بخش «هرگز نباید انجام دهد» بوده یا نه. اگر نبوده، اضافه‌اش کن — این فهرست با تجربه کامل می‌شود.

جمع‌بندی

سند وظیفه با مرزهای ایمنی، حلقهٔ پنج‌مرحله‌ای، حافظهٔ ساده، ساخت تدریجی با حالت تمرینی، چهار محافظ قابلیت اعتماد، و ارزیابی دقت روی نمونهٔ واقعی. ایجنتی که این‌ها را داشته باشد، هفته‌ها بدون تو کار می‌کند.

مسیر کامل را در نقشهٔ راه ایجنت‌ها و اتوماسیون ببین و در @MrChatGPT_IR همراه ما باش.