ادغام عامل هوش مصنوعی با Bubble و پروتکل MCP

ادغام عامل هوش مصنوعی برای برنامه‌های Bubble با دسترسی به داده‌های پروتکل MCP

https://axeto.ai/n8n

ادغام عامل هوش مصنوعی برای برنامه‌های Bubble با دسترسی به داده‌های پروتکل MCP

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

این گردش کار n8n با عنوان "ادغام عامل هوش مصنوعی برای برنامه‌های Bubble با دسترسی به داده‌های پروتکل MCP" برای تسهیل ادغام بین یک عامل هوش مصنوعی و یک برنامه Bubble از طریق تریگر سرور MCP (پروتکل چند کاناله) طراحی شده است. این گردش کار به عنوان یک پل برای بازیابی داده‌های دقیق از یک برنامه Bubble مربوط به پروژه‌ها، کاربران و پلاگین‌ها بر اساس شناسه‌های منحصر به فرد عمل می‌کند و پردازش یا اتوماسیون پویا مبتنی بر هوش مصنوعی را امکان‌پذیر می‌سازد.

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

• ۱.۱ تریگر ورودی سرور MCP: گوش دادن به درخواست‌های پروتکل MCP ورودی برای شروع گردش کار.
• ۱.۲ بازیابی داده‌های Bubble: پرس و جو از برنامه Bubble برای دریافت جزئیات مربوط به پروژه‌ها، کاربران و پلاگین‌ها با استفاده از شناسه‌های منحصر به فرد یا فیلترهای ارائه شده.

---

۲. تجزیه و تحلیل بلوک به بلوک

#### ۱.۱ تریگر ورودی سرور MCP

• مرور کلی:

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

• گره‌های درگیر:

- تریگر سرور MCP

• جزئیات گره:

- نام گره: تریگر سرور MCP

- نوع: @n8n/n8n-nodes-langchain.mcpTrigger (گره تریگر تخصصی برای پروتکل MCP)

- پیکربندی:

- مسیر وب‌هوک: db8e6f1e-863d-4889-b56b-f88fad0b24af

- نسخه نوع: ۲

- عبارات کلیدی / متغیرها: هیچ کدام به طور صریح، این گره منتظر درخواست‌های HTTP ورودی مطابق با مسیر وب‌هوک است.

- اتصالات ورودی: ندارد (گره تریگر).

- اتصالات خروجی: از طریق خروجی ai_tool به سه گره بازیابی داده Bubble (دریافت جزئیات پروژه، دریافت اطلاعات کاربر، دریافت جزئیات پلاگین) تغذیه می‌کند.

- الزامات نسخه: نیازمند نسخه n8n سازگار با گره تریگر MCP @n8n/n8n-nodes-langchain، نسخه ۲ یا بالاتر.

- شکست‌های احتمالی:

- خرابی ثبت وب‌هوک (تداخل پورت، مجوزها).

- اتمام زمان در صورت عدم وجود درخواست ورودی.

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

- گردش کار فرعی: ندارد.

---

#### ۱.۲ بازیابی داده‌های Bubble

• مرور کلی:

این بلوک شامل سه گره است که از برنامه Bubble برای موجودیت‌های داده خاص پرس و جو می‌کنند: جزئیات پروژه، اطلاعات کاربر و جزئیات پلاگین. هر گره از اعتبارنامه API Bubble برای دسترسی به داده‌ها بر اساس پارامترهای دریافت شده به صورت پویا یا لغو شده توسط عبارات تولید شده توسط هوش مصنوعی استفاده می‌کند.

• گره‌های درگیر:

- دریافت جزئیات پروژه

- دریافت اطلاعات کاربر

- دریافت جزئیات پلاگین

• جزئیات گره:

- نام گره: دریافت جزئیات پروژه

- نوع: n8n-nodes-base.bubbleTool (گره ادغام API Bubble)

- پیکربندی:

- نوع شیء: project

- شناسه شیء: عبارت پویا با استفاده از لغو هوش مصنوعی:

={{ $fromAI('Object_ID', 'Get project details using project unique ID', 'string') }}

- نوع توضیحات: دستی

- توضیحات ابزار: بازیابی اطلاعات پروژه از برنامه Bubble.

- اعتبارنامه‌ها: از اعتبارنامه‌های API Bubble با نام "حساب Bubble" استفاده می‌کند.

- اتصالات ورودی: از طریق خروجی ai_tool از تریگر سرور MCP فعال می‌شود.

- اتصالات خروجی: در این گردش کار پایین‌دستی ندارد.

- الزامات نسخه: سازگار با نسخه ۱ گره API Bubble.

- شکست‌های احتمالی:

- شناسه شیء نامعتبر یا گمشده که منجر به عدم بازگشت داده می‌شود.

- خطاهای احراز هویت API.

- مشکلات اتصال شبکه.

- خرابی عبارات در صورتی که لغو هوش مصنوعی یک رشته معتبر را برنگرداند.

- نام گره: دریافت اطلاعات کاربر

- نوع: n8n-nodes-base.bubbleTool

- پیکربندی:

- نوع شیء: user

- شناسه شیء: عبارت پویا با استفاده از لغو هوش مصنوعی:

={{ $fromAI('Object_ID', 'Get user information using user unique id', 'string') }}

- نوع توضیحات: دستی

- توضیحات ابزار: بازیابی اطلاعات کاربر از برنامه Bubble.

- اعتبارنامه‌ها: از همان اعتبارنامه‌های API Bubble بالا استفاده می‌کند.

