ساخت خودکار تیکت Jira از ایمیل با هوش مصنوعی Llama 3.2

ایجاد تیکت Jira از ایمیل با هوش مصنوعی و Llama 3.2

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

این گردش کار و سایر گردش کارهای اتوماسیون قدرتمند را در کاتالوگ Axeto کاوش کنید: https://axeto.ai/n8n

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

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

1. دریافت ایمیل و بازیابی محتوا: به صورت دوره‌ای Gmail را برای یافتن ایمیل‌های جدید از فرستنده مشخصی بررسی کرده و محتوای کامل آن‌ها را بازیابی می‌کند.

2. تحلیل ایمیل با هوش مصنوعی و استخراج وظایف: از Llama 3.2 از طریق یک عامل LangChain برای تحلیل محتوای ایمیل، دسته‌بندی آن (ویژگی/مشکل)، خلاصه‌سازی تیکت اصلی و استخراج وظایف فرعی در قالبی ساختاریافته JSON استفاده می‌کند.

3. تجزیه JSON و آماده‌سازی داده‌ها: خروجی خام JSON هوش مصنوعی را پاکسازی و تجزیه کرده، سپس وظایف فرعی را به آیتم‌های جداگانه برای پردازش تقسیم می‌کند.

4. ایجاد تیکت Jira: یک تیکت اصلی Jira را بر اساس خلاصه هوش مصنوعی ایجاد کرده و متعاقباً تمام وظایف فرعی مرتبط را که به تیکت اصلی پیوند داده شده‌اند، ایجاد می‌کند.

5. هماهنگی و همگام‌سازی: از گره‌های انتظار (Wait nodes) برای اطمینان از اجرای متوالی و مدیریت وابستگی‌ها بین پردازش هوش مصنوعی و ایجاد تیکت Jira استفاده می‌کند.

تشریح جزئیات نودها

۱. دریافت ایمیل و بازیابی محتوا

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

• نودها:

* Check for New Emails (Gmail Trigger)

* Fetch Full Email Content (Gmail Node)

• جزئیات نود:

* Check for New Emails

* نوع: n8n-nodes-base.gmailTrigger

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

* پیکربندی: از اعتبارنامه OAuth2 "Gmail account - test" استفاده می‌کند. بر اساس ایمیل فرستنده فیلتر می‌کند.

* ورودی: ندارد (نود تریگر).

* خروجی: متادیتای ایمیل‌های جدید، از جمله شناسه پیام (message ID) را منتشر می‌کند.

* نسخه: ۱.۲

* مشکلات احتمالی: محدودیت‌های نرخ API Gmail، عدم وجود ایمیل مطابق، خطاهای احراز هویت.

* Fetch Full Email Content

* نوع: n8n-nodes-base.gmail

* نقش: با استفاده از شناسه پیام (message ID)، محتوای کامل یک ایمیل را بازیابی می‌کند.

* پیکربندی: عملیات روی "get" تنظیم شده و messageId به صورت پویا از خروجی تریگر (={{ $json.id }}) تنظیم می‌شود.

* اعتبارنامه‌ها: از همان اعتبارنامه OAuth2 "Gmail account - test" استفاده می‌کند.

* ورودی: خروجی Check for New Emails.

* خروجی: محتوای کامل ایمیل (بدنه، فرستنده، موضوع و غیره).

* نسخه: ۲.۱

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

۲. تحلیل ایمیل با هوش مصنوعی و استخراج وظایف

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

• نودها:

* Analyze Email & Extract Tasks (LangChain Agent Node)

* Chat Model (LangChain LLM Chat Ollama Node)

* AI Tool - Think Support (LangChain Tool Think Node)

• جزئیات نود:

* Analyze Email & Extract Tasks

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

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

* پیکربندی:

* متن ورودی، بدنه ایمیل است (={{ $json.text }}).

* پیام سیستمی به هوش مصنوعی دستور می‌دهد که JSON خالص با فیلدهای مشخص: category, main_ticket, main_description, و sub_tasks را خروجی دهد.

* از ابزار "think" برای استدلال کمکی استفاده می‌کند.

* ورودی: محتوای ایمیل از Fetch Full Email Content.

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

* نسخه: ۱.۸

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

* Chat Model

* نوع: @n8n/n8n-nodes-langchain.lmChatOllama

* نقش: بک‌اند مدل Llama 3.2 را برای عامل هوش مصنوعی فراهم می‌کند.

* پیکربندی: مدل روی "llama3.2" تنظیم شده است.

* اعتبارنامه‌ها: از اعتبارنامه API "Ollama - test" استفاده می‌کند.

* ورودی: به عنوان ارائه‌دهنده مدل زبانی از Analyze Email & Extract Tasks متصل شده است.

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

* نسخه: ۱

* مشکلات احتمالی: خطاهای احراز هویت API، عدم دسترسی به مدل، خطاهای زمانی درخواست.

* AI Tool - Think Support

* نوع: @n8n/n8n-nodes-langchain.toolThink

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

* ورودی: به عنوان ارائه‌دهنده ابزار هوش مصنوعی به Analyze Email & Extract Tasks متصل شده است.

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

* نسخه: ۱

* مشکلات احتمالی: خرابی ابزار یا پیکربندی نادرست.

۳. تجزیه JSON و آماده‌سازی داده‌ها

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

• نودها:

* Parse JSON Output from AI (Code Node)

* Wait (Wait Node)

* Split Subtasks JSON to Items (Code Node)

• جزئیات نود:

* Parse JSON Output from AI

* نوع: n8n-nodes-base.code

* نقش: پاسخ خام هوش مصنوعی را پردازش می‌کند، نشانگرهای بلوک کد markdown (```json) را حذف کرده و JSON را تجزیه می‌کند.

* عناصر کلیدی کد: نشانگرهای ``json در ابتدا و ` در انتها را حذف می‌کند. از JSON.parse استفاده کرده و در صورت شکست خطا ایجاد می‌کند. یک شیء JSON تجزیه شده با category, main_ticket, main_description, و sub_tasks` برمی‌گرداند.

* ورودی: خروجی از Analyze Email & Extract Tasks.

* خروجی: شیء JSON ساختاریافته برای نودهای پایین‌دستی.

* نسخه: ۲

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

* Wait

* نوع: n8n-nodes-base.wait

* نقش: با انتظار برای تکمیل نود Parse JSON Output from AI قبل از ادامه، پردازش متوالی را تضمین می‌کند.

* پیکربندی: انتظار پیش‌فرض (بدون تاخیر مشخص)، برای همگام‌سازی استفاده می‌شود.

* ورودی: از Analyze Email & Extract Tasks.

* خروجی: نود Parse JSON Output from AI را فعال می‌کند.

* نسخه: ۱.۱

* مشکلات احتمالی: تاخیرهای جزئی در اجرا.

* Split Subtasks JSON to Items

* نوع: n8n-nodes-base.code

* نقش: آرایه sub_tasks را از JSON تجزیه شده به آیتم‌های جداگانه تبدیل می‌کند و امکان ایجاد جداگانه وظایف فرعی Jira را برای هر کدام فراهم می‌سازد.

* عناصر کلیدی کد: آرایه sub_tasks را استخراج می‌کند. هر شیء وظیفه فرعی را به یک آیتم جدید با کلید sub_task نگاشت می‌کند.

* ورودی: خروجی از Jira - Create Main Issue (پس از ایجاد تیکت اصلی).

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

* نسخه: ۲

* مشکلات احتمالی: آرایه sub_tasks خالی، اشیاء وظیفه فرعی نامعتبر.

۴. ایجاد تیکت Jira

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

• نودها:

* Jira - Create Main Issue (Jira Node)

* Create Subtasks (Jira Node)

• جزئیات نود:

* Jira - Create Main Issue

* نوع: n8n-nodes-base.jira

* نقش: تیکت اصلی Jira را ایجاد می‌کند.

* پیکربندی:

* شناسه پروژه: 10002

* نوع تیکت: Task (شناسه 10008)

* خلاصه: به صورت پویا از فیلد main_ticket در JSON تجزیه شده تنظیم می‌شود.

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

* مسئول: شناسه کاربر 5fec3f15dd5eb501088e0226 (نام کش شده "ajay").

* اعتبارنامه‌ها: از اعتبارنامه API "Jira SW Cloud - test" استفاده می‌کند.

* ورودی: از Parse JSON Output from AI.

* خروجی: کلید و جزئیات تیکت Jira برای تیکت اصلی تازه ایجاد شده.

* نسخه: ۱

* مشکلات احتمالی: خطاهای API Jira، شناسه‌های پروژه یا کاربر نامعتبر، مجوزهای ناکافی.

* Create Subtasks

* نوع: n8n-nodes-base.jira

* نقش: وظایف فرعی را زیر تیکت اصلی Jira ایجاد می‌کند.

* پیکربندی:

* شناسه پروژه: 10002

* نوع تیکت: Subtask (شناسه 10010)

* خلاصه و توضیحات: به صورت پویا از هر آیتم sub_task تنظیم می‌شود (sub_task.summary, sub_task.description).

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

* مسئول: همانند تیکت اصلی.

* اعتبارنامه‌ها: از همان اعتبارنامه API "Jira SW Cloud - test" استفاده می‌کند.

* ورودی: از Split Subtasks JSON to Items.

* خروجی: وظایف فرعی Jira ایجاد شده.

* نسخه: ۱

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

۵. هماهنگی گردش کار و یادداشت‌ها

• نودها:

* Sticky Note (Sticky Note Node)

• جزئیات نود:

* Sticky Note

* نوع: n8n-nodes-base.stickyNote

* نقش: مروری بر پروژه و توضیحات آن را در بوم گردش کار ارائه می‌دهد.

* محتوا:

```

📌 ایجاد خودکار تیکت Jira از ایمیل (با هوش مصنوعی) – مرور کلی

این گردش کار با هوش مصنوعی، ایمیل‌ها را می‌خواند، درخواست را با استفاده از LLM درک می‌کند و تیکت‌های ساختاریافته Jira ایجاد می‌کند:

مراحل جریان:

📨 هر ۵ دقیقه ایمیل‌های جدید را بررسی می‌کند.

📬 محتوای کامل ایمیل را بازیابی می‌کند.

🧠 محتوا را با هوش مصنوعی تحلیل می‌کند تا مشکل را درک کند.

📝 یک تیکت اصلی Jira ایجاد می‌کند.

➕ وظایف فرعی مرتبط را ایجاد می‌کند.

```

* نسخه: ۱

جدول خلاصه