تغییر نام خودکار گره‌های n8n با هوش مصنوعی

تولید خودکار نام‌های توصیفی گره با هوش مصنوعی برای خوانایی بهتر گردش کار

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

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

1. ورودی تریگر (Trigger Input): ورودی کاربر را برای انتخاب گردش کار هدف از طریق یک فرم تریگر (انتخاب از لیست کشویی) یا تریگر دستی (انتخاب مستقیم گردش کار) می‌پذیرد.

2. دریافت و استخراج داده‌های گردش کار (Fetch & Extract Workflow Data): JSON کامل گردش کار انتخاب شده را بازیابی کرده و گره‌ها و اتصالات آن را برای پردازش به یک ساختار تمیز استخراج می‌کند.

3. تولید نام با هوش مصنوعی (AI Rename Generation): JSON استخراج شده گردش کار را به یک مدل زبان هوش مصنوعی ارسال می‌کند تا نگاشتی از نام‌های گره قدیمی به نام‌های توصیفی جدید تولید کند.

4. اعتبارسنجی و اعمال (Validation and Application): تأیید می‌کند که خروجی هوش مصنوعی تمام گره‌ها را پوشش می‌دهد، سپس نام‌های جدید را به گره‌ها، اتصالات و ارجاعات پارامتر اعمال می‌کند.

5. ذخیره و بازخورد (Save & Feedback): نسخه به‌روز شده گردش کار را ذخیره می‌کند، پیوندهایی به هر دو نسخه جدید و قبلی ایجاد می‌کند و نتایج را به کاربر نمایش می‌دهد.

6. مدیریت خطا (Error Handling): در صورت شکست اعتبارسنجی، با پیام خطا اجرا را متوقف می‌کند و مداخله دستی یا تلاش مجدد را درخواست می‌کند.

---

۱. ورودی تریگر (Trigger Input)

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

گره‌های درگیر:

• n8n-nodes-base.form (Form Trigger)
• n8n-nodes-base.manualTrigger (Manual Trigger)
• n8n-nodes-base.n8n (Fetch All Workflows)
• n8n-nodes-base.aggregate (Aggregate Workflow List)
• n8n-nodes-base.form (Form Dynamic Workflow List)
• n8n-nodes-base.n8n (Select a Workflow)
• n8n-nodes-base.set (Parse Selected Workflow Id)
• n8n-nodes-base.set (Set Target Workflow Id)

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

• Form Trigger

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

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

* پیکربندی: عنوان و توضیحات سفارشی فرم برای توضیح گردش کار.

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

* موارد مرزی: لغو توسط کاربر یا اتمام زمان برای ورودی فرم.

• Manual Trigger

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

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

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

• Fetch All Workflows

* نوع: n8n-nodes-base.n8n (List Workflows)

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

* اعتبارنامه‌ها (Credentials): نیاز به اعتبارنامه حساب API n8n دارد.

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

• Aggregate Workflow List

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

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

* ورودی: لیست گردش کارها از گره "Fetch All Workflows".

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

• Form Dynamic Workflow List

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

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

* پیکربندی: JSON گزینه‌های کشویی برای گردش کارها را با برچسب "name (#id)" تعریف می‌کند.

* خروجی‌ها: انتخاب کاربر به صورت JSON.

• Select a Workflow

* نوع: n8n-nodes-base.n8n (Get Workflow)

* نقش: JSON کامل گردش کار انتخاب شده را بر اساس شناسه (ID) بازیابی می‌کند.

* اعتبارنامه‌ها: حساب API n8n.

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

* خروجی: JSON کامل گردش کار.

• Parse Selected Workflow Id

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

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

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

• Set Target Workflow Id

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

* نقش: شناسه گردش کار را در فیلد workflow_id قرار می‌دهد و برای گره دریافت (fetch) آماده می‌کند.

---

۲. دریافت و استخراج داده‌های گردش کار (Fetch & Extract Workflow Data)

این بخش، JSON کامل گردش کار را دریافت کرده و گره‌ها (nodes) و اتصالات (connections) آن را استخراج می‌کند و یک شیء پاک و ساده‌شده برای پردازش توسط هوش مصنوعی آماده می‌سازد.

گره‌های مورد استفاده:

• n8n-nodes-base.n8n (Fetch Target Workflow JSON)
• n8n-nodes-base.set (Extract Workflow Nodes Connections)

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

• Fetch Target Workflow JSON

* نوع: n8n-nodes-base.n8n (Get Workflow)

* نقش: بازیابی JSON خام گردش کار هدف بر اساس شناسه (ID).

* اعتبارنامه‌ها (Credentials): حساب API n8n.

* ورودی‌ها: workflow_id از بلوک قبلی.

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

• Extract Workflow Nodes Connections

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

* نقش: JSON گردش کار را با حذف فیلدهای غیرضروری پاک‌سازی کرده و سه فیلد کلیدی را استخراج می‌کند:

* old_workflow: JSON کامل گردش کار بدون pinData/shared

* nodes: آرایه‌ای از اشیاء گره

* connections: شیئی که اتصالات گره‌ها را نگاشت می‌کند

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

---

۳. تولید نام با هوش مصنوعی (AI Rename Generation)

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

گره‌های درگیر:

• @n8n/n8n-nodes-langchain.chainLlm (Generate Node Rename Mapping)
• @n8n/n8n-nodes-langchain.outputParserStructured (Parse LLM Mapping ToJson)

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

• Generate Node Rename Mapping

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

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

* دستور (Prompt):

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

* محدودیت‌ها: حداکثر ۵ کلمه، حروف بزرگ ابتدای کلمات (Title Case)، منحصربه‌فرد بودن، دقت فنی، آرایه خروجی باید با تعداد گره‌ها مطابقت داشته باشد.

* ورودی‌ها: JSON old_workflow از بلوک قبلی.

* خروجی‌ها: JSON پاسخ خام هوش مصنوعی.

• Parse LLM Mapping ToJson

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

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

* طرح‌واره (Schema): آرایه‌ای از اشیاء، هر کدام با فیلدهای رشته‌ای الزامی old_name و new_name.

* موارد خاص (Edge Cases): خطاهای تجزیه در صورت نامعتبر بودن خروجی هوش مصنوعی.

---

۴. اعتبارسنجی و اعمال (Validation and Application)

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

گره‌های درگیر:

• n8n-nodes-base.set (Prepare LLM Validation Data)
• n8n-nodes-base.if (Validate All Nodes Renamed)
• n8n-nodes-base.set (Apply Renamed Nodes Connections)
• n8n-nodes-base.set (new_workflow_without)
• n8n-nodes-base.set (new_connections)
• n8n-nodes-base.set (new_nodes)
• n8n-nodes-base.set (Assemble New Workflow Object)
• n8n-nodes-base.stopAndError (Stop)

جزئیات گره:

• Prepare LLM Validation Data

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

* نقش: متغیرها را برای اعتبارسنجی آماده می‌کند:

* old_workflow (JSON اصلی گردش کار)

* nodes_name (آرایه‌ای از نام‌های گره اصلی)

* connections_nodes_name_reference (آرایه‌ای از تمام نام‌های گره ارجاع داده شده در اتصالات)

* parameters_names (آرایه‌ای از رشته‌ها که ارجاعات نام گره را در پارامترها نشان می‌دهد)

* AI_output (آرایه نگاشت هوش مصنوعی تجزیه شده)

• Validate All Nodes Renamed

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

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

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

* مسیر نادرست: گره‌های گمشده یا اضافی → گره خطا را فعال کنید.

• Apply Renamed Nodes Connections

* نقش:

* نام‌های گره قدیمی را در آرایه گره‌ها به نام‌های جدید نگاشت می‌کند (تغییر نام گره‌ها).

* ارجاعات به نام‌های گره قدیمی را در پارامترها با نام‌های جدید جایگزین می‌کند (در تمام فیلدهای پارامتر).

* کلیدها و اهداف شیء اتصالات را با نام‌های گره جدید به‌روز می‌کند.

• new_workflow_without

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

* نقش: یک کپی از شیء گردش کار اصلی را بدون فیلدهای nodes و connections برای ادغام تمیز ایجاد می‌کند.

• new_connections

* نوع: n8n-nodes-base.set (object)

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

• new_nodes

* نوع: n8n-nodes-base.set (array)

* نقش: آرایه گره‌های به‌روز شده را با گره‌های نام‌گذاری مجدد شده و پارامترهای به‌روز شده می‌سازد.

• Assemble New Workflow Object

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

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

• Stop

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

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

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

---

۵. ذخیره و بازخورد (Save & Feedback)

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

گره‌های درگیر:

• n8n-nodes-base.n8n (Save Renamed Workflow Version)
• n8n-nodes-base.set (Build Workflow Version Links)
• n8n-nodes-base.if (Check Trigger Source Type)
• n8n-nodes-base.form (Display Workflow Version Links)
• n8n-nodes-base.set (Done)

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

• Save Renamed Workflow Version

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

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

* خروجی‌ها: JSON گردش کار ذخیره شده.

• Build Workflow Version Links

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

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

* خروجی‌ها: آرایه‌ای از URLهای نسخه.

• Check Trigger Source Type

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

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

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

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

• Display Workflow Version Links

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

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

* خروجی‌ها: فرم با پیوندهای نسخه.

• Done

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

* نقش: پایان گردش کار را علامت‌گذاری می‌کند.

---

۶. مدیریت خطا (Error Handling)

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

گره‌های درگیر:

• n8n-nodes-base.stopAndError (Stop)

جزئیات گره:

• Stop

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

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

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

---

جدول خلاصه