آموزش ساخت workflows در n8n به صورت گام‌به‌گام

آموزش ساخت workflows در n8n به صورت گام به گام

هر هفته زمان زیادی از تیم‌های فنی و اجرایی صرف کارهای روتین می‌شود. انتقال دستی داده‌ها بین نرم‌افزارهای مختلف یا ثبت تکراری گزارش‌ها، علاوه بر اتلاف وقت، احتمال خطای انسانی را بسیار بالا می‌برد. در این مقاله از بخش آموزش هوش مصنوعی در وبلاگ پارس‌پک، ابتدا معماری n8n و سپس نحوه ساخت Workflow در پلتفرم n8n را از پایه آموزش داده و پس از ساخت اولین گردش کار، نحوه اتصال به APIهای خارجی را بیان می‌دهیم. در خاتمه هم به این سوال که چگونه با اتصال AI Studio پارس‌پک به VS Code از طریق افزونه Cline، یک دستیار هوشمند برای نوشتن کدهای n8n بسازیم، پاسخ خواهیم داد.

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

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

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

برای آغاز کار، ابتدا باید پلتفرم n8n را راه‌اندازی کنید. برای این کار دو راه پیش روی شماست:

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

نصب n8n

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

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

در این بخش برای اینکه مفاهیم بخش قبلی برایتان ملموس‌تر شوند، مثالی از ساخت یک ورک‌فلوی ساده را شرح می‌دهیم:
این ورک‌فلو باید هر روز ساعت ۹ صبح، داده‌ای را از یک API عمومی بگیرد، فقط فیلدهای لازم را نگه دارد و برآیند را برایتان ایمیل کند.

بعد از ورود به n8n، در صفحه Overview روی دکمه Create در گوشه بالا سمت راست بزنید و Workflow را انتخاب کنید.

اگر ادیشن‌تان از پروژه‌ها (Projects) پشتیبانی کند، n8n می‌پرسد ورک‌فلو در فضای شخصی ساخته شود یا داخل یکی از پروژه‌ها. برای شروع کار فضای شخصی کافی است. یک بوم خالی باز می‌شود که وسطش دکمه Add first step را می‌بینید.

قبل از هر کاری، بالای صفحه روی نام پیش‌فرض (My workflow) کلیک کنید و اسمی بگذارید که چند ماه بعد هم بفهمید این ورک‌فلو چه می‌کند، مثلا «گزارش روزانه صبح برای تیم». با Ctrl+S هم ذخیره‌اش کنید. اگر قرار است ورک‌فلوهای زیادی داشته باشید، برچسب (Tag) زدن هم بعدا پیدا کردن آن‌ها را خیلی راحت می‌کند.

روی Add first step کلیک کنید. n8n می‌پرسد چه چیزی این ورک‌فلو را ابتدا می‌کند و چند گزینه جلویتان می‌گذارد. رایج‌ترین‌ها این‌ها هستند:

برای مثال ما On a schedule مناسب است. بعد از انتخابش، در تنظیمات Trigger Interval را روی Days بگذارید، Days Between Triggers را ۱ و Trigger at Hour را ۹ صبح قرار دهید.

نکته:

Schedule Trigger از منطقه زمانی (Timezone) ورک‌فلو استفاده می‌کند. در تنظیمات ورک‌فلو (Settings) منطقه زمانی را روی Asia/Tehran بگذارید، وگرنه ممکن است اجرا در ساعتی غیر از آنچه انتظار دارید اتفاق بیفتد.

حالا روی علامت + کنار خروجی Trigger کلیک کنید و نود HTTP Request را جست‌وجو و اضافه کنید.

این نود برای گرفتن داده از هر API است. Method را روی GET بگذارید و آدرس API را در فیلد URL وارد کنید.

اگر مستندات سرویس یک دستور cURL داده، دکمه Import cURL کار را برایتان خیلی ساده می‌کند. بعد روی Execute step بزنید تا خروجی واقعی را در پنل سمت راست ببینید. این کار دو فایده دارد:

نود بعدی Edit Fields (Set) است. خروجی بعضی APIها پر از فیلدهایی است که به کارتان نمی‌آید. در این نود فقط فیلدهایی را که لازم دارید تعریف می‌کنید و مقدارشان را از داده نود قبلی می‌گیرید. ساده‌ترین راه این است که فیلد مورد نظر را از پنل ورودی بگیرید و داخل فیلد مقصد رها کنید. n8n خودش Expression را می‌نویسد.

در نهایت یک نود برای ارسال برآیند اضافه کنید، مثلا Send Email یا نود پیام‌رسانی که استفاده می‌کنید. این نود برای اولین بار گزارش‌ها احراز هویت می‌خواهد. کافی است در بخش Credential روی Create new credential بزنید، گزارش‌ها را وارد کنید و ذخیره کنید. متن پیام را هم می‌توانید ترکیبی از متن ثابت و Expression بنویسید، مثل «دمای امروز: {{ $json.temperature }} درجه».

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

