عامل هوش مصنوعی: استخراج، خلاصه‌سازی و ذخیره مقالات در Notion

عامل هوش مصنوعی: استخراج، خلاصه‌سازی و ذخیره مقالات در Notion (Gemini، Browserless)

این گردش کار، فرآیند دریافت مقالات وب یا لینک‌های به اشتراک گذاشته شده در مکالمات چت را خودکار می‌کند، آن‌ها را با استفاده از هوش مصنوعی Google Gemini خلاصه کرده و محتوای غنی‌شده را در یک پایگاه داده Notion ذخیره می‌کند. همچنین پس از اتمام، یک اعلان تأیید به کانال Discord ارسال می‌کند.

کاتالوگ Axeto.ai: مشاهده گردش کار

نمای کلی گردش کار

این گردش کار n8n، مقالات وب یا لینک‌های به اشتراک گذاشته شده در مکالمات چت را به طور خودکار دریافت کرده و آن‌ها را به عنوان صفحات ساختاریافته در یک پایگاه داده Notion ذخیره می‌کند. این گردش کار از هوش مصنوعی Gemini گوگل برای تفسیر پیام‌های چت و هماهنگی فرآیند، Browserless برای استخراج محتوای وب (web scraping) و API Notion برای ذخیره داده‌های غنی‌شده مقاله استفاده می‌کند. علاوه بر این، پس از اتمام کار، یک اعلان تأیید به کانال Discord ارسال می‌کند.

موارد استفاده هدف:

• تحقیق ساده شده: کاربرانی که می‌خواهند تحقیقات وب یا مقالات به اشتراک گذاشته شده در چت را بدون کپی و پیست دستی ذخیره و سازماندهی کنند.
• مدیریت پایگاه دانش: تیم‌ها یا افرادی که پایگاه دانش خود را در Notion با خلاصه‌های تولید شده توسط هوش مصنوعی و فراداده (metadata) نگهداری می‌کنند.
• گردش کارهای خودکار برش وب: خودکارسازی گردش کارهای برش وب با استخراج محتوا و خلاصه‌سازی بهبود یافته توسط هوش مصنوعی.

ساختار گردش کار:

1. دریافت ورودی: با پیام‌های چت ورودی فعال می‌شود.

2. پردازش و هماهنگی هوش مصنوعی: هوش مصنوعی Gemini گوگل پیام را تفسیر کرده، URLها را شناسایی می‌کند و اجرای ابزارهای بعدی را مدیریت می‌کند.

3. استخراج محتوای وب (Web Scraping): API Browserless محتوای کامل URL ارائه شده را استخراج می‌کند.

4. ذخیره داده: محتوای استخراج شده و پردازش شده توسط هوش مصنوعی به عنوان یک صفحه جدید در پایگاه داده Notion با قالب‌بندی غنی و فراداده ذخیره می‌شود.

5. اطلاع‌رسانی: یک پیام Discord موفقیت در ذخیره‌سازی را تأیید کرده یا خطاها را گزارش می‌دهد.

---

تحلیل گره‌های جزئیات

۱. دریافت ورودی

• گره: When chat message received
• نوع: @n8n/n8n-nodes-langchain.chatTrigger
• نقش: این گره به عنوان نقطه ورود گردش کار عمل می‌کند و از طریق یک Webhook پیام‌های چت جدید را گوش می‌دهد.
• پیکربندی:

* Webhook عمومی برای دسترسی خارجی فعال شده است.

* در این مرحله هیچ فیلتر خاصی اعمال نمی‌شود.

• ورودی/خروجی:

* ورودی: ندارد (چون یک Trigger است).

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

• ملاحظات:

* پیام‌های ورودی بدون URL همچنان گردش کار را فعال می‌کنند اما توسط منطق هوش مصنوعی در مراحل بعدی مدیریت خواهند شد.

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

---

۲. پردازش و هماهنگی هوش مصنوعی

• گره‌ها: Gemini 2.5 PRO, Save Article To Notion
• نقش: این بخش هسته هوشمند گردش کار است. از هوش مصنوعی Google Gemini برای درک پیام چت، استخراج اطلاعات مرتبط و هماهنگی استفاده از ابزارهای مختلف (استخراج محتوای وب، ذخیره در Notion، اطلاع‌رسانی Discord) استفاده می‌کند.

