مقدمه

دستیار هوشمند Notion با n8n:

N8N ابزاری است که به کمک آن می توانید در مدت‌زمان کوتاهی، فرایندهای خود را با هوش مصنوعی خودکار کنید و از مزایای اتوماسیون هوشمند بهره‌ مند شوید.

N8N برای چه کسب و کارهایی مناسب است:

اگر سازمان شما کوچک می باشد و هم اکنون بسیاری از کار های خود را با نرم افزار هایی همچون اکسل انجام می دهید، N8N برای کسب و کار شما ایده آل است و در صورتی که کسب و کاری متوسط یا بزرگ دارید می توانید بخش های بسیاری از فرایند های غیر کلیدی خود را با این ابزار هوشمند کنید.

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

رمز فایل: danixai.com

دستیار هوشمند Notion با n8n:

ساخت خودکار دستیار هوشمند برای Notion با n8n؛ تولید Workflow از روی دیتابیس Notion

ساخت یک AI Agent که بتواند اطلاعات موجود در Notion را جست‌وجو کند و بر اساس محتوای آن به سوالات کاربران پاسخ دهد، ایده جذابی برای ساخت پایگاه دانش هوشمند است. اما زمانی که ساختار دیتابیس Notion تغییر کند، معمولاً باید Workflow مربوط به Agent را نیز به‌صورت دستی تغییر داد. این موضوع مخصوصاً زمانی که با چند دیتابیس مختلف سروکار دارید، می‌تواند زمان‌بر و مستعد خطا باشد.

Workflow حاضر این مشکل را با ترکیب n8n، Notion و مدل‌های زبانی Anthropic حل می‌کند. کاربر فقط URL یک دیتابیس Notion را در Chat وارد می‌کند و Workflow ابتدا ساختار آن دیتابیس را دریافت می‌کند، اطلاعات غیرضروری را حذف و ساختار را استاندارد می‌کند و سپس آن را در اختیار یک Agent هوش مصنوعی قرار می‌دهد.

Agent با استفاده از یک Workflow Template از قبل تعریف‌شده، نسخه جدیدی از Workflow را متناسب با ساختار دیتابیس دریافت‌شده تولید می‌کند. اما فرآیند در همین نقطه تمام نمی‌شود. Workflow تولیدشده ابتدا از نظر وجود خطاهای شناخته‌شده بررسی می‌شود و سپس یک مدل زبانی دیگر اعتبار JSON آن را ارزیابی می‌کند. اگر خروجی مشکل داشته باشد، اطلاعات مربوط به خطا دوباره به مرحله تولید بازگردانده می‌شود تا Workflow اصلاح شود.

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

قبل از شروع

اگر هنوز n8n را نصب نکرده‌اید، پیشنهاد می‌کنیم ابتدا مقاله «آموزش n8n» را مطالعه کنید. در آن مقاله، مراحل نصب با Node.js و Docker، راه‌اندازی اولیه و ساخت اولین Workflow به‌صورت کامل آموزش داده شده است. پس از نصب و راه‌اندازی، به این مقاله بازگردید و مراحل پیاده‌سازی این Workflow را دنبال کنید.

این Workflow چه کاری انجام می‌دهد؟

این Template در واقع فرایند ساخت AI Agent برای دیتابیس Notion را تا حد زیادی خودکار می‌کند.

کاربر از طریق Chat Trigger یک URL مربوط به دیتابیس Notion را وارد می‌کند. سپس Workflow به Notion متصل می‌شود و اطلاعاتی مانند موارد زیر را دریافت می‌کند:

• شناسه دیتابیس
• URL دیتابیس
• نام دیتابیس
• Propertyهای دیتابیس
• نوع هر Property
• گزینه‌های مربوط به Select و Multi-select

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

در مرحله بعد، یک AI Agent با استفاده از مدل Anthropic، ساختار دیتابیس جدید را با یک Workflow Template مقایسه می‌کند. Template داخلی این Workflow در واقع نمونه‌ای از یک Notion Knowledge Base AI Assistant است که شامل Chat Trigger، Notion، AI Agent، Memory و ابزارهای جست‌وجو در Notion است.