ترتیب اتصال‌ها ترتیب اجرا را مشخص می‌کند. ساختارهای پیچیده‌تر هم با همین منطق ساخته می‌شوند: نود IF دو خروجی دارد (درست و غلط) و مسیر ورک‌فلو را دو شاخه می‌کند، و نود Merge چند شاخه را دوباره به هم می‌رساند. برای ورک‌فلوی ما یک مسیر خطی کافی است: Schedule Trigger، بعد HTTP Request، بعد Edit Fields و در آخر Send Email.

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

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

وقتی همه‌چیز درست کار کرد، نوبت فعال‌سازی است. ورک‌فلوهای تازه به‌صورت پیش‌فرض منتشر نشده‌اند و ورک‌فلویی که با Trigger آغاز می‌شود، تا وقتی منتشر نکنید خودکار اجرا نمی‌شود. برای فعال‌سازی، روی دکمه Publish بزنید. در ویرایش‌های تازه n8n این دکمه جای سوئیچ Active قبلی را گرفته است؛ اگر آموزشی را دیدید که از سوئیچ Active حرف می‌زند، منظورش همین است. بعد از انتشار، ورک‌فلو با تحقق شرط Trigger اجرا می‌شود و حاصل هر اجرا در تب Executions ثبت می‌شود.

نکته:

اگر بعدا ورک‌فلوی منتشرشده را ویرایش کردید، تغییرها با ذخیره کردن به‌تنهایی وارد مدار نمی‌شوند و باید دوباره Publish کنید.

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

سرویس AI Studio پارس‌پک برای همین نیاز ساخته شده است. این سرویس یک لایه مدیریتی متمرکز برای استفاده از مدل‌های هوش مصنوعی در نرم‌افزارها فراهم می‌کند و APIهای آن با استانداردهای رایج و سرویس‌های شناخته‌شده جهانی سازگار است. یعنی وقتی پروژه‌تان را به AI Studio وصل می‌کنید، برای عوض کردن مدل لازم نیست ساختار کدها را از نو بنویسید.

در ادامه به نحوه استفاده از این سرویس برای استفاده در نودهای هوش مصنوعی در n8n می‌پردازیم.
برای آغاز وارد پنل کاربری و بخش AI Studio شوید. قبل از هر چیز باید یک کلید API اختصاصی بسازید. مراحل کار در پنل پارس‌پک به این شکل است:

۱. در پنل کاربری پارس‌پک، از منوی سمت راست وارد بخش «کلیدهای API» شوید.

۲. روی دکمه «ایجاد کلید API» کلیک کنید.

۳. نامی برای کلید خود انتخاب کنید (برای مثال PP_n8n) و روی «ایجاد کلید» کلیک کنید.

۴. توکن ایجاد شده را کپی کنید. دقت کنید که این کلید فقط همین یک بار نمایش داده می‌شود و باید آن را در جای امنی ذخیره کنید.

حالا که کلید را دارید، نوبت وصل کردنش به n8n است. اگر می‌خواهید از نودهای آماده هوش مصنوعی n8n مثل AI Agent یا OpenAI Chat Model استفاده کنید، کافی است در بخش Credential یک اعتبارنامه از نوع OpenAI بسازید و به‌جای آدرس پیش‌فرض OpenAI، در فیلد Base URL آدرس AI Studio را قرار دهید و کلید API را هم در همان جا وارد کنید؛ چون این نودها زیرساخت‌شان بر پایه همان API استاندارد OpenAI است، تغییر آدرس پایه کافی است تا مدل‌های AI Studio جای مدل‌های اصلی بنشینند، بدون آنکه ساختار ورک‌فلو یا Expressionها را تغییر بدهید.

برای سناریوهایی که نود آماده‌ای ندارند یا می‌خواهید کنترل بیشتری روی درخواست داشته باشید، همان کلید را می‌توانید در نود HTTP Request و در هدر Authorization به‌صورت Bearer ارسال کنید و مسیر مدل موردنظر را روی Endpoint مربوطه بزنید. در هر دو حالت، بهتر است کلید را داخل یک Credential ذخیره کنید نه داخل خود نود یا نود Code، تا هم رمزنگاری‌شده بماند و هم به‌راحتی در چند ورک‌فلوی مختلف قابل استفاده باشد.

اگر با ابزارهای هوش مصنوعی مختلف کار کرده باشید، می‌دانید مدیریت چند حساب، چند صورتحساب و چند سبک API چقدر می‌تواند وقت‌گیر باشد. AI Studio این مسائل را متمرکز می‌کند و مزیت‌هایش این‌هاست:

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

۱. نودهای آماده (Built-in Integrations): برای سرویس‌های پرکاربرد مثل Google Sheets، Slack یا GitHub نود آماده وجود دارد. کافی است روی نود بروید، در بخش Credential گزینه Create new credential را بزنید و بسته به سرویس، کلید API را وارد کنید یا با OAuth2 وارد حساب کاربری شوید. بعد از ذخیره، همان اتصال در همه نودهای آن سرویس قابل استفاده است.

