اتوماسیون Kitemaker با n8n: دسترسی عامل هوش مصنوعی به کاربر…

ادغام عامل هوش مصنوعی برای عملیات کاربر و آیتم‌های کاری Kitemaker

این Workflow به عوامل هوش مصنوعی امکان می‌دهد تا از طریق یکپارچه‌سازی سرور MCP (Multi-Channel Platform) با قابلیت‌های کاربر و آیتم‌های کاری Kitemaker تعامل داشته باشند. این Workflow برای سناریوهایی طراحی شده است که فرآیندهای خودکار یا عوامل مبتنی بر هوش مصنوعی نیاز به مدیریت برنامه‌نویسی شده داده‌های سازمانی، فضاها، کاربران و آیتم‌های کاری در Kitemaker دارند.

این Workflow و موارد دیگر را در Axeto.ai کاوش کنید: https://axeto.ai/n8n

---

نمای کلی Workflow

این Workflow با نام "Kitemaker Tool MCP Server" به عنوان یک پل عمل می‌کند و به عوامل هوش مصنوعی اجازه می‌دهد تا عملیات مختلفی را بر روی پلتفرم Kitemaker اجرا کنند. این Workflow به دو بخش اصلی تقسیم شده است:

1. دریافت درخواست هوش مصنوعی: یک Node تریگر MCP درخواست‌های ورودی را از عوامل هوش مصنوعی دریافت می‌کند.

2. عملیات داده Kitemaker: مجموعه‌ای از Nodes ابزار Kitemaker عملیات API خاصی را بر اساس دستورالعمل‌های عامل هوش مصنوعی اجرا می‌کنند.

هر Node عملیات Kitemaker مستقیماً به تریگر MCP متصل است و به عوامل هوش مصنوعی اجازه می‌دهد تا اقدامات فردی را به طور مستقل فراخوانی کنند.

---

جزئیات Node ها

۱. دریافت درخواست هوش مصنوعی

هدف: این نقطه ورود Workflow است که برای گوش دادن و ثبت درخواست‌های آغاز شده توسط عوامل هوش مصنوعی از طریق رابط MCP طراحی شده است.

Nodes:

• Kitemaker Tool MCP Server

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

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

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

* ورودی: ندارد (زیرا یک Node تریگر است).

* خروجی: به تمام Nodes عملیات Kitemaker بعدی متصل می‌شود و درخواست عامل هوش مصنوعی را منتقل می‌کند.

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

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

---

۲. عملیات داده Kitemaker

هدف: این بخش شامل Nodes است که مستقیماً با API Kitemaker برای انجام وظایف ضروری بازیابی و دستکاری داده تعامل دارند. هر Node مربوط به یک اقدام خاص Kitemaker است و توسط ورودی MCP فعال می‌شود.

Nodes:

• دریافت سازمان کاربر وارد شده

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

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

* پیکربندی: از عملیات پیش‌فرض برای بازیابی اطلاعات سازمان استفاده می‌کند. برای زمینه کاربر به اعتبارنامه‌های Kitemaker متکی است.

* ورودی: داده‌ها را از Node Kitemaker Tool MCP Server دریافت می‌کند.

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

• دریافت چندین فضا

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

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

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

* ورودی: داده‌ها را از Node Kitemaker Tool MCP Server دریافت می‌کند.

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

• دریافت چندین کاربر

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

* نقش: لیستی از کاربران در سازمان یا فضای کاری را دریافت می‌کند.

* پیکربندی: از پارامترهای پیش‌فرض برای دریافت کاربران استفاده می‌کند؛ هیچ صفحه‌بندی یا فیلتر صریحی تنظیم نشده است.

* ورودی: داده‌ها را از Node Kitemaker Tool MCP Server دریافت می‌کند.

* مشکلات احتمالی: خطاهای مجوز، نتایج خالی، یا اتمام زمان API.

• ایجاد یک آیتم کاری

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

* نقش: یک آیتم کاری جدید در Kitemaker ایجاد می‌کند.

* پیکربندی: پارامترهای ایجاد پیش‌فرض. نیاز به ارائه داده‌های ورودی (مانند عنوان، توضیحات، نوع) به صورت پویا توسط عامل هوش مصنوعی یا Nodes قبلی دارد.

* ورودی: داده‌ها را از Node Kitemaker Tool MCP Server دریافت می‌کند.

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

• دریافت یک آیتم کاری

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

* نقش: اطلاعات دقیق یک آیتم کاری خاص را بازیابی می‌کند.