Agent نسخه جدید Workflow را تولید می‌کند؛ اما خروجی آن مستقیماً به کاربر تحویل داده نمی‌شود.

ابتدا JSON تولیدشده استخراج می‌شود و قسمت‌هایی که احتمال ایجاد خطا دارند بررسی می‌شوند. سپس یک Text Classifier تشخیص می‌دهد که آیا خروجی یک JSON معتبر برای Workflow n8n است یا خیر.

اگر خروجی نامعتبر باشد، Workflow وارد مسیر اصلاح می‌شود و دوباره Agent برای تولید نسخه اصلاح‌شده اجرا خواهد شد.

در نهایت، JSON معتبر در Chat نمایش داده می‌شود تا کاربر بتواند آن را در محیط n8n Import کند.

کاربردهای این Workflow

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

• ساخت AI Agent برای پایگاه دانش شرکت: اطلاعات منابع انسانی، قوانین داخلی، فرآیندها و مستندات را در Notion نگهداری کنید و برای آن Agent بسازید.
• ساخت دستیار هوشمند برای تیم IT: اطلاعات مربوط به نرم‌افزارها، تجهیزات، مشکلات فنی و دستورالعمل‌های IT را در Notion قرار دهید.
• تولید Agent برای دیتابیس‌های مختلف Notion: به‌جای ساخت دستی Workflow برای هر دیتابیس، URL دیتابیس را به Generator بدهید.
• ساخت دستیار منابع انسانی: اطلاعاتی مانند مرخصی، مزایا، سیاست‌های شرکت و فرآیندهای استخدام می‌توانند در Notion ذخیره شوند.
• ساخت دستیار داخلی برای تیم توسعه: مستندات پروژه، GitHub، DevOps، راهنمای توسعه و اطلاعات فنی را می‌توان به پایگاه دانش تبدیل کرد.
• نمونه‌سازی سریع AI Agent: برای آزمایش ایده‌های مختلف، می‌توان بدون ساخت دستی تمام Nodeها یک Workflow اولیه تولید کرد.
• تبدیل پایگاه‌های داده مختلف به دستیار هوشمند: هر دیتابیس Notion که ساختار متفاوتی داشته باشد می‌تواند ورودی Generator قرار بگیرد.

پیش‌نیازهای اجرای این Workflow

برای راه‌اندازی دستیار هوشمند Notion با n8n به موارد زیر نیاز دارید:

• نصب و راه‌اندازی n8n
• دسترسی به Chat Trigger در n8n
• یک حساب Notion
• Credential مربوط به Notion API
• دسترسی Credential به دیتابیس موردنظر
• API Credential برای مدل Anthropic
• یک دیتابیس Notion دارای Propertyهای مشخص
• امکان استفاده از Nodeهای AI و LangChain در نسخه n8n مورد استفاده
• دسترسی مناسب به API مربوط به Notion

نکته مهم این است که Credentialهای موجود در JSON متعلق به محیطی هستند که Workflow اصلی در آن ساخته شده است. بنابراین هنگام Import کردن Template، نباید انتظار داشته باشید همان Credentialها در محیط شما قابل استفاده باشند.

دانلود Template

فایل JSON این Workflow را از این قسمت دانلود کنید.

رمز فایل: danixai.com

آموزش Import کردن Workflow

وارد داشبورد n8n شوید.
روی Import from File کلیک کنید.
فایل JSON را انتخاب کنید.
Workflow ایجاد خواهد شد.
Credentialهای موردنیاز را تنظیم کنید.

پس از Import کردن Template، برای اجرای صحیح دستیار هوشمند Notion با n8n باید Credentialهای موردنیاز را تنظیم کنید.

ساختار Workflow

ساختار کلی دستیار هوشمند Notion با n8n را می‌توان به چند مرحله اصلی تقسیم کرد:

Chat Trigger
    ↓
Notion
    ↓
Standardize Schema
    ↓
Simplify Properties
    ↓
Set Input Data
    ↓
Generate Workflow Agent
    ↓
