← بازگشت به وبلاگ

تریگر دستی چیست؟ آموزش Manual Trigger در اتوماسیون و ایجنت‌های هوش مصنوعی

تریگر دستی چیست و چه کاربردی در اتوماسیون و ایجنت‌های هوش مصنوعی دارد؟ با نحوه استفاده از Manual Trigger، payload و اجرای Workflow در دهکده آشنا شوید.

تریگر دستی چیست؟ آموزش Manual Trigger در اتوماسیون و ایجنت‌های هوش مصنوعی

در دنیای اتوماسیون هوشمند و ایجنت‌های هوش مصنوعی، همه‌چیز با یک سؤال ساده شروع می‌شود: چه چیزی این فرایند را روشن کند؟

گاهی پاسخ، یک وب‌هوک یا زمان‌بندی خودکار است؛ گاهی هم باید خودِ انسان تصمیم بگیرد که «الان اجرا شود». اینجا پای تریگر دستی (Manual Trigger) به میان می‌آید.

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

اتوماسیون هوشمند بدون نقطه شروع معنا ندارد

هر گردش‌کار (Workflow) حداقل از سه لایه ساخته می‌شود:

  1. 1. محرک (Trigger) — چه زمانی اجرا شروع شود؟
  2. 2. منطق و پردازش — شرط، فیلتر، تبدیل داده، فراخوانی API
  3. 3. اقدام (Action) — ارسال پیام، ذخیره در دیتابیس، پاسخ به کاربر، فراخوانی ایجنت

اگر محرک درست انتخاب نشود، بهترین نودها هم فقط روی کاغذ زیبا می‌مانند. تریگرها معمولاً چند خانواده دارند:

نوع تریگر مثال مناسب برای
رویدادی Webhook، تلگرام، ایمیل واکنش فوری به رویداد خارجی
زمان‌بندی Cron / Schedule گزارش روزانه، یادآوری، همگام‌سازی دوره‌ای
داده‌ای تغییر در دیتابیس، فایل، RSS پایش منبع داده
دستی دکمه Run / اجرای دستی تست، عملیات کنترلی، سناریوهای حساس

تریگر دستی چیست؟

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

در ابزارهایی شبیه n8n و در پلتفرم‌هایی مثل دهکده، این نود معمولاً با عنوان‌هایی مثل:

  • اجرای دستی
  • Manual Trigger
  • manual_trigger

شناخته می‌شود و اغلب نقطه شروع گردش‌کارهای آزمایشی، عملیاتی یا «تحت کنترل انسان» است.

چه چیزی وارد گردش‌کار می‌شود؟

برخلاف وب‌هوک که payload از بیرون می‌آید، در تریگر دستی معمولاً می‌توانید:

  • یک JSON اولیه (payload دستی) تعریف کنید
  • یا اجرا را بدون داده شروع کنید و نودهای بعدی داده را بسازند
  • گاهی پارامترهای ساده مثل شناسه سفارش، متن پیام یا پرچم‌های تست را هم پاس بدهید

این ورودی، همان «سوخت اولیه» ایجنت یا زنجیره پردازش است.

چرا در عصر ایجنت‌ها هنوز به تریگر دستی نیاز داریم؟

ایجنت هوشمند (AI Agent) می‌تواند تصمیم بگیرد، ابزار صدا بزند و چند مرحله را پشت سر هم انجام دهد. اما شروع ایجنت همچنان باید کنترل‌شده باشد.

۱. تست و توسعه بدون ریسک

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

۲. عملیات حساس انسانی

پرداخت، ابطال سفارش، ارسال انبوه پیام یا تغییر وضعیت حساب مشتری گاهی نباید خودکارِ کامل باشد. تریگر دستی یعنی: انسان تأیید کرد، بعد سیستم اجرا کند.

۳. ورودی کنترل‌شده برای ایجنت

می‌توانید با یک payload مشخص به ایجنت بگویید:

{
  "orderId": "A-1024",
  "customer": "رضا",
  "intent": "وضعیت_سفارش"
}

سپس ایجنت در دهکده (یا هر موتور مشابه) از نودهای دیتابیس، HTTP و پاسخ‌دهی استفاده کند.

۴. اجرای موردی از داشبورد

مدیر عملیات می‌خواهد «همین حالا گزارش بساز» یا «این لیست را پردازش کن»؛ نه فردا ساعت ۹. تریگر دستی دقیقاً برای همین سناریوها طراحی شده است.

۵. پل بین انسان و اتوماسیون

در معماری‌های Human-in-the-loop، انسان نقطه شروع یا نقطه تأیید است و بقیه مسیر خودکار پیش می‌رود.

تریگر دستی در کنار ایجنت‌ها: الگوی پیشنهادی

یک الگوی رایج و حرفه‌ای این است:

تریگر دستی
    ↓
آماده‌سازی داده (Set / Transform)
    ↓
ایجنت یا مدل AI (تحلیل / تصمیم / تولید پاسخ)
    ↓
ابزارها (دیتابیس، HTTP، پیامک، تلگرام، …)
    ↓
خروجی و لاگ اجرا