#### ۲.۱ Gemini 2.5 PRO

• نوع: @n8n/n8n-nodes-langchain.lmChatGoogleGemini
• نقش: از مدل هوش مصنوعی Google Gemini برای تفسیر زمینه پیام‌های چت و تولید دستورالعمل‌ها یا محتوا برای مراحل بعدی استفاده می‌کند.
• پیکربندی:

* مدل: models/gemini-2.5-pro-exp-03-25 به دلیل پنجره زمینه بزرگ و سرعت پردازش آن انتخاب شده است.

* دما (Temperature): برای پاسخ‌های هوش مصنوعی قطعی و سازگار، روی 0 تنظیم شده است.

* اعتبارنامه (Credential): نیاز به یک کلید API پیکربندی شده Google Gemini دارد.

• ورودی/خروجی:

* ورودی: داده‌های پیام چت را از گره When chat message received دریافت می‌کند.

* خروجی: محتوا و دستورالعمل‌های تولید شده توسط هوش مصنوعی را به گره عامل Save Article To Notion تغذیه می‌کند.

• ملاحظات:

* برای جلوگیری از خطاهای احراز هویت، از اعتبارنامه‌های API معتبر اطمینان حاصل کنید.

* محدودیت‌های نرخ (rate limits) و سهمیه‌های (quotas) API Google Gemini را در نظر داشته باشید.

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

#### ۲.۲ Save Article To Notion

• نوع: @n8n/n8n-nodes-langchain.agent
• نقش: این گره به عنوان یک عامل هوش مصنوعی عمل می‌کند و اجرای ابزارهای خاص را هماهنگ می‌کند: website_scraper, save_to_notion, و discord_notification.
• پیکربندی:

* پیام سیستمی (System Message): به عامل دستور می‌دهد تا به صورت متوالی از ابزارهای تعریف شده برای استخراج محتوا، ذخیره در Notion و ارسال اعلان‌های Discord استفاده کند.

* پارامترهای ابزار (Tool Parameters): پارامترهای دقیقی را که توسط ابزار save_to_notion انتظار می‌رود، شامل عنوان، توضیحات، برچسب‌ها، تاریخ انتشار، خلاصه، اهداف، مفاهیم، فناوری‌ها، قطعه کدها، نتایج و آیکون مشخص می‌کند.

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

* مدیریت خطا (Error Handling): پیکربندی شده است تا حتی در صورت شکست فراخوانی ابزار، پردازش را ادامه دهد و اطلاعات خطا را خروجی دهد.

• ورودی/خروجی:

* ورودی: خروجی پردازش شده را از گره Gemini 2.5 PRO دریافت می‌کند.

* خروجی: خروجی مستقیمی تولید نمی‌کند؛ بلکه اجرای ابزارهای دیگر را به صورت داخلی فراخوانی و مدیریت می‌کند.

• ملاحظات:

* شکست در هر یک از ابزارهای فراخوانی شده (استخراج محتوا، ذخیره، اطلاع‌رسانی) می‌تواند منجر به موفقیت جزئی گردش کار شود.

* تفسیرهای اشتباه هوش مصنوعی می‌تواند منجر به استخراج ناقص یا نادرست داده‌ها شود.

* اجرای ابزار ممکن است با خطا در زمان‌بندی (timeout) مواجه شود یا خطاهای API را تجربه کند.

---

۳. استخراج محتوای وب (Web Scraping)

• گره: website_scraper
• نوع: @n8n/n8n-nodes-langchain.toolHttpRequest
• نقش: این گره یک درخواست HTTP POST به API Browserless ارسال می‌کند تا محتوای یک URL مشخص را استخراج کند.
• پیکربندی:

* URL: http://browserless:3000/content (فرض بر این است که Browserless به صورت خود میزبان (self-hosted) در دسترس است. در صورت استفاده از سرویس ابری، آن را تنظیم کنید).

* متد (Method): POST

* بدنه (Body) (JSON): شامل URL هدف و gotoOptions از Puppeteer با waitUntil: networkidle0 برای اطمینان از بارگذاری کامل محتوای صفحه قبل از استخراج است.

* توضیحات ابزار (Tool Description): "website\_scraper: Scrape a website given it's URL"

* پارامتر (Parameter): پارامتر url به صورت پویا توسط عامل هوش مصنوعی پر می‌شود.

