تحلیل خطای گردش کار n8n با هوش مصنوعی Gemini 2.5 Pro

تحلیل خطا و پیشنهاد اصلاح با هوش مصنوعی برای گردش کار n8n با Gemini 2.5 Pro

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

مزایای کلیدی:

• اشکال‌زدایی سریع: علت اصلی شکست گردش کار را بدون بازرسی دستی لاگ‌ها به سرعت شناسایی کنید.
• بینش‌های عملی: پیشنهادات واضح و گام به گام برای رفع خطاها دریافت کنید.
• نظارت پیشگیرانه: از سلامت گردش کار و مشکلات احتمالی مطلع بمانید.
• تحلیل مبتنی بر هوش مصنوعی: از قابلیت‌های پیشرفته Gemini 2.5 Pro برای تشخیص هوشمندانه بهره ببرید.

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

---

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

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

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

1. ثبت خطا و بازیابی زمینه: خرابی‌های گردش کار را تشخیص داده و تعریف کامل JSON گردش کار ناموفق را واکشی می‌کند.

2. تحلیل علت ریشه‌ای با هوش مصنوعی: جزئیات خطا و زمینه گردش کار را برای تحلیل و پیشنهاد اصلاحات به Gemini 2.5 Pro ارسال می‌کند.

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

---

تشریح گام به گام گردش کار

مرحله ۱: ثبت خطا و بازیابی زمینه

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

نودها:

• Error Trigger (n8n-nodes-base.errorTrigger)
• Get Workflow JSON (n8n-nodes-base.httpRequest)

۱.۱ Error Trigger

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

۱.۲ Get Workflow JSON

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

* URL: به صورت پویا با استفاده از متغیر محیطی N8N_EDITOR_BASE_URL و workflow.id به دست آمده از نود Error Trigger ساخته می‌شود.

* احراز هویت: از احراز هویت هدر HTTP با یک اعتبارنامه عمومی استفاده می‌کند. شما باید کلید API n8n خود را در هدر X-N8N-API-KEY ارائه دهید.

* قالب پاسخ: روی JSON تنظیم شده است.

• ورودی: payload خطا را از نود Error Trigger دریافت می‌کند.
• خروجی: داده‌های کامل JSON گردش کار شکست خورده.
• راه‌اندازی:

1. یک کلید API در نمونه n8n خود ایجاد کنید (تنظیمات > API).

2. یک اعتبارنامه هدر HTTP عمومی در n8n پیکربندی کنید، نام هدر را X-N8N-API-KEY و مقدار هدر را کلید API ایجاد شده خود قرار دهید.

---

مرحله ۲: تحلیل علت ریشه‌ای با قدرت هوش مصنوعی

این مرحله از مدل Gemini 2.5 Pro برای تجزیه و تحلیل خطا و زمینه گردش کار استفاده می‌کند.

نودها:

• Gemini 2.5 Pro (@n8n/n8n-nodes-langchain.lmChatOpenRouter)
• Debugger Agent (@n8n/n8n-nodes-langchain.agent)

۲.۱ Gemini 2.5 Pro

• نقش: این نود از طریق API OpenRouter با مدل Gemini 2.5 Pro ارتباط برقرار می‌کند و امکان تحلیل با قدرت هوش مصنوعی را فراهم می‌سازد.
• پیکربندی:

* Model: روی google/gemini-2.5-pro تنظیم شده است.

* Credentials: نیاز به پیکربندی کلید API OpenRouter شما دارد.

• ورودی: ورودی را از نود Debugger Agent دریافت می‌کند.
• خروجی: پاسخ تولید شده توسط هوش مصنوعی، معمولاً در قالب markdown.

۲.۲ Debugger Agent

• نقش: این نود یک prompt دقیق برای هوش مصنوعی می‌سازد و اطلاعات خطا و JSON کامل گردش کار را ترکیب می‌کند. سپس این prompt را برای تحلیل به مدل هوش مصنوعی ارسال می‌کند.
• پیکربندی:

* Text Input: به صورت پویا برای شامل شدن موارد زیر مونتاژ می‌شود:

* نام گردش کار.

* جزئیات نود شکست خورده (نام و نوع).

* پیام خطای خاص.

* JSON رشته شده کل گردش کار شکست خورده.

* System Message: پیکربندی شده تا هوش مصنوعی را به عنوان یک توسعه‌دهنده و دیباگر متخصص n8n راهنمایی کند و بر ارائه تحلیل مستقیم و عملی در قالب markdown تمرکز کند.

• ورودی: داده‌ها را از نود Get Workflow JSON دریافت می‌کند و برای استفاده از نود Gemini 2.5 Pro به عنوان مدل زبان خود پیکربندی شده است.
• خروجی: تحلیل هوش مصنوعی، شامل شناسایی علت ریشه‌ای و رفع‌های پیشنهادی، که در قالب markdown فرمت شده است.

---

مرحله ۳: قالب‌بندی و اطلاع‌رسانی

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

نودها:

• Convert Markdown To HTML (n8n-nodes-base.markdown)
• Send Debugging Email (n8n-nodes-base.gmail)

۳.۱ Convert Markdown To HTML

• نقش: این نود خروجی markdown از هوش مصنوعی را به HTML تبدیل می‌کند و از رندر صحیح در کلاینت‌های ایمیل اطمینان حاصل می‌کند.
• پیکربندی:

* Mode: روی markdownToHtml تنظیم شده است.

* Markdown Input: خروجی هوش مصنوعی را از نود Debugger Agent می‌گیرد.

* HTML Output: HTML تبدیل شده را در کلید responseHtml ذخیره می‌کند.

• ورودی: تحلیل markdown را از نود Debugger Agent دریافت می‌کند.
• خروجی: تحلیل هوش مصنوعی که به قالب HTML تبدیل شده است.

۳.۲ Send Debugging Email

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

* Send To: آدرس ایمیلی را که می‌خواهید گزارش‌های اشکال‌زدایی را دریافت کنید، وارد کنید.

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

* Body: شامل یک لینک مستقیم به اجرای شکست خورده، جزئیات اطلاعات خطا، و پاسخ دستیار اشکال‌زدایی هوش مصنوعی (که به صورت HTML فرمت شده است) می‌باشد.

* Credentials: نیاز به پیکربندی حساب Gmail شما با استفاده از OAuth2 دارد.

• ورودی: تحلیل فرمت شده HTML را از نود Convert Markdown To HTML دریافت می‌کند.
• خروجی: تأیید ارسال ایمیل.
• راه‌اندازی: اعتبارنامه‌های Gmail OAuth2 را در n8n پیکربندی کنید.

---

جدول خلاصه گردش کار

---

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

برای ساخت این گردش کار به صورت دستی در n8n، مراحل زیر را دنبال کنید:

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

* نوع: Error Trigger

* هدف: برای شروع گردش کار در صورت بروز هرگونه خطای اجرایی n8n.

* پیکربندی: از تنظیمات پیش‌فرض استفاده کنید.

2. افزودن گره HTTP Request "Get Workflow JSON":

* نوع: HTTP Request

* ورودی متصل: از گره Error Trigger.

* URL: ={{${$env.N8N_EDITOR_BASE_URL}/api/v1/workflows/${$json.workflow.id}}}

* احراز هویت: Generic HTTP Header Authentication را انتخاب کنید.

* یک اعتبارنامه جدید ایجاد کنید:

* نام هدر: X-N8N-API-KEY

* مقدار هدر: کلید API n8n شما (از تنظیمات n8n > API دریافت کنید).

* قالب پاسخ: JSON

3. افزودن گره "Gemini 2.5 Pro":

* نوع: @n8n/n8n-nodes-langchain.lmChatOpenRouter (مدل چت OpenRouter)

* مدل: google/gemini-2.5-pro

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

4. افزودن گره LangChain Agent "Debugger Agent":

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

* ورودی‌های متصل:

* از گره Get Workflow JSON.

* از گره Gemini 2.5 Pro (به عنوان ورودی ai_languageModel).

* ورودی متن: یک رشته چند خطی با استفاده از عبارات بسازید:

```javascript

نام گردش کار: {{ $json.name }}

گره ناموفق: {{ $('Error Trigger').item.json.execution.error.node.name }} (نوع: {{ $('Error Trigger').item.json.execution.error.node.type }})

پیام خطا: {{ $('Error Trigger').item.json.execution.error.message }}

JSON گردش کار:

```json

{{ JSON.stringify($json) }}

```

```

* پیام سیستم:

```

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

```

5. افزودن گره "Convert Markdown To HTML":

* نوع: Markdown

* حالت: markdownToHtml

* ورودی Markdown: {{ $json.output }} (ارجاع به خروجی از Debugger Agent)

6. افزودن گره "Send Debugging Email":

* نوع: Gmail

* ارسال به: آدرس ایمیل گیرنده را وارد کنید.

* موضوع: خطای گردش کار n8n: {{ $json.name }}

* بدنه: بدنه ایمیل را با استفاده از HTML و عبارات بسازید، شامل:

* لینکی به اجرا: {{ $('Error Trigger').item.json.execution.id }}

* جزئیات خطا از گره Error Trigger.

* خروجی HTML از گره Convert Markdown To HTML: {{ $json.responseHtml }}

* اعتبارنامه‌ها: اعتبارنامه‌های OAuth2 Gmail خود را پیکربندی کنید.

---

خطاهای رایج و راه‌حل‌ها

• خطاهای احراز هویت (HTTP Request یا Gmail): اطمینان حاصل کنید که کلیدهای API و توکن‌های OAuth شما به درستی پیکربندی شده‌اند و منقضی نشده‌اند. در صورت نیاز مجدداً احراز هویت کنید.
• N8N_EDITOR_BASE_URL تنظیم نشده است: این متغیر محیطی برای نود Get Workflow JSON حیاتی است. مطمئن شوید که به درستی در محیط n8n شما تعریف شده است.
• مشکلات کلید API OpenRouter: تأیید کنید که کلید API OpenRouter شما معتبر است و اعتبار کافی دارد. برای مشاهده مصرف و محدودیت‌های احتمالی، داشبورد OpenRouter را بررسی کنید.
• JSON گردش کار نامعتبر: اگر نود Debugger Agent نتواند JSON را پردازش کند، عبارت JSON.stringify را دوباره بررسی کنید و مطمئن شوید که JSON ورودی معتبر است.

---

راهنمای ویدیویی

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