Skip to main content

Намоишии қобилияти (Ability Visibility)

Superdav AI Agent v1.12.0 кӯтоиҳои Намоишии қобилиятиро таҳия мекунад, ки муайян мекунанд кадом рӯйхатҳо (surfaces) ҳамаи қобилиятиро нишон медиҳанд. Ин имкон ба администраторҳо медиҳад, ки онро мутобиқ карда таомбар кунанд, ки кадоме аз қобилияти агент-ҳо тавассути REST API, серверҳои MCP, интегратсияҳои WooCommerce ва интерфейсҳои дигари мавҷудаи идоракунӣ дарёфта мешаванд.

Намоишии қобилияти чист?​

Намоишии қобилияти системаи иҷозатномаест, ки инҳоро идора мекунад:

  • Кадом қобилияти ба агент-ҳо мавҷуданд
  • Он он ҷойҳо нишон дода мешаванд (REST API, MCP, WooCommerce ва ғайра)
  • Кӣ метавонад онҳоро дарёбарад (тавассути рӯйхатҳои иҷозати ҳамкорони - allow-lists)
  • Онҳо чӣ гуна тасниф карда мешаванд (маълум ва номаълум)

Ҳар як қобилияти сатҳи намоиширо дорад, ки мавҷудияти онро дар рӯйхатҳои гуногуни система муайян мекунад.

Саттҳои намоиши (Visibility Levels)​

Оммавӣ (Public)​

Қобилияти оммавӣ ҳама ҷо мавҷуданд:

  • Endpoint-ҳои REST API
  • Серверҳои MCP
  • Интегратсияҳои WooCommerce
  • Интерфейсҳои чат
  • Ҳамаи намудаҳои корбар (бо иҷозатҳои мувофиқ)

Мисол: scaffold-block-theme, activate-theme, send-email

Дохилӣ (Internal)​

Қобилияти дохилӣ танҳо дар истифодаи инсоли WordPress мавҷуданд:

  • Интерфейсҳои чат
  • Панелҳои администратор
  • Танҳо корбарони воридшуда
  • Тавассути REST API ё интегратсияҳои беруна нишон дода намешаванд

Мисол: manage-settings, view-analytics, export-data

Ҳамкорон (Partner)​

Қобилияти ҳамкорон танҳо ба ҳамкорони рӯйхати иҷозатшуда мавҷуданд:

  • Барои воридшавии муайян дар рӯйхати иҷозати ҳамкор лозим аст
  • Тавассути REST API бо маълумоти ҳамкорон мавҷуд аст
  • Тавассути MCP бо тасдиқи ҳамкорони мавҷуданд
  • Ба корбарони оммавӣ мавҷуда намешавад

Мисол: bulk-import-users, modify-billing, access-analytics

Хусусият бартарафшуда (Disabled)​

Қобилияти бартарафшуда дар ҳеҷ ҷой мавҷуда нест:

  • Тавассути ҳеҷ рӯйхат нишон дода намешавад
  • Дар чат мавҷуд нест
  • Дар панелҳои администратор мавҷуд нест
  • Барои қобилияти бартарафшуда ё таҷрибаӣ муфид аст

Идоракунӣ аз Намоиши Қовватҳо (Ability Visibility)​

Дастрасӣ ба Настроёни Намоиши Қовватҳо​

  1. Ба WordPress Admin → Superdav AI Agent → Settings равед.
  2. Ба таббики Abilities клик кунед.
  3. Шумо рӯйди ҳамаи қовватҳои орорсозии интихобӣ ва сатҳи намоиши онҳоро хоҳед диданд.

Нарафтан ба Детаилҳои Қовват​

Ба ҳар як қовват клик кунед, то инҳоро бинед:

  • Name: Идентификатори қовват
  • Description: Он чӣ кор мекунад
  • Current visibility: Оммавӣ (Public), Дохилӣ (Internal), Ҳамкори (Partner) ё Басарбанд (Disabled)
  • Partner allow-list: Кадом ҳамкорон метавонанд дастрас шаванд (агар намоиши ҳамкори бошад)
  • Last updated: Вақти охир аз навсозии намоиш тағйир ёфтааст
  • Status: Маъруф (Recognized) ё Намунашуда (Unclassified)

Тағйир додани Сатҳи Намоиш​

Барои тағйири сатҳи намоиши як қовват:

  1. Ба қовват дар рӯйди он клик кунед
  2. Сатҳи намоиши нав аз менюи чоп (dropdown) интихоб кунед
  3. Агар "Partner" -ро интихоб кунед, идентификаторҳои ҳамкоронро ба рӯйли иҷозатнома (allow-list) илова кунед
  4. Ба Save клик кунед

Мисол:

Ability: bulk-import-users
Current visibility: Public
Change to: Partner
Partner allow-list: partner-123, partner-456