• ورودی/خروجی:

* ورودی: URL مورد نظر برای استخراج محتوا را از گره عامل Save Article To Notion دریافت می‌کند.

* خروجی: محتوای HTML استخراج شده را به گره عامل هوش مصنوعی برمی‌گرداند.

• ملاحظات:

* از در دسترس بودن API Browserless و پیکربندی صحیح آن اطمینان حاصل کنید (ممکن است برای نسخه‌های ابری نیاز به احراز هویت باشد).

* استخراج محتوا ممکن است برای صفحاتی با اجرای سنگین جاوا اسکریپت یا اقدامات پیشرفته ضد ربات با شکست مواجه شود.

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

---

۴. ذخیره داده در Notion

• گره: save_to_notion
• نوع: n8n-nodes-base.notionTool
• نقش: این گره مسئول ایجاد یک صفحه جدید در پایگاه داده Notion مشخص شده است و آن را با خلاصه تولید شده توسط هوش مصنوعی، فراداده (metadata) و محتوای ساختاریافته استخراج شده از مقاله پر می‌کند.
• پیکربندی:

* شناسه پایگاه داده (Database ID): روی شناسه پایگاه داده Notion هدف شما تنظیم شده است (مثلاً "Knowledge Database").

* نگاشت خصوصیات (Property Mapping):

* عنوان (Title): به عنوان مقاله تولید شده توسط هوش مصنوعی نگاشت شده است.

* بلوک‌های محتوای غنی (Rich Content Blocks): با سرصفحه‌ها و بخش‌های متنی مختلف که به صورت پویا از خروجی‌های هوش مصنوعی (خلاصه، اهداف، مفاهیم، فناوری‌ها، قطعه کدها، نتایج) پر می‌شوند، پیکربندی شده است.

* سایر خصوصیات: به توضیحات، URL، برچسب‌ها و تاریخ انتشار نگاشت شده‌اند.

* آیکون (Icon): به صورت پویا با استفاده از یک ایموجی انتخاب شده توسط هوش مصنوعی تنظیم می‌شود.

* اعتبارنامه (Credential): نیاز به یک کلید API پیکربندی شده Notion با دسترسی مناسب به پایگاه داده هدف دارد.

• ورودی/خروجی:

* ورودی: محتوا و فراداده تولید شده توسط هوش مصنوعی را از گره عامل Save Article To Notion دریافت می‌کند.

* خروجی: URL یا شناسه صفحه Notion تازه ایجاد شده را به گره عامل هوش مصنوعی برمی‌گرداند.

• ملاحظات:

* مجوزهای API Notion را تأیید کنید و اطمینان حاصل کنید که ادغام (integration) به پایگاه داده هدف دسترسی دارد.

* نگاشت نادرست خصوصیات می‌تواند منجر به از دست رفتن داده یا خطا شود.

* بلوک‌های محتوای بزرگ ممکن است از محدودیت‌های API Notion فراتر روند و باعث شکست شوند.

---

۵. اطلاع‌رسانی

• گره: discord_notification
• نوع: n8n-nodes-base.discordTool
• نقش: یک پیام تأیید به کانال Discord تعیین شده ارسال می‌کند و نشان می‌دهد که آیا مقاله با موفقیت ذخیره شده است یا در طول فرآیند خطایی رخ داده است.
• پیکربندی:

* اعتبارنامه‌ها (Credentials): نیاز به اعتبارنامه‌های پیکربندی شده Discord webhook یا bot دارد.

* کانال هدف (Target Channel): شناسه‌های خاص سرور (Guild) و کانال Discord را تنظیم کنید.

* محتوای پیام (Message Content): شامل یک ایموجی اطلاعاتی و یک پیام تأیید تولید شده توسط هوش مصنوعی است.

* Embed: یک پیام Embed برای گنجاندن URL، عنوان و توضیحات مقاله پیکربندی شده است.

• ورودی/خروجی:

* ورودی: محتوای اطلاع‌رسانی تولید شده توسط هوش مصنوعی و فراداده مقاله را دریافت می‌کند.

* خروجی: ندارد (این یک گره پایانی در گردش کار است).

• ملاحظات:

* از پیکربندی صحیح اعتبارنامه‌های API Discord و شناسه‌های کانال/سرور اطمینان حاصل کنید.

