تحلیلگر ایمیل با هوش مصنوعی: پردازش PDF، تصاویر و ذخیره در …

تحلیلگر ایمیل با هوش مصنوعی: پردازش PDF، تصاویر و ذخیره در Google Drive + تلگرام

این گردش کار، تحلیل و خلاصه‌سازی ایمیل‌های دریافتی و پیوست‌های آن‌ها (PDF و تصاویر) را با استفاده از هوش مصنوعی خودکار می‌کند. این سیستم محتوا را از ایمیل‌ها و پیوست‌ها استخراج کرده، خلاصه‌هایی تولید می‌کند، این خلاصه‌ها را در Google Sheets ذخیره می‌کند و یک خلاصه تجمیعی را از طریق تلگرام ارسال می‌نماید. این فرآیند مدیریت محتوای ایمیل را ساده کرده و دسترسی به اطلاعات مهم و اقدام‌پذیری آن‌ها را آسان می‌سازد.

گردش کار به طور منطقی به بخش‌های زیر تقسیم می‌شود:

• دریافت ورودی: نظارت بر ایمیل‌های دریافتی و شناسایی پیوست‌ها.
• استخراج و دسته‌بندی پیوست: استخراج و جدا کردن پیوست‌های PDF و تصویری.
• تحلیل محتوای پیوست: پردازش PDFها و تصاویر با استفاده از هوش مصنوعی برای تولید خلاصه‌ها.
• خلاصه‌سازی محتوای ایمیل: استخراج و خلاصه‌سازی بدنه اصلی ایمیل.
• ذخیره‌سازی خلاصه: ذخیره تمام خلاصه‌های تولید شده در Google Sheets.
• تجمیع خلاصه: جمع‌آوری خلاصه‌های فردی در یک گزارش واحد و جامع.
• اعلان نهایی: ارسال خلاصه تجمیعی از طریق تلگرام.

---

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

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

گره‌های (Nodes) درگیر:

• Email Trigger (IMAP): گوش دادن به ایمیل‌های جدید.
• If Node: بررسی اینکه آیا ایمیل دارای پیوست است یا خیر.

جزئیات گره:

• Email Trigger (IMAP)

* نوع و نقش: یک گره محرک ایمیل که از طریق IMAP یک صندوق ورودی مشخص را نظارت می‌کند.

* پیکربندی: اطمینان حاصل کنید که downloadAttachments روی true تنظیم شده است تا هرگونه فایل پیوست به طور خودکار دریافت شود.

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های IMAP معتبر برای حساب ایمیل در حال نظارت دارد.

* ورودی/خروجی: ورودی ندارد؛ داده‌های ایمیل جدید، از جمله هرگونه پیوست را خروجی می‌دهد.

* ملاحظات: مشکلات احتمالی اتصال IMAP، خطاهای احراز هویت و مدیریت پیوست‌های بسیار بزرگ.

* یادداشت‌ها: این نقطه شروع گردش کار است.

• If Node

* نوع و نقش: یک گره شرطی که گردش کار را بر اساس وجود پیوست‌ها منشعب می‌کند.

* پیکربندی: بررسی می‌کند که آیا ویژگی binary (نماینده پیوست‌ها) خالی نیست.

* ورودی: داده‌های ایمیل از گره Email Trigger.

* خروجی: دو شاخه: true (پیوست‌ها موجود است) و false (پیوست‌ها موجود نیست).

* ملاحظات: ایمیل‌های با انواع پیوست پشتیبانی نشده یا فایل‌های خراب را مدیریت می‌کند.

---

۲. استخراج و دسته‌بندی پیوست‌ها

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

گره‌های (Nodes) درگیر:

• Code Node: پیوست‌ها را استخراج و جدا می‌کند.
• Switch Node: پیوست‌ها را بر اساس نوع فایل مسیریابی می‌کند.
• Sticky Note Node: توضیحات گردش کار را ارائه می‌دهد.

جزئیات گره‌ها:

• Code Node (استخراج پیوست‌ها)

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

* پیکربندی: داده‌های binary ورودی را پردازش می‌کند و هر پیوست را با داده‌هایش تحت کلید data خروجی می‌دهد.

* ورودی: داده‌های ایمیل حاوی پیوست‌ها از گره If (شاخه true).

