تولید خودکار توضیحات محصول با Azure OpenAI برای Adobe Comme…

تولید خودکار توضیحات محصول با Azure OpenAI برای Adobe Commerce/Magento

این گردش کار، تولید توضیحات محصول را برای محصولاتی که در حال حاضر فاقد توضیحات هستند، در Adobe Commerce (Magento 2) خودکار می‌کند. این ابزار برای مدیران تجارت الکترونیک و توسعه‌دهندگانی طراحی شده است که به دنبال غنی‌سازی سیستماتیک کاتالوگ محصولات بدون ورود دستی هستند.

این گردش کار و موارد بیشتر را در کاتالوگ Pixori.me بیابید: https://pixori.me/n8n

---

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

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

1. بازیابی داده‌های محصول: محصولاتی را که فاقد توضیحات هستند از Adobe Commerce دریافت کرده و تمام ویژگی‌های لازم محصول را بازیابی می‌کند و مقادیر گزینه‌های قابل انتخاب را به برچسب‌های قابل خواندن توسط انسان تبدیل می‌کند.

2. تولید توضیحات با استفاده از هوش مصنوعی: داده‌های خام ویژگی‌ها را به یک فرمت ساختاریافته تبدیل کرده و آن را به یک مدل زبان Azure OpenAI ارسال می‌کند تا توضیحات محصولی سازگار با سئو و طبیعی تولید کند.

3. به‌روزرسانی محصول در Magento: توضیحات تازه تولید شده را از طریق API REST Magento 2 به فروشگاه Adobe Commerce بازمی‌گرداند.

---

تجزیه و تحلیل دقیق گردش کار

۱. بازیابی داده‌های محصول

این بلوک بر جمع‌آوری اطلاعات لازم از فروشگاه Adobe Commerce شما تمرکز دارد.

• Manual Trigger

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

* نقش: نقطه ورود برای شروع دستی گردش کار.

* پیکربندی: هیچ پارامتری لازم نیست؛ توسط کاربر راه‌اندازی می‌شود.

* خروجی: گره‌های بعدی بازیابی داده را راه‌اندازی می‌کند.

• Get Attributes and Options

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

* نقش: فراداده ویژگی‌های محصول Magento را بازیابی می‌کند، به طور خاص برای ویژگی‌هایی که دارای گزینه‌های قابل انتخاب هستند (جایی که frontend_input برابر با select است) فیلتر می‌کند. این برای ترجمه شناسه‌های گزینه به برچسب‌های معنی‌دار حیاتی است.

* پیکربندی:

* URL: نقطه پایانی API REST Magento /V1/products/attributes را با فیلترهایی برای frontend_input=select فراخوانی می‌کند و فیلدهایی مانند attribute_code, frontend_input, default_frontend_label, و options را انتخاب می‌کند.

* احراز هویت: به اعتبارنامه API Magento 2 شما نیاز دارد.

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

* ورودی: ماشه را از گره Manual Trigger دریافت می‌کند.

* خروجی: داده‌های ویژگی و گزینه را به گره Wait until nodes ready ارسال می‌کند.

* نسخه: فرض بر این است که نسخه API Magento 2 برابر با 4.2 است.

• Get Product Without Description

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

* نقش: یک محصول را از Magento 2 که فاقد توضیحات است، بازیابی می‌کند.

* پیکربندی:

* URL: از نقطه پایانی /V1/products با پارامترهای پرس و جو برای فیلتر کردن محصولاتی که فیلد description آنها null است، استفاده می‌کند.

* Page Size: برای پردازش محصولات یک به یک به ۱ محدود شده است.

* احراز هویت: به اعتبارنامه API Magento 2 شما نیاز دارد.

* ورودی: ماشه را از گره Manual Trigger دریافت می‌کند.

* خروجی: داده‌های محصول را به گره Wait until nodes ready ارسال می‌کند.

• Wait until nodes ready

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

* نقش: جریان‌های داده را از هر دو Get Attributes and Options و Get Product Without Description همگام‌سازی می‌کند. این اطمینان حاصل می‌کند که قبل از رفتن به مرحله بعدی، هم داده‌های محصول و هم فراداده ویژگی‌های آن در دسترس هستند.

* ورودی: داده‌ها را از هر دو گره HTTP Request قبلی دریافت می‌کند.

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

۲. تولید توضیحات با استفاده از هوش مصنوعی

این بلوک از Azure OpenAI برای ایجاد توضیحات جذاب محصول استفاده می‌کند.

• Prepare attributes

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

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

* ورودی: داده‌های محصول و ویژگی‌های ادغام شده را از Wait until nodes ready دریافت می‌کند.

* خروجی: شیء JSON محصول غنی شده را به گره Basic LLM Chain ارسال می‌کند.

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

• Azure OpenAI Chat Model

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

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

* پیکربندی:

* Model: برای مسیریابی پیش‌فرض مدل Azure OpenAI روی "model-router" تنظیم شده است.

* Credentials: اعتبارنامه API Azure OpenAI شما باید به طور ایمن در n8n پیکربندی شود.

* ورودی: به عنوان مدل زبان هوش مصنوعی برای گره Basic LLM Chain پیکربندی شده است.

* خروجی: پاسخ‌های مدل را به گره Basic LLM Chain جریان می‌دهد.

• Basic LLM Chain

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

* نقش: تولید توضیحات هوش مصنوعی را هماهنگ می‌کند. این گره یک قالب اعلان (prompt) تعریف کرده و از Azure OpenAI Chat Model برای تولید توضیحات استفاده می‌کند.

* پیکربندی:

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

* Input: رشته JSON محصول غنی شده از Prepare attributes به عنوان ورودی برای اعلان استفاده می‌شود.

* ورودی: داده‌های محصول پردازش شده را از Prepare attributes و پیکربندی مدل هوش مصنوعی را از Azure OpenAI Chat Model دریافت می‌کند.

* خروجی: متن توضیحات محصول تولید شده به گره set Description ارسال می‌شود.

• set Description

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

* نقش: متن توضیحات تولید شده را از خروجی LLM استخراج کرده و آن را به یک کلید JSON جدید به نام description اختصاص می‌دهد. این داده‌ها را برای مرحله به‌روزرسانی نهایی آماده می‌کند.

* پیکربندی: فیلد متن را از JSON ورودی به کلید description اختصاص می‌دهد.

* ورودی: خروجی LLM را از Basic LLM Chain دریافت می‌کند.

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

۳. به‌روزرسانی محصول در Magento

این بلوک نهایی فروشگاه Adobe Commerce شما را با توضیحات تولید شده توسط هوش مصنوعی به‌روزرسانی می‌کند.

• Save configurable

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

* نقش: توضیحات محصول را در فروشگاه Magento شما با استفاده از درخواست PUT به API REST Magento به‌روزرسانی می‌کند.

* پیکربندی:

* URL: به طور پویا با استفاده از SKU محصول (استخراج شده از گره Get Product Without Description) و کدگذاری URL ساخته می‌شود.

* JSON Body: آرایه custom_attributes را به‌روزرسانی می‌کند و ویژگی description را به متن تولید شده تنظیم می‌کند. خطوط جدید جایگزین شده و نقل قول‌ها برای اطمینان از اعتبار JSON فرار می‌شوند.

* احراز هویت: به اعتبارنامه API Magento 2 شما نیاز دارد.

* ورودی: فیلد description را از set Description و SKU محصول را از Get Product Without Description دریافت می‌کند.

* خروجی: این آخرین گره در این گردش کار است؛ هیچ اتصال خروجی دیگری ندارد.

---

جدول خلاصه