گردش کار هوش مصنوعی: اولویت‌بندی بازخورد از Jotform به Trell…

هوش مصنوعی برای اولویت‌بندی بازخورد: Jotform به Trello، Airtable و Slack با Gemini

این گردش کار، فرآیند اولویت‌بندی و مدیریت بازخوردهای ارسالی از طریق Jotform را خودکار می‌کند. با استفاده از هوش مصنوعی Google Gemini، بازخوردها را تجزیه و تحلیل، دسته‌بندی و به وظایف عملی یا گزارش‌ها در Trello، Airtable و Slack هدایت می‌کند.

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

موارد استفاده

• جمع‌آوری خودکار بازخورد: بازخورد کاربران را به طور یکپارچه از طریق Jotform جمع‌آوری کنید.
• تحلیل با هوش مصنوعی: بازخوردها را با استفاده از Google Gemini به طور خودکار دسته‌بندی و خلاصه کنید.
• مدیریت وظایف: کارت‌های Trello برای باگ‌ها و درخواست‌های ویژگی ایجاد کنید.
• ثبت بازخورد: یک گزارش ساختاریافته از بازخوردهای عمومی در Airtable نگهداری کنید.
• هشدار فوری: تیم توسعه خود را از طریق Slack برای باگ‌های با اولویت بالا مطلع سازید.
• تأیید کاربر: ایمیل‌های تأیید خودکار را برای کاربرانی که اطلاعات تماس خود را ارائه می‌دهند، ارسال کنید.

منطق گردش کار

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

1. دریافت ورودی: دریافت ارسال‌های بازخورد از Jotform و تنظیم پیکربندی‌های اولیه.

2. تأیید ایمیل شرطی: ارسال ایمیل تأییدیه به کاربر در صورت ارائه آدرس ایمیل.

3. پردازش بازخورد با هوش مصنوعی: استفاده از Google Gemini برای تجزیه و تحلیل بازخورد، استخراج اطلاعات کلیدی و ساختاردهی آن برای پردازش بیشتر.

4. دسته‌بندی و مسیریابی بازخورد: هدایت بازخورد به مسیرهای مختلف بر اساس اینکه آیا باگ، درخواست ویژگی یا بازخورد عمومی است.

5. ایجاد کارت Trello: ایجاد کارت‌های Trello برای موارد قابل اقدام (باگ‌ها و درخواست‌های ویژگی).

6. ثبت در Airtable: ثبت بازخوردهای عمومی در یک پایگاه Airtable برای بررسی.

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

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

9. مستندات و یادداشت‌های راه‌اندازی: شامل یادداشت‌های چسبان با دستورالعمل‌های راه‌اندازی ضروری و توضیحات.

---

تشریح گره‌های جزئیات

۱. دریافت ورودی

• هدف: دریافت ارسال‌های بازخورد از Jotform و مقداردهی اولیه متغیرهای پیکربندی.
• گره‌ها:

* JotForm Trigger (گره Trigger)

* Config (گره Set)

• جزئیات:

* JotForm Trigger: به ارسال‌های جدید در یک Jotform مشخص گوش می‌دهد. داده‌های ارسال شده را با نام فیلدهای حل شده خروجی می‌دهد.

* پیکربندی: نیاز به اعتبارنامه‌های API Jotform و شناسه فرم دارد.

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

* Config: داده‌های پیکربندی ضروری مانند شناسه‌های لیست و برچسب Trello را به عنوان متغیرهای رشته‌ای ذخیره می‌کند. این گره تضمین می‌کند که این مقادیر برای گره‌های بعدی به راحتی در دسترس هستند.

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

۲. تأیید ایمیل شرطی

• هدف: ارسال ایمیل تأیید به کاربر در صورت ارائه آدرس ایمیل در فرم.
• گره‌ها:

* Email Provided? (گره If)

* Send Confirmation Email (گره Gmail)

* Skip Confirmation Email (گره NoOp)

• جزئیات:

* Email Provided?: ارزیابی می‌کند که آیا فیلد "Your Email (Optional)" از Jotform خالی نیست.

* خروجی‌ها: در صورت درست بودن به Send Confirmation Email و در غیر این صورت به Skip Confirmation Email هدایت می‌کند.

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

* Send Confirmation Email: از Gmail برای ارسال ایمیل تأیید متنی ساده با استفاده از اعتبارنامه‌های OAuth2 استفاده می‌کند.

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

* موارد مرزی: مشمول محدودیت‌های نرخ API Gmail و انقضای توکن OAuth است. آدرس‌های ایمیل معتبر را ارائه دهید.

* Skip Confirmation Email: یک گره نگهدارنده که هیچ کاری انجام نمی‌دهد و به گردش کار اجازه می‌دهد تا زمانی که ایمیلی ارائه نشده است، ادامه یابد.

۳. پردازش بازخورد با هوش مصنوعی

• هدف: تجزیه و تحلیل متن بازخورد با استفاده از Google Gemini برای استخراج خلاصه ساختاریافته، شامل عنوان وظیفه، دسته، اولویت و برچسب‌های مرتبط.
• گره‌ها:

* Google Gemini Chat Model (@n8n/n8n-nodes-langchain.lmChatGoogleGemini)

* AI Feedback Triage (@n8n/n8n-nodes-langchain.agent)

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

• جزئیات:

* Google Gemini Chat Model: برای پردازش زبان طبیعی به API Google Gemini متصل می‌شود.

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

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

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

* AI Feedback Triage: به عنوان یک عامل Langchain عمل می‌کند. از یک پرامپت دقیقاً طراحی شده برای دستور دادن به Gemini در مورد نحوه تجزیه و تحلیل بازخورد استفاده می‌کند.

* دستورالعمل‌های پرامپت: یک عنوان وظیفه ایجاد کنید، دسته (Bug، Feature Request، General Feedback) را تعیین کنید، اولویت (High، Medium، Low) را پیشنهاد دهید و برچسب‌ها را به عنوان یک آرایه استخراج کنید.

* عبارت کلیدی: {{ $('JotForm Trigger').item.json['Feedback Details'] }} متن بازخورد را بازیابی می‌کند.

* خروجی‌ها: یک خروجی JSON ساختاریافته در ویژگی output تولید می‌کند.

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

* Structured Output Parser: خروجی هوش مصنوعی را در برابر یک طرحواره JSON از پیش تعریف شده (مانند task_title، category، suggested_priority، tags) اعتبارسنجی می‌کند.

* خروجی‌ها: یک شیء JSON ساختاریافته آماده برای استفاده در گره‌های بعدی.

* موارد مرزی: عدم تطابق طرحواره یا خطاهای تجزیه JSON.

۴. دسته‌بندی و مسیریابی بازخورد

• هدف: تعیین ماهیت بازخورد (باگ، درخواست ویژگی، یا عمومی) و هدایت آن به مرحله بعدی مناسب.
• گره‌ها:

* Is it a Bug or Feature? (گره If)

* Create Trello Card (گره Trello)

* Log General Feedback to Airtable (گره Airtable)

• جزئیات:

* Is it a Bug or Feature?: بررسی می‌کند که آیا فیلد category (از خروجی هوش مصنوعی) 'bug' یا 'feature request' (بدون حساسیت به بزرگی و کوچکی حروف) است.

* خروجی‌ها: در صورت برآورده شدن شرط به Create Trello Card و در غیر این صورت به Log General Feedback to Airtable هدایت می‌کند.

* موارد مرزی: فیلدهای دسته گمشده یا غلط املایی و حساسیت به بزرگی و کوچکی حروف را مدیریت می‌کند.

* Create Trello Card: یک کارت جدید در Trello ایجاد می‌کند.

* پیکربندی:

* کارت را بر اساس دسته به لیست 'Bugs' یا 'Feature Backlog' اختصاص می‌دهد.

* نام کارت را با استفاده از عنوان وظیفه تولید شده توسط هوش مصنوعی تنظیم می‌کند.

* اطلاعات دقیق را در توضیحات کارت (نوع ارسال کننده، بازخورد، برچسب‌ها) درج می‌کند.

* برچسب‌های مرتبط (مانند Customer، Staff، Urgent) را با استفاده از شناسه‌های گره Config اعمال می‌کند.

* ورودی‌ها: به داده‌های گره‌های AI Feedback Triage، JotForm Trigger و Config متکی است.

* خروجی‌ها: داده‌های مربوط به کارت Trello ایجاد شده، از جمله URL آن را برمی‌گرداند.

* موارد مرزی: نیاز به اعتبارنامه‌های معتبر Trello، شناسه‌های لیست/برچسب صحیح دارد و مشمول محدودیت‌های نرخ API Trello است.

* Log General Feedback to Airtable: یک رکورد جدید در یک پایگاه و جدول مشخص Airtable ایجاد می‌کند.

* پیکربندی:

* فیلدهایی مانند Email، Source، AI Tags، Full Feedback و Feedback Summary را نگاشت می‌کند.

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

* ورودی‌ها: از داده‌های گره‌های AI Feedback Triage و JotForm Trigger استفاده می‌کند.

* خروجی‌ها: تأیید ایجاد رکورد Airtable.

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

۵. بررسی فوریت و هشدار Slack

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

* Is it an Urgent Bug? (گره If)

* Alert Dev Team (گره Slack)

* No Alert Needed (گره NoOp)

• جزئیات:

* Is it an Urgent Bug?: بررسی می‌کند که آیا دسته بازخورد 'bug' است و suggested_priority 'high' (بدون حساسیت به بزرگی و کوچکی حروف) است.

* خروجی‌ها: در صورت درست بودن به Alert Dev Team و در غیر این صورت به No Alert Needed هدایت می‌کند.

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

* Alert Dev Team: یک پیام اعلان به یک کانال Slack تعیین شده ارسال می‌کند.

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

* ورودی‌ها: از داده‌های گره‌های JotForm Trigger، AI Feedback Triage و Create Trello Card استفاده می‌کند.

* خروجی‌ها: وضعیت تحویل پیام Slack.

* موارد مرزی: خطاهای احتمالی API/وب‌هوک Slack یا مشکلات مجوز کانال.

* No Alert Needed: یک گره نگهدارنده که این مسیر گردش کار را زمانی که نیازی به هشدار Slack نیست، خاتمه می‌دهد.

۶. یادداشت‌های مستندسازی و راه‌اندازی

• هدف: ارائه دستورالعمل‌های راه‌اندازی حیاتی و توضیحات مستقیماً در بوم گردش کار.
• گره‌ها:

* گره‌های Sticky Note متعدد.

• جزئیات:

* این گره‌ها حاوی متن و ابزارهای بصری هستند که توضیح می‌دهند:

* چگونه فرم Jotform خود را برای جمع‌آوری بازخورد پیکربندی کنید.

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

* جزئیات مربوط به فرآیند تجزیه و تحلیل هوش مصنوعی و مهندسی پرامپت.

* منطق ایجاد کارت Trello.

* مشخصات پیکربندی برای ثبت Airtable.

* مراحل راه‌اندازی هشدارهای Slack برای باگ‌های فوری.

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

---

جدول خلاصه