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

دسته‌بندی و حذف خودکار ایمیل برای جیمیل با هوش مصنوعی (پاک‌کننده اسپم/پیشنهادات)

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

این گردش کار و موارد دیگر را در Axeto.ai کاوش کنید: https://axeto.ai/n8n

---

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

گردش کار "حذف خودکار اسپم/بازاریابی و پیشنهادات" برای مدیریت هوشمندانه صندوق ورودی جیمیل شما طراحی شده است. این گردش کار به طور مداوم ایمیل‌های جدید را اسکن می‌کند، از یک مدل زبان هوش مصنوعی (به طور خاص، یک نسخه سبک GPT-4.1) برای دسته‌بندی هر ایمیل به عنوان اسپم (SPAM)، پیشنهاد (OFFER) یا مهم (IMPORTANT) استفاده می‌کند و سپس به طور خودکار موارد دسته‌بندی شده به عنوان اسپم یا پیشنهاد را حذف می‌کند.

گردش کار به اجزای اصلی زیر ساختار یافته است:

• ۱.۱ دریافت ایمیل: یک گره ماشه جیمیل که صندوق ورودی شما را به صورت ساعتی برای ایمیل‌های جدید بررسی می‌کند.
• ۱.۲ دسته‌بندی با هوش مصنوعی: یک گره عامل هوش مصنوعی که توسط مدل زبان OpenAI پشتیبانی می‌شود، محتوای ایمیل را برای تعیین دسته آن تجزیه و تحلیل می‌کند.
• ۱.۳ منطق تصمیم‌گیری: یک گره 'اگر' (If) خروجی دسته‌بندی هوش مصنوعی را ارزیابی کرده و گردش کار را بر اساس نتیجه هدایت می‌کند.
• ۱.۴ حذف ایمیل: یک گره جیمیل که ایمیل‌های علامت‌گذاری شده به عنوان اسپم یا پیشنهاد را به طور دائم حذف می‌کند.
• ۱.۵ مستندات: یک گره یادداشت چسبان (Sticky Note) حاوی اطلاعات دقیق و هشدارهایی در مورد عملکرد گردش کار.

---

۲. تحلیل گره‌های دقیق

۲.۱ دریافت ایمیل

• نام گره: Gmail Trigger
• نوع گره: n8n-nodes-base.gmailTrigger
• عملکرد: این گره به عنوان نقطه ورود عمل می‌کند و هر ساعت صندوق ورودی جیمیل شما را برای پیام‌های ورودی جدید برای شروع گردش کار، بررسی می‌کند.
• پیکربندی:

* pollTimes: برای بررسی‌های ساعتی روی everyHour تنظیم شده است.

* هیچ فیلتر خاصی اعمال نمی‌شود، به این معنی که برای هر ایمیل جدید دریافتی فعال می‌شود.

• ورودی: ندارد (زیرا یک گره ماشه است).
• خروجی: داده‌های ایمیل جدید، از جمله شناسه پیام و خلاصه‌ای از محتوا را به گره‌های بعدی منتقل می‌کند.
• اعتبارنامه‌ها: نیاز به احراز هویت OAuth2 برای جیمیل دارد (مانند Gmail TEST).
• نسخه: ۱.۲
• مشکلات احتمالی:

* خطاهای احراز هویت در صورت انقضای توکن OAuth.

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

* تأخیر در فعال‌سازی در صورت آفلاین بودن نمونه n8n یا غیرفعال بودن گردش کار.

۲.۲ دسته‌بندی با هوش مصنوعی

• گره‌ها: Validator of Email, OpenAI Chat Model
• عملکرد: این بخش از یک مدل زبان هوش مصنوعی برای تجزیه و تحلیل محتوای هر ایمیل ورودی استفاده می‌کند و یکی از سه برچسب را به آن اختصاص می‌دهد: SPAM، OFFER یا IMPORTANT.

* Validator of Email

* نوع گره: @n8n/n8n-nodes-langchain.agent

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

* پیکربندی:

* Text Input: Tu masz ostatnią wiadomość email: \n {{ $json.snippet }} (لهستانی برای "این آخرین پیام ایمیل است").