Оператсияҳои Амалиёти Бӯликӣ (Bulk Operations)​

Барои тағйир додани намоиши баъзе қовватҳо:

  1. Ба ҷойҳои паст аз қовватҳо марказӣ кунед (чекбоксоҳоро иҷозат диҳед)
  2. Сатҳи намоиши нав аз менюи амалиёти бӯликӣ интихоб кунед
  3. Ба Apply клик кунед

Рӯйли Иҷозатномаи Ҳамкорон (Partner Allow-List)​

partner allow-list муайян мекунад, ки кадом ҳамкорони беруна метавонанд ба қовватҳои сатҳи ҳамкори дастрас шаванд.

Илова кардани Ҳамкорон​

  1. Ба Superdav AI Agent → Settings → Partners равед
  2. Ба Add Partner клик кунед
  3. Идентификатори ҳамкорро (одатан API key ё ID-и ташкилот) ворид кунед
  4. Имкории номи ва тавсифи ҳамкорро илова кунед
  5. Ба Save клик кунед

Муайян кардани Қовватҳо ба Ҳамкорон​

Баъди илова кардани ҳамкор:

  1. Барои таб Abilities бароведӣ боравед кунед
  2. Талаби қобилиятҳоро биёвед, ки доираи назаррас (Partner visibility) доранд
  3. Барои тасвир ва тағйир клик кунед
  4. Дар қисми "Partner allow-list" ба ҷойҳои мувофиқ барои партнёрҳое, ки донистанд иҷозат доштанд, марказ (check) кунед
  5. Save (Савдот) клик кунед

Бурдории иҷозати партнёрро бартарӣ кардан​

Барои бартарифи иҷозати як партнёр:

  1. Тағйирро тасвир кунед
  2. Ба ҷойҳои мувофиқ (allow-list) барои партнёр марказ (check) накунед
  3. Save клик кунед

Партнёр дарҳол ба ин қобилиятҳо дастрасӣ намеёбад.

Қобилиятҳои таснифнашуда (Unclassified Abilities)​

Вақте шумо як қобилияти иҷрошавандаи калонсоз (third-party ability)-ро насб мекунед, ки Superdav AI Agent онро шинос намекунад, он ба Unclassified (Таснифнашуда) муайян карда мешавад.

Эълони администратор барои қобилиятҳои таснифнашуда​

Шумо эълони администраторӣ дида мебинед:

⚠️ Unclassified Abilities Detected

Қобилиятҳои зерин насб шудаанд, аммо шинос нашуданд:
- custom-import-tool
- external-api-wrapper

Ин қобилиятҳо метавонанд хатари аманӣ ё мувофиқатро ба вуҷуд оранд.
Лутфан онҳоро баррасӣ ва тасниф кунед.

[Review Abilities] [Dismiss]

Баррасии қобилиятҳои таснифнашуда​

  1. Дар эълон Review Abilities (Баррасии қобилиятҳо) клик кунед

  2. Барои ҳар як қобилияти таснифнашуда, шумо инҳоро мебинед:

    • Номи ва тавсифи қобилият
    • Манба (ки плагин/addon онро насб кардааст)
    • Дарёи назаррас барои нишон додани он
    • Баҳори аманӣ

  3. Дарёи назаррасро интихоб кунед:

    • Public (Оммавӣ): Ба қобилият боварӣ ҳосил кунед; онро дар ҳама ҷо нишон диҳед
    • Internal (Ичкилиётӣ): Онро танҳо барои истифодаи ичкилиётӣ маҳдуд кунед
    • Partner (Партнёр): Онро ба партнёрҳои муайян маҳдуд кунед
    • Disabled (Басарбанд): Ин қобилиятро истифода набаред

  4. Барои сақла кардани қарори худ Classify (Тасниф кардан) клик кунед

Чаро қобилиятҳои таснифнашударо тасниф мекунем?​

Таснифи қобилиятҳо:

  • Аманӣ баланд бардошта: Шумо он чизеро, ки нишон дода мешавад, бевосита тасдиқ мекунед
  • Хатои интихобро пешгирӣ мекунад: Қобилиятҳои таснифнашуда дар ҳоли худкона басарбанд карда мешаванд
  • Ҳамаҷонибаҳоро фароҳам мерасонад: Баъди тасниф кардан, қобилият омода мешавад
  • Қарорҳоро ҳуҷҷат медиҳад: Интихобҳои шумо барои баррасӣ ва муайянкунӣ сақла карда мешаванд

Назаррафти в Андозаҳои Гуноҷовар (Visibility in Different Surfaces)​

REST API​

Қаболияти оммавӣ (Public abilities) тавассути 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 and Partner abilities) тавассути REST API мавҷуда нест.

MCP Servers​

Қаболияти оммавӣ (Public abilities) тавассути MCP мавҷуданд:

MCP Server: Superdav AI Agent Қаболияти мавҷуда:

  • scaffold-block-theme
  • activate-theme
  • send-email

Қаболияти дохилӣ (Internal abilities) тавассути MCP нишон дода намешаванд.

Қаболияти ҳамкори (Partner abilities) танҳо бо маслиҳати ҳамкорро мавҷуданд.

WooCommerce Integration​

Қаболияти оммавӣ (Public abilities) марбута ба WooCommerce мавҷуданд:

  • идораи маҳсулот (Product management)
  • коркарди дароз (Order processing)
  • илакомиёти муштаърият (Customer communication)

Қаболияти дохилӣ (Internal abilities) ба WooCommerce нишон дода намешаванд.

Chat Interface​

Ҳамаи қаболияти (оммавӣ, дохилӣ, ҳамкори) дар чат мавҷуданд, вобаста ба иҷозатҳои корбар:

  • Администраторҳо ҳамаи қаболиятро мебийнаваранд
  • Корбарони оммавӣ танҳо қаболияти оммавӣ (Public abilities) -ро мебийнаваранд
  • Ҳамкорон қаболияти оммавӣ + қаболияти ҳамкорӣ (агар дар рӯйхаи иҷозатҳо истифодабанд бошад) -ро мебийнаваранд

Азгузаришҳои Безопасӣ (Security Best Practices)​

Принципи Ҳарфсавдории Камтарин Иҷозат (Principle of Least Privilege)​

  • Қаболиятро ба тасвири бештар аз ҳама мувофиқ созед, ки истифодаи онро иҷозат медиҳад
  • Барои амалиёти ҳаттоси (sensitive operations) аз қаболияти ҳамкори истифода баред
  • Қаболиятро ба таври нофаъол истифода мебаред, ба таври нофаъол базднед

Муайянкунандагиҳои Доимӣ (Regular Audits)​

  • Ҳар моҳ қаболияти назаррасониро баррасӣ кунед
  • Барои қаболияти бетаснифӣ (unclassified abilities) тафтиш кунед
  • Дастрасӣ ба ҳамкорон аз истифодабандаҳоро бартараф кунед

Логирование ва Назорат (Logging and Monitoring)​

  • Муайян кунед, ки кадом қаболияти бештар истифода мешаванд
  • Тарзи дастрасии ҳамкоронро назорати кунед
  • Дар мавриди истифодаи номудда ба таври ғайриаввақат (unusual ability usage) огоҳ шавед

Қаболияти Сардошта (Third-Party Abilities)​

  • Пеш аз фаъол кардани қаболияти сардошта, онро баррасӣ кунед
  • Онҳоро ба таври аниқ тасниф кунед
  • Бо қаболияти дохилӣ ё ҳамкори оғоз кунед
  • Танҳо пас аз санҷиши мукамдел (vetting) ба оммавӣ арзёбӣ кунед

Устранение неполадок​

Возможность не отображается в списке

  • Проверьте, установлена ли возможность и активна ли она
  • Проверьте, включен ли плагин/дополнение
  • Обновите страницу

Я не могу изменить видимость возможности

  • Убедитесь, что у вас есть права администратора
  • Проверьте, не заблокирована ли возможность каким-либо плагином
  • Попробуйте отключить конфликтующие плагины

Партнер не может получить доступ к возможности

  • Убедитесь, что партнер находится в списке разрешенных (allow-list)
  • Проверьте, установлено ли видимость возможности как "Partner"
  • Подтвердите, что учетные данные партнера верны
  • Проверьте логи API на наличие ошибок аутентификации

Неклассифицированные возможности продолжают появляться

  • Просмотрите и классифицируйте их в уведомлениях администратора (admin notice)
  • Убедитесь, что ваша классификация сохранена
  • Проверьте, обновлен ли плагин, предоставляющий эту возможность

Миграция из устаревшего режима (Legacy Mode)​

Если вы обновляетесь с более старой версии Superdav AI Agent:

  • Все существующие возможности автоматически классифицируются как "Public" (Публичные)
  • Просмотрите и настройте видимость по мере необходимости
  • Никаких действий не требуется, если вы не хотите ограничить доступ

См. Миграцию в режим сторонних сервисов (Third-Party Mode Migration) для получения более подробной информации о переходе к интеграции с нативной API возможностей (Abilities API).

Следующие шаги​

После настройки видимости возможностей:

  1. Просмотрите свои возможности: Проведите аудит всех установленных возможностей
  2. Классифицируйте неклассифицированные возможности: Ответьте на уведомления администратора
  3. Настройте партнеров: Добавьте партнеров, если вы используете видимость "Partner"
  4. Отслеживайте использование: Отслеживайте, какие возможности используются чаще всего
  5. Документируйте решения: Ведите записи о том, почему вы выбрали каждый уровень видимости