۲. نود HTTP Request: اگر سرویسی نود آماده ندارد، تقریبا همیشه یک REST API دارد و با این نود می‌توانید هر درخواستی به آن بفرستید. در بخش Authentication یا از Predefined Credential Type استفاده می‌کنید یا از Generic Credential Type که روش‌هایی مثل Basic Auth، Bearer Auth، Header Auth و OAuth2 را پوشش می‌دهد. هدرها، پارامترهای کوئری و بدنه JSON هم همین‌جا تنظیم می‌شوند. برای APIهایی که برآیند را صفحه‌به‌صفحه برمی‌گردانند، گزینه Pagination را در Options پیدا می‌کنید.

برای آشنایی با مراحل اتصال هوش مصنوعی به N8N مقاله زیر را بخوانید:

اتصال هوش مصنوعی به n8n

۳. نود Webhook: وقتی می‌خواهید سیستم دیگری خودش داده را برای ورک‌فلو بفرستد، از این نود استفاده می‌کنید. دو آدرس دارد: Test URL که فقط در زمان تست و وقتی ورک‌فلو منتظر دریافت داده است کار می‌کند، و Production URL که بعد از انتشار ورک‌فلو فعال می‌شود. اگر n8n را روی سرور خودتان اجرا می‌کنید، حتما آدرس عمومی درستی برای آن تنظیم کنید (متغیر WEBHOOK_URL)، وگرنه سرویس‌های بیرونی به آدرس localhost دسترسی ندارند. برای امنیت هم در تنظیمات همین نود احراز هویت (مثلا Header Auth) را فعال کنید.

۴. نودهای هوش مصنوعی: برای اضافه کردن قابلیت‌هایی مثل خلاصه‌سازی متن، دسته‌بندی پیام‌ها یا پاسخ‌گویی خودکار، n8n نودهایی مثل AI Agent و مدل‌های چت دارد. اتصال این بخش بیانات خودش را دارد.

نکته:

چند عادت کمک می‌کند که ورک‌فلوی شما از یک آزمایش ساده به چیز قابل‌اعتمادتر تبدیل شود. وقتی API محدودیت تعداد درخواست دارد، با نود Loop Over Items داده را دسته‌دسته پردازش کنید و در صورت نیاز نود Wait اضافه کنید. خروجی JSON را قبل از استفاده در نودهای بعدی با Edit Fields مرتب کنید تا ساختار داده ثابت بماند و برای هر اتصال حساس، از Credential استفاده کنید، نه اینکه کلید را داخل خود نود یا Code بنویسید.

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

اگر هنوز با این مفهوم آشنا نیستید، مقاله زیر را برای آغاز مطالعه کنید:

هوش مصنوعی چیست؟

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

چگونه در ۶ مرحله N8N را به پیام‌رسان بله متصل کنیم؟ پاسخ را در مقاله زیر بخوانید:

اتصال بله به n8n

اگر همین امروز اولین ورک‌فلوی خودتان را بسازید، با هر اتوماسیونی که اضافه می‌کنید، ساعت‌ها زمان و بسیاری از خطاهای انسانی از کارتان حذف می‌شود. وقتی ساخت گردش کار در n8n جدی‌تر شد، به سروری پایدار نیاز دارید که شبانه‌روز روشن بماند. برای این منظور تهیه هاست n8n پارس‌پک را به شما توصیه می‌کنیم و در ادامه برای طراحی اتوماسیون‌های هوشمند هم می‌توانید سرویس AI Studio را تهیه کنید و مدل هوش مصنوعی را بدون دردسر به پروژه‌هایتان اضافه کنید.

خیر. بسیاری از ورک‌فلوها فقط با کشیدن و رها کردن نودها و پر کردن فیلدها ساخته می‌شوند. البته آشنایی مقدماتی با JSON و کمی JavaScript برای نوشتن Expressionها و نود Code کمک می‌کند، ولی برای آغاز لازم نیست.

اجرای دستی (Execute workflow) برای تست است و با کلیک شما شروع کار می‌شود. اجرای خودکار فقط بعد از انتشار ورک‌فلو (Publish) اتفاق می‌افتد و با Trigger آغاز می‌شود، مثل رسیدن ساعت مشخص یا دریافت درخواست روی Webhook. داده پین‌شده هم فقط در اجرای دستی استفاده می‌شود.

اول به تب Executions بروید و اجرای ناموفق را باز کنید. نودی که خطا داده با رنگ قرمز تأیید شده و پیام خطا و داده ورودی و خروجی‌اش را می‌توانید ببینید. شایع‌ترین علت‌ها داده‌ها احراز هویت اشتباه، ساختار داده غیرمنتظره یا منتشر نشدن ورک‌فلو هستند.

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

سوالات متداول

آخرین اطلاعات درباره کنید چیست؟

جدیدترین اطلاعات و تغییرات مربوط به کنید در این گزارش ارائه شده است.