* System Message Prompt: یک اعلان دقیق، هوش مصنوعی را برای دسته‌بندی ایمیل‌ها به SPAM، OFFER یا IMPORTANT راهنمایی می‌کند و بر پاسخ تک کلمه‌ای تأکید دارد و مثال‌هایی را برای به حداقل رساندن اشتباهات در دسته‌بندی ارائه می‌دهد.

* Prompt Type: define (اعلان سفارشی).

* ورودی: داده‌های ایمیل را از گره Gmail Trigger دریافت می‌کند.

* خروجی: یک شیء JSON حاوی ویژگی output با برچسب دسته‌بندی (SPAM، OFFER یا IMPORTANT).

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های API OpenAI دارد (مانند OpenAi TEST API).

* نسخه: ۱.۹

* مشکلات احتمالی:

* قطعی سرویس هوش مصنوعی یا رسیدن به محدودیت‌های استفاده از API.

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

* خطا در صورت عدم وجود پیش‌بینی نشده فیلد $json.snippet.

* تأخیر به دلیل زمان پردازش فراخوانی API.

* OpenAI Chat Model

* نوع گره: @n8n/n8n-nodes-langchain.lmChatOpenAi

* عملکرد: این گره قابلیت‌های مدل زبان هوش مصنوعی را فراهم می‌کند و به طور خاص از مدل gpt-4.1-nano برای دسته‌بندی استفاده می‌کند.

* پیکربندی:

* Model: gpt-4.1-nano (یک نسخه فشرده GPT-4).

* ورودی: دستورالعمل‌های اعلان را از گره Validator of Email دریافت می‌کند.

* خروجی: نتیجه دسته‌بندی را به گره Validator of Email برمی‌گرداند.

* اعتبارنامه‌ها: از همان اعتبارنامه‌های API OpenAI استفاده می‌کند (مانند OpenAi TEST API).

* نسخه: ۱.۲

* مشکلات احتمالی:

* کلید API نامعتبر یا محدودیت نرخ توسط OpenAI.

* خطا در قالب پاسخ مدل.

۲.۳ منطق تصمیم‌گیری

• نام گره: If
• نوع گره: n8n-nodes-base.if
• عملکرد: این گره خروجی دسته‌بندی را از هوش مصنوعی ارزیابی می‌کند. اگر ایمیل به عنوان SPAM یا OFFER دسته‌بندی شود، گردش کار را به مرحله حذف هدایت می‌کند. ایمیل‌های دسته‌بندی شده به عنوان IMPORTANT از این مرحله عبور می‌کنند.
• پیکربندی:

* شرایط: بررسی می‌کند که آیا فیلد {{$json.output}} برابر با SPAM یا OFFER است.

* اعتبارسنجی حساس به حروف بزرگ و کوچک و نوع داده سخت‌گیرانه فعال است.

• ورودی: نتیجه دسته‌بندی را از گره Validator of Email دریافت می‌کند.
• خروجی:

* شاخه True: در صورت برآورده شدن شرط (SPAM یا OFFER) به گره حذف ایمیل ادامه می‌دهد.

* شاخه False: هیچ اقدام بیشتری برای ایمیل‌های IMPORTANT انجام نمی‌شود.

• نسخه: ۲.۲
• مشکلات احتمالی:

* دسته‌بندی اشتباه به دلیل ویژگی output غیرمنتظره یا گمشده از هوش مصنوعی.

* دسته‌بندی نادرست اگر حروف بزرگ و کوچک خروجی هوش مصنوعی با شرط مطابقت نداشته باشد (به عنوان مثال، "spam" به جای "SPAM").

۲.۴ حذف ایمیل

• نام گره: Delete Email (توجه: در مستندات اصلی غلط املایی "Delate Email" وجود داشت)
• نوع گره: n8n-nodes-base.gmail
• عملکرد: این گره ایمیل‌هایی را که به عنوان اسپم یا پیشنهاد دسته‌بندی شده‌اند، به طور دائم از صندوق ورودی جیمیل شما حذف می‌کند.
• پیکربندی:

* Operation: delete

* Message ID: به طور پویا با استفاده از شناسه گره Gmail Trigger تنظیم شده است: {{$node["Gmail Trigger"].json.id}}.

• ورودی: ایمیل‌ها را از شاخه "true" گره If دریافت می‌کند.
• خروجی: ندارد (این یک گره پایانی برای ایمیل‌های حذف شده است).
• اعتبارنامه‌ها: نیاز به اعتبارنامه‌های OAuth2 جیمیل دارد (مانند Gmail TEST).
• نسخه: ۲.۱
• مشکلات احتمالی:

* شکست در حذف به دلیل شناسه پیام نامعتبر یا خطاهای API جیمیل.

* شرایط رقابتی اگر ایمیل قبل از اجرای گردش کار به صورت دستی از جیمیل حذف شود.

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

۲.۵ مستندات

• نام گره: Sticky Note
• نوع گره: n8n-nodes-base.stickyNote
• عملکرد: این گره حاوی مستندات جاسازی شده است و توضیحات دقیقی از هدف گردش کار، اجزای آن، هشدارهای عملیاتی و توصیه‌های استفاده را در اختیار کاربران قرار می‌دهد.
• پیکربندی: یک بلوک متنی بزرگ حاوی اطلاعات جامع به زبان انگلیسی.
• ورودی/خروجی: ندارد (صرفاً اطلاعاتی).
• نسخه: ۱

---

۳. خلاصه گردش کار

---

۴. ساخت گردش کار از ابتدا

۱. Gmail Trigger:

* یک گره Gmail Trigger (n8n-nodes-base.gmailTrigger) اضافه کنید.

* اعتبارنامه‌های OAuth2 را برای جیمیل پیکربندی کنید.

* pollTimes را روی everyHour تنظیم کنید و فیلترها را خالی بگذارید.

۲. OpenAI Chat Model:

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

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

* gpt-4.1-nano را به عنوان مدل انتخاب کنید.

۳. AI Email Classifier (Agent Node):

* یک گره Validator of Email (@n8n/n8n-nodes-langchain.agent) اضافه کنید.

* از همان اعتبارنامه‌های API OpenAI استفاده کنید.

* Text Input: روی Tu masz ostatnią wiadomość email: \n {{ $json.snippet }} تنظیم کنید.

* System Message: اعلان دقیق برای دسته‌بندی را وارد کنید (همانطور که در مستندات اصلی ارائه شده است).

* Prompt Type: define.

* خروجی گره OpenAI Chat Model را به ورودی ai_languageModel این گره عامل متصل کنید.

۴. منطق شرطی:

* یک گره If (n8n-nodes-base.if) اضافه کنید.

* شرط را برای بررسی اینکه آیا {{$json.output}} برابر با SPAM یا OFFER است، پیکربندی کنید. اطمینان حاصل کنید که اعتبارسنجی حساس به حروف بزرگ و کوچک و نوع داده سخت‌گیرانه فعال است.

۵. حذف ایمیل:

* یک گره Gmail (n8n-nodes-base.gmail) اضافه کنید.

* اعتبارنامه‌های OAuth2 جیمیل را پیکربندی کنید.

* Operation را روی delete تنظیم کنید.

* برای Message ID، از عبارت {{$node["Gmail Trigger"].json.id}} استفاده کنید.

۶. مستندات (اختیاری):

* یک گره Sticky Note (n8n-nodes-base.stickyNote) اضافه کنید.

* توضیحات دقیق گردش کار و هشدارها را در یادداشت بچسبانید.

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

* Gmail Trigger → Validator of Email

* Validator of Email → If

* If (True Branch) → Delete Email

* OpenAI Chat Model → Validator of Email (از طریق ورودی ai_languageModel)

۸. تست و فعال‌سازی:

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

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

---

۵. منابع

• گردش کارهای n8n در Axeto.ai: https://axeto.ai/n8n
• مستندات گره جیمیل n8n: (پیوند به مستندات رسمی n8n در صورت موجود بودن، در غیر این صورت حذف شود)
• مستندات API OpenAI: (پیوند به مستندات رسمی OpenAI در صورت موجود بودن، در غیر این صورت حذف شود)