* مراقب محدودیت‌های نرخ API Discord باشید.

* در صورت عدم ساختاردهی صحیح، ممکن است خطاهای قالب‌بندی پیام رخ دهد.

---

جدول خلاصه

بازسازی گردش کار از ابتدا

1. افزودن گره Trigger:

* گره Chat Trigger (@n8n/n8n-nodes-langchain.chatTrigger) را اضافه کنید.

* آن را برای استفاده از یک Webhook عمومی پیکربندی کنید.

* در این مرحله فیلتر اضافی لازم نیست.

2. افزودن گره پردازش هوش مصنوعی:

* گره Google Gemini (@n8n/n8n-nodes-langchain.lmChatGoogleGemini) را اضافه کنید.

* اعتبارنامه API Google Gemini خود را پیکربندی کنید.

* مدل models/gemini-2.5-pro-exp-03-25 را انتخاب کرده و دما (temperature) را روی 0 تنظیم کنید.

3. افزودن گره Agent هوش مصنوعی:

* گره Agent (@n8n/n8n-nodes-langchain.agent) را اضافه کرده و نام آن را Save Article To Notion بگذارید.

* پیام سیستمی را پیکربندی کنید تا Agent را در مورد مراحل گردش کار (استخراج محتوا، ذخیره، اطلاع‌رسانی) راهنمایی کند.

* ابزارهایی را که Agent می‌تواند استفاده کند، از جمله website_scraper، save_to_notion و discord_notification تعریف کنید.

* مطمئن شوید که executeOnce فعال است و مدیریت خطا پیکربندی شده است.

4. افزودن گره ابزار استخراج محتوای وب:

* گره HTTP Request (@n8n/n8n-nodes-langchain.toolHttpRequest) را اضافه کرده و نام آن را website_scraper بگذارید.

* URL را روی نقطه پایانی (endpoint) API Browserless خود تنظیم کنید (مثلاً http://browserless:3000/content).

* متد را روی POST تنظیم کرده و بدنه JSON را با URL و گزینه‌های Puppeteer پیکربندی کنید.

* توضیحات ابزار را اضافه کنید: "website\_scraper: Scrape a website given it's URL".

5. افزودن گره ابزار ذخیره در Notion:

* گره Notion (n8n-nodes-base.notionTool) را اضافه کرده و نام آن را save_to_notion بگذارید.

* اعتبارنامه API Notion خود را پیکربندی کنید.

* شناسه پایگاه داده (Database ID) هدف را مشخص کنید.

* فیلدهای داده ورودی (عنوان، خلاصه، URL و غیره) را به خصوصیات Notion و بلوک‌های محتوای مربوطه نگاشت (map) کنید.

* آیکون صفحه را تنظیم کنید.

6. افزودن گره ابزار اعلان Discord:

* گره Discord (n8n-nodes-base.discordTool) را اضافه کرده و نام آن را discord_notification بگذارید.

* اعتبارنامه Webhook یا ربات Discord خود را پیکربندی کنید.

* شناسه‌های Guild و Channel هدف را مشخص کنید.

* محتوای پیام و ساختار embed را برای گنجاندن اطلاعات مربوط به مقاله طراحی کنید.

7. اتصال گره‌ها:

* گره When chat message received را به گره Gemini 2.5 PRO متصل کنید.

* Gemini 2.5 PRO را به Save Article To Notion متصل کنید.

* در داخل گره Agent Save Article To Notion، فراخوانی‌های ابزار را برای پیوند دادن به گره‌های website_scraper، save_to_notion و discord_notification پیکربندی کنید.

8. افزودن یادداشت‌های چسبان (Sticky Notes):

* از گره‌های Sticky Note (n8n-nodes-base.stickyNote) برای افزودن توضیحات برای هر بخش اصلی یا گره پیچیده استفاده کنید و گزینه‌های پیکربندی یا الزامات را شرح دهید.

9. تست و اصلاح:

* گردش کار را ذخیره کرده و با ارسال یک پیام چت حاوی URL آن را تست کنید.

* لاگ‌های اجرا را برای هرگونه خطا نظارت کنید.

* برای عملکرد بهینه، اعلان‌های هوش مصنوعی، پیکربندی ابزارها و تنظیمات Notion/Discord را در صورت نیاز تنظیم کنید.