Set Schema for Eval
    ↓
Check for WF JSON Errors
    ↓
Valid n8n Workflow JSON?
    ↓
   ├── معتبر → Return Success to Chat
   │
   └── نامعتبر → Add Feedback Prompt
                     ↓
                Set Schema for Rerun
                     ↓
                Set Input Data
                     ↓
                Generate Workflow Agent

در کنار Agent اصلی، چند Node مربوط به مدل زبانی و Output Parser نیز قرار گرفته‌اند:

Anthropic Chat Model
        ↓
Generate Workflow Agent

Structured Output Parser
        ↓
Auto-fixing Output Parser
        ↓
Generate Workflow Agent

Anthropic Chat Model
        ↓
Valid n8n Workflow JSON?

بنابراین این Workflow صرفاً یک AI Agent ساده نیست؛ بلکه یک چرخه تولید، ارزیابی و اصلاح خروجی ایجاد می‌کند.

آموزش کامل Nodeهای Workflow

1. When chat message received (Chat Trigger)

وظیفه Node

نقطه شروع Workflow. یک رابط چت وب‌محور ایجاد می‌کند که کاربر می‌تواند در آن URL پایگاه داده Notion خود را وارد کند.

ورودی

ورودی کاربر (آدرس URL پایگاه داده Notion)

خروجی

رکوردی شامل chatInput (متن ورودی کاربر)، sessionId و action

تنظیمات مهم

پارامتر public روی true تنظیم شده تا رابط چت عمومی باشد. عنوان چت «Notion database assistant generator» و زیرعنوان آن توضیح کوتاهی از عملکرد ارائه می‌دهد. پیام اولیه چت کاربر را راهنمایی می‌کند.

نکات قابل تغییر

می‌توانید متن پیام اولیه، عنوان و زیرعنوان را متناسب با نیاز خود تغییر دهید.

دلیل استفاده در Workflow

به‌عنوان درگاه ورودی Workflow، امکان تعامل کاربر با سیستم را فراهم می‌کند.

2. Notion

وظیفه Node

با استفاده از API رسمی Notion، جزئیات پایگاه داده مورد نظر کاربر را دریافت می‌کند.

ورودی

URL پایگاه داده که از chatInput استخراج شده است.

خروجی

شامل شناسه پایگاه داده، URL، نام، و ساختار فیلدها (Properties)

تنظیمات مهم

از حالت database با ورودی URL استفاده می‌کند. مقدار databaseId با یک عبارت بازیابی_regular expression از chatInput استخراج می‌شود.

نکات قابل تغییر

Credential این Node باید با حساب Notion فعال شما تنظیم شود. اگر دسترسی به دیتابیس مشخصی ندارید، Integration Notion خود را به آن دیتابیس اضافه کنید.

دلیل استفاده در Workflow

دریافت ساختار واقعی پایگاه داده برای تولید Workflow سفارشی ضروری است.

3. standardize schema (Set)

وظیفه Node

خروجی پیچیده API Notion را به ساختار استاندارد و ساده‌تری تبدیل می‌کند.

ورودی

خروجی خام Node Notion

خروجی

شیء inputDatabase شامل فیلدهای id، url، public_url، name و properties

تنظیمات مهم

هر فیلد به‌صورت جداگانه استخراج و نام‌گذاری می‌شود.

نکات قابل تغییر

این Node برای سازگاری با فرمت‌های مختلف خروجی API Notion طراحی شده است.

دلیل استفاده در Workflow

نرمال‌سازی داده‌ها برای پردازش صحیح در مراحل بعدی ضروری است.

4. Simplify properties object (Code)

وظیفه Node

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

ورودی

شیء inputDatabase با فیلدهای کامل

خروجی

همان شیء با فیلدهای ساده‌شده (فقط id، name، type و در صورت وجود select/multi_select، options)

تنظیمات مهم

کد JavaScript از حلقه map روی آیتم‌های ورودی استفاده می‌کند و هر فیلد را به ساختار ساده‌تری تبدیل می‌کند.

نکات قابل تغییر