* پیکربندی: نیاز به شناسه آیتم کاری (Work Item ID) دارد که باید به صورت پویا ارائه شود (مثلاً از درخواست عامل هوش مصنوعی).

* ورودی: داده‌ها را از Node Kitemaker Tool MCP Server دریافت می‌کند.

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

• دریافت چندین آیتم کاری

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

* نقش: لیستی از چندین آیتم کاری را دریافت می‌کند، احتمالاً با فیلترهای پیش‌فرض یا تنظیمات صفحه‌بندی.

* پیکربندی: هیچ فیلتر صریحی در تنظیمات پیش‌فرض قابل مشاهده نیست.

* ورودی: داده‌ها را از Node Kitemaker Tool MCP Server دریافت می‌کند.

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

• به‌روزرسانی یک آیتم کاری

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

* نقش: خصوصیات موجود یا وضعیت یک آیتم کاری خاص را تغییر می‌دهد.

* پیکربندی: نیاز به شناسه آیتم کاری (Work Item ID) و فیلدهایی که باید به‌روزرسانی شوند دارد، که باید به صورت پویا ارائه شوند.

* ورودی: داده‌ها را از Node Kitemaker Tool MCP Server دریافت می‌کند.

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

---

جدول خلاصه Workflow

(توجه: یادداشت‌های چسبان (Sticky Notes) برای مستندسازی در داخل Workflow استفاده می‌شوند و در اینجا به عنوان Nodes عملکردی فهرست نشده‌اند.)

---

ساخت Workflow از ابتدا

1. افزودن تریگر MCP:

* Node با نوع @n8n/n8n-nodes-langchain.mcpTrigger را جستجو و اضافه کنید.

* نام آن را "Kitemaker Tool MCP Server" بگذارید.

* پیکربندی آن را با تنظیمات پیش‌فرض رها کنید.

2. ادغام عملیات Kitemaker:

* برای هر اقدام Kitemaker، یک Node از نوع n8n-nodes-base.kitemakerTool اضافه کنید.

* ورودی هر Node kitemakerTool را به خروجی ai_tool از Node تریگر "Kitemaker Tool MCP Server" متصل کنید.

* هر Node kitemakerTool را مطابق با عملیات خاص پیکربندی کنید:

* دریافت سازمان کاربر وارد شده: عملیات پیش‌فرض "Fetch organization info for current user" را انتخاب کنید.

* دریافت چندین فضا: عملیات "List spaces accessible to user" را انتخاب کنید.

* دریافت چندین کاربر: عملیات "List users associated with the organization" را انتخاب کنید.

* ایجاد یک آیتم کاری: عملیات "Create new work item" را انتخاب کنید. اطمینان حاصل کنید که فیلدهای لازم (مانند عنوان، توضیحات) برای پذیرش ورودی پویا پیکربندی شده‌اند.

* دریافت یک آیتم کاری: عملیات "Retrieve single work item by ID" را انتخاب کنید. پارامتر Work Item ID را برای پذیرش ورودی پویا پیکربندی کنید.

* دریافت چندین آیتم کاری: عملیات "List work items" را انتخاب کنید. هرگونه فیلتر یا صفحه‌بندی دلخواه را پیکربندی کنید.

* به‌روزرسانی یک آیتم کاری: عملیات "Update work item" را انتخاب کنید. پارامترهای مربوط به Work Item ID و فیلدهایی که باید به‌روزرسانی شوند را پیکربندی کنید و اطمینان حاصل کنید که ورودی پویا را می‌پذیرند.

3. پیکربندی اعتبارنامه‌های Kitemaker:

* برای تمام Nodes kitemakerTool، اعتبارنامه‌های API Kitemaker خود (مانند کلید API یا توکن OAuth) را در مدیریت اعتبارنامه‌های n8n تنظیم کنید.

4. افزودن مستندات (اختیاری):

* از Nodes n8n-nodes-base.stickyNote برای افزودن توضیحات یا دستورالعمل‌ها در داخل بوم Workflow استفاده کنید.

5. تنظیمات Workflow:

* منطقه زمانی Workflow را در صورت لزوم پیکربندی کنید (مثلاً "America/New_York").

6. تست کامل:

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

* تأیید کنید که هر Node عملیات Kitemaker به درستی اجرا می‌شود و داده‌های مورد انتظار را برمی‌گرداند یا اقدام مورد نظر را انجام می‌دهد.

---

منابع

• کاتالوگ n8n در Axeto.ai: https://axeto.ai/n8n
• مستندات Kitemaker: (برای جزئیات API به مستندات رسمی Kitemaker مراجعه کنید)