دۆخی بینراوکردنەوەی تواناکان (Ability Visibility)
Superdav AI Agent v1.12.0 سیستەمی کۆنتڕۆڵکردنی دۆخی بینراوکردنەوەی تواناکان (Ability Visibility) دەهێنێت کە دیاری دەکات چ ڕووبەرێک (surface) ئەو تواناکانە دەردەخات. ئەمەش بەڕێوەبەری پۆلسیون دەبێت بۆ ئەوەی بتوانێت وردکاری بکات کە کام تواناکانی لە ڕێگەی REST API، MCP servers، WooCommerce integrations و دیکە ئامرازەکاندا بەکاربهێنرێت.
دۆخی بینراوکردنەوەی تواناکان چییە؟
دۆخی بینراوکردنەوەی تواناکان سیستەمێکی ڕێگەپێدانە کە کۆنتڕۆڵ دەکات:
- کام تواناکان بۆ ئەژمارەکان دەربکەون (available)
- لە کوێدا دەردەخاتن (REST API، MCP، WooCommerce و هتد)
- کی دەتوانێت دەستکارییان بکات (بە ڕێگەی لیستەکانی ڕێگەپێدان بۆ هاوبەشکان - partner allow-lists)
- چۆنی پۆلسیون دەکرێن (ئەو framedن کە ناسراون یان نەکراون)
هەر تواناکان ئاستێکی بینراوکردنەوەی هەیە کە دیاری دەکات چۆن لە ڕووبەڕووبوونەوەی ڕووبەرە جیاوازەکاندا بەکاربهێنرێت.
ئاستەکان بۆ بینراوکردنەوە (Visibility Levels)
جیهانی (Public)
تواناکانی جیهانی لە هەموو شوێنێکدا دەربکەون:
- REST API endpoints
- MCP servers
- WooCommerce integrations
- Chat interfaces
- هەموو ڕۆڵەکانی بەکارهێنەر (بە ڕێگەپێدانەکانی پێویست)
نموونە: scaffold-block-theme، activate-theme، send-email
ناوخۆیی (Internal)
تواناکانی ناوخۆیی تەنها لەناو دامەنی WordPress یەکەت دەربکەون:
- Chat interfaces
- Admin panels
- بەکارهێنەرانی تۆڕکراو (Logged-in users) تەنها
- نەکراون ڕێگەی REST API یان هاوبەشەکانی دەرەوەیان دەدات
نموونە: manage-settings، view-analytics، export-data
هاوبەش (Partner)
تواناکانی هاوبەش تەنها بۆ هاوبەشانی لیستکراو بەکار دەهێنرێت:
- پێویستی بە تۆمارکردنی ڕێگەپێدان لە لیستەکانی هاوبەشی دیاریکراو هەیە
- دەکرێت بە REST API بە ناسنامەی هاوبەش (partner credentials) بەکارهێنرێت
- دەکرێت بە MCP بە ناسنامەی هاوبەشی بەکاربهێنرێت
- بۆ بەکارهێنەرانی ئاسایی دروست نین
نموونە: bulk-import-users، modify-billing، access-analytics
ناتواندنی (Disabled)
تواناکانی ناتواندنی لە هیچ شوێنێکدا دەربکەون:
- بە ڕێگەی هیچ ڕووبەرێک دەردەخاتن
- لە چاتدا بەکارن دەهێنرێت
- لە ناو Admin panels دا بەکارن دەهێنرێت
- بۆ تواناکانی کۆن یان ئەزموونکردن (experimental) کار دەکات
بەڕێوەبردنی بینینی تواناکان (Managing Ability Visibility)
دەستکردن بۆ تنظیمووی بینینی تواناکان (Accessing Ability Visibility Settings)
- بگواشبە WordPress Admin → Superdav AI Agent → Settings
- لە تبەکەدا، Abilities (تواناکان) هەڵبژێرە
- لێرەدا لیستێک دەبینیت لە هەموو تواناکانی دامەزراو کە ئاستی بینینیان هەیە
دۆخێتی وردی تواناکان ببینن (Viewing Ability Details)
لە هەر توانایەک یەک دەبێت بۆ ئەوەی ئەم شتان ببینیت:
- Name (ناوی): ناسنامەی ئەو توانایە
- Description (وەرگێڕان/توصیف): ئەو توانایە چی دەکات
- Current visibility (بینینی ئێستای): Public (بۆ هەمووان)، Internal (داخلي)، Partner (هەڵگر)، یان Disabled (بەدواداچوون)
- Partner allow-list: چیا بەشە هاوکاران دەتوانن دەستکارییان بکەنەوە (ئەگەر بینینی Partner بێت)
- Last updated (کاتی نوێکردنەوە): کاتێک بینینەکە لە کۆتاییدا گۆڕاوە
- Status (دۆخ): Recognized (پێناسراوە) یان Unclassified (ناشناس)
گۆڕینی ئاستی بینین (Changing Visibility Levels)
بۆ گۆڕینی بینینی توانایەک:
- ئەو توانایەی لە لیستەکەدا هەڵبژێرە
- نیشاندانی ئاستێکی بینینی نوێ لە منوچەی دروپێشکردنەوە هەڵبژێرە
- ئەگەر "Partner" (هاوکار) هەڵبژێردرێت، ناسنامەکانی هاوکارییەکە زیاد بکە بە لیستەکەی ڕێنمایی (allow-list)
- Save (سەردانکردن): بۆ کۆتاییهێنان
نموونە:
Ability: bulk-import-users
Current visibility: Public
Change to: Partner
Partner allow-list: partner-123, partner-456
کارکردنی زۆر (Bulk Operations)
بۆ گۆڕینی بینین بۆ چەند توانایەک:
- لەسەر کاتی تواناکان، خاڵەکان بە ئاماژە دەدات (Check the boxes)
- نیشاندانی ئاستی بینینی نوێ لە منوچەی کارکردنی زۆر هەڵبژێرە
- Apply (برگرتن): بۆ ئەوەی گۆڕانەکە جێبەجێ بکرێت
لیستەکەی هاوکاران (Partner Allow-List)
partner allow-list ئەو شتەیە کە دیاری دەکات چیا هاوکارییەکانی دەرەکی دەتوانن تواناکانی ئاستی Partner بەدەست بهێنن.
زیادکردنی هاوکاران (Adding Partners)
- بگواشبە Superdav AI Agent → Settings → Partners
- Add Partner (هاوکار زیاد بکە) هەڵبژێرە
- ناسنامەی هاوکارییەکە بنووسە (بە گشتی API key یان Organization ID)
- بەختور، ناوی و وەسفی هاوکارییەک دەتوانی زیاد بکەیت
- Save (سەردانکردن): بۆ کۆتاییهێنان
دیاریکردنی تواناکان بۆ هاوکاران (Assigning Abilities to Partners)
لە دوای زیادکردنی هاوکارێک:
١. سەرەتا، گەڕانەکەدا Abilities (قابلیتەکان) تابلۆکەکەت بگەرە. ٢. ئەو قابیلەیەی کە visibility (دۆخ ببینەوە) بۆ Partner (هۆڵبورداری) هەیە بدۆزەرەوە. ٣. بۆ ویرتکردن، دەستکاری بکە. ٤. لە بەشی "Partner allow-list" (لیست ڕێگەپێدان بۆ هاوبەشەکان)، بۆ ئەو هاوبەشانەی کە دەبێت دەستکارییان هەبێت، چۆڵەکانی تیک بدە. ٥. Save (سەردانکردن) بکە.
بەدوورخستنی دەستکاریی Partner (Revoking Partner Access)
ئەگەر دەتەوێت دەستکارییەکی هاوبەش لە دەست بگرێیت:
١. ئەو قابیلەیە دەستکاری بکە. ٢. چۆڵەکە لە لیست ڕێگەپێداندا بۆ ئەو هاوبەشە تیک نادەستە بکە. ٣. Save (سەردانکردن) بکە.
هاوڕێیەک بە خێرایی دەتوانێت دەسیاری ئەو قابیلەیە لەدەست بدات.
Abilities کە دۆخ نەدۆزراون (Unclassified Abilities)
کاتێک پلاتفۆرمێکی تری (third-party ability) دامەزرێنیت کە Superdav AI Agent ناناوە، بە Unclassified (نەدەدۆزراو) دەبێت.
ئاگاداری ئەدمن بۆ Abilitiesی نەدۆزراو (Admin Notice for Unclassified Abilities)
ئەوە دەبینیت ئاگاداری ئەدمنێک:
⚠️ Unclassified Abilities Detected
The following abilities were installed but are not recognized:
- custom-import-tool
- external-api-wrapper
These abilities may pose security or compatibility risks.
Please review and classify them.
[Review Abilities] [Dismiss]
داواکردنی Abilitiesی نەدۆزراو (Reviewing Unclassified Abilities)
١. لە ئاگادارییەکەدا، Review Abilities (پێشینەوەی دەستکارییەکان) بکە. ٢. بۆ هەر دەستکارییەکی نەدۆزراو، ئەم شتان دەبینیت:
- ناوی دەستکارییەکە و وەسفی وردەکارییەکەی
- سەرچاوە (کێ ئەو پڵگین/ئادۆنە دامەزراندوە)
- ئاستی دۆخی پێشنیارکراو بۆ visibility (دۆخ ببینەوە)
- هەڵسارکردنی ئەمنی
٣. ئاستێکی visibility هەڵبژێرە:
- Public (پەیوەست): بە دەستکارییەکە متمان بکە؛ لە هەموو شوێنێک دەردەبڕیت.
- Internal (داخلي): تەنها بۆ بەکارهێنانی ناوخۆیی ڕابگرە.
- Partner (هاوبەش): تەنها بۆ هاوبەشانی دیاریکراو ڕابگرە.
- Disabled (بەدوورخستراو): ئەم دەستکارییە بەکار نھێنە.
٤. بۆ شتنی هەڵبژاردنت، Classify (دۆزراوە) بکە.
بۆچی Abilitiesی نەدۆزراو دۆزراون؟ (Why Classify Unclassified Abilities?)
دۆزراوکردنی دەستکارییەکان:
- ئامانتی زیاتر دەکات: تۆ بە ڕاستی پەسەند دەکەیت چی دەردەبڕێت.
- کۆبوونەوەی هەڵە پێشواز دەگرێت: Abilitiesی نەدۆزراو بە شێوەیەکی پیشتەوا، نیشانەیان دەدرێن.
- ئامرازەکان دەگشایێت: دوای ئەوەی دۆزراون، دەستکارییەکە دەبێت ئامادە بێت بۆ بەکارهێنان.
- دڵنیایی دەدات لەسەر بڕیارەکان: هەڵبژاردنەکان بۆ پشکنینی دوای کار تۆمار دەکرێن.
بینایی در سطوح مختلف
REST API
قابلیتهای عمومی (Public) از طریق endpointهای REST در دسترس هستند:
curl -X POST https://yoursite.com/wp-json/superdav/v1/abilities/scaffold-block-theme \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{"theme_name": "My Theme"}'
قابلیتهای داخلی (Internal) و شرکای (Partner) از طریق REST API در دسترس نیستند.
سرورهای MCP
قابلیتهای عمومی (Public) از طریق MCP در دسترس هستند:
سرور MCP: Superdav AI Agent قابلیتهای موجود:
- scaffold-block-theme
- activate-theme
- send-email
قابلیتهای داخلی از طریق MCP نمایش داده نمیشوند.
قابلیتهای شرکای (Partner) فقط با اعتبارنامههای شریک در دسترس هستند.
یکپارچهسازی ووکامرس (WooCommerce Integration)
قابلیتهای عمومی (Public) مربوط به ووکامرس در دسترس هستند:
- مدیریت محصول
- پردازش سفارش
- ارتباط با مشتری
قابلیتهای داخلی به ووکامرس نمایش داده نمیشوند.
رابط چت (Chat Interface)
تمام قابلیتها (عمومی، داخلی، شریک) بسته به مجوزهای کاربر در چت در دسترس هستند:
- مدیران همه قابلیتها را میبینند
- کاربران عادی فقط قابلیتهای عمومی را میبینند
- شرکا قابلیتهای عمومی + شرکای خود را میبینند (اگر لیست سفید شده باشند)
بهترین شیوههای امنیتی
اصل حداقل امتیاز (Principle of Least Privilege)
- قابلیتها را روی محدودترین سطح دید تنظیم کنید که همچنان اجازه استفاده از آنها را بدهد.
- برای عملیات حساس از دید شریک (Partner visibility) استفاده کنید.
- قابلیتهایی را غیرفعال کنید که از آنها استفاده نمیکنید.
بازرسیهای منظم (Regular Audits)
- هر ماه دید قابلیتها را بررسی کنید.
- به دنبال قابلیتهای بدون دستهبندی باشید.
- دسترسی شرکای غیرضروری را حذف کنید.
لاگبرداری و نظارت (Logging and Monitoring)
- نظارت کنید کدام قابلیتها بیشتر استفاده میشوند.
- الگوهای دسترسی شرکا را ردیابی کنید.
- در مورد استفاده غیرمعمول از قابلیتها هشدار دهید.
قابلیتهای شخص ثالث (Third-Party Abilities)
- قبل از فعال کر دن، قابلیتهای شخص ثالث را بررسی کنید.
- آنها را به صراحت طبقهبندی کنید.
- با دید داخلی یا شریک شروع کنید.
- فقط پس از تأیید و بررسی، به عمومی ارتقا دهید.
گشایی و رفع اشکال
یک قابلیت در لیست نمایش داده نمیشود
- بررسی کنید که قابلیت نصب و فعال است
- مطمئن شوید که پلاگین/افزونه فعال است
- صفحه را رفرش (Refresh) کنید
نمیتوانم دید یک قابلیت را تغییر دهم
- تأیید کنید که دسترسی مدیر (administrator permissions) دارید
- بررسی کنید که آیا افزونهای قابلیت را قفل نکرده است یا نه
- سعی کنید افزونههای تداخلی را غیرفعال کنید
یک شریک نمیتواند به یک قابلیت دسترسی داشته باشد
- تأیید کنید که شریک در لیست اجازه (allow-list) قرار دارد
- بررسی کنید که آیا دید آن قابلیت روی "Partner" تنظیم شده است یا خیر
- تأیید کنید که اطلاعات ورود (credentials) شریک صحیح هستند
- لاگهای API را برای خطاهای احراز هویت چک کنید
قابلیتهای بدون دسته بندی همچنان ظاهر میشوند
- آنها را در اعلانهای مدیریت بررسی و طبقهبندی کنید
- مطمئن شوید که طبقهبندی شما ذخیره شده است
- تأیید کنید که افزونهای که این قابلیت را فراهم میکند بهروز است
مهاجرت از حالت قدیمی (Legacy Mode)
اگر از نسخه قدیمی Superdav AI Agent ارتقا میدهید:
- تمام قابلیتهای موجود به صورت خودکار به عنوان عمومی (Public) طبقهبندی میشوند
- دید آنها را بر اساس نیاز بررسی و تنظیم کنید
- مگر اینکه بخواهید دسترسی را محدود کنید، نیازی به انجام کاری نیست
برای جزئیات بیشتر در مورد انتقال به یکپارچگی API قابلیتهای بومی (native Abilities API integration)، به مهاجرت حالت شخص ثالث (Third-Party Mode Migration) مراجعه کنید.
مراحل بعدی
بعد از تنظیم دید قابلیتها:
۱. قابلیتهای خود را بررسی کنید: تمام قابلیتهای نصب شده را بازبینی کنید ۲. قابلیتهای بدون دستهبندی را طبقهبندی کنید: به اعلانهای مدیریت پاسخ دهید ۳. شرکای خود را تنظیم کنید: اگر از دید شریک استفاده میکنید، شرکا را اضافه کنید ۴. مصرف را نظارت کنید: ردیابی کنید کدام قابلیتها بیشتر استفاده میشوند ۵. تصمیمات را مستند کنید: یادداشتهایی در مورد اینکه چرا هر سطح دید خاص را انتخاب کرد، نگه دارید