اگر نوع فیلد خاصی در دیتابیس شما وجود دارد که مدیریت نشده، می‌توانید شرط اضافه کنید.

دلیل استفاده در Workflow

اطلاعات خام Notion بسیار حجیم است. ساده‌سازی آن باعث صرفه‌جویی قابل توجه در توکن‌های مصرفی مدل هوش مصنوعی می‌شود و هزینه و زمان پردازش را کاهش می‌دهد.

5. Set input data (Code)

وظیفه Node

داده‌های ورودی شامل ساختار دیتابیس، prompt بازخورد (در صورت retry) و قالب Workflow مرجع را آماده‌سازی می‌کند.

ورودی

inputDatabase ساده‌شده از مراحل قبل

خروجی

شیء شامل inputDatabase، feedbackPrompt و workflowTemplate

تنظیمات مهم

این Node حاوی کل قالب Workflow مرجع (شامل تمام Nodeها و Connectionهای نمونه) به‌صورت یک شیء JSON بزرگ است. همچنین مکانیزمی برای مدیرت بازخورد خطا (retry) دارد.

نکات قابل تغییر

اگر می‌خواهید از مدل هوش مصنوعی متفاوتی در Workflow تولیدشده استفاده کنید (مثلاً GPT-4 به جای مدل پیش‌فرض)، می‌توانید قالب مرجع را تغییر دهید.

دلیل استفاده در Workflow

تمام ورودی‌های مورد نیاز عامل تولیدکننده را در یک ساختار واحد جمع‌آوری می‌کند.

6. Generate Workflow Agent (AI Agent)

وظیفه Node

مغز اصلی Workflow. با استفاده از مدل هوش مصنوعی Anthropic Claude، یک نسخه سفارشی از Workflow مرجع را بر اساس ساختار پایگاه داده ورودی تولید می‌کند.

ورودی

inputDatabase، feedbackPrompt و workflowTemplate

خروجی

generatedWorkflow شامل کد JSON Workflow تولیدشده

تنظیمات مهم

از نوع عامل reActAgent استفاده می‌کند. سیستم‌پرامپت به مدل می‌گوید که متخصص n8n است و باید فقط JSON معتبر خروجی دهد. maxTokensToSample روی ۸۱۹۲ تنظیم شده تا خروجی‌های بلندتر پشتیبانی شوند.

نکات قابل تغییر

می‌توانید دمای مدل (temperature)، پرامپت سیستم و حداکثر توکن‌ها را تغییر دهید.

دلیل استفاده در Workflow

این Node هوش مصنوعی را با دانش تخصصی n8n ترکیب می‌کند تا Workflow سفارشی تولید کند.

7. Anthropic Chat Model

وظیفه Node

مدل هوش مصنوعی Anthropic Claude را به‌عنوان مغز پردازشی عامل تولید Workflow فراهم می‌کند.

ورودی

درخواست‌های متنی از Generate Workflow Agent

خروجی

پاسخ‌های متنی مدل

تنظیمات مهم

دما (temperature) روی 0.7 و حداکثر توکن‌ها روی 8192 تنظیم شده است.

نکات قابل تغییر

می‌توانید مدل Anthropic دیگری (مانند Claude Sonnet ی Claude Opus) انتخاب کنید یا دما را برای خروجی‌های خلاقانه‌تر یا دقیق‌تر تنظیم کنید.

دلیل استفاده در Workflow

Anthropic Claude به دلیل توانایی بالا در تولید JSON ساختاریافته و درک الگوهای کد، انتخاب مناسبی برای این کار است.

8. Structured Output Parser

وظیفه Node

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

ورودی

پاسخ خام مدل

خروجی

شیء JSON شامل workflowJson

تنظیمات مهم

اسکیمای مورد انتظار { "workflowJson": "json of workflow" } تعریف شده است.

نکات قابل تغییر

اگر فرمت خروجی متفاوتی نیاز دارید، اسکیما را تغییر دهید.

دلیل استفاده در Workflow

تضمین می‌کند که خروجی مدل همیشه در فرمت قابل پردازش باشد.

