اسکیل‌ها برای عامل‌های هوش مصنوعی

اسکیل‌های GetMyBot پوشش‌های عاملانه آماده روی GetMyBot API هستند. به عامل هوش مصنوعی (مثلاً Claude Code) یاد می‌دهند با بات‌های شما به زبان طبیعی کار کند: «یک واکنش در GetMyBot بساز»، «همه‌رسانی GetMyBot با برچسب VIP را راه‌اندازی کن»، «آمار بات را نشان بده». در پشت صحنه، اسکیل ابزارهای MCP GetMyBot را فراخوانی می‌کند، و اگر سرور MCP متصل نباشد — همان درخواست‌ها را از طریق REST با توکن شما انجام می‌دهد.

اسکیل‌ها یک ویژگی پولی جداگانه یا مارکت‌پلیس نیستند. فایل‌های SKILL.md هستند (فرمت Claude Code) که به‌صورت محلی کنار عامل خود نصب می‌کنید.

چگونه کار می‌کند

هر اسکیل بر اساس اصل آشکارسازی تدریجی ساختار یافته: توضیح کوتاه عامل را برای عبارت‌های حوزه‌ای فعال می‌کند، و مرجع سنگین API فقط زمانی بارگذاری می‌شود که لازم باشد. در هر اسکیل دو مسیر دسترسی مستندسازی شده است:

  • MCP (ترجیح داده می‌شود) — اگر سرور MCP GetMyBot به عامل متصل باشد، اسکیل ابزارها را مستقیم فراخوانی می‌کند.
  • REST-fallback — اگر MCP در دسترس نباشد، اسکیل همان عملیات را با درخواست‌های curl با توکن شخصی انجام می‌دهد.

احراز هویت در همه اسکیل‌ها یکسان است: توکن شخصی mbp_… و آدرس پایه /api. جزئیات بیشتر در راهنمای احراز هویت.

شش اسکیل

  • mybot — نقطه ورود و ناوبری: GetMyBot API چیست، چگونه PAT و حوزه‌های آن را دریافت کنید، آدرس پایه، نحوه اتصال سرور MCP، چه زمانی REST و چه زمانی MCP، فرمت خطاها، صفحه‌بندی و محدودیت‌ها. از اینجا عامل وارد پنج اسکیل دیگر می‌شود.
  • mybot-bots — اتصال و مدیریت بات‌ها: بررسی توکن، اتصال، فهرست و کارت، به‌روزرسانی، همگام‌سازی، تغییر توکن، انتقال، حذف، تنظیمات، قالب‌ها.
  • mybot-reactions — سازنده واکنش‌ها (بزرگ‌ترین): ساختار «ماشه → شرط‌ها → چت‌ها → اقدامات»، ایجاد و به‌روزرسانی، انواع ماشه، شرط‌های AND/OR، کاتالوگ اقدامات، پیام‌ها و دکمه‌ها، دکمه‌های پویا و پارامترها، فرمول‌ها (DSL)، پوشه‌ها، پیوندهای واکنش‌ها، ورودی از SamBot، بررسی فرمول‌ها، ترتیب.
  • mybot-broadcasts — همه‌رسانی: راه‌اندازی بر اساس واکنش، تقسیم‌بندی بر اساس برچسب، مکث/از سرگیری/لغو و وضعیت، ویرایش پیام‌های ارسال‌شده (تکی و «برای همه»)، صف و تکرار.
  • mybot-data — داده‌ها و یکپارچه‌سازی‌ها: مجموعه‌ها (جداول — فیلدها و رکوردها)، سناریوها (flows)، یکپارچه‌سازی‌ها (هوش مصنوعی، Google Sheets، GetCourse، پردازنده خارجی از طریق WebSocket)، اتصالات و دسترسی‌ها.
  • mybot-analytics — مشاهده‌پذیری و مخاطبان: آمار (مصرف موجودی، معیارها، گزارش، سلامت واکنش‌ها)، تحلیل‌ها (مخاطبان، چت‌ها، قیف‌ها)، مشترکان و برچسب‌ها، مکالمات، صورتحساب (موجودی، طرح‌ها، تراکنش‌ها).

نصب

اسکیل‌ها در مخزن GetMyBot در پوشه skills/ قرار دارند. هر اسکیل یک پوشه skills/<name>/ با فایل‌های SKILL.md (راهنمای مختصر) و reference.md (مرجع کامل حوزه با نمونه‌های MCP و curl) است.

برای اینکه عامل اسکیل‌ها را ببیند، آن‌ها را با کاتالوگ اسکیل‌های Claude Code پیوند بزنید. در مخزن یک اسکریپت آماده وجود دارد:

./skills/install.sh

این اسکریپت سیم‌لینک‌های ~/.claude/skills/<name> به پوشه‌های داخل مخزن ایجاد می‌کند — تغییرات در مخزن فوری برای عامل قابل مشاهده است و نسخه‌های اضافی ایجاد نمی‌شود. پس از نصب، کارتان را با کلمات معمولی توصیف کنید («در GetMyBot یک بات پاسخگوی خودکار بساز»)، و عامل اسکیل مناسب را خودش پیدا می‌کند.

بیشتر بخوانید