مقدمه
ساخت دستیار هوشمند با n8n
ساخت دستیار هوشمند با n8n: آموزش ساخت دستیار هوشمند OpenAI با اتصال Google Drive در n8n | راهنمای کامل پیادهسازی AI Assistant
این Template به شما امکان میدهد یک Assistant اختصاصی در OpenAI ایجاد کنید، فایلهای موجود در Google Drive را بهصورت خودکار دانلود و به فرمت مناسب تبدیل کنید، سپس آنها را در OpenAI بارگذاری کرده و به دستیار متصل نمایید. در نهایت نیز کاربران میتوانند از طریق رابط چت n8n با این دستیار گفتگو کنند و پاسخهایی مبتنی بر اطلاعات اختصاصی سازمان دریافت نمایند.
این Workflow نمونهای کاربردی از ترکیب قابلیتهای OpenAI Assistants، Google Drive و n8n است و میتواند پایهای مناسب برای ساخت سیستمهای پشتیبانی مشتری، پاسخگویی به سوالات متداول، راهنمای محصولات، مشاور داخلی سازمان و بسیاری از پروژههای دیگر باشد. اگر قصد دارید بدون برنامهنویسی یک دستیار هوشمند مبتنی بر اسناد خود ایجاد کنید، این آموزش تمامی مراحل را به زبان ساده توضیح میدهد.
قبل از شروع
اگر هنوز n8n را نصب نکردهاید، پیشنهاد میکنیم ابتدا مقاله «آموزش n8n» را مطالعه کنید. در آن مقاله، مراحل نصب با Node.js و Docker، راهاندازی اولیه و ساخت اولین Workflow بهصورت کامل آموزش داده شده است. پس از نصب و راهاندازی، به این مقاله بازگردید و مراحل پیادهسازی این Workflow را دنبال کنید.
این Workflow چه کاری انجام میدهد؟
این Workflow یک دستیار اختصاصی مبتنی بر OpenAI ایجاد میکند که تنها از اطلاعات موجود در فایلهای Google Drive برای پاسخگویی استفاده میکند.
روند اجرای Workflow به این صورت است:
- یک Assistant جدید در OpenAI ایجاد میشود.
- فایل موردنظر از Google Drive دانلود میشود.
- فایل Google Docs به PDF تبدیل میشود.
- فایل در OpenAI آپلود میشود.
- فایل به Assistant متصل میشود.
- کاربران از طریق Chat Trigger با دستیار گفتگو میکنند.
- دستیار با استفاده از فایل بارگذاریشده به سوالات پاسخ میدهد.
- حافظه مکالمه نیز نگهداری میشود تا کیفیت گفتگو افزایش پیدا کند.
در نتیجه، پاسخهای تولیدشده به جای تکیه بر دانش عمومی مدل، بر اساس اطلاعات اختصاصی موجود در اسناد Google Drive ارائه میشوند.
ساخت دستیار هوشمند با n8n
کاربردهای این Workflow
ساخت دستیار هوشمند با n8n در کسبوکارهای مختلف کاربردهای فراوانی دارد و میتواند بهعنوان یک پایگاه دانش هوشمند مورد استفاده قرار گیرد.
- ساخت چتبات پاسخگوی سوالات مشتریان
- ایجاد دستیار هوشمند داخلی برای کارکنان شرکت
- پاسخگویی خودکار بر اساس مستندات سازمان
- راهنمای محصولات و خدمات شرکت
- ایجاد سیستم FAQ هوشمند
- اتصال اسناد Google Docs به OpenAI بدون نیاز به کدنویسی
- ساخت دستیار آموزشی برای دورههای آنلاین
- پاسخگویی بر اساس قوانین و آییننامههای سازمان
- مشاور فروش مبتنی بر اطلاعات محصولات
- ساخت پایگاه دانش (Knowledge Base) هوشمند
پیشنیازهای اجرای Workflow
برای اجرای صحیح این Template به موارد زیر نیاز خواهید داشت:
| پیشنیاز | توضیح |
|---|---|
| نصب n8n | برای اجرای Workflow |
| حساب OpenAI | جهت ایجاد Assistant و استفاده از مدل GPT |
| OpenAI API Key | اتصال n8n به سرویس OpenAI |
| حساب Google | برای دسترسی به Google Drive |
| Google Drive OAuth2 Credential | اتصال n8n به Google Drive |
| فایل Google Docs | سندی که اطلاعات موردنیاز در آن قرار دارد |
| دسترسی به Chat Trigger | برای گفتگو با Assistant |
| اتصال اینترنت پایدار | جهت ارتباط با سرویسهای ابری |
فایل JSON این Workflow را از این قسمت دانلود کنید.
رمز فایل: danixai.com
آموزش Import کردن Workflow
- وارد داشبورد n8n شوید.
- روی Import from File کلیک کنید.
- فایل JSON را انتخاب کنید.
- Workflow ایجاد خواهد شد.
- Credentialهای موردنیاز را تنظیم کنید.
ساخت دستیار هوشمند با n8n
ساختار کلی Workflow
این Workflow از دو مسیر اصلی تشکیل شده است.
مسیر اول: آمادهسازی دستیار
Manual Trigger
↓
OpenAI (Create Assistant)
↓
Google Drive (Download Document)
↓
OpenAI (Upload File)
↓
OpenAI (Update Assistant)
در این مسیر ابتدا دستیار ساخته میشود، سپس فایل Google Docs دانلود شده، به PDF تبدیل میشود، در OpenAI آپلود میشود و در نهایت به دستیار متصل خواهد شد.
مسیر دوم: گفتگو با دستیار
Chat Trigger
↓
OpenAI Assistant
↓
Window Buffer Memory
کاربران پیام خود را ارسال میکنند و Assistant با استفاده از فایل بارگذاریشده و حافظه مکالمات، پاسخ مناسب را تولید میکند.
آموزش کامل تمام Nodeهای Workflow
در این Template چندین Node مختلف برای ایجاد، آموزش و استفاده از یک دستیار هوشمند OpenAI در کنار Google Drive استفاده شده است. هر Node وظیفه مشخصی بر عهده دارد و حذف یا تنظیم نادرست هرکدام میتواند باعث اختلال در عملکرد کل Workflow شود. در ادامه تمامی Nodeهای موجود را بهصورت کامل بررسی میکنیم.
1.Manual Trigger
وظیفه Node
این Node نقطه شروع Workflow است و تنها زمانی اجرا میشود که در محیط طراحی n8n روی دکمه Test Workflow کلیک کنید.
ورودی
ندارد
خروجی
اجرای همزمان دو شاخه از Workflow:
- ایجاد دستیار جدید در OpenAI
- دانلود فایل از Google Drive
تنظیمات مهم
این Node تنظیمات پیچیدهای ندارد و تنها برای اجرای دستی Workflow استفاده میشود.
نکات قابل تغییر
در پروژه واقعی میتوانید این Trigger را با موارد زیر جایگزین کنید:
- Schedule Trigger
- Webhook
- Cron
- فرم ثبت اطلاعات
- Telegram Trigger
- Slack Trigger
- Gmail Trigger
دلیل استفاده در Workflow
در مرحله راهاندازی اولیه، بهترین گزینه اجرای دستی Workflow است تا فرآیند ساخت Assistant فقط در زمان موردنیاز انجام شود.
2.OpenAI (Create Assistant)
وظیفه Node
این Node یک Assistant جدید در OpenAI ایجاد میکند.
در تنظیمات آن مشخص شده است:
- نام Assistant
- مدل هوش مصنوعی
- توضیحات
- دستورالعملهای اصلی
ورودی
خروجی Manual Trigger
خروجی
شناسه Assistant ساختهشده
تنظیمات مهم
در این Template از مدل هوش مصنوعی GPT-4o Mini استفاده شده است که هزینه کمتر و سرعت بالاتری نسبت به بسیاری از مدلهای دیگر دارد.
نام دستیار: Travel with us Assistant
نکات قابل تغییر
میتوانید موارد زیر را تغییر دهید:
- مدل AI
- نام دستیار
- توضیحات
- Prompt
- زبان پاسخها
- لحن گفتگو
- محدودیتهای پاسخگویی
دلیل استفاده در Workflow
بدون ایجاد Assistant امکان استفاده از قابلیت فایلهای اختصاصی OpenAI وجود ندارد.
3.Google Drive
وظیفه Node
دانلود فایل موردنظر از Google Drive
ورودی
شناسه فایل Google Docs
خروجی
فایل PDF
تنظیمات مهم
در این Node فایل Google Docs به صورت خودکار به PDF تبدیل میشود.
پارامتر مهم:
Google File Conversion
که باعث میشود اسناد Google Docs به فایل PDF قابل استفاده در OpenAI تبدیل شوند.
همچنین فایل خروجی داخل Property به نام data.pdf ذخیره میشود.
نکات قابل تغییر
میتوانید:
- فایل دیگری انتخاب کنید.
- Folder دیگری بخوانید.
- چند فایل دانلود کنید.
- فایل Word یا PDF آماده دانلود نمایید.
- فایلهای جدید را بهصورت خودکار پیدا کنید.
دلیل استفاده در Workflow
OpenAI برای پردازش اسناد نیاز به فایل دارد و اطلاعات Google Docs باید ابتدا دانلود و تبدیل شوند.
4.OpenAI (Upload File)
وظیفه Node
آپلود فایل PDF در OpenAI
ورودی
فایل PDF تولیدشده توسط Google Drive
خروجی
File ID
این شناسه بعداً برای اتصال فایل به Assistant استفاده میشود.
تنظیمات مهم
Purpose روی مقدار Assistants قرار گرفته است.
این گزینه مشخص میکند فایل قرار است توسط Assistants API استفاده شود.
نکات قابل تغییر
میتوان فایلهای زیر را نیز آپلود کرد:
- TXT
- Markdown
- CSV
- DOCX
- فایلهای آموزشی دیگر
دلیل استفاده در Workflow
بدون Upload کردن فایل، Assistant به اطلاعات اختصاصی دسترسی نخواهد داشت.
5.OpenAI (Update Assistant)
وظیفه Node
اتصال فایل آپلودشده به Assistant
ورودی
File ID
خروجی
Assistant بهروزرسانیشده
تنظیمات مهم
در این Node شناسه Assistant انتخاب شده و File ID به آن متصل میشود.
از این لحظه دستیار قادر است اطلاعات موجود در فایل را هنگام پاسخگویی استفاده کند.
نکات قابل تغییر
امکان اتصال:
- چند فایل
- فایلهای جدید
- جایگزینی فایلهای قدیمی
- ایجاد نسخههای مختلف پایگاه دانش
وجود دارد.
دلیل استفاده در Workflow
این مرحله پایگاه دانش Assistant را تکمیل میکند.
6.Chat Trigger
نام Node
When chat message received
وظیفه Node
شروع گفتگو با کاربر
هر زمان کاربر پیامی ارسال کند این Node اجرا میشود.
ورودی
پیام کاربر
خروجی
متن پیام برای Assistant
تنظیمات مهم
این Node دارای Webhook اختصاصی است که رابط گفتگوی n8n از آن استفاده میکند.
نکات قابل تغییر
میتوان این Trigger را با موارد زیر جایگزین کرد:
- Telegram
- Discord
- Slack
- فرم وب
- API
- Webhook سفارشی
دلیل استفاده در Workflow
تمام ارتباط کاربران با سیستم از این نقطه آغاز میشود.
7.OpenAI Assistant
وظیفه Node
ارسال پیام کاربر به Assistant و دریافت پاسخ
ورودی
- پیام کاربر
- شناسه Assistant
- حافظه گفتگو
خروجی
پاسخ تولیدشده توسط Assistant
تنظیمات مهم
این Node به همان Assistant ساختهشده متصل میشود و پاسخها را از آن دریافت میکند.
به دلیل اینکه فایل PDF قبلاً به Assistant متصل شده است، پاسخها بر اساس همان اطلاعات تولید خواهند شد.
نکات قابل تغییر
میتوانید:
- Assistant دیگری انتخاب کنید.
- مدل AI را تغییر دهید.
- فایلهای بیشتری متصل کنید.
- تنظیمات پاسخ را تغییر دهید.
دلیل استفاده در Workflow
هسته اصلی سیستم چت همین Node است.
8.Window Buffer Memory
وظیفه Node
نگهداری تاریخچه گفتگو
ورودی
پیامهای قبلی
خروجی
حافظه مکالمه
تنظیمات مهم
این Node چند پیام آخر را ذخیره میکند تا Assistant بتواند مفهوم گفتگو را حفظ کند.
به عنوان مثال اگر کاربر ابتدا درباره تور استانبول سؤال کند و سپس بپرسد «قیمتش چقدر است؟»، Assistant منظور از «آن» را متوجه خواهد شد.
نکات قابل تغییر
میتوانید:
- تعداد پیامهای ذخیرهشده را افزایش دهید.
- حافظه را کوتاهتر کنید.
- از انواع دیگر Memory استفاده کنید.
دلیل استفاده در Workflow
بدون Memory کیفیت مکالمات چندمرحلهای بهطور محسوسی کاهش پیدا میکند.
نحوه عملکرد کلی Workflow
پس از ساخت دستیار هوشمند با n8n میتوانید تقریباً تمام بخشهای Workflow را مطابق نیاز خود شخصیسازی کنید.در یک نگاه، این Template چهار مرحله اصلی را طی میکند:
- ایجاد دستیار هوشمند: ابتدا یک Assistant در OpenAI با دستورالعملهای اختصاصی ساخته میشود.
- ساخت پایگاه دانش: فایل Google Docs دانلود، به PDF تبدیل و در OpenAI بارگذاری میشود تا بهعنوان منبع دانش Assistant مورد استفاده قرار گیرد.
- اتصال فایل به Assistant: فایل بارگذاریشده به Assistant متصل میشود تا پاسخها صرفاً بر اساس محتوای آن تولید شوند.
- گفتگو با کاربران: کاربران از طریق Chat Trigger پیام ارسال میکنند و Assistant با کمک حافظه مکالمه و اطلاعات موجود در فایل، پاسخهای دقیق و مرتبط ارائه میدهد.
این معماری باعث میشود اطلاعات Assistant بهسادگی با بهروزرسانی اسناد Google Drive قابل مدیریت باشد و نیازی به تغییر Prompt یا بازنویسی منطق Workflow برای هر تغییر محتوایی وجود نداشته باشد.
نحوه شخصیسازی Workflow
یکی از مهمترین مزیتهای این Template، انعطافپذیری بالای آن است. تقریباً تمامی بخشهای Workflow قابل تغییر هستند و میتوانید آن را متناسب با نیاز کسبوکار خود سفارشیسازی کنید.
تغییر Prompt دستیار
مهمترین بخش برای شخصیسازی، دستورالعمل (Instructions) موجود در Node OpenAI (Create Assistant) است. با ویرایش این قسمت میتوانید رفتار دستیار را تغییر دهید؛ برای مثال:
-
تعیین لحن رسمی یا دوستانه
-
پاسخگویی به زبان فارسی، انگلیسی یا چندزبانه
-
محدود کردن پاسخها به موضوعات خاص
-
تعیین حداکثر طول پاسخ
-
مشخص کردن نحوه برخورد با سؤالهای نامرتبط
هرچه Prompt دقیقتر نوشته شود، کیفیت پاسخهای Assistant نیز بهتر خواهد بود.
استفاده از مدلهای مختلف OpenAI
در این Template از مدل GPT-4o Mini استفاده شده است، اما در صورت نیاز میتوانید مدل را تغییر دهید. انتخاب مدل به بودجه، سرعت موردنیاز و کیفیت پاسخها بستگی دارد. برای پروژههای ساده، مدلهای سبکتر هزینه کمتری دارند و برای پروژههای تخصصی میتوان از مدلهای قدرتمندتر استفاده کرد.
اتصال فایلهای بیشتر
در این Workflow تنها یک فایل Google Docs به Assistant متصل شده است، اما میتوانید:
-
چندین فایل PDF
-
فایلهای راهنما
-
مستندات فنی
-
کاتالوگ محصولات
-
قوانین سازمان
-
فایلهای آموزشی
را بارگذاری کرده و یک پایگاه دانش جامع ایجاد کنید.
تغییر منبع اطلاعات
اگر اطلاعات شما در Google Drive نگهداری نمیشود، میتوانید منبع داده را تغییر دهید. برای مثال:
-
Dropbox
-
OneDrive
-
AWS S3
-
FTP
-
پایگاه داده
-
Webhook
-
HTTP Request
در این حالت تنها کافی است Node مربوط به دریافت فایل را جایگزین کنید.
تغییر Trigger
در نسخه فعلی، گفتگو از طریق Chat Trigger انجام میشود؛ اما بسته به نیاز پروژه میتوانید آن را با Triggerهای دیگر جایگزین کنید، مانند:
-
Telegram Bot
-
Slack
-
Discord
-
فرم وب
-
Webhook
-
Microsoft Teams
-
WhatsApp (از طریق سرویسهای واسط)
زمانبندی بهروزرسانی اطلاعات
اگر اسناد Google Drive بهطور مرتب تغییر میکنند، میتوانید بهجای Manual Trigger از Schedule Trigger استفاده کنید تا Workflow در بازههای زمانی مشخص اجرا شود. به این ترتیب، فایل جدید بهصورت خودکار در OpenAI بارگذاری و به Assistant متصل خواهد شد.
افزودن منطق شرطی
برای هوشمندتر شدن Workflow میتوانید Nodeهای زیر را اضافه کنید:
-
IF
-
Switch
-
Merge
-
Code
-
Set
برای مثال، اگر فایل جدیدی نسبت به نسخه قبلی تغییری نداشته باشد، فرآیند آپلود مجدد انجام نشود و در مصرف توکن و زمان صرفهجویی شود.
ساخت دستیار هوشمند با n8n
مزایای استفاده از این Workflow
استفاده از این Template مزایای متعددی دارد، از جمله:
-
ایجاد دستیار هوشمند بدون نیاز به برنامهنویسی
-
استفاده از اطلاعات اختصاصی سازمان بهجای دانش عمومی مدل
-
بهروزرسانی آسان پایگاه دانش از طریق Google Drive
-
کاهش زمان پاسخگویی به کاربران
-
امکان توسعه و اتصال به سرویسهای مختلف
-
نگهداری تاریخچه گفتگو برای پاسخهای دقیقتر
-
کاهش هزینه نگهداری سیستمهای پشتیبانی
-
قابلیت استفاده در پروژههای کوچک و بزرگ
-
ساخت پایگاه دانش متمرکز برای کارکنان و مشتریان
نکات مهم
برای بهرهبرداری بهتر از این Workflow، موارد زیر را در نظر داشته باشید:
-
API Keyهای OpenAI و Google Drive را بهصورت امن نگهداری کنید.
-
دسترسی فایل Google Docs را بهدرستی تنظیم کنید.
-
پس از تغییر محتوای فایل، Assistant را مجدداً بهروزرسانی کنید.
-
از Promptهای واضح و دقیق استفاده کنید.
-
فایلهای بسیار بزرگ را به چند بخش تقسیم کنید تا مدیریت آنها سادهتر باشد.
-
حافظه مکالمه را متناسب با نوع پروژه تنظیم کنید.
-
عملکرد Workflow را پس از هر تغییر تست کنید.
-
مصرف توکنهای OpenAI را بهصورت دورهای بررسی کنید.
-
برای پروژههای حساس، سطح دسترسی کاربران به اسناد را کنترل کنید.
-
از نسخههای پشتیبان Workflow و فایلهای مهم نگهداری کنید.
خطاهای رایج (Troubleshooting)
1. خطای Authentication در Google Drive
علت: تنظیم نبودن Credential یا منقضی شدن دسترسی OAuth.
راهحل: اتصال Google Drive را مجدداً احراز هویت کنید و دسترسیهای لازم را بررسی نمایید.
2. خطای Upload File در OpenAI
علت: فرمت فایل پشتیبانی نمیشود یا فایل بهدرستی دانلود نشده است.
راهحل: مطمئن شوید فایل با فرمت مناسب (مانند PDF) تولید شده و در خروجی Node Google Drive موجود است.
3. Assistant پاسخ نامرتبط میدهد
علت: Prompt مناسب نیست یا فایل اطلاعات کافی ندارد.
راهحل: دستورالعملهای Assistant را بازنویسی کنید و محتوای فایل را کاملتر و ساختاریافتهتر نمایید.
4. فایل جدید در پاسخها استفاده نمیشود
علت: Assistant پس از آپلود فایل بهروزرسانی نشده است.
راهحل: Node مربوط به Update Assistant را اجرا کنید و اطمینان حاصل کنید File ID جدید به Assistant متصل شده است.
5. Chat Trigger اجرا نمیشود
علت: Workflow فعال نیست یا تنظیمات Trigger بهدرستی انجام نشده است.
راهحل: Workflow را فعال کنید، آدرس Trigger را بررسی کرده و یک پیام آزمایشی ارسال نمایید.
6. پاسخها بسیار کند هستند
علت: حجم زیاد فایلها، بار بالای مدل یا محدودیتهای سرویس.
راهحل: فایلها را به بخشهای کوچکتر تقسیم کنید، در صورت امکان از مدل سبکتر استفاده کنید و تعداد درخواستهای همزمان را مدیریت نمایید.
جمعبندی
ساخت دستیار هوشمند با n8n یکی از کاربردیترین روشها برای ایجاد سیستمهای پاسخگویی هوشمند مبتنی بر دانش اختصاصی است. در این Workflow، ابتدا یک Assistant در OpenAI ساخته میشود، سپس اسناد موجود در Google Drive دانلود و به فرمت مناسب تبدیل میشوند و در نهایت به دستیار متصل میشوند تا پاسخها بر اساس همان اطلاعات تولید شوند.
مزیت اصلی این معماری، جداسازی منطق هوش مصنوعی از محتوای سازمان است. بهجای ویرایش مداوم Prompt یا تغییر ساختار Workflow، کافی است محتوای فایلهای Google Drive را بهروزرسانی کنید تا Assistant نیز از اطلاعات جدید استفاده کند. این موضوع نگهداری سیستم را سادهتر کرده و امکان توسعه آن برای پروژههای بزرگ را فراهم میسازد.
همچنین، استفاده از حافظه مکالمه باعث میشود دستیار بتواند گفتوگوهای چندمرحلهای را بهتر درک کند و تجربه کاربری طبیعیتری ارائه دهد. اگر به دنبال ساخت یک چتبات سازمانی، سامانه پاسخگویی به سؤالات متداول، مشاور فروش یا پایگاه دانش هوشمند هستید، این Template میتواند نقطه شروع بسیار مناسبی برای پروژه شما باشد.
سوالات متداول
1.آیا میتوان چند فایل را به Assistant متصل کرد؟
بله. Assistants API امکان استفاده از چندین فایل را فراهم میکند و میتوانید پایگاه دانش گستردهتری ایجاد کنید.
2.آیا برای استفاده از این Template باید برنامهنویسی بلد باشم؟
خیر. تمامی مراحل از طریق Nodeهای n8n انجام میشود و برای استفاده از Template به دانش برنامهنویسی نیاز ندارید.
3.آیا امکان اتصال این Assistant به تلگرام یا Slack وجود دارد؟
بله. کافی است Chat Trigger را با Trigger یا Node مربوط به Telegram، Slack، Discord یا سایر سرویسهای پیامرسان جایگزین کنید.
4.چگونه اطلاعات Assistant را بهروزرسانی کنم؟
کافی است محتوای فایل Google Docs را ویرایش کرده و مراحل دانلود، آپلود فایل و بهروزرسانی Assistant را دوباره اجرا کنید تا اطلاعات جدید در پاسخهای دستیار استفاده شود.
5.آیا میتوان از فایلهایی غیر از Google Docs استفاده کرد؟
بله. OpenAI از فرمتهای مختلفی مانند PDF، TXT، Markdown و برخی فرمتهای دیگر پشتیبانی میکند. همچنین میتوانید منبع فایل را از Google Drive به سرویسهای دیگری مانند Dropbox یا OneDrive تغییر دهید.
6.آیا ساخت دستیار هوشمند با n8n برای شرکتهای کوچک هم مناسب است؟
بله. ساخت دستیار OpenAI با Google Drive در n8n تنها برای سازمانهای بزرگ طراحی نشده است. شرکتهای کوچک، استارتاپها، فروشگاههای اینترنتی، آژانسهای خدماتی و حتی کسبوکارهای یکنفره نیز میتوانند از این Workflow برای ایجاد یک دستیار هوشمند مبتنی بر اسناد اختصاصی خود استفاده کنند.


