آموزش گام‌به‌گام ساخت ایجنت هوش مصنوعی با n8n

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

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

ملیکا طاهران‌ پور

ایجنت هوش مصنوعی چیست؟ از کجا بدانیم چه زمانی به AI Agent نیاز داریم؟

مطالعه '9

پیشنهاد می‌کنم دست به‌کار بشوید و قدم‌به‌قدم ساخت ایجنت هوش مصنوعی رایگان با n8n را با ما پیش ببرید.

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

• نسخه‌ی ابری (n8n Cloud): یک دوره‌ی تست رایگان دارد؛ اما بعد از آن پولی می‌شود؛ بنابراین برای صرفه‌جویی در کردیت رایگانتان باید کمترین میزان اشتباه را در ساخت و اجرا داشته باشید تا درنهایت به یک ایجنت کارآمد برسید.
• نسخه‌ی محلی (Self-Hosted/Desktop): این پلتفرم متن‌باز است؛ یعنی می‌توانید کاملاً رایگان روی سیستم خودتان نصبش کنید و برای همیشه بدون محدودیت از آن استفاده کنید. تنها محدودیت در نسخه‌ی رایگان محلی این است که کامپیوتر باید روشن باشد تا ایجنت کار کند؛ مگر اینکه روی یک سرور مجازی رایگان یا ارزان نصبش کنید.

برای اینکه بابت مغز متفکر ایجنت، مثل OpenAI/ChatGPT هم پولی ندهید، می‌توانید از APIهای رایگان مدل‌های قدرتمندی مثل جمینای یا گراک استفاده کنید. هرچند اگر نسخه‌ای اشتراکی هوش مصنوعیتان را به سیستم وصل کنید، با محدودیت‌های بسیار کمتری مواجه خواهید شد.

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

• در بازه‌های زمانی مشخص، ایمیل‌های جدیدتان را بررسی کند (از ۱۲ شب تا ۶ صبح یک بار و از ۶ صبح تا ۱۲ شب سه بار).
• ایمیل‌های مهم را تشخیص دهد.
• خلاصه‌ای از آن‌ها را به تلگرام ارسالی کند.
• اگر ایمیل نیاز به پاسخ داشته باشد، یک پیش‌نویس با هوش مصنوعی تولید کند.
• قبل از ارسال، از شما در تلگرام تأیید بگیرد.
• در صورت تأیید، ایمیل را ارسال کند.
• در صورت رد، فقط لینک ایمیل را برای شما در تلگرام بفرستد تا خودتان به‌صورت دستی پاسخ دهید.

بدین‌ترتیب یک سیستم دارید که هم فیلتر می‌کند، هم فکر می‌کند، هم پیشنهاد می‌دهد، هم منتظر تصمیم شما می‌ماند.

اولین کاری که بعد از ثبت‌نام در n8n باید انجام دهید، ساخت یک Workflow جدید است. در n8n هر ایجنت به‌صورت یک Workflow ساخته می‌شود؛ یعنی زنجیره‌ای از مراحل که به‌ترتیب اجرا می‌شوند. بعد از ورود به داشبورد:

• روی Create Workflow کلیک کنید؛ وارد صفحه‌ی ویرایشگر می‌شوید. در این صفحه، یک بوم خالی می‌بینید که قرار است تمام رفتارهای ایجنت را روی آن طراحی کنید.

برای ساخت ایجنت با n8n، به چند بلوک (یا اصطلاحاً Node) نیاز داریم. بیایید مرحله به مرحله آن‌ها را به هم وصل کنیم.

• برای تغییر نام Workflow در گوشه‌ی بالایی سمت چپ روی My Workflow کلیک کنید و آن را مثلا به Email Assistant Agent تغییر دهید.
• برای اضافه‌کردن نود جدید روی آیکون + وسط بوم بزنید.

اولین نودی که وارد صفحه می‌کنیم، Schedule است. این نود وظیفه دارد ایجنت را بیدار کند. ایجنت ما نباید هر ثانیه کار کند چون هم منابع سیستم را درگیر می‌کند، هم نیازی نیست. می‌خواهیم سر ساعت‌های خاصی ایمیل‌ها را چک کند.

• روی علامت + کلیک کنید و نود Schedule Trigger را به صفحه بیاورید.

• در تنظیمات نود، فیلدی به‌نام Trigger Interval وجود دارد. روی آن کلیک کنید.
• از منوی کشویی باز شده، به پایین بروید و گزینه‌ی Custom (Cron) را انتخاب کنید.