* خروجی: چندین آیتم، که هر آیتم نشان‌دهنده یک پیوست منفرد است.

* ملاحظات: ایمیل‌های بدون پیوست یا پیوست‌ها در فرمت‌های پشتیبانی نشده را مدیریت می‌کند.

• Switch Node

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

* پیکربندی:

* شرط ۱: اگر پسوند فایل دقیقاً "pdf" باشد، به شاخه پردازش PDF هدایت می‌شود.

* شرط ۲: اگر پسوند فایل با عبارت منظم /^(jpg|png)$/i (بدون حساسیت به بزرگی و کوچکی حروف برای JPG و PNG) مطابقت داشته باشد، به شاخه پردازش تصویر هدایت می‌شود.

* ورودی: آیتم‌های پیوست منفرد از گره Code Node.

* خروجی: دو خروجی مجزا: pdf و image. پیوست‌ها با پسوندهای دیگر مسیریابی نخواهند شد.

* ملاحظات: حساسیت به بزرگی و کوچکی حروف مدیریت می‌شود.

• Sticky Note Node

* محتوا: "تمام پیوست‌های موجود در ایمیل را استخراج کنید. این گردش کار به طور خاص PDFها و تصاویر را پردازش می‌کند."

* زمینه: دامنه پردازش پیوست در گردش کار را روشن می‌کند.

---

۳. تحلیل محتوای پیوست

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

گره‌های (Nodes) درگیر:

• Google Drive Node (آپلود پیوست‌ها): پیوست‌ها را در Google Drive ذخیره می‌کند.
• Code Node (استخراج متن PDF): متن را از فایل‌های PDF استخراج می‌کند.
• OpenAI Node (تحلیلگر PDF): محتوای PDF را با استفاده از هوش مصنوعی خلاصه می‌کند.
• Code Node (تجزیه‌کننده خروجی ساختاریافته): خروجی هوش مصنوعی را تجزیه می‌کند.
• Google Sheets Node (ذخیره خلاصه PDF): خلاصه‌های PDF را در Google Sheets ذخیره می‌کند.
• OpenAI Node (تحلیل تصویر): توضیحات تصاویر را با استفاده از هوش مصنوعی تولید می‌کند.
• Google Sheets Node (ذخیره خلاصه تصویر): خلاصه‌های تصویر را در Google Sheets ذخیره می‌کند.
• Code Node (نگاشت خلاصه تصویر): خلاصه‌های تصویر را برای تجمیع آماده می‌کند.
• Sticky Note Nodes: توضیحات مربوط به تحلیل PDF و تصویر را ارائه می‌دهند.

جزئیات گره:

• Google Drive Node (آپلود پیوست‌ها)

* نوع و نقش: پیوست‌های پردازش شده (هم PDF و هم تصاویر) را در یک پوشه مشخص Google Drive آپلود می‌کند.

* پیکربندی:

* نام فایل‌ها با استفاده از یک مُهر زمانی و نام فایل اصلی به صورت پویا تولید می‌شوند.

* در پوشه با شناسه (1CV5PgqBQIVFEacmbApdCApjNEtoNPzXQ) در "My Drive" آپلود می‌شود.

* ورودی: داده‌های پیوست از گره Switch.

* خروجی: تأیید آپلود موفقیت‌آمیز در Google Drive.

* ملاحظات: خطاهای احتمالی API Google Drive یا مشکلات مجوز.

• Code Node (استخراج متن PDF)

* نوع و نقش: محتوای متنی ساده را از فایل‌های PDF استخراج می‌کند.

* پیکربندی: از قابلیت‌های داخلی استخراج متن PDF استفاده می‌کند.

* ورودی: داده‌های پیوست PDF از گره Google Drive (پس از آپلود).

* خروجی: محتوای متنی استخراج شده از PDF.

* ملاحظات: ممکن است با PDFهای خراب یا ساختارهای پیچیده سند مواجه شود.

• OpenAI Node (تحلیلگر PDF)

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

* پیکربندی:

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

* ورودی، متن PDF استخراج شده است.

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

* ورودی: متن PDF استخراج شده از گره Code Node (استخراج متن PDF).

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

* مدل هوش مصنوعی: از یک مدل هوش مصنوعی مشخص (مانند Gemini 2.0 Flash از طریق OpenRouter) استفاده می‌کند.

* ملاحظات: خطاهای احتمالی timeout مدل هوش مصنوعی، خلاصه‌های ناقص، یا خطاهای تفسیر prompt.

• Code Node (تجزیه‌کننده خروجی ساختاریافته)

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

* ورودی: خروجی خام هوش مصنوعی از گره تحلیلگر PDF.

* خروجی: محتوای خلاصه تجزیه شده، آماده برای پردازش بیشتر.

* ملاحظات: در صورتی که فرمت خروجی هوش مصنوعی از ساختار مورد انتظار منحرف شود، ممکن است خطا رخ دهد.

• Google Sheets Node (ذخیره خلاصه PDF)

* نوع و نقش: خلاصه‌های PDF تولید شده را به یک Google Sheet اضافه می‌کند.

* پیکربندی:

* یک ردیف جدید با ستون‌های: ID (شناسه پیام ایمیل)، DATE (تاریخ فعلی)، TYPE ("pdf")، EMAIL (فرستنده)، SUBJECT و SUMMARY (خلاصه تولید شده توسط هوش مصنوعی) اضافه می‌کند.

* نیاز به اعتبارنامه‌های OAuth2 Google Sheets دارد.

* یک Google Sheet و صفحه کاری مشخص را هدف قرار می‌دهد.

* ورودی: خلاصه PDF تجزیه شده از گره تجزیه‌کننده خروجی ساختاریافته.

* خروجی: تأیید عملیات افزودن ردیف.

* ملاحظات: خطاهای API Google Sheets، محدودیت‌های سهمیه، یا عدم تطابق فرمت داده.

• OpenAI Node (تحلیل تصویر)

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

* پیکربندی:

* از یک مدل هوش مصنوعی مشخص (مانند OpenAI GPT-4o-mini) استفاده می‌کند.

* ورودی، داده‌های باینری تصویر است که معمولاً در base64 کدگذاری شده است.

* شامل یک prompt سیستمی است که هوش مصنوعی را برای ارائه توضیحات دقیق و واقعی از تصویر راهنمایی می‌کند.

* ورودی: داده‌های پیوست تصویر از گره Switch.

* خروجی: توضیحات متنی محتوای تصویر.

* ملاحظات: خطاهای احتمالی مدل هوش مصنوعی یا مشکلات مربوط به فرمت‌های تصویری پشتیبانی نشده.

• Google Sheets Node (ذخیره خلاصه تصویر)

* نوع و نقش: خلاصه‌های تصویر تولید شده را به همان Google Sheet اضافه می‌کند.

* پیکربندی: مشابه گره ذخیره خلاصه PDF، اما ستون TYPE روی "image" تنظیم شده است.

* ورودی: توضیحات تصویر از گره تحلیل تصویر.

* خروجی: تأیید عملیات افزودن ردیف.

* ملاحظات: مشابه گره ذخیره خلاصه PDF.

• Code Node (نگاشت خلاصه تصویر)

* نوع و نقش: اطمینان حاصل می‌کند که محتوای خلاصه تصویر به درستی فرمت شده است (مانند تنظیم فیلد content) برای مراحل تجمیع بعدی.

* ورودی: خروجی از گره ذخیره خلاصه تصویر.

* خروجی: محتوای خلاصه نگاشت شده، آماده برای ادغام.

* ملاحظات: خطاهای احتمالی نگاشت داده.

• Sticky Note Node (تحلیل PDF)

* محتوا: "محتوای فایل‌های PDF را تحلیل کرده و برای هر کدام خلاصه‌ای تولید کنید."

* زمینه: هدف مراحل پردازش PDF را روشن می‌کند.

• Sticky Note Node (تحلیل تصویر)

* محتوا: "محتوای تصویر را تحلیل کرده و توضیحات دقیقی ارائه دهید."

* زمینه: هدف مراحل پردازش تصویر را روشن می‌کند.

---

۴. خلاصه‌سازی محتوای ایمیل

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

گره‌های (Nodes) درگیر:

• Markdown Node (تبدیل متن): HTML را به متن ساده تبدیل می‌کند.
• OpenAI Node (خلاصه‌ساز ایمیل): محتوای متنی ساده ایمیل را خلاصه می‌کند.
• Google Sheets Node (ذخیره خلاصه ایمیل): خلاصه ایمیل را در Google Sheets ذخیره می‌کند.
• Code Node (نگاشت خلاصه ایمیل): خلاصه ایمیل را برای مرحله تجمیع آماده می‌کند.
• Sticky Note Node: توضیحات گردش کار را ارائه می‌دهد.

جزئیات گره:

• Markdown Node (تبدیل متن)

* نوع و نقش: بدنه HTML ایمیل (textHtml) را به فرمت متن ساده تبدیل می‌کند.

* پیکربندی: فیلد textHtml را از داده‌های ایمیل به عنوان ورودی می‌گیرد.

* ورودی: داده‌های ایمیل از گره If (هر دو شاخه true و false، برای مدیریت ایمیل‌های با یا بدون پیوست).

* خروجی: نسخه متن ساده محتوای ایمیل.

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

• OpenAI Node (خلاصه‌ساز ایمیل)

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

* پیکربندی:

* از یک prompt سیستمی دقیق استفاده می‌کند که به هوش مصنوعی دستور می‌دهد ایمیل را در 3-5 جمله خلاصه کند، جزئیات کلیدی و لحن اصلی را حفظ کند.

* ورودی، محتوای متنی ساده ایمیل است.

* ورودی: محتوای متنی ساده ایمیل از گره Markdown Node.

* خروجی: نسخه‌ای خلاصه شده از متن ایمیل.

* مدل هوش مصنوعی: از یک مدل هوش مصنوعی مشخص استفاده می‌کند (مثلاً DeepSeek R1 از طریق OpenRouter).

* ملاحظات: خطاهای احتمالی API هوش مصنوعی، محدودیت‌های نرخ (rate limits) یا تفسیر نادرست prompt.

• Google Sheets Node (ذخیره خلاصه ایمیل)

* نوع و نقش: خلاصه ایمیل تولید شده را به Google Sheet اضافه می‌کند.

* پیکربندی: مشابه گره‌های ذخیره خلاصه پیوست، اما ستون TYPE روی "email" تنظیم شده است.

* ورودی: متن خلاصه شده ایمیل از گره خلاصه‌ساز ایمیل.

* خروجی: تأیید عملیات افزودن ردیف.

* ملاحظات: خطاهای API Google Sheets یا محدودیت‌های سهمیه (quota limits).

• Code Node (نگاشت خلاصه ایمیل)

* نوع و نقش: محتوای خلاصه ایمیل را (مثلاً با تنظیم فیلد content) برای مرحله نهایی تجمیع قالب‌بندی می‌کند.

* ورودی: خروجی از گره ذخیره خلاصه ایمیل.

* خروجی: محتوای خلاصه آماده شده.

* ملاحظات: خطاهای احتمالی نگاشت داده.

• Sticky Note Node

* محتوا: "محتوای بدنه ایمیل را تحلیل و خلاصه کن."

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

---

۵. ذخیره‌سازی خلاصه

این بخش با ذخیره خلاصه‌های تولید شده برای متن ایمیل، PDF و تصاویر در یک Google Sheet واحد، سوابق متمرکزی را برای دسترسی و بررسی آسان فراهم می‌کند.

گره‌های (Nodes) درگیر:

• Google Sheets Node (ذخیره خلاصه PDF)
• Google Sheets Node (ذخیره خلاصه تصویر)
• Google Sheets Node (ذخیره خلاصه ایمیل)

جزئیات گره:

• هر سه گره Google Sheets برای افزودن ردیف‌ها به طور یکسان پیکربندی شده‌اند. آن‌ها از اعتبارنامه‌های Google Sheets یکسان استفاده می‌کنند و همان صفحه گسترده و برگه کاری را هدف قرار می‌دهند.
• هر گره ورودی را از مرحله خلاصه‌سازی مربوطه خود (PDF، تصویر یا ایمیل) دریافت می‌کند.
• ستون‌های پر شده عبارتند از: ID (شناسه پیام ایمیل)، DATE (تاریخ فعلی)، TYPE (به عنوان مثال، "pdf"، "image"، "email")، EMAIL (فرستنده)، SUBJECT (موضوع) و SUMMARY (متن خلاصه تولید شده توسط هوش مصنوعی).
• ملاحظات: محدودیت‌های احتمالی سهمیه API، مشکلات مجوز با Google Sheets و عدم تطابق فرمت داده بین محتوای خلاصه و فرمت مورد انتظار برگه.

---

۶. تجمیع خلاصه

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

گره‌های (Nodes) درگیر:

• Merge Node (تمام خلاصه‌ها): خلاصه‌ها را از منابع مختلف ترکیب می‌کند.
• Code Node (تجزیه): متن خلاصه را برای تجمیع استخراج می‌کند.
• Aggregate Node: خلاصه‌ها را برای پردازش هوش مصنوعی گروه‌بندی می‌کند.
• OpenAI Node (ایجاد خلاصه نهایی): خلاصه نهایی تجمیع شده را با استفاده از هوش مصنوعی تولید می‌کند.
• Sticky Note Node: توضیحات گردش کار را ارائه می‌دهد.

جزئیات گره‌ها:

• Merge Node (تمام خلاصه‌ها)

* نوع و نقش: خلاصه‌های تولید شده برای متن ایمیل، تصاویر و PDF را در یک جریان داده واحد ترکیب می‌کند.

* پیکربندی: برای پذیرش سه ورودی تنظیم شده است.

* ورودی: خلاصه‌ها از گره نگاشت خلاصه ایمیل، گره نگاشت خلاصه تصویر و مسیر پردازش خلاصه PDF.

* خروجی: یک آرایه ترکیبی حاوی تمام خلاصه‌های فردی.

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

• Code Node (تجزیه)

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

* ورودی: آرایه ترکیبی خلاصه‌ها از گره Merge Node.

* خروجی: لیستی از متون خلاصه، آماده برای گروه‌بندی.

* ملاحظات: با تغییرات در نحوه ساختاردهی خلاصه‌ها از منابع مختلف برخورد می‌کند.

• Aggregate Node

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

* پیکربندی: برای تجمیع تمام ورودی‌ها در یک مورد پیکربندی شده است.

* ورودی: لیست متون خلاصه از گره Code Node (تجزیه).

* خروجی: یک رشته واحد حاوی تمام خلاصه‌های الحاق شده.

* ملاحظات: اطمینان حاصل می‌کند که تمام خلاصه‌ها در اعلان نهایی گنجانده شده‌اند.

• OpenAI Node (ایجاد خلاصه نهایی)

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

* پیکربندی:

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

* ورودی، بلوک متنی بزرگ واحد از گره Aggregate Node است.

* ورودی: خلاصه‌های تجمیع شده از گره Aggregate Node.

* خروجی: متن خلاصه نهایی تجمیع شده.

* مدل هوش مصنوعی: از یک مدل هوش مصنوعی مشخص (مانند OpenRouter Chat Model) استفاده می‌کند.

* ملاحظات: خطاهای احتمالی مدل هوش مصنوعی یا نیاز به تنظیم اعلان برای کیفیت خلاصه بهینه.

• Sticky Note Node

* محتوا: "تمام خلاصه‌های فردی (ایمیل، PDF، تصویر) را تجمیع کرده و یک خلاصه نهایی و جامع با استفاده از هوش مصنوعی ایجاد کنید."

* زمینه: هدف مراحل تجمیع و خلاصه‌سازی نهایی را توضیح می‌دهد.

---

۷. اعلان نهایی

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

گره‌های (Nodes) درگیر:

• Telegram Node: پیام خلاصه نهایی را ارسال می‌کند.

جزئیات گره:

• Telegram Node

* نوع و نقش: ارسال پیام به یک چت تلگرام.

* پیکربندی:

* نیاز به توکن ربات تلگرام (Telegram Bot Token) و شناسه چت (Chat ID) دارد.

* محتوای پیام، خلاصه تجمیع‌شده نهایی تولید شده در مرحله قبل تنظیم می‌شود.

* ورودی: متن خلاصه تجمیع‌شده نهایی از گره OpenAI (ایجاد خلاصه نهایی).

* خروجی: تأیید ارسال پیام به تلگرام.

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

---

این گردش کار راه‌حلی قوی برای پردازش و خلاصه‌سازی خودکار محتوای ایمیل و پیوست‌های آن، با بهره‌گیری از هوش مصنوعی برای تحلیل هوشمند و ارائه بینش‌های کلیدی از طریق کانال‌های راحت مانند Google Sheets و Telegram ارائه می‌دهد.