مقدمه
اتصال Notion به هوشمصنوعی با n8n:
N8N ابزاری است که به کمک آن می توانید در مدتزمان کوتاهی، فرایندهای خود را با هوش مصنوعی خودکار کنید و از مزایای اتوماسیون هوشمند بهره مند شوید.
N8N برای چه کسب و کارهایی مناسب است:
اگر سازمان شما کوچک می باشد و هم اکنون بسیاری از کار های خود را با نرم افزار هایی همچون اکسل انجام می دهید، N8N برای کسب و کار شما ایده آل است و در صورتی که کسب و کاری متوسط یا بزرگ دارید می توانید بخش های بسیاری از فرایند های غیر کلیدی خود را با این ابزار هوشمند کنید.
اگر به پیادهسازی اختصاصی، اتصال n8n به نرمافزارهای سازمانی یا سفارشیسازی Workflowها متناسب با کسبوکارتان نیاز دارید، Danix با بررسی نیازهای کسبوکار تان، میتواند این فرایند را از طراحی تا استقرار برای شما انجام دهیم.
برای کسب و کارهای کوچک به این لینک مراجعه کنید.
همچنین اگر ترجیح میدهید شخصاً نصب و راهاندازی را انجام دهید، میتوانید از اطلاعات موجود در مقالات، دسته N8N استفاده کنید .همچنین می توانید template موجود در این workflow را به صورت رایگان از این قسمت دانلود کنید.
رمز فایل: danixai.com
اتصال Notion به هوشمصنوعی با n8n:
ساخت دستیار هوش مصنوعی برای جستجو در پایگاه دانش Notion با n8n
وقتی اطلاعات یک شرکت در یک پایگاه دانش بزرگ ذخیره میشود، پیدا کردن پاسخ مناسب همیشه به سادگی جستجوی یک کلمه نیست. ممکن است یک سؤال با چند عبارت مختلف مطرح شود یا پاسخ موردنظر در میان دهها یا صدها رکورد Notion قرار گرفته باشد. در چنین شرایطی، ترکیب اتصال Notion به هوشمصنوعی با n8n میتواند یک رابط هوشمند برای دسترسی سریعتر به اطلاعات ایجاد کند.
در این Workflow یک دستیار برای اتصال Notion به هوشمصنوعی با n8n ساخته شده است. کاربر سؤال خود را از طریق رابط چت ارسال میکند و AI Agent بر اساس محتوای پایگاه دانش Notion، رکوردهای مرتبط را پیدا کرده و پاسخ را به شکل خلاصه و قابل فهم ارائه میدهد. این Agent مستقیماً به ابزارهایی برای جستجوی پایگاه داده و دریافت محتوای صفحات Notion دسترسی دارد.
Workflow از مدل OpenAI، حافظه مکالمه و دو ابزار HTTP برای تعامل با Notion استفاده میکند. همچنین پیش از اجرای Agent، اطلاعاتی مانند شناسه پایگاه داده، نام Database و گزینههای Tag استخراج و آماده میشوند.
در نتیجه، بهجای اینکه کاربر مجبور باشد در میان صفحات مختلف Notion جستجو کند، میتواند سؤال خود را به زبان طبیعی مطرح کند و پاسخ مرتبط را از دستیار دریافت کند.
قبل از شروع
اگر هنوز n8n را نصب نکردهاید، پیشنهاد میکنیم ابتدا مقاله «آموزش n8n» را مطالعه کنید. در آن مقاله، مراحل نصب با Node.js و Docker، راهاندازی اولیه و ساخت اولین Workflow بهصورت کامل آموزش داده شده است. پس از نصب و راهاندازی، به این مقاله بازگردید و مراحل پیادهسازی این Workflow را دنبال کنید.
این Workflow چه کاری انجام میدهد؟
این Workflow یک دستیار دانش مبتنی بر Notion ایجاد میکند. این ساختار، امکان ساخت دستیار هوش مصنوعی Notion را فراهم میکند که میتواند اطلاعات پایگاه دانش را بهصورت مکالمهای در اختیار کاربر قرار دهد. جریان کار با دریافت پیام کاربر از طریق Chat Trigger شروع میشود. سپس اطلاعات Database از Notion دریافت شده و در یک Node از نوع Set به ساختار موردنیاز Workflow تبدیل میشود.
بعد از آن، پیام کاربر به AI Agent میرسد. Agent با استفاده از مدل زبانی OpenAI میتواند برای پیدا کردن اطلاعات، ابزار جستجوی Database و ابزار دریافت محتوای رکوردهای Notion را فراخوانی کند.
Agent طوری تنظیم شده که پاسخها را بر اساس اطلاعات موجود در Notion تولید کند و از ساختن اطلاعات غیرواقعی جلوگیری کند. همچنین اگر جستجوی اولیه نتیجه مناسبی نداشته باشد، میتواند معیارهای جستجوی جایگزین را امتحان کند.
کاربردهای این Workflow
این Template در سناریوهای مختلف قابل استفاده است، از جمله:
- پشتیبانی داخلی کارکنان: کارمندان میتوانند درباره قوانین، فرآیندها و مستندات شرکت سؤال کنند.
- دستیار منابع انسانی: اطلاعات مربوط به مرخصی، قوانین داخلی و فرآیندهای HR را میتوان در Notion نگهداری کرد.
- جستجوی مستندات فنی: تیمهای فنی میتوانند Documentation و راهنماهای داخلی را در Notion ذخیره کرده و از طریق Agent جستجو کنند.
- پایگاه دانش تیم پشتیبانی: کارشناسان پشتیبانی میتوانند پاسخ سؤالات مشتریان را سریعتر از Knowledge Base استخراج کنند.
- دستیار اطلاعات محصول: مشخصات محصولات، FAQ و مستندات محصول در Notion ذخیره شده و از طریق چت قابل دسترسی هستند.
- دستیار دانش سازمانی: شرکتها میتوانند اطلاعات پراکنده خود را در یک Database متمرکز کرده و یک رابط مکالمهای برای دسترسی به آن ایجاد کنند.
پیشنیازهای اجرای این Workflow
برای اجرای این Template به موارد زیر نیاز دارید:
- یک نمونه فعال n8n
- یک حساب Notion
- یک Notion API Credential
- یک Database در Notion
- دسترسی Integration ساختهشده در Notion به Database موردنظر
- یک OpenAI API Credential
- یک مدل زبانی سازگار با Node مدل AI
- دسترسی به Chat Trigger در n8n
ساختار Database نیز باید با منطق Workflow سازگار باشد. در این Template از فیلدهایی مانند question و tags برای جستجو استفاده شده است. ابزار جستجو امکان فیلتر کردن بر اساس Keyword یا Tag را فراهم میکند و این دو شرط با رابطه OR اجرا میشوند.
برای راهاندازی اولیه، باید Database موردنظر را در Notion با Integration به اشتراک بگذارید و سپس همان Credential را در Nodeهای مربوط به Notion تنظیم کنید.
دانلود Template
فایل JSON این Workflow را از این قسمت دانلود کنید.
رمز فایل: danixai.com
آموزش Import کردن Workflow
وارد داشبورد n8n شوید.
روی Import from File کلیک کنید.
فایل JSON را انتخاب کنید.
Workflow ایجاد خواهد شد.
Credentialهای موردنیاز را تنظیم کنید.
ساختار Workflow
در ادامه، مراحل اتصال Notion به هوشمصنوعی با n8n را از دریافت پیام کاربر تا جستجو در پایگاه دانش بررسی میکنیم:
When chat message received
↓
Get database details
↓
Format schema
↓
AI Agent
↓
OpenAI Chat Model
↓
Window Buffer Memory
↓
Search notion database
↓
Search inside database record
البته OpenAI، Memory و ابزارهای Notion بهصورت مستقیم در مسیر اصلی Workflow قرار نگرفتهاند؛ بلکه به AI Agent بهعنوان Connectionهای مخصوص Agent متصل شدهاند. برای مثال، مدل OpenAI از طریق ai_languageModel، حافظه از طریق ai_memory و ابزارهای Notion از طریق ai_tool به Agent متصل هستند.
آموزش کامل Nodeهای Workflow
1. When chat message received
وظیفه Node
این Node نقطه شروع Workflow است و پیام کاربر را از رابط چت دریافت میکند.
این Trigger بهصورت عمومی تنظیم شده و عنوان رابط چت آن Notion Knowledge Base است. همچنین یک پیام اولیه برای نمایش هنگام شروع مکالمه تعریف شده است.
ورودی
پیام و اطلاعات Session مربوط به کاربر
خروجی
اطلاعاتی مانند sessionId، action و chatInput که در مراحل بعدی Workflow استفاده میشوند.
تنظیمات مهم
گزینه Public فعال است و عنوان رابط چت در تنظیمات Trigger مشخص شده است.
نکات قابل تغییر
میتوانید عنوان Chat، پیام اولیه و تنظیمات مربوط به دسترسی Trigger را تغییر دهید.
دلیل استفاده در Workflow
بدون این Node، Workflow ورودی مکالمهای مشخصی برای دریافت سؤال کاربر نخواهد داشت.
2. Get database details
وظیفه Node
این Node از نوع Notion است و اطلاعات Database موردنظر را دریافت میکند. Database انتخابشده در Template، یک پایگاه دانش با ساختار پرسش و پاسخ و Tag است.
ورودی
شناسه Database که در تنظیمات Node مشخص شده است.
خروجی
اطلاعات Database، از جمله شناسه، عنوان و Propertyهای آن
تنظیمات مهم
Resource روی database قرار دارد و Database ID باید به Database واقعی شما تغییر کند.
نکات قابل تغییر
اگر Database دیگری دارید، باید آن را از قسمت Database انتخاب کنید.
دلیل استفاده در Workflow
Workflow از اطلاعات Database برای ساخت Context و تشخیص Tagهای موجود استفاده میکند.
3. Format schema
وظیفه Node
این Node از نوع Set است و اطلاعات دریافتشده را برای استفاده در مراحل بعدی مرتب و آماده میکند.
مقادیر مهمی که در این مرحله ساخته میشوند شامل sessionId، action، chatInput، notionID، databaseName و tagsOptions هستند.
ورودی
اطلاعات Chat Trigger و خروجی Database
خروجی
یک ساختار استانداردشده شامل اطلاعات موردنیاز Agent و ابزارها
تنظیمات مهم
Expressionهای این Node اطلاعات را از Nodeهای قبلی استخراج میکنند.
نکات قابل تغییر
در صورت تغییر ساختار Database میتوان Expressionهای مربوط به عنوان یا Tagها را تغییر داد.
دلیل استفاده در Workflow
بهجای انتقال دادههای اضافی، فقط اطلاعات موردنیاز مراحل بعدی آماده میشود.
4. AI Agent
وظیفه Node
هسته اصلی Workflow همین Node است. AI Agent پیام کاربر را دریافت میکند و بر اساس System Prompt تصمیم میگیرد چگونه اطلاعات موردنیاز را از Notion پیدا کند.
ورودی
مقدار chatInput
خروجی
پاسخ نهایی و قابل نمایش برای کاربر
تنظیمات مهم
System Prompt مشخص میکند Agent باید فقط از رکوردهای Notion استفاده کند، پاسخها را خلاصه نگه دارد و از Hallucination جلوگیری کند.
همچنین Agent در صورت پیدا نکردن نتیجه مناسب، امکان امتحان کردن عبارتهای جایگزین را دارد.
نکات قابل تغییر
میتوانید لحن پاسخ، طول پاسخ، نحوه برخورد با ابهام و قوانین استفاده از منابع را در System Prompt تغییر دهید.
دلیل استفاده در Workflow
این Node وظیفه تصمیمگیری و هماهنگ کردن مدل AI با ابزارهای جستجوی Notion را بر عهده دارد.
5. OpenAI Chat Model
وظیفه Node
این Node مدل زبانی مورد استفاده Agent را فراهم میکند. در Template از مدل gpt-4o استفاده شده و Temperature روی 0.7 قرار گرفته است. Timeout نیز 25000 میلیثانیه تنظیم شده است.
ورودی
Promptها و اطلاعاتی که AI Agent برای مدل ارسال میکند.
خروجی
پاسخ تولیدشده توسط مدل برای استفاده Agent
تنظیمات مهم
مدل، Temperature و Timeout
نکات قابل تغییر
در صورت دسترسی به مدل مناسب دیگر میتوانید مدل را تغییر دهید. Template همچنین در توضیحات خود اشاره میکند که با Claude 3.5 نیز تست شده است.
دلیل استفاده در Workflow
AI Agent برای تحلیل سؤال، انتخاب ابزار و تولید پاسخ به یک Language Model نیاز دارد.
6. Window Buffer Memory
وظیفه Node
این Node حافظه کوتاهمدت مکالمه را برای Agent فراهم میکند. مقدار contextWindowLength برابر 4 است؛ بنابراین Agent بخشی محدود از مکالمه قبلی را در Context خود نگه میدارد.
ورودی
پیامهای مکالمه
خروجی
Context مکالمه برای AI Agent
تنظیمات مهم
تعداد پیامها یا پنجره Context
نکات قابل تغییر
اگر مکالمههای طولانیتری دارید، میتوان مقدار Context را افزایش داد؛ البته افزایش Context میتواند مصرف Token را بیشتر کند.
دلیل استفاده در Workflow
کاربر میتواند در چند پیام پشت سر هم درباره موضوع مشابه صحبت کند و Agent اطلاعات مکالمه قبلی را بهتر درک کند.
7. Search notion database
وظیفه Node
این Node یک Tool برای AI Agent است و با API مربوط به Notion Database کار میکند. درخواست آن به Endpoint مربوط به Query Database ارسال میشود.
ورودی
Keyword یا Tag انتخابشده توسط Agent
خروجی
رکوردهای مرتبط موجود در Database
تنظیمات مهم
URL API، Method برابر POST، Credential مربوط به Notion و فیلترهای جستجو
در این ابزار، جستجو روی Property question با Keyword و روی Property tags با Tag انجام میشود. این دو شرط رابطه OR دارند.
نکات قابل تغییر
اگر ساختار Database شما متفاوت است، نام Propertyها و منطق Filter باید تغییر کند.
دلیل استفاده در Workflow
Agent از این Tool برای پیدا کردن رکوردهای مرتبط در میان اطلاعات Knowledge Base استفاده میکند.
8. Search inside database record
وظیفه Node
این Node نیز یک Tool برای Agent است، اما برخلاف Node قبلی، برای دریافت محتوای یک Page مشخص از Notion استفاده میشود. Endpoint آن برای دریافت Children مربوط به Page طراحی شده است.
ورودیpage_id که از نتایج جستجوی Database به دست میآید.
خروجی
محتوای Page شامل پاراگرافها، Headingها، لیستها و سایر بخشهای انتخابشده.
تنظیمات مهم
فیلدهای قابل دریافت، Credential و شناسه Page
نکات قابل تغییر
میتوان فیلدهای موردنیاز را بر اساس ساختار صفحات Notion تغییر داد.
دلیل استفاده در Workflow
جستجوی Database فقط مشخص میکند کدام رکورد مرتبط است؛ این Node محتوای واقعی آن رکورد را در اختیار Agent قرار میدهد.
نقش Notion و OpenAI در این Workflow
Notion در این Template نقش Knowledge Base را دارد. اطلاعات شرکت یا تیم در Database ذخیره میشود و Agent به کمک API میتواند آنها را جستجو کند.
OpenAI نیز نقش موتور زبانی را دارد. مدل زبانی سؤال کاربر را تحلیل کرده، ابزار مناسب را انتخاب میکند و نتیجه جستجو را به پاسخ طبیعی تبدیل میکند.
در نتیجه، این Workflow صرفاً یک Chatbot عمومی نیست؛ پاسخ آن باید بر اساس اطلاعاتی باشد که در پایگاه دانش Notion قرار گرفتهاند.
نحوه شخصیسازی Workflow
برای شخصیسازی اتصال Notion به هوشمصنوعی با n8n میتوانید تغییرات زیر را انجام دهید:
تغییر Prompt
مهمترین بخش قابل شخصیسازی، System Prompt مربوط به AI Agent است. میتوانید مشخص کنید Agent چه لحن و ساختاری داشته باشد، چه اطلاعاتی را نمایش دهد و در صورت نبودن پاسخ چه رفتاری انجام دهد.
تغییر مدل AI
در Node مربوط به OpenAI میتوانید مدل مورد استفاده را تغییر دهید. انتخاب مدل بهتر است بر اساس هزینه، سرعت و کیفیت پاسخ انجام شود.
تغییر Database
در Get database details میتوانید Database دیگری را انتخاب کنید. سپس باید مطمئن شوید Propertyهای آن با Filterهای ابزار جستجو هماهنگ هستند.
تغییر Tagها
Workflow گزینههای موجود در Property مربوط به Tag را از Database استخراج میکند و آنها را در اختیار Agent قرار میدهد.
تغییر Trigger
میتوانید Chat Trigger را متناسب با سناریوی خود تغییر دهید یا در صورت نیاز ورودی Workflow را به روش دیگری طراحی کنید.
تغییر حافظه
مقدار Window Memory را میتوان افزایش یا کاهش داد. مقدار بالاتر Context بیشتری در اختیار Agent قرار میدهد اما میتواند مصرف Token را افزایش دهد.
تغییر منطق جستجو
در Search notion database میتوان Filter، Propertyها و Sort را تغییر داد. در Template، نتایج بر اساس زمان بهروزرسانی مرتب میشوند.
مزایای استفاده از این Workflow
- دسترسی سریع به اطلاعات: کاربران بهجای جستجوی دستی، سؤال خود را مطرح میکنند.
- استفاده از دادههای واقعی شرکت: پاسخها به Knowledge Base موجود متکی هستند.
- رابط کاربری ساده: کاربر فقط با یک محیط Chat کار میکند.
- قابل توسعه بودن: میتوان ابزارها و منابع اطلاعاتی بیشتری به Agent اضافه کرد.
- حافظه مکالمه: Agent میتواند بخشی از Context مکالمات قبلی را حفظ کند.
- قابلیت شخصیسازی بالا: Prompt، مدل، Database، Tag و منطق جستجو قابل تغییر هستند.
- کاهش جستجوی دستی: اطلاعات از میان رکوردهای Notion به شکل هوشمند استخراج میشوند.
نکات مهم
برای اینکه اتصال Notion به هوشمصنوعی با n8n بدون مشکل اجرا شود، چند نکته مهم را باید هنگام تنظیم Workflow در نظر بگیرید:
- قبل از اجرای Workflow مطمئن شوید Notion Integration به Database دسترسی دارد.
- Propertyهای Database باید با Filterهای تعریفشده در Tool هماهنگ باشند.
- API Credentialهای Notion و OpenAI را در n8n بهدرستی تنظیم کنید.
- اگر Database پیدا نمیشود، دسترسی Integration را در Notion بررسی کنید.
- افزایش Window Memory باعث افزایش Context و احتمالاً مصرف بیشتر Token میشود.
- Prompt را طوری تنظیم کنید که Agent اطلاعات خارج از Knowledge Base را بهعنوان واقعیت ارائه نکند.
- اگر Tagهای جدید اضافه کردید، مطمئن شوید Workflow آنها را از Database دریافت میکند.
- تغییر ساختار Database ممکن است باعث خراب شدن Queryهای Notion شود.
- قبل از فعالسازی Workflow، آن را از طریق دکمه Chat تست کنید.
- در صورت افزایش تعداد رکوردها، عملکرد و زمان پاسخ API را زیر نظر داشته باشید.
خطاهای رایج (Troubleshooting)
1. خطای پیدا نشدن Database
علت:
Integration مربوط به Notion به Database دسترسی ندارد.
راهحل:
Database را در Notion با Integration موردنظر Share کنید. مستندات Template نیز این مشکل را بهعنوان یکی از خطاهای رایج معرفی کرده است.
2. خطای Credential در Notion
علت:
Credential مربوط به Notion در یکی از Nodeهای موردنیاز تنظیم نشده است.
راهحل:
Credential مربوط به Notion را در Get database details، Search notion database و Search inside database record تنظیم کنید.
3. Agent پاسخ نامرتبط میدهد.
علت:
ساختار Database یا Filterهای جستجو با دادههای واقعی هماهنگ نیست.
راهحل:
نام Propertyهای question و tags، نوع آنها و منطق Filter را بررسی کنید.
4. Agent اطلاعاتی خارج از Knowledge Base ارائه میکند.
علت:
System Prompt ممکن است محدودیت کافی برای استفاده از منابع نداشته باشد یا Prompt تغییر کرده باشد.
راهحل:
در System Prompt تأکید کنید که Agent فقط بر اساس رکوردهای Notion پاسخ دهد و در صورت نبودن اطلاعات، عدم وجود پاسخ را اعلام کند. همین رویکرد در Prompt اصلی Template نیز در نظر گرفته شده است.
5. Workflow کند اجرا میشود.
علت:
دریافت جزئیات Database قبل از اجرای Agent یک مرحله اضافی به Workflow اضافه میکند.
راهحل:
ابتدا زمان اجرای Nodeها را بررسی کنید. توضیحات Template اشاره میکند که مرحله دریافت Database میتواند حدود 250 تا 800 میلیثانیه به هر اجرا اضافه کند.
جمعبندی
ساخت یک دستیار برای اتصال Notion به هوشمصنوعی با n8n نمونه خوبی از ترکیب Automation، Knowledge Base و هوش مصنوعی است. در این Workflow، n8n نقش هماهنگکننده را بر عهده دارد و اجزای مختلف را به یکدیگر متصل میکند؛ Notion منبع اصلی اطلاعات است و مدل زبانی OpenAI وظیفه درک سؤال و تولید پاسخ را انجام میدهد.
مزیت اصلی این ساختار در این است که کاربر مجبور نیست برای پیدا کردن یک پاسخ، صفحات مختلف Knowledge Base را بهصورت دستی بررسی کند. AI Agent میتواند ابتدا Database را جستجو کرده و سپس محتوای Page مرتبط را دریافت کند. حافظه مکالمه نیز امکان حفظ بخشی از Context را فراهم میکند.
ساختار Workflow در عین کاربردی بودن، قابل توسعه است. میتوان Databaseهای دیگری اضافه کرد، ابزارهای جدید در اختیار Agent قرار داد، مدل AI را تغییر داد یا Prompt را برای نیازهای یک سازمان خاص بازنویسی کرد.
برای شرکتهایی که اطلاعات داخلی خود را در Notion نگهداری میکنند، چنین معماری میتواند پایه مناسبی برای ساخت دستیارهای داخلی، سیستمهای پشتیبانی و ابزارهای جستجوی هوشمند باشد.
سوالات متداول
1. آیا برای اجرای این Workflow حتماً به OpenAI نیاز داریم؟
Template با Node مدل OpenAI و مدل gpt-4o تنظیم شده است، اما ساختار Agent میتواند با مدلهای سازگار دیگر نیز استفاده شود. در توضیحات Template به تست آن با Claude 3.5 نیز اشاره شده است.
2. آیا میتوان Database دیگری در Notion استفاده کرد؟
بله. در Node Get database details میتوانید Database موردنظر خود را انتخاب کنید. با این حال، Propertyهای Database باید با منطق جستجوی Workflow هماهنگ باشند.
3. آیا میتوان Tagهای بیشتری اضافه کرد؟
بله. Workflow گزینههای موجود در Property مربوط به Tag را از Database دریافت میکند و در اختیار Agent قرار میدهد. بنابراین میتوانید Tagهای بیشتری در ساختار Notion داشته باشید.
4. آیا این Workflow فقط برای سؤال و جواب مناسب است؟
خیر. Agent برای جستجو و خلاصهسازی اطلاعات چند رکورد نیز طراحی شده است. بنابراین میتوان از آن برای استخراج و جمعبندی اطلاعات موجود در Knowledge Base استفاده کرد.
5. اگر Notion Database پیدا نشود چه کاری باید انجام داد؟
ابتدا بررسی کنید Integration مربوط به Notion به Database دسترسی داشته باشد. سپس Credential تنظیمشده در n8n و Database انتخابشده در Get database details را بررسی کنید.
6. آیا میتوان حافظه مکالمه را افزایش داد؟
بله. Node Window Buffer Memory دارای تنظیم contextWindowLength است و در Template مقدار آن روی 4 تنظیم شده است. با تغییر این مقدار میتوانید حجم Context مکالمه را تغییر دهید.
7. آیا میتوان ظاهر Chat را تغییر داد؟
بله. تنظیمات Chat Trigger شامل عنوان رابط و پیام اولیه است و میتوان آنها را متناسب با برند یا کاربرد Workflow تغییر داد.