• به‌محض انتخاب Custom (Cron)، فیلد جدیدی به‌نام Expression باز می‌شود. کد زمان‌بندی زیر را داخل فیلد کپی کنید. (اگر کدنویسی بلد نیستید، نترسید!)

این کد یک زبان استاندارد و جهانی برای زمان‌بندی به‌نام Cron Expression است. به زبان خیلی ساده، کد به سیستم می‌گوید: «هر روز، دقیقاً سر ساعت‌های ۲ نصفه‌شب، ۸ صبح، ۲ ظهر و ۸ شب ایجنت را بیدار کن.»

نود بعدی را به Gmail اختصاص می‌دهیم. آن را به اکانت گوگل خود متصل کرده و تنظیم می‌کنیم تا فقط ایمیل‌های Unread (نخوانده‌شده) را بیاورد.

• با کلیک روی دکمه‌ی + در سمت راست نود اول، نود Gmail را اضافه کنید. به‌محض انتخاب، لیستی از اکشن‌ها (Actions) نمایش داده می‌شود. از لیست بازشده، گزینه‌ی Get many messages را انتخاب کنید.

• حالا باید اکانت گوگل خود را متصل کنید. در بالای بخش تنظیمات نود روی set up credentials بزنید. ممکن است گزینه‌های دیگری مثل setup manually یا sign in with Google را هم ببینید. روی هرکدام که راحت هستید بزنید.

• روش OAuth2 و سپس sign in with Google را انتخاب کنید. n8n شما را به صفحه‌ی ورود گوگل می‌برد. ایمیلتان را انتخاب کنید و دسترسی‌های لازم را تأیید کنید تا جیمیل متصل شود.

برای اینکه به ایجنت بگویید که فقط به سراغ ایمیل‌های جدید و نخوانده برود:

• به پایین تنظیمات نود بروید و روی دکمه‌ی Add Filters کلیک و گزینه‌ی Label Names or IDs را انتخاب کنید.
• از منوی کشویی روی UNREAD بزنید.

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

• به سایت Google AI Studio بروید با اکانت گوگلتان لاگین کنید. وی‌پی‌ان را روشن کنید و از بالا روی دکمه‌ی Get API Key بزنید تا یک کلید جدید بسازید. این کلید رمز عبور ایجنت شما به مغز گوگل است؛ آن را کپی کنید.

• در n8n، نود AI Agent را اضافه کنید. این نود به یک مدل زبانی نیاز دارد روی دکمه‌ی + کنار chat model در زیر نود کلیک کنید تا نود Google Gemini Chat Model را اضافه کرده و به ایجنت وصل کنید.

• وقتی تنظیمات مدل Gemini باز شد، همان بالا یک دکمه برای ساخت Credential جدید است، روی آن بزنید و کلید API-ای را که از گوگل استودیو کپی کرده بودید، اینجا پیست کنید.

• حالا در نود AI Agent، روی add options بزنید و System Message را انتخاب کنید. این بخش برای تعیین نقش، شخصیت و قوانین کلی است. یعنی به هوش مصنوعی می‌گویید: «تو کی هستی و وظیفه‌ات چیست؟». متن زیر را وارد کنید:

در بخش System Message قوانین را به ایجنت گفتیم. حالا در کادر Prompt باید ایمیلی را که نود جیمیل دریافت کرده است، به‌صورت خودکار به او پاس بدهیم. به این کار استفاده از داده‌های داینامیک (Dynamic Data) می‌گویند؛ بدین‌منظور، داخل کادر Prompt کلیک کنید و عبارت زیر را بنویسید:

عبارت Here is the email به هوش مصنوعی می‌فهماند که قرار است چه چیزی را بخواند. بخش {{ $json.snippet }} هم مثل یک جای خالی است که n8n به‌طور خودکار متن هر ایمیل جدید را درون آن می‌گذارد تا سیستم بدون نیاز به دخالت دستی شما کار کند.

حالا که ایجنت ایمیل را خواند و جواب را پیش‌نویس کرد، باید آن را به شما نشان دهد تا تصمیم بگیرید. می‌خواهیم ایجنت پیامش را به تلگرام بفرستد و زیر آن دو دکمه‌ی «تأیید» و «رد» قرار دهد.

۱. ساخت ربات تلگرامی

ابتدا باید یک ربات اختصاصی برای خودتان بسازید:

• در تلگرام، آیدی BotFather@ را جست‌وجو کنید و دکمه‌ی Start را بزنید.
• پیام newbot/ را برایش بفرستید.
• تلگرام از شما یک نام و سپس یک آیدی می‌خواهد که حتماً باید با کلمه‌ی bot تمام شود.
• در نهایت، بات‌فادر یک پیام طولانی حاوی کدی به‌نام API Token به شما می‌دهد. این کد کلید ورود n8n به ربات شماست، آن را کپی کنید.

۲. تنظیم نود Telegram در n8n

• در صفحه‌ی n8n، روی دکمه‌ی + کلیک کنید و نود Telegram را بیاورید.
• از منوی بازشده، اکشن Send a message را انتخاب کنید.
• در بخش Credential، روی Create New Credential کلیک کنید و توکنی را که از بات‌فادر کپی کرده بودید، در اینجا پیست کنید.

۳.تنظیم Chat ID

ما نمی‌خواهیم ربات ایمیل‌های شخصی ما را در گروه یا برای شخص دیگری بفرستد، پس باید آیدی خودمان را به او بدهیم.

• در تلگرام به ربات userinfobot@ پیام بدهید. این ربات یک شماره‌آیدی عددی (مثلاً 123456789) به شما می‌دهد.

• عدد دریافتی از ربات userinfobot@ را کپی کنید و در پارامترهای نود تلگرام، داخل فیلد Chat ID قرار دهید.

۴. متن پیام (داده‌های داینامیک)

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

راه اول: میانبر تایپ‌کردن (سریع‌ترین راه)

کافی‌ست ماوس را روی فیلد Text ببرید، روی کلمه‌ی Expression (یا علامت fx در کنار کادر) کلیک کنید. حالا کادر متنی به حالت کدنویسی درمی‌آید. دقیقاً عبارت زیر را داخل کادر کپی کنید؛ این کد کوتاه به‌زبان اتوماسیون یعنی: «هر زمان که بیدار شدی، برو خروجی (output) نود قبلی را بردار و اینجا بگذار!»

راه دوم: تست‌کردن مسیر (برای اطمینان)

• پنجره‌ی تنظیمات تلگرام را ببندید و یک قدم به عقب برگردید؛ یعنی روی نود AI Agent کلیک کنید.
• در پایینِ تنظیمات نود، روی دکمه‌ی Test step (یا Execute Node) کلیک کنید.
• چندثانیه صبر کنید تا هوش مصنوعی پردازش را انجام دهد و یک خروجی واقعی بسازد.
• حالا دوباره به تنظیمات نود Telegram برگردید. می‌بینید که در پنل سمت چپ (Input Data)، متغیری به‌نام output ظاهر شده است. آن را با ماوس بگیرید و داخل فیلد Text رها کنید.

۵. تعریف دکمه‌های Inline Keyboard برای رد و تایید

• در پایین تنظیمات نود تلگرام، روی Reply Markup بزنید و گزینه‌ی Inline Keyboard را انتخاب کنید.
• حالا روی دکمه‌ی add keyboard row کلیک کنید و بعد دکمه‌ی add button بزنید.

اینجا دو دکمه می‌سازیم:

• دکمه‌ی اول (تأیید): در فیلد Text بنویسید تأیید و ارسال. گزینه‌ی add Fields را بزنید و URL را انتخاب کنید. در کادر بنویسید:

• دکمه‌ی دوم (رد): دوباره روی Add Button کلیک کنید. در فیلد Text بنویسید رد و نوشتن دستی. گزینه‌ی add Fields را بزنید و URL را انتخاب کنید و بنویسید:

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

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

• روی علامت + کلیک کنید و نود Wait را به صفحه بیاورید.
• در تنظیمات نود، بخش Resume را پیدا کنید و آن را روی حالت On Webhook Call (منتظر ماندن برای دریافت یک فرمان خارجی) قرار دهید.

• حالا ایجنت دقیقاً در همین نقطه به خواب می‌رود تا زمانی که در تلگرام یکی از دکمه‌ها را فشار دهیم و بیدارش کنیم.

وقتی در تلگرام دکمه‌ای را می‌زنیم، کلمه‌ی رمز آن (approve یا reject) به n8n فرستاده می‌شود. ما باید ایجنت را سر یک دو راهی قرار دهیم:

• بعد از نود Wait، روی علامت + کلیک کنید و نود Switch را به صفحه بیاورید.
• وقتی تنظیمات نود باز می‌شود، شما باید قانون (Rule) تعیین کنید. روی دکمه‌ی Add Routing Rule کلیک کنید:

ساخت مسیر اول (برای دکمه‌ی تأیید):

• کادر اول (Value 1) را روی حالت fx قرار دهید و کد زیر را وارد کنید.
• فیلد دوم را روی is equal to قرار دهید.
• در فیلد سوم (Value 2) کلمه‌ی approve را بنویسید.

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

• یک مسیر دیگر بسازید. کادر اول را روی کد زیر تنظیم کنید.
• در کادر دوم is equal to را انتخاب کرده و در کادر سوم کلمه‌ی reject را تایپ کنید.

حالا باید مشخص کنیم اگر دکمه‌ی تأیید زده شد، ایمیل واقعاً ارسال شود:

• به خروجی اول نود Switch یک نود Gmail وصل کنید.
• فیلد Resource را روی Message و Operation را روی Reply قرار دهید.
• در فیلد Message ID روی علامت fx کلیک کرده و کد زیر را وارد کنید (کلمه Get many messages باید دقیقاً هم‌نام نود اول شما باشد):

• برای اینکه هوش مصنوعی فقط جواب را بفرستد و بخش خلاصه را برای فرستنده ایمیل نکند، در فیلد Message (متن پیام) کد زیر را وارد کنید:

اگر دکمه‌ی رد را زدید، ربات فقط باید لینک ایمیل را بفرستد تا خودتان جواب دهید:

• به خروجی دوم نود Switch یک نود Telegram به‌شکل Send a message وصل کنید.
• Chat ID خود را وارد کنید.
• در کادر Text روی علامت fx کلیک کنید و فقط لینک زیر را قرار دهید: (کلمه Get many messages باید دقیقاً هم‌نام نود اول شما باشد).

با این کار، با ردکردن پیش‌نویس، لینک مستقیم ایمیل به تلگرام شما می‌آید تا با یک کلیک وارد جیمیل شوید.

بعد از تست‌کردن کامل و سبزشدن تمام نودها، زمانی که مطمئن شدید همه‌چیز به‌درستی کار می‌کند، روی دکمه‌ی Publish بزنید تا ایجنت شما در زمان‌های تاییدشده شروع به‌کار کند.

شما موفق شدید اولین دستیار هوشمند و خودمختار خودتان را با n8n بسازید.

نمونه‌ی پیام ارسال‌شده به تلگرام از طریق ایجنت به‌شکل زیر است. با زدن دکمه‌ی تایید، پیام به نود Switch می‌رسد که در آنجا با تشخیص مقدار (Approve)، مسیر پاسخ، به نود Gmail (ارسال ایمیل) هدایت می‌شود. این نود، پاسخ آماده‌شده را به فرستنده ارسال می‌کند.

برای حداکثر استفاده از محیط n8n بد نیست نکات زیر را پیش‌از ساخت ایجنت بدانید.

به‌جای طراحی کامل ورک‌فلو که برای افراد مبتدی سخت و زمانبر است، می‌توانید در همان ابتدا به دستیار هوش مصنوعی n8n بگویید که چه سناریویی در ذهن دارید؛ او به جای شما نودها را می‌چیند و ساختار اصلی ورک‌فلو را در چندثانیه می‌سازد؛ بدین‌ترتیب حتی اگر برای اولین‌بار وارد n8n می‌شوید، دستیار هوش مصنوعی مثل یک مهندس خبره، اسکلت‌بندی کارتان را برایتان آماده می‌کند.

بااین‌حال شما همچنان باید تنظیمات خاصی را شخصا ایجاد کنید؛ برای مثال تنظیماتی مثل وارد کردن API مدل زبانی مدنظرتان، لاگین‌شدن در حساب گوگل و واردکردن چت‌آیدی تلگرام را همچنان خودتان باید دستی انجام دهید.

ملیکا طاهران‌ پور

آموزش پرامپت نویسی هوش مصنوعی؛ چگونه دقیقا به آنچه از AI می‌خواهیم برسیم؟

مطالعه '9

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

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

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

آیا موفق شدید این ایجنت را برای خودتان بسازید؟ در مسیر راه‌اندازی آن با چه چالشی روبه‌رو شدید یا چه ایده‌ی جدیدی برای توسعه و شخصی‌سازی آن به ذهنتان رسید؟