9. Auto-fixing Output Parser

وظیفه Node

خروجی Structured Output Parser را بررسی و در صورت وجود خطاهای رایج (مانند JSON نامعتبر، کاراکترهای اضافی یا فاصله‌گذاری نادرست) به‌صورت خودکار اصلاح می‌کند.

ورودی

JSON خروجی از Structured Output Parser

خروجی

JSON اصلاح‌شده

تنظیمات مهم

این Node به یک نمونه دیگر از Anthropic Chat Model متصل است تا برای اصلاح خطاها از هوش مصنوعی استفاده کند.

نکات قابل تغییر

معمولاً نیاز به تغییر ندارد.

دلیل استفاده در Workflow

مدل‌های هوش مصنوعی گاهی در تولید JSON خالص با مشکل مواجه می‌شوند. این Node نرخ موفقیت خروجی را به‌شدت افزایش می‌دهد.

10. Set schema for eval (Set)

وظیفه Node

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

ورودی

خروجی عامل تولید

خروجی

شامل searchNotionDBJsonBody (برای بررسی خطای جایگذاری)، generatedWorkflow (JSON نهایی) و inputDatabase (اطلاعات دیتابیس)

تنظیمات مهم

از عبارات بازیابی JavaScript پیچیده برای استخراج مقادیر از JSON تو در تو استفاده می‌کند.

نکات قابل تغییر

اگر خطاهای جدیدی شناسایی کردید، می‌توانید فیلدهای اضافی برای بررسی اضافه کنید.

دلیل استفاده در Workflow

آماده‌سازی داده‌ها برای اعتبارسنجی چندمرحله‌ای خروجی

11. Check for WF JSON errors (Switch)

وظیفه Node

خروجی تولیدشده را برای خطای رایج [object Object] در jsonBody بررسی می‌کند. این خطا زمانی رخ می‌دهد که مدل به‌جای رشته JSON، یک شیء JavaScript خام تولید کند.

ورودی

خروجی از Set schema for eval

خروجی

دو مسیر – خطا یا ادامه

تنظیمات مهم

یک قاعده تعریف شده که بررسی می‌کند آیا searchNotionDBJsonBody شامل رشته object Object است.

نکات قابل تغییر

می‌توانید قواعد بیشتری برای بررسی خطاهای رایج اضافه کنید.

دلیل استفاده در Workflow

شناسایی زودهنگام خطاها و جلوگیری از تولید Workflow نامعتبر

12. Add feedback prompt (Set)

وظیفه Node

یک پیام بازخورد حاوی توضیح خطا و اطلاعات تلاش ناموفق قبلی ایجاد می‌کند تا مدل در تلاش بعدی بتواند اشتباه خود را اصلاح کند.

ورودی

خروجی حاوی خطا

خروجی

شیء با feedbackPrompt که شامل پیام خطای توصیفی است.

تنظیمات مهم

includeOtherFields فعال است تا سایر فیلدها حفظ شوند.

نکات قابل تغییر

متن بازخورد را می‌توانید دقیق‌تر و توصیفی‌تر کنید.

دلیل استفاده در Workflow

بازخورد سازنده به مدل کمک می‌کند در تلاش بعدی خطا را تکرار نکند.

13. Set schem for rerun (Set)

وظیفه Node

اطلاعات inputDatabase را برای ارسال مجدد به عامل تولید آماده می‌کند.

ورودی

خروجی از Add feedback prompt یا Valid n8n workflow JSON؟

خروجی

شیء شامل inputDatabase

تنظیمات مهم

فقط فیلد inputDatabase را حفظ می‌کند تا در چرخه retry استفاده شود.

نکات قابل تغییر

معمولاً نیاز به تغییر ندارد.

دلیل استفاده در Workflow

تنظیم مجدد داده‌ها برای چرخه بازآزمایی

14. Valid n8n workflow JSON? (Text Classifier)

وظیفه Node

یک بررسی نهایی انجام می‌دهد تا تأیید کند آیا خروجی تولیدشده واقعاً یک Workflow JSON معتبر n8n است یا خیر

ورودی

generatedWorkflow از Set schema for eval

خروجی

دو دسته – validJSON یا invalidJSON

تنظیمات مهم

سیستم‌پرامپت به مدل می‌گوید متخصص n8n است و باید فقط JSON را طبقه‌بندی کند.

نکات قابل تغییر

معمولاً نیاز به تغییر ندارد.

دلیل استفاده در Workflow

لایه اعتبارسنجی نهایی برای اطمینان از صحت Workflow تولیدشده قبل از ارسال به کاربر.

15. Return success to chat (Set)

وظیفه Node

پیام موفقیت شامل JSON Workflow نهایی را در قالب مناسب چت آماده می‌کند.

ورودی

خروجی از Text Classifier (در صورت validJSON)

خروجی

متن شامل Workflow JSON با دستورالعمل کپی کردن

تنظیمات مهم

خروجی با فرمت بلوک کد Markdown ارائه می‌شود.

نکات قابل تغییر

می‌توانید دستورالعمل‌های اضافی یا لینک‌های راهنما اضافه کنید.

دلیل استفاده در Workflow

ارائه خروجی نهایی به کاربر در فرمت قابل استفاده

16. Return error to chat (Set)

وظیفه Node

پیام خطای مناسب را در صورتی که URL واردشده معتبر نباشد یا دسترسی وجود نداشته باشد، به کاربر نمایش می‌دهد.

ورودی

خروجی خطا از Node Notion

خروجی

پیام خطای دوستانه

تنظیمات مهم

sessionId برای حفظ جلسه چت حفظ می‌شود.

نکات قابل تغییر

متن خطا را می‌توانید دقیق‌تر و راهنمایی‌محورتر کنید.

دلیل استفاده در Workflow

ارائه بازخورد مناسب به کاربر در صورت بروز خطا

نحوه شخصی‌سازی Workflow

برای شخصی‌سازی دستیار هوشمند Notion با n8n می‌توانید تغییرات زیر را انجام دهید:

تغییر Promptها

پرامپت اصلی عامل تولید Workflow در Node «Set input data» قرار دارد. می‌توانید سیستم‌پرامپت عامل Generate Workflow Agent را برای تغییر رفتار تولید ویرایش کنید. همچنین پرامپت‌های classifier و output parser قابل ویرایش هستند.

تغییر APIها

API اصلی مورد استفاده در Workflow تولیدشده، API رسمی Notion است (Endpointهای /databases/{id}/query و /blocks/{page_id}/children). Credentialهای Notion باید در دو جا تنظیم شوند: یکی برای Node اصلی و دیگری برای Workflow تولیدشده.

تغییر مدل هوش مصنوعی

سه نمونه از Anthropic Chat Model در Workflow وجود دارد. می‌توانید هر کدام را به مدل متفاوتی (OpenAI، Google Gemini یا مدل‌های دیگر) تغییر دهید. همچنین می‌توانید دما و حداکثر توکن‌ها را تنظیم کنید.

تغییر Trigger

Trigger پیش‌فرض Chat Trigger است که یک رابط وب ارائه می‌دهد. می‌توانید آن را با Webhook، Cron Job یا هر Trigger دیگری جایگزین کنید.

تغییر زمان‌بندی

اگر Workflow را با Cron Job اجرا کنید، می‌توانید آن را به‌صورت دوره‌ای (مثلاً روزانه یا هفتگی) اجرا کنید تا Workflow جدید برای دیتابیس‌های به‌روزشده تولید شود.

تغییر شرط‌ها

Node Switch برای بررسی خطای خاصی ([object Object]) تنظیم شده است. می‌توانید شرط‌های بیشتری برای بررسی خطاهای رایج اضافه کنید.

تغییر مسیر اجرای Workflow

می‌توانید مکانیزم retry را غیرفعال کنید یا تعداد دفعات بازآزمایی را محدود کنید. همچنین می‌توانید مسیر خطا را به سیستم اطلاع‌رسانی دیگری (ایمیل، Slack و…) متصل کنید.

مزایای استفاده از این Workflow

• صرفه جویی چشمگیر در زمان: به جای صرف ساعت‌ها برای ساخت دستی Workflow چت‌بات Notion، تنها با وارد کردن URL دیتابیس در عرض چند دقیقه Workflow سفارشی دریافت می‌کنید.
• قابلیت استفاده مجدد برای دیتابیس‌های مختلف: هر بار می‌توانید URL یک پایگاه داده متفاوت وارد کنید و Workflow جدیدی متناسب با آن دریافت کنید، بدون نیاز به تنظیم مجدد
• اعمال خودکار اعتبارسنجی: سیستم سه‌لایه بررسی خطا (بررسی [object Object]، طبقه‌بندی معتبر/نامعتبر، و اصلاح خودکار) تضمین می‌کند Workflow نهایی قابل استفاده باشد.
• کاهش نیاز به دانش فنی عمیق: حتی کاربرانی که با ساختار JSON Workflow n8n آشنا نیستند، می‌توانند با وارد کردن URL، خروجی آماده استفاده دریافت کنند.
• پشتیبانی از بازآزمایی هوشمند: در صورت بروز خطا، Workflow به‌صورت خودکار بازخورد را به مدل ارسال و تلاش مجدد می‌کند تا نتیجه صحیح حاصل شود.
• صرفه جویی در مصرف توکن: ساده‌سازی فیلدهای دیتابیس قبل از ارسال به مدل هوش مصنوعی، باعث کاهش حجم توکن‌های مصرفی و در نتیجه کاهش هزینه API می‌شود.
• انعطاف‌پذیری در سفارشی‌سازی: هر بخش از Workflow قابل ویرایش است و می‌توانید مدل هوش مصنوعی، APIها، Promptها و شرط‌ها را متناسب با نیاز خود تغییر دهید.

نکات مهم

• قبل از استفاده، حتماً اطمینان حاصل کنید که Integration Notion شما به پایگاه داده مورد نظر دسترسی دارد. بدون دسترسی، Node Notion با خطا مواجه خواهد شد.

• این Workflow از مدل Anthropic Claude استفاده می‌کند و برای کار نیاز به یک API Key معتبر دارد. هزینه استفاده از API Anthropic به تعداد توکن‌های مصرفی بستگی دارد.

• Workflow تولیدشده شامل Credentialهای نمونه (مانند حساب OpenAI و Notion) است. قبل از استفاده، Credentialها را با حساب‌های خود جایگزین کنید.

• حداکثر تعداد توکن‌ها روی 8192 تنظیم شده است. اگر دیتابیس Notion شما بسیار بزرگ باشد، ممکن است نیاز به افزایش این مقدار باشد.

• Workflow تولیدشده روی نسخه 1.52.0 یا بالاتر n8n کار می‌کند. نسخه‌های قدیمی‌تر ممکن است سازگاری کامل نداشته باشند.

• مکانیزم retry به‌صورت خودکار عمل می‌کند، اما در صورت بروز خطاهای مکرر، ممکن است Workflow در یک حلقه بی‌نهایت گیر کند. توصیه می‌شود حداکثر تعداد تلاش‌ها را محدود کنید.

• نتایج تولیدشده توسط هوش مصنوعی همیشه 100 درصد دقیق نیستند. Workflow نهایی را قبل از استفاده در محیط تولید، حتماً تست کنید.

• اگر Workflow تولیدشده شامل مقادیر placeholder باشد، آن را به‌صورت دستی جایگزین کنید یا دوباره تلاش کنید.

خطاهای رایج (Troubleshooting)

1. پیام «Sorry that doesn’t look like a valid notion database url»

علت:

URL واردشده توسط کاربر فرمت صحیح ندارد یا Node Notion نتوانسته پایگاه داده را پیدا کند. همچنین ممکن است Integration Notion به آن دیتابیس دسترسی نداشته باشد.

راه‌حل:

از صحیح بودن فرمت URL مطمئن شوید (باید شامل notion.so/ باشد). همچنین در صفحه تنظیمات Integration در Notion، دسترسی پایگاه داده مورد نظر را فعال کنید.

2. Workflow تولیدشده JSON نامعتبر تولید می‌کند.

علت:

مدل هوش مصنوعی ممکن است در تولید JSON خالص با مشکل مواجه شود، به‌ویژه برای دیتابیس‌های بزرگ با فیلدهای متعدد.

راه‌حل:

چند بار تلاش کنید. مکانیزم retry خودکار در Workflow طراحی شده تا این خطاها را اصلاح کند. اگر مشکل ادامه داشت، maxTokensToSample را افزایش دهید.

3. خروجی شامل مقادیر [object Object] به جای رشته JSON

علت:

مدل هوش مصنوعی به‌جای تولید رشته JSON، یک شیء JavaScript خام تولید کرده است. این خطا حدود ۲۵ درصد مواقع رخ می‌دهد.

راه‌حل:

Node Switch در Workflow این خطا را شناسایی و به‌صورت خودکار retry انجام می‌دهد. اگر مشکل ادامه داشت، دمای مدل را کاهش دهید تا خروجی دقیق‌تر شود.

4. ارور احراز هویت Anthropic

علت:

API Key Anthropic نامعتبر، منقضی شده یا اعتبار کافی ندارد.

راه‌حل:

وارد پنل Anthropic شوید و API Key جدیدی بسازید. مطمئن شوید اعتبار حساب شما کافی است و محدودیت نرخ (Rate Limit) فعال نیست.

5. Node Notion خطا برمی‌گرداند اما Workflow متوقف نمی‌شود.

علت:

Node Notion با پارامتر onError: continueErrorOutput تنظیم شده تا در صورت خطا، Workflow متوقف نشود و مسیر خطا را طی کند.

راه‌حل:

این رفتار عادی است. در صورت بروز خطا، Workflow مسیر «Return error to chat» را طی کرده و پیام مناسبی به کاربر نمایش می‌دهد.

جمع‌بندی

Template ساخت دستیار هوشمند Notion با n8n یک ابزار قدرتمند و نوآورانه است که فرآیند ساخت چت‌بات هوشمند برای پایگاه‌های داده Notion را کاملاً خودکار می‌کند. با ترکیب قابلیت‌های هوش مصنوعی Anthropic Claude، API رسمی Notion و اتوماسیون n8n، این Workflow امکان تولید Workflowهای سفارشی برای هر پایگاه داده‌ای را فقط با وارد کردن یک URL فراهم می‌کند. سیستم اعتبارسنجی چندمرحله‌ای با مکانیزم خودکار اصلاح خطا و بازآزمایی هوشمند، تضمین می‌کند که خروجی نهایی Workflowی معتبر و قابل استفاده باشد. برای سازمان‌هایی که حجم زیادی از داده‌ها را در Notion مدیریت می‌کنند، ساخت ابزار دستیار هوشمند Notion با n8n می‌تواند تحول بزرگی در دسترسی به اطلاعات و بهره‌وری تیم ایجاد کند.

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

1. آیا برای استفاده از این Workflow نیاز به دانش برنامه‌نویسی دارید؟

خیر. این Workflow به‌گونه‌ای طراحی شده که بدون نیاز به برنامه‌نویسی قابل استفاده باشد. کافی است API Key و Credentialهای لازم را تنظیم کنید و URL پایگاه داده Notion خود را وارد کنید.

2. هزینه استفاده از API Anthropic چقدر است؟

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

3. آیا می‌توانم به جای Anthropic از OpenAI استفاده کنم؟

بله. می‌توانید Nodeهای Anthropic Chat Model را با OpenAI Chat Model جایگزین کنید. فقط مطمئن شوید OpenAI Credential شما در n8n تنظیم شده و API Key معتبر دارید.

4. آیا این Workflow با پایگاه‌های داده خصوصی Notion کار می‌کند؟

بله، به شرطی که Integration شما به پایگاه داده مورد نظر دسترسی داشته باشد. در صفحه پایگاه داده در Notion، باید Connection مربوط به Integration خود را اضافه کنید.

5. Workflow تولیدشده چه مدت اعتبار دارد؟

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

 

GIT