مثال عملی: «وضعیت سفارشم چیه؟» (نسخه دستی/داخلی)

  1. 1. اپراتور یا توسعه‌دهنده اجرای دستی را می‌زند
  2. 2. payload شامل orderId است
  3. 3. نود دیتابیس سفارش را می‌خواند
  4. 4. ایجنت یا نود قالب‌ساز، پاسخ فارسی می‌سازد
  5. 5. نتیجه در لاگ اجرا ثبت می‌شود (و در صورت نیاز به کانال پشتیبانی ارسال می‌شود)

همین الگو بعداً می‌تواند با تریگر تلگرام یا وب‌هوک جایگزین شود؛ منطق وسط ثابت می‌ماند.

چه زمانی تریگر دستی را انتخاب نکنیم؟

  • وقتی رویداد باید بلافاصله از سیستم بیرونی برسد (پرداخت موفق، پیام کاربر) → Webhook / پیام‌رسان
  • وقتی کار باید سر ساعت تکرار شود → Schedule
  • وقتی منبع حقیقت تغییر داده است → Database / File / RSS Trigger

تریگر دستی جایگزین همه محرک‌ها نیست؛ مکمل آن‌هاست: برای کنترل، تست و عملیات آگاهانه.

تریگر دستی در دهکده

در دهکده نود اجرای دستی با شناسه تقریبی manual_trigger در دسته محرک‌ها قرار دارد و مانند سایر تریگرها باید این چرخه را طی کند:

انتخاب نود در ادیتور
→ تنظیم در پنل پیکربندی
→ ذخیره با دکمه Save بالای صفحه
→ ذخیره در Workflow JSON
→ بارگذاری مجدد همان تنظیمات
→ اجرا و مشاهده خروجی واقعی

تنظیمات مهم تریگر دستی در دهکده

بسته به نسخه UI، این موارد معمولاً در پنل تنظیمات نود دیده می‌شوند:

تنظیم توضیح
عنوان نود نام قابل فهم در بوم گردش‌کار (مثلاً «شروع تست سفارش»)
Payload دستی (JSON) داده اولیه اجرای گردش‌کار؛ باید JSON معتبر باشد
پیش‌نمایش / اعتبارسنجی جلوگیری از ذخیره JSON خراب
توضیح یا یادداشت برای تیم که بدانند این اجرا چه منظوری دارد
اصل مهم در دهکده: تنظیمات نباید فقط در state موقت فرانت بماند. هر فیلدی که در UI می‌بینید باید در Node Data → Workflow JSON → دیتابیس ذخیره شود و بعد از بستن و باز کردن صفحه، دوباره همان‌طور برگردد.

چگونه در دهکده یک گردش‌کار با تریگر دستی بسازیم؟

  1. 1. وارد سازنده گردش‌کار شوید و یک workflow جدید بسازید.
  2. 2. از دسته محرک‌ها نود اجرای دستی را به بوم اضافه کنید.
  3. 3. در پنل تنظیمات، در صورت نیاز یک JSON نمونه وارد کنید.
  4. 4. نودهای بعدی را وصل کنید: شرط، دیتابیس، HTTP، ایجنت AI، ارسال پیام و …
  5. 5. فقط با ذخیره بالای صفحه تنظیمات را Persist کنید.
  6. 6. گردش‌کار را فعال / اجرا کنید و از مسیر اجرای دستی، یک بار تست بگیرید.
  7. 7. تاریخچه اجرا و لاگ را بررسی کنید تا خروجی واقعی ایجنت و نودها مشخص شود.

نکات عملی برای کار با ایجنت در دهکده

  • برای تست ایجنت، اول با تریگر دستی و payload ثابت شروع کنید؛ بعد به تلگرام یا وب‌هوک مهاجرت دهید.
  • Credentialها (کلید API، توکن مدل، اتصال دیتابیس) را در سیستم اعتبارنامه‌ها نگه دارید؛ داخل JSON گردش‌کار secret نگذارید.
  • خروجی ایجنت را با نودهای داده (فیلتر، اعتبارسنجی، قالب‌ساز) تمیز کنید تا پاسخ نهایی قابل اتکا باشد.
  • اگر اجرا در Docker است، اتصال Mongo (برای workflow و رجیستری) و SQL (برای کاربران و تنظیمات) را درست پیکربندی کنید تا ذخیره و اجرای دستی پایدار بماند.

اشتباهات رایج

  1. 1. JSON نامعتبر در payload → اجرا fail می‌شود یا داده خالی می‌رسد
  2. 2. فراموش کردن Save بالای صفحه → بعد از رفرش تنظیمات از بین می‌رود
  3. 3. استفاده از تریگر دستی به‌جای وب‌هوک در production → وابستگی دائمی به دخالت انسان
  4. 4. نداشتن لاگ و بررسی خروجی → ایجنت «کار می‌کند» اما کیفیت پاسخ کنترل نمی‌شود
  5. 5. شروع پیچیده → چند شاخه و چند ایجنت قبل از یک اجرای موفق ساده

جمع‌بندی

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

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

نظرات کاربران

هنوز نظر تأییدشده‌ای ثبت نشده است. اولین نفر باشید.

ثبت نظر

پس از بررسی مدیر نمایش داده می‌شود.