- اتصالات ورودی: از طریق خروجی ai_tool از تریگر سرور MCP فعال می‌شود.

- اتصالات خروجی: ندارد.

- شکست‌های احتمالی: مشابه گره دریافت جزئیات پروژه.

- نام گره: دریافت جزئیات پلاگین

- نوع: n8n-nodes-base.bubbleTool

- پیکربندی:

- نوع شیء: plugin

- عملیات: getAll با فیلترها

- فیلترها: یک فیلتر با اعمال محدودیت "متن شامل" با کلید و مقدار که به صورت پویا از طریق لغو هوش مصنوعی تنظیم شده است:

- کلید: ={{ $fromAI('filter0_Key', '', 'string') }}

- مقدار: ={{ $fromAI('filter0_Value', '', 'string') }}

- نوع توضیحات: دستی

- توضیحات ابزار: بازیابی اطلاعات پلاگین مطابق با معیارهای فیلتر.

- اعتبارنامه‌ها: از همان اعتبارنامه‌های API Bubble استفاده می‌کند.

- اتصالات ورودی: از طریق خروجی ai_tool از تریگر سرور MCP فعال می‌شود.

- اتصالات خروجی: ندارد.

- شکست‌های احتمالی:

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

- خرابی احراز هویت یا اتصال API.

- خطاهای ارزیابی عبارت در صورتی که ورودی‌های لغو هوش مصنوعی نامعتبر باشند.

---

۳. جدول خلاصه

---

۴. بازتولید گردش کار از ابتدا

۱. یک گردش کار جدید ایجاد کنید در n8n، آن را "Bubble MCP server" نامگذاری کنید.

۲. گره تریگر سرور MCP را اضافه کنید:

- نوع گره: @n8n/n8n-nodes-langchain.mcpTrigger

- پارامتر path را به یک شناسه وب‌هوک منحصر به فرد تنظیم کنید، به عنوان مثال، "db8e6f1e-863d-4889-b56b-f88fad0b24af".

- از نسخه نوع ۲ استفاده کنید.

- نیازی به اعتبارنامه نیست.

- این گره به عنوان نقطه ورود برای درخواست‌های پروتکل MCP عمل می‌کند.

۳. اعتبارنامه‌های API Bubble را پیکربندی کنید:

- اعتبارنامه‌های موجود یا جدید برای دسترسی به API Bubble ایجاد کنید (OAuth2 یا کلید API مطابق با برنامه Bubble شما).

- برای سازگاری، آن را "حساب Bubble" نامگذاری کنید.

۴. گره دریافت جزئیات پروژه را اضافه کنید:

- نوع گره: n8n-nodes-base.bubbleTool

- نوع شیء را روی project تنظیم کنید.

- در شناسه شیء، عبارت را تنظیم کنید:

={{ $fromAI('Object_ID', 'Get project details using project unique ID', 'string') }}

این امکان ورودی پویا از لغو عامل هوش مصنوعی را فراهم می‌کند.

- نوع توضیحات را روی دستی تنظیم کنید، توضیحات ابزار مانند "دریافت اطلاعات پروژه در برنامه Bubble ما" را اضافه کنید.

- اعتبارنامه‌های API Bubble ("حساب Bubble") را پیوست کنید.

- ورودی را از خروجی ai_tool گره تریگر سرور MCP متصل کنید.

۵. گره دریافت اطلاعات کاربر را اضافه کنید:

- نوع گره: n8n-nodes-base.bubbleTool

- نوع شیء را روی user تنظیم کنید.

- عبارت شناسه شیء را تنظیم کنید:

={{ $fromAI('Object_ID', 'Get user information using user unique id', 'string') }}

- نوع توضیحات دستی، با توضیحات ابزار مناسب.

- همان اعتبارنامه‌های API Bubble را پیوست کنید.

- ورودی را از خروجی ai_tool گره تریگر سرور MCP متصل کنید.

۶. گره دریافت جزئیات پلاگین را اضافه کنید:

- نوع گره: n8n-nodes-base.bubbleTool

- نوع شیء را روی plugin تنظیم کنید.

- عملیات: getAll.

- فیلترها را پیکربندی کنید:

- یک فیلتر با موارد زیر اضافه کنید:

- کلید: ={{ $fromAI('filter0_Key', '', 'string') }}

- مقدار: ={{ $fromAI('filter0_Value', '', 'string') }}

- نوع محدودیت: text contains.

- نوع توضیحات دستی، با توضیحات ابزار برای بازیابی اطلاعات پلاگین.

- اعتبارنامه‌های API Bubble را پیوست کنید.

- ورودی را از خروجی ai_tool گره تریگر سرور MCP متصل کنید.

۷. گردش کار را ذخیره و فعال کنید.

این تنظیم تضمین می‌کند که گردش کار ورودی‌های پروتکل MCP را گوش می‌دهد، سپس بر اساس پارامترهای هدایت شده توسط هوش مصنوعی، به صورت پویا از Bubble برای پروژه‌ها، کاربران و پلاگین‌ها پرس و جو می‌کند.

---

۵. نکات عمومی و منابع

---

سلب مسئولیت: متن ارائه شده منحصراً از یک گردش کار خودکار n8n که با ابزار ادغام و اتوماسیون n8n ایجاد شده است، مشتق شده است. این پردازش به شدت از سیاست‌های محتوای فعلی پیروی می‌کند و حاوی هیچ عنصر غیرقانونی، توهین‌آمیز یا محافظت شده‌ای نیست. تمام داده‌های دستکاری شده قانونی و عمومی هستند.