تحلیل خودکار خطای n8n با هوش مصنوعی و FreshDesk

تحلیل خودکار خطا و مدیریت حوادث با هوش مصنوعی، FreshDesk و Slack

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

دسته‌بندی‌ها: خلاصه‌سازی با هوش مصنوعی، هوش مصنوعی چندوجهی

کاتالوگ Axeto: https://axeto.ai/n8n

---

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

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

گردش کار به بلوک‌های عملکردی کلیدی زیر ساختار یافته است:

• ۱.۱ تشخیص خطا: با استفاده از گره Error Trigger هر خطای اجرای گردش کار را به صورت سراسری ثبت می‌کند.
• ۱.۲ اشکال‌زدایی با هوش مصنوعی: جزئیات خطا و زمینه اجرا را با یک مدل هوش مصنوعی (از طریق LangChain و OpenAI) تجزیه و تحلیل می‌کند تا یک گزارش تشخیصی ساختاریافته و راه‌حل‌های پیشنهادی تولید کند.
• ۱.۳ استانداردسازی داده‌ها: تجزیه و تحلیل هوش مصنوعی و فراداده خطا را به متغیرهای استاندارد و با کاربری آسان پاکسازی و سازماندهی می‌کند.
• ۱.۴ ایجاد تیکت پشتیبانی: با استفاده از گره HTTP Request، یک تیکت پشتیبانی دقیق در FreshDesk ایجاد می‌کند که با بینش‌های حاصل از هوش مصنوعی و زمینه خطا پر شده است.
• ۱.۵ آماده‌سازی پیام اعلان: اطلاعات تیکت را با تجزیه و تحلیل هوش مصنوعی ادغام می‌کند تا یک پیام غنی و قالب‌بندی شده برای Slack بسازد.
• ۱.۶ ارسال هشدار Slack: هشدار آماده شده Slack را به یک کانال تعیین شده ارسال می‌کند و از آگاهی فوری تیم اطمینان حاصل می‌کند.

یادداشت‌های چسبان در سراسر گردش کار تعبیه شده‌اند تا مستندات، دستورالعمل‌های راه‌اندازی و راهنمایی استفاده را ارائه دهند.

---

۲. تحلیل جزئیات نودها

---

۲.۱ تشخیص خطا

• هدف: این بخش به عنوان یک شنونده سراسری برای هر خطایی که در طول اجرای گردش کار n8n رخ می‌دهد، عمل می‌کند. اطلاعات دقیق خطا و زمینه اجرا را برای تجزیه و تحلیل به مراحل بعدی منتقل می‌کند.
• نودها:

* Error Trigger (داخلی)

• پیکربندی:

* نوع: نود داخلی errorTrigger.

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

* ورودی‌ها: ندارد (زیرا یک نود تریگر است).

* خروجی‌ها: داده‌های جامع خطا را شامل پیام خطا، ردیابی پشته (stack trace)، آخرین نود اجرا شده، فراداده اجرا و اطلاعات گردش کار ارائه می‌دهد.

* ملاحظات: در صورت بروز همزمان چندین خطا در گردش کار، ممکن است به دفعات فعال شود. اطمینان حاصل کنید که نودهای بعدی می‌توانند حجم داده را مدیریت کنند و محدودیت‌های نرخ (rate limits) را رعایت کنند.

* نسخه: به نسخه n8n 0.145.0 یا بالاتر نیاز دارد.

---

۲.۲ اشکال‌زدایی با هوش مصنوعی

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

* Debugger (@n8n/n8n-nodes-langchain.chainLlm)

* Structured Output Parser (@n8n/n8n-nodes-langchain.outputParserStructured)

• پیکربندی:

* نود Debugger:

* نوع: نود LangChain chainLlm.

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

* ورودی‌ها: داده‌های خطا را از نود Error Trigger دریافت می‌کند.

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

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

* ملاحظات: به محدودیت‌های نرخ API یا مسائل مربوط به سهمیه (quota) سرویس هوش مصنوعی توجه داشته باشید. داده‌های ورودی نامعتبر می‌توانند منجر به خروجی‌های غیرمنتظره هوش مصنوعی شوند. فرمت پاسخ هوش مصنوعی را تأیید کنید.

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

* نود Structured Output Parser:

* نوع: نود LangChain outputParserStructured.

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

* ورودی‌ها: خروجی متنی خام از نود Debugger را می‌گیرد.

* خروجی‌ها: یک شیء JSON تجزیه شده با فیلدهای به وضوح تعریف شده (مانند analysis.issue, solution.primary_fix, prevention.recommendations).

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

---

۲.۳ استانداردسازی داده‌ها

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

* Clean Data (n8n-nodes-base.set)

• پیکربندی:

* نوع: نود set.

* تنظیمات: چندین متغیر را با استخراج فیلدها از خروجی JSON تجزیه شده هوش مصنوعی و داده‌های اصلی تریگر خطا اختصاص می‌دهد. مثال‌ها شامل workflow_url, debugger_analysis_issue, debugger_solution, و debugger_prevention هستند.

* ورودی‌ها: JSON تجزیه شده هوش مصنوعی را از نود Structured Output Parser دریافت می‌کند.

* خروجی‌ها: یک شیء JSON استاندارد شده با فیلدهای مسطح و نام‌گذاری توصیفی.

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

---

۲.۴ ایجاد تیکت پشتیبانی

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

* Create FreshDesk Ticket (n8n-nodes-base.httpRequest)

• پیکربندی:

* نوع: نود httpRequest.

* تنظیمات:

* متد (Method): POST.

* URL: https://yourcompany.freshdesk.com/api/v2/tickets ( yourcompany را با دامنه واقعی FreshDesk خود جایگزین کنید).

* احراز هویت (Authentication): با استفاده از اعتبارنامه‌های Basic Auth یا API Token در n8n پیکربندی کنید.

* بدنه JSON (JSON Body): به صورت پویا با استفاده از داده‌های استاندارد شده ساخته می‌شود. فیلدهایی مانند subject, description (با جزئیات تجزیه و تحلیل و پیشگیری هوش مصنوعی قالب‌بندی شده)، email, priority, status, type, و source باید پر شوند. برخی از جایگزین‌ها ممکن است نیاز به تکمیل دستی داشته باشند.

* ورودی‌ها: داده‌های استاندارد شده از نود Clean Data.

* خروجی‌ها: پاسخ HTTP از FreshDesk، که معمولاً شامل تأیید ایجاد تیکت و شناسه تیکت جدید است.

* ملاحظات: از اعتبارنامه‌های صحیح API FreshDesk، دامنه معتبر و دسترسی شبکه اطمینان حاصل کنید. خطاهای احتمالی HTTP، شکست‌های احراز هویت و محدودیت‌های نرخ API را مدیریت کنید. تأیید کنید که تمام فیلدهای مورد نیاز به درستی پر شده‌اند.

---

۲.۵ آماده‌سازی پیام اعلان

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

* Merge (n8n-nodes-base.merge)

* Prep Slack Message (n8n-nodes-base.code)

• پیکربندی:

* نود Merge:

* نوع: نود merge.

* تنظیمات: از "Combine mode by position" برای ادغام خروجی نود Create FreshDesk Ticket (داده‌های تیکت) و نود Clean Data (تجزیه و تحلیل هوش مصنوعی و فراداده خطا) استفاده می‌کند.

* ورودی‌ها:

* اصلی: خروجی از Create FreshDesk Ticket.

* ثانویه: خروجی از Clean Data.

* خروجی‌ها: یک شیء JSON واحد که حاوی تمام داده‌های لازم برای پیام Slack است.

* نود Prep Slack Message:

* نوع: نود code (جاوا اسکریپت).

* تنظیمات:

* داده‌های ادغام شده و جزئیات اجرای خطای تریگر را استخراج می‌کند.

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

* یک پیام متنی ساده جایگزین برای کلاینت‌هایی که از بلوک‌ها پشتیبانی نمی‌کنند، تولید می‌کند.

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

* یک شیء JSON حاوی slack_blocks و slack_text را برمی‌گرداند.

* ورودی‌ها: داده‌های ادغام شده از نود Merge.

* خروجی‌ها: بار JSON آماده برای نود Slack، حاوی ساختار کامل پیام و متن جایگزین.

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

---

۲.۶ ارسال هشدار Slack

• هدف: این بخش هشدار Slack آماده شده را به یک کانال تعیین شده ارسال می‌کند و به تیم اعلان‌های فوری و بینش‌های عملی در مورد خطاهای گردش کار ارائه می‌دهد.
• نودها:

* Error Notifcation (n8n-nodes-base.slack)

• پیکربندی:

* نوع: نود slack.

* تنظیمات:

* احراز هویت (Authentication): از اعتبارنامه‌های برنامه OAuth2 Slack با مجوز chat:write استفاده کنید.

* کانال (Channel): شناسه کانال Slack هدف را مشخص کنید (مانند C08UZ06DYAE).

* متن (Text): از یک عبارت برای ارسال متن جایگزین آماده شده توسط نود Prep Slack Message استفاده کنید (مانند $json.slack_text).

* بلوک‌ها (Blocks): به صورت اختیاری برای ارسال بلوک‌های Slack آماده شده پیکربندی کنید.

* ورودی‌ها: داده‌ها از نود Prep Slack Message.

* خروجی‌ها: پاسخ از API Slack.

* ملاحظات: از محدودیت‌های نرخ API Slack آگاه باشید، توکن‌های OAuth معتبر را بررسی کنید و مجوزهای کانال را بررسی کنید. محدودیت‌های اندازه پیام Slack را رعایت کنید.

---

۳. جدول خلاصه

---

۴. بازتولید گردش کار (Workflow)

برای بازتولید این گردش کار:

1. راه‌اندازی n8n: از فعال بودن نمونه n8n خود اطمینان حاصل کنید.

2. نصب Node ها: Node های کامیونیتی مورد نیاز را در صورت عدم وجود نصب کنید: @n8n/n8n-nodes-langchain.

3. پیکربندی اعتبارنامه‌ها (Credentials):

* OpenAI: کلید API OpenAI خود را در اعتبارنامه‌های n8n تنظیم کنید.

* FreshDesk: اعتبارنامه‌های API FreshDesk خود (کلید API یا Basic Auth) را پیکربندی کنید.

* Slack: برنامه Slack خود را با مجوزهای لازم (chat:write) احراز هویت کنید.

4. وارد کردن گردش کار (Workflow): فایل JSON گردش کار را در نمونه n8n خود وارد کنید.

5. سفارشی‌سازی:

* URL گره Create FreshDesk Ticket را با دامنه FreshDesk خود به‌روز کنید.

* شناسه کانال Slack را در گره Error Notifcation تنظیم کنید.

* Prompt ها را در گره Debugger برای تحلیل بهینه هوش مصنوعی مرور و تنظیم کنید.

* هر فیلد خاص مورد نیاز برای تنظیمات تیکت FreshDesk خود را پیکربندی کنید.

6. فعال‌سازی تریگر خطا (Error Trigger): اطمینان حاصل کنید که گره Error Trigger فعال است و برای ثبت خطاها در سطح جهانی پیکربندی شده است.

7. تست: عمداً خطایی را در یکی از گردش کارهای n8n خود ایجاد کنید تا عملکرد سرتاسری را آزمایش کنید.