تولیدکننده خودکار پروژه ClickUp با هوش مصنوعی و فرم

تولیدکننده پروژه Agile با سلسله مراتب وظایف ClickUp با استفاده از GPT-5 و فرم‌ها

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

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

این گردش کار مراحل منطقی زیر را دنبال می‌کند:

1. دریافت ورودی: جزئیات پروژه را از طریق یک فرم وب یا تریگر دستی جمع‌آوری می‌کند.

2. نام‌گذاری پروژه و تولید کلید (پردازش هوش مصنوعی): از GPT-5 برای اصلاح نام پروژه، تولید توضیحات و ایجاد یک کلید منحصر به فرد برای پروژه استفاده می‌کند.

3. ایجاد لیست پروژه در ClickUp: یک لیست جدید در ClickUp برای نگهداری پروژه ایجاد می‌کند.

4. تولید وظایف Agile (پردازش هوش مصنوعی): از GPT-5 برای تجزیه ویژگی‌های پروژه به داستان‌های کاربری Agile دقیق با وظایف فرعی مرتبط استفاده می‌کند.

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

6. اطلاع‌رسانی: پس از ایجاد موفقیت‌آمیز پروژه و وظایف، یک ایمیل تأیید ارسال می‌کند.

---

تحلیل جزئیات بلاک‌ها

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

این بخش مسئول دریافت اولیه داده‌های پروژه است.

نودها:

• Manual Trigger (برای تست)
• Form Trigger (برای ورودی زنده)

جزئیات:

• Manual Trigger

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

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

* پیکربندی: پارامتر خاصی ندارد؛ با شروع دستی فعال می‌شود.

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

* خروجی: داده‌های نمونه Project Name و Project Full Features را ارائه می‌دهد.

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

• Form Trigger

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

* هدف: جزئیات پروژه ارسال شده از طریق یک فرم وب با عنوان "Jira Full Project Generator" را دریافت می‌کند.

* پیکربندی: به دو فیلد فرم نیاز دارد:

* Project Name (اجباری)

* Project Full Features (متن طولانی، اجباری)

* ورودی: داده‌های حاصل از ارسال فرم HTTP.

* خروجی: شیء JSON حاوی داده‌های فرم ارسال شده.

* موارد مرزی: مشکلات احتمالی با پیکربندی نادرست Webhook، تغییرات در طرح ورودی فرم، یا فیلدهای اجباری گمشده.

۲. نام‌گذاری پروژه و تولید کلید (پردازش هوش مصنوعی)

این بلاک هویت پروژه را با استفاده از هوش مصنوعی اصلاح می‌کند.

نودها:

• OpenAI Chat Model
• Project Naming (Chain LLM)
• Structured Output Parser1

جزئیات:

• OpenAI Chat Model

* نوع: n8n-nodes-base.openAiChatModel (ادغام Langchain)

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

* پیکربندی:

* مدل: روی "gpt-5-mini" تنظیم شده است (شبیه‌سازی قابلیت‌های GPT-5).

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

* ورودی: پرامپت‌های متنی تولید شده توسط نودهای بعدی.

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

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

• Project Naming (Chain LLM)

* نوع: n8n-nodes-base.chainLLM (پرامپت متنی Langchain)

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

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

* ورودی: داده‌های JSON حاوی Project Name و Project Full Features از بلاک دریافت ورودی.

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

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

• Structured Output Parser1

* نوع: n8n-nodes-base.structuredOutputParser (Langchain)

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

* پیکربندی: یک طرح JSON شامل project_name، project_description و project_key تعریف می‌کند.

* ورودی: پاسخ خام هوش مصنوعی از نود "Project Naming".

* خروجی: یک شیء JSON ساختاریافته حاوی جزئیات اصلاح شده پروژه.

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

۳. ایجاد لیست پروژه در ClickUp

این بلاک کانتینر اصلی پروژه را در ClickUp ایجاد می‌کند.

نودها:

• ClickUp Create List
• Sticky Note3 (comment)

جزئیات:

• ClickUp Create List

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

* هدف: یک لیست جدید در فضای کاری مشخص ClickUp برای نمایش پروژه ایجاد می‌کند.

* پیکربندی:

* منبع: list

* عملیات: create

* نام: به صورت پویا بر اساس project_name تولید شده توسط هوش مصنوعی تنظیم می‌شود.

* شناسه تیم و فضا: از قبل پیکربندی شده است (مثلاً 9014828465، 90143504524).

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

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

* ورودی: نام پروژه JSON از نود "Structured Output Parser1".

* خروجی: JSON حاوی جزئیات لیست ایجاد شده ClickUp، از جمله شناسه آن.

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

• Sticky Note3 (comment)

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

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

* پیکربندی: محتوای متنی برای یادداشت.

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

* خروجی: محتوای یادداشت.

* موارد مرزی: برای عملکرد اصلی حیاتی نیست اما برای درک گردش کار مفید است.

۴. تولید وظایف Agile (پردازش هوش مصنوعی)

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

نودها:

• Clickup Project Task Generator (Chain LLM)
• Structured Output Parser
• Split Out

جزئیات:

• Clickup Project Task Generator (Chain LLM)

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

* هدف: GPT-5 را برای تولید لیستی از وظایف داستان کاربر Agile، هر کدام با وظایف فرعی بالقوه، بر اساس توضیحات کامل ویژگی پروژه، پرامپت می‌کند.

* پیکربندی:

* پرامپت: هوش مصنوعی را برای خروجی وظایف در قالب آرایه JSON، مناسب برای متدولوژی‌های Agile، هدایت می‌کند.

* متغیرهای ورودی: از Project Name و Project Full Features استفاده می‌کند. توجه: این نود ممکن است برای اهداف تست از داده‌های تریگر دستی استفاده کند که با مسیر ورودی فرم متفاوت است.

* ورودی: داده‌های نام پروژه و ویژگی‌ها.

* خروجی: پاسخ خام JSON حاوی وظایف و وظایف فرعی تولید شده.

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

• Structured Output Parser

* نوع: n8n-nodes-base.structuredOutputParser (Langchain)

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

* ورودی: پاسخ خام JSON هوش مصنوعی از "Clickup Project Task Generator".

* خروجی: یک آرایه ساختاریافته از اشیاء وظیفه، که هر کدام به طور بالقوه حاوی وظایف فرعی هستند.

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

• Split Out

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

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

* ورودی: اشیاء وظیفه JSON فردی.

* خروجی: اشیاء وظیفه JSON فردی.

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

۵. پردازش وظایف و وظایف فرعی

این بلاک اصلی اجرایی است که وظایف و وظایف فرعی را در ClickUp ایجاد می‌کند.

نودها:

• Limit
• Loop Over Items (پردازش دسته‌ای برای وظایف اصلی)
• ClickUp Create Task
• Set (قبلاً Edit Fields)
• Split Out1 (برای وظایف فرعی)
• Merge
• Execute Workflow (برای فراخوانی گردش کار فرعی)
• When Executed by Another Workflow (تریگر گردش کار فرعی)
• Loop Over Items1 (پردازش دسته‌ای برای وظایف فرعی)
• ClickUp Create Sub-Task

جزئیات:

• Limit

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

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

* ورودی: وظایف از نود "Split Out".

* خروجی: یک دسته محدود از وظایف.

* موارد مرزی: اگر محدودیتی تعریف نشده باشد، ممکن است همه وظایف به طور همزمان پردازش شوند.

• Loop Over Items

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

* هدف: از طریق وظایف اصلی تکرار می‌شود و آنها را یکی یکی (یا در دسته‌های کوچک) پردازش می‌کند تا بار API را مدیریت کرده و ایجاد منظم را تضمین کند.

* ورودی: وظایف از نود "Limit".

* خروجی: یک شیء وظیفه واحد در هر تکرار.

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

• ClickUp Create Task

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

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

* پیکربندی:

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

* نام وظیفه: از فیلد task_title وظیفه ورودی نگاشت می‌شود.

* محتوا: از فیلد description وظیفه ورودی نگاشت می‌شود.

* ورودی: وظیفه JSON فردی از نود "Loop Over Items".

* خروجی: JSON حاوی جزئیات وظیفه ایجاد شده ClickUp، از جمله شناسه آن.

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

• Set

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

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

* ورودی: خروجی JSON از "ClickUp Create Task"، که شامل داده‌های وظیفه اصلی به همراه آرایه sub_tasks است.

* خروجی: JSON وظیفه، با آرایه sub_tasks که به وضوح تعریف شده است.

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

• Split Out1

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

* هدف: آرایه sub_tasks را گرفته و آن را تقسیم می‌کند و هر وظیفه فرعی را به عنوان یک آیتم جداگانه خروجی می‌دهد.

* ورودی: JSON حاوی آرایه sub_tasks از نود "Set".

* خروجی: اشیاء وظیفه فرعی JSON فردی.

* موارد مرزی: آرایه‌های sub_tasks خالی یا داده‌های وظیفه فرعی ناقص را به خوبی مدیریت می‌کند.

• Merge

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

* هدف: جریان‌های داده را ترکیب می‌کند. در اینجا، اطلاعات وظیفه والد (مانند list_id و task_id) را با جزئیات وظایف فرعی فردی قبل از ارسال آنها به گردش کار فرعی ترکیب می‌کند.

* ورودی: JSON وظیفه فرعی از "Split Out1" و اطلاعات وظیفه والد از "ClickUp Create Task".

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

* موارد مرزی: برای عملکرد صحیح به حالت ادغام و هم‌ترازی داده‌ها نیاز دارد.

• Execute Workflow

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

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

* پیکربندی:

* ارجاع گردش کار: به شناسه گردش کار فرعی اشاره دارد (مثلاً "ClickUp Project Generator Template Workflow").

* نگاشت ورودی: پارامترهای لازم مانند list_id، task_id، subtask_title و subtask_description را به گردش کار فرعی ارسال می‌کند.

* ورودی: داده‌های ترکیب شده از نود "Merge".

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

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

• When Executed by Another Workflow

* نوع: n8n-nodes-base.executeWorkflow (به عنوان تریگر)

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

* ورودی: ورودی‌های گردش کار: list_id، task_id، subtask_title، subtask_description.

* خروجی: داده‌های وظیفه فرعی آماده برای پردازش.

• Loop Over Items1

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

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

* ورودی: آرایه داده‌های وظیفه فرعی.

* خروجی: یک شیء وظیفه فرعی واحد در هر تکرار.

• ClickUp Create Sub-Task

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

* هدف: وظیفه فرعی واقعی را در ClickUp ایجاد می‌کند و آن را به وظیفه والد خود پیوند می‌دهد.

* پیکربندی:

* شناسه لیست، شناسه وظیفه والد (parentId)، عنوان وظیفه فرعی و توضیحات وظیفه فرعی از ورودی نگاشت می‌شوند.

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

* ورودی: وظیفه فرعی JSON فردی از "Loop Over Items1".

* خروجی: جزئیات وظیفه فرعی ایجاد شده ClickUp.

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

۶. اطلاع‌رسانی

این بلوک نهایی تکمیل موفقیت‌آمیز گردش کار را تأیید می‌کند.

نودها:

• Aggregate
• Gmail

جزئیات:

• Aggregate

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

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

* ورودی: داده‌ها از نود "Loop Over Items" (وظایف اصلی).

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

* موارد مرزی: مواردی را که داده‌ای برای تجمیع وجود ندارد یا عدم تطابق احتمالی داده‌ها را مدیریت می‌کند.

• Gmail

* نوع: n8n-nodes-base.gmail (OAuth2)

* هدف: یک اعلان ایمیلی برای تأیید اینکه پروژه و وظایف آن با موفقیت در ClickUp تولید شده‌اند، ارسال می‌کند.

* پیکربندی:

* گیرنده: روی یک ایمیل نگهدارنده تنظیم شده است (مثلاً n8n_test_result_replace_me@yopmail.com) که باید با یک آدرس معتبر به‌روز شود.

* موضوع: "Project successfully generated".

* بدنه پیام: شامل نام پروژه، شناسه لیست ClickUp و پیوند مستقیم به لیست پروژه ایجاد شده جدید در ClickUp است.

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

* ورودی: داده‌های تجمیع شده از نود "Aggregate".

* خروجی: وضعیت عملیات ارسال ایمیل.

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

---

پشته فنی

• پلتفرم اتوماسیون: n8n (میزبانی شده در Axeto.ai)
• مدل هوش مصنوعی: GPT-5 (شبیه‌سازی شده از طریق gpt-5-mini در Langchain)
• ابزار مدیریت پروژه: ClickUp
• ارتباطات: Gmail (برای اعلان‌ها)
• روش ورودی: فرم‌های وب (از طریق n8n-nodes-base.formTrigger)

---

شروع کار

1. راه‌اندازی n8n: اطمینان حاصل کنید که یک نمونه n8n در حال اجرا دارید که از طریق Axeto.ai قابل دسترسی است.

2. پیکربندی اعتبارنامه‌ها: کلید API OpenAI و توکن API یا اعتبارنامه‌های OAuth کلیک‌آپ خود را در n8n اضافه کنید. اعتبارنامه‌های OAuth2 جیمیل را برای اعلان‌ها تنظیم کنید.

3. استقرار گردش کار: این گردش کار را در نمونه n8n خود وارد یا ایجاد کنید.

4. به‌روزرسانی ایمیل اعلان: آدرس گیرنده گره جیمیل را به ایمیل دلخواه خود تغییر دهید.

5. راه‌اندازی گردش کار:

* برای آزمایش، از گره "Manual Trigger" استفاده کنید.

* برای استفاده زنده، به URL وب‌هوک ارائه شده توسط گره "Form Trigger" دسترسی پیدا کرده و جزئیات پروژه را از طریق فرم وب ارسال کنید.

این گردش کار راه‌حلی قوی برای خودکارسازی راه‌اندازی پروژه‌های Agile ارائه می‌دهد که تلاش دستی را به میزان قابل توجهی کاهش داده و سازگاری را تضمین می‌کند.