پشتیبان‌گیری خودکار گردش کار n8n و مستندسازی با GPT-4

خودکارسازی مستندات و پشتیبان‌گیری گردش کار n8n با GPT-4 و Airtable

این راهنمای جامع، گردش کار n8n در Pixori.me را با جزئیات شرح می‌دهد که برای پشتیبان‌گیری خودکار گردش کارهای n8n شما و تولید مستندات مبتنی بر هوش مصنوعی با استفاده از GPT-4 و Airtable طراحی شده است. این گردش کار تضمین می‌کند که شما تاریخچه‌ای نسخه‌بندی شده از گردش کارهای خود را حفظ می‌کنید، همراه با خلاصه‌های مختصر و گزارش‌های تغییرات، که ردیابی تکامل و درک اتوماسیون‌های پیچیده را آسان‌تر می‌کند.

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

لینک کاتالوگ Pixori.me: https://pixori.me/n8n

---

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

این گردش کار، پشتیبان‌گیری و مستندسازی مبتنی بر هوش مصنوعی گردش کارهای n8n شما را خودکار می‌کند. این گردش کار به صورت دوره‌ای تمام گردش کارهای شما را اسکن می‌کند، نسخه‌های جدید (اسنپ‌شات‌ها) را شناسایی کرده، این اسنپ‌شات‌ها را در Airtable ذخیره می‌کند و خلاصه‌های مختصر هوش مصنوعی و گزارش‌های تغییرات را با استفاده از GPT-4 تولید می‌کند. این برای کاربرانی که نیاز به یک پشتیبان متمرکز و نسخه‌بندی شده از گردش کارهای n8n خود با بینش‌های تولید شده توسط هوش مصنوعی برای ردیابی و درک بهتر تغییرات در طول زمان دارند، ایده‌آل است.

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

• ۱.۱ بازیابی گردش کار زمان‌بندی شده: این بلوک که بر اساس یک برنامه زمان‌بندی فعال می‌شود، تمام گردش کارهای n8n را بازیابی کرده و آن‌ها را با پشتیبان‌های موجود در Airtable مقایسه می‌کند تا مشخص شود کدام گردش کارها نیاز به توجه دارند.
• ۱.۲ شناسایی و فیلتر کردن اسنپ‌شات: گردش کارهای بازیابی شده را پردازش می‌کند تا نسخه‌های جدید یا به‌روز شده (اسنپ‌شات‌ها) را که نیاز به پشتیبان‌گیری دارند، مشخص کند.
• ۱.۳ به‌روزرسانی فراداده گردش کار: اطمینان حاصل می‌کند که فراداده گردش کار در جدول "Workflows" در Airtable شما با ایجاد رکوردهای جدید یا به‌روزرسانی رکوردهای موجود، به‌روز است.
• ۱.۴ دانلود و مقایسه اسنپ‌شات: جدیدترین اسنپ‌شات یک گردش کار را دانلود کرده و آن را با نسخه فعلی مقایسه می‌کند تا تفاوت‌ها را تشخیص دهد.
• ۱.۵ پردازش هوش مصنوعی: از GPT-4 برای تولید یا بازتولید خلاصه‌های گردش کار و گزارش‌های تغییرات دقیق بر اساس تفاوت‌های شناسایی شده استفاده می‌کند.
• ۱.۶ ذخیره‌سازی اسنپ‌شات: نسخه جدید گردش کار را به همراه مستندات تولید شده توسط هوش مصنوعی مرتبط با آن، به عنوان یک اسنپ‌شات در Airtable ذخیره می‌کند.
• ۱.۷ نهایی‌سازی: ذخیره‌سازی فایل‌های گردش کار را به عنوان پیوست‌های Airtable مدیریت کرده و زمان‌های انتظار را برای رعایت محدودیت‌های نرخ API در بر می‌گیرد.

---

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

۲.۱ بازیابی گردش کار زمان‌بندی شده

هدف: این بخش گردش کار را در یک زمان‌بندی مشخص (روزانه ساعت ۸ صبح) آغاز کرده و تمام گردش کارهای موجود را از نمونه n8n شما دریافت می‌کند. سپس این لیست را با پشتیبان Airtable شما مقایسه می‌کند تا گردش کارهای جدید یا به‌روز شده را شناسایی کند.

نودهای درگیر:

• Schedule Trigger
• Get all n8n workflows
• Search all existing snapshots (Airtable)
• Match snapshot IDs
• Only keep new snapshots

جزئیات نودها:

• Schedule Trigger

* نوع: Schedule Trigger

* پیکربندی: تنظیم شده برای اجرا روزانه در ساعت ۸:۰۰ صبح.

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

* خروجی‌ها: اجرای گردش کار را آغاز می‌کند.

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

• Get all n8n workflows

* نوع: n8n API node

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

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های OAuth2 یا توکن API n8n دارد.

* خروجی: لیستی از گردش کارها، شامل فراداده آن‌ها (شناسه، نام، نسخه، مُهر زمانی).

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

• Search all existing snapshots (Airtable)

* نوع: Airtable node (با استفاده از عملیات 'Search').

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

* اعتبارنامه‌ها: نیاز به اعتبارنامه‌های توکن API Airtable دارد.

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

* موارد مرزی: محدودیت نرخ API Airtable یا خطاهای احراز هویت می‌تواند فرآیند را مختل کند.

• Match snapshot IDs

* نوع: Merge node.

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

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

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

• Only keep new snapshots

* نوع: Filter node.

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

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

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

۲.۲ شناسایی و فیلتر کردن اسنپ‌شات

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

نودهای درگیر:

• Loop Over Items

جزئیات نودها:

• Loop Over Items

* نوع: SplitInBatches node.

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

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

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

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

۲.۳ به‌روزرسانی فراداده گردش کار

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

نودهای درگیر:

• Create or update workflow
• Search all snapshots

جزئیات نودها:

• Create or update workflow

* نوع: Airtable node (با استفاده از عملیات 'Upsert').

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

* ورودی: فراداده گردش کار از نود Loop Over Items.

* خروجی: رکورد Airtable مربوط به گردش کار.

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

• Search all snapshots

* نوع: Airtable node (با استفاده از عملیات 'Search').

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

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

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

۲.۴ دانلود و مقایسه اسنپ‌شات

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

نودهای درگیر:

• Check workflow status
• Existing workflow?
• Download previous snapshot
• Extract from File1
• State that this is the first version
• Document workflow differences
• Prepare edits since last snapshot
• Consolidate edits since last snapshot

جزئیات نودها:

• Check workflow status

* نوع: Code node.

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

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

* موارد مرزی: فرمت‌های ورودی غیرمنتظره یا داده‌های اسنپ‌شات گمشده می‌تواند منجر به بررسی‌های نادرست وضعیت شود.

• Existing workflow?

* نوع: If node.

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

* خروجی: اجرای گردش کار را بر اساس شرط منشعب می‌کند.

* موارد مرزی: یک شرط نادرست ممکن است منطق پردازش را به اشتباه هدایت کند.

• Download previous snapshot

* نوع: Airtable node (با استفاده از عملیات 'Search').

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

* خروجی: داده‌های فایل باینری JSON گردش کار قبلی.

* موارد مرزی: پیوست‌های گمشده یا محدودیت‌های نرخ API Airtable می‌تواند باعث شکست شود.

• Extract from File1

* نوع: Extract from File node.

* پیکربندی: محتوای JSON را از فیلد پیوست "Workflow\_file\_0" استخراج می‌کند.

* خروجی: محتوای JSON تجزیه شده گردش کار قبلی.

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

• State that this is the first version

* نوع: Set node.

* پیکربندی: مقدار متنی "N/A - First identified version" را به فیلد "Edits since last snapshot" تنظیم می‌کند. این زمانی استفاده می‌شود که هیچ اسنپ‌شات قبلی وجود نداشته باشد.

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

• Document workflow differences

* نوع: Langchain Chain LLM node (پیکربندی شده برای OpenAI GPT-4).

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

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

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

* موارد مرزی: ورودی‌های JSON بزرگ ممکن است از محدودیت‌های توکن فراتر رفته یا باعث اتمام زمان شوند.

• Prepare edits since last snapshot

* نوع: Set node.

* پیکربندی: خلاصه متنی تولید شده توسط هوش مصنوعی از تفاوت‌ها را به فیلدی به نام "Edits since last snapshot" اختصاص می‌دهد.

* خروجی: خلاصه ساختار یافته ویرایش‌های شناسایی شده.

• Consolidate edits since last snapshot

* نوع: Set node.

* پیکربندی: خلاصه آماده شده "Edits since last snapshot" را برای ذخیره‌سازی بعدی منتقل می‌کند.

* خروجی: رشته خلاصه نهایی ویرایش‌ها.

۲.۵ پردازش هوش مصنوعی

هدف: این بخش بر اساس منطق تعریف شده در نود "Check workflow status" تعیین می‌کند که آیا خلاصه هوش مصنوعی جدیدی برای گردش کار مورد نیاز است یا خیر. در صورت لزوم، GPT-4 را برای تولید خلاصه فراخوانی می‌کند.

نودهای درگیر:

• Needs new workflow summary?
• Re-summarise workflow
• Store new workflow summary

جزئیات نودها:

• Needs new workflow summary?

* نوع: If node.

* پیکربندی: خروجی بولی از نود "Check workflow status" را بررسی می‌کند تا تصمیم بگیرد که آیا با تولید خلاصه هوش مصنوعی جدید ادامه دهد یا این مرحله را رد کند.

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

• Re-summarise workflow

* نوع: Langchain Chain LLM node (پیکربندی شده برای OpenAI GPT-4).

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

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

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

• Store new workflow summary

* نوع: Airtable node (با استفاده از عملیات 'Update').

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

* خروجی: رکورد به‌روز شده گردش کار در Airtable.

* موارد مرزی: خطاهای به‌روزرسانی Airtable می‌تواند از ذخیره خلاصه جلوگیری کند.

۲.۶ ذخیره‌سازی اسنپ‌شات

هدف: این بخش مسئول ذخیره اسنپ‌شات جدید گردش کار در Airtable است. این شامل فراداده اسنپ‌شات، ویرایش‌های تولید شده توسط هوش مصنوعی، و فایل JSON گردش کار به عنوان پیوست است. همچنین شامل یک مرحله انتظار برای مدیریت محدودیت‌های نرخ API است.

نودهای درگیر:

• Store new snapshot
• Get full workflow JSON
• Move Binary Data
• Extract from File
• Store workflow file into Airtable
• Wait
• The backup is done!

جزئیات نودها:

• Store new snapshot

* نوع: Airtable node (با استفاده از عملیات 'Create').

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

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

* موارد مرزی: خطاهای عملیات 'Create' Airtable می‌تواند از ثبت اسنپ‌شات جلوگیری کند.

• Get full workflow JSON

* نوع: n8n API node.

* پیکربندی: JSON کامل گردش کار را برای شناسه گردش کار فعلی دانلود می‌کند.

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

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

• Move Binary Data

* نوع: Move Binary Data node.

* پیکربندی: داده‌های رشته JSON را به فرمت باینری مناسب برای آپلود به عنوان پیوست تبدیل می‌کند، به طور خاص آن را برای ویژگی "file" آماده می‌کند.

* خروجی: داده‌های باینری فرمت شده برای آپلود Airtable.

• Extract from File

* نوع: Extract from File node.

* پیکربندی: داده‌های باینری را به یک ویژگی تبدیل می‌کند که به راحتی توسط نودهای بعدی قابل مدیریت است.

* خروجی: داده‌های فایل پردازش شده.

• Store workflow file into Airtable

* نوع: HTTP Request node.

* پیکربندی: فایل JSON باینری را به عنوان پیوست به رکورد اسنپ‌شات تازه ایجاد شده در Airtable با استفاده از API REST Airtable آپلود می‌کند.

* مهم: شما باید به صورت دستی <AIRTABLE-BASE-ID> را در URL با شناسه پایگاه Airtable واقعی خود جایگزین کنید.

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

• Wait

* نوع: Wait node.

* پیکربندی: اجرای گردش کار را برای ۳ ثانیه متوقف می‌کند. این برای رعایت محدودیت‌های نرخ API Airtable و جلوگیری از مسدود شدن احتمالی حیاتی است.

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

• The backup is done!

* نوع: NoOp (No Operation) node.

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

* خروجی: ندارد.

۲.۷ نودهای یادداشت و مستندات

چندین نود Sticky Note در سراسر گردش کار گنجانده شده‌اند تا زمینه ضروری، دستورالعمل‌های راه‌اندازی و توضیحات را برای کاربران فراهم کنند. این یادداشت‌ها موضوعاتی مانند موارد زیر را پوشش می‌دهند:

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

---

۳. جدول خلاصه