Skip to main content

Видимост способности (Ability Visibility)

Superdav AI Agent v1.12.0 вводи Ability Visibility контролите кои управуваат кои поврвици на секоја способност (ability). Ова им овозможува администраторите да ги направат прецизно настроени кои способности на агентите ќе бидат достапни преку REST API, MCP сервери, WooCommerce интеграции и други интерфејси.

Што е Ability Visibility?​

Ability Visibility е систем за дозволи што контролира:

  • Кои способности се достапни за агентите
  • Каде се изложени (REST API, MCP, WooCommerce итн.)
  • Кој може да ги пристапи (преку партнерски списоци на одобрени)
  • Како се класифицираат (признати vs. некласифицирани)

Секоја способност носи ниво на видимост што одредува нејзината достапност преку различни површини.

Нивови на видимост (Visibility Levels)​

Публично (Public)​

Публичните способности се достапни каде било:

  • REST API конек точки
  • MCP сервери
  • WooCommerce интеграции
  • Чат интерфејси
  • Сите ролови на корисниците (со соодветни дозволи)

Пример: scaffold-block-theme, activate-theme, send-email

Внатрешно (Internal)​

Внатрешните способности се достапни само во вашата WordPress инсталација:

  • Чат интерфејси
  • Административни панели
  • Само на вложени корисници
  • Не се изложени преку REST API или надворешни интеграции

Пример: manage-settings, view-analytics, export-data

Партнер (Partner)​

Партнерските способности се достапни само за списоци на одобрени партнери:

  • Иако бараат експлицитно вметнување во партнерски список на одобрени
  • Достапни преку REST API со партнерски податоци за пријавување (credentials)
  • Достапни преку MCP со партнерска автентикација
  • Не се достапни за редовните корисници

Пример: bulk-import-users, modify-billing, access-analytics

Издржувано (Disabled)​

Издржаните способности не се достапни каде било:

  • Не се изложени преку никаква површина
  • Не се достапни во чатот
  • Не се достапни во административните панели
  • Корисно за способности што веќе не се користат или експериментални

Управу навистина видливост (Ability Visibility)​

Достапу до поставките за видливост на способностите (Accessing Ability Visibility Settings)​

  1. Одете во WordPress Admin → Superdav AI Agent → Settings
  2. Кликнете на табот Abilities (Способности)
  3. Ќе видите листа со сите инсталирани способности и нивните нивоа на видливост

Гледење детали за способност (Viewing Ability Details)​

Кликнете на која било способност за да видите:

  • Name: Идентификатот на способноста
  • Description: Што прави споротноста
  • Current visibility: Публична, Внатрешна, Партнер или Деактивирана
  • Partner allow-list: Кои партнери можат да пристапат (ако е поставка за видливост на партнер)
  • Last updated: Кога беше променета последниот пат видливоста
  • Status: Призната или Некласифицирана

Промена на нивоа на видливост (Changing Visibility Levels)​

За да промените видливоста на некоја способност:

  1. Кликнете на споротноста во листата
  2. Изберете ново ниво на видливост од менито со отворено поле
  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. Изберете ново ниво на видливост од менито за масова акција (bulk action dropdown)
  3. Кликнете на Apply (Примени)

Партнерски листа за дозволени партнери (Partner Allow-List)​

Партнерската листа за дозволени партнери контролира кои надворешни партнери можат да пристапат до способности со ниво на партнер.

Додавување партнери (Adding Partners)​

  1. Одете во Superdav AI Agent → Settings → Partners
  2. Кликнете на Add Partner (Додај Партнер)
  3. Внесете идентификатор на партнерот (обично API ключ или организациски ID)
  4. По избор, додадете име и опис на партнерот
  5. Кликнете на Save (Зачувај)

Поставување способности на партнери (Assigning Abilities to Partners)​

По додавањето на партнер:

  1. Отидете на табот Abilities (Способности)
  2. Пронајдете способност со видливост за Партнери (Partner visibility)
  3. Кликнете за уредување
  4. Во секцијата "Partner allow-list" (Бели листа за партнери), означете квадратите за партнерите кои треба да имаат пристап
  5. Кликнете на Save (Зачувај)

Отворање пристап до партнерски способности​

За да го премахнете пристапот на некој партнер:

  1. Уредете ја способноста
  2. Отстранете ознаката за партнерот во белата листа
  3. Кликнете на Save (Зачувај)

Партнерот ќе веднаш губи пристап до таа способност.

Некласифицирани способности​

Кога инсталирате трета страна способност што Superdav AI Agent не ја препознава, таа се означува како Unclassified (Некласифицирана).

Административна порака за некласифицирани способности​

Ќе видите административна порака:

⚠️ Означени Некласифицирани Способности

Следните способности биле инсталирани но не се препозначуваат:
- custom-import-tool
- external-api-wrapper

Овие способности можат да предизвикаат сигурностни или соодветностни ризици.
Ве молиме проверете и класифицирајте ги.

[Проверете Способности] [Одбијај]

Преглед на некласифицирани способности​

  1. Кликнете на Review Abilities (Прегледај Способности) во пораката

  2. За секоја некласифицирана способност, ќе видите:

    • Име и опис на способноста
    • Извор (како плагин/додаток ја инсталира)
    • Предложената ниво на видливост
    • Оцена за сигурност

  3. Изберете ниво на видливост:

    • Public (Јавни): Доверување на способноста; изложете ја каде што е можно
    • Internal (Внатрешни): Ограничете само за внатрешна употреба
    • Partner (Партнерски): Ограничете за конкретни партнери
    • Disabled (Обезбедено): Не користете ја оваа способност

  4. Кликнете на Classify (Класифицирај) за да го зачувате вашето одлучување

Зошто класифицираме некласифицирани способности?​

Класификацијата на способности:

  • Подобрува сигурността: Експлицитно ги одобрувате што е отворено
  • Пречиства несреќа: Некласифицираните способности се обезбедени по дефолт (не користат се)
  • Овозможува функции: Еднаш кога ќе бидат класифицирани, способноста станува достапна
  • Документира одлуките: Вашите избори се забележуваат за аудитен на目的是

Видимост на Различни Површини​

REST API​

Јавни способности се достапни преку 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"}'

Внатрешни и партнерски способности не се достапни преку REST API.

MCP Сервери​

Јавни способности се достапни преку MCP:

MCP Server: Superdav AI Agent
Достапни способности:
- scaffold-block-theme
- activate-theme
- send-email

Внатрешните способности не се отворени преку MCP.

Партнерските способности се достапни само со партнерски податоци за пријавување.

Интеграција со WooCommerce​

Јавни способности поврзани со WooCommerce се достапни:

  • Управување со производи
  • Обрачуна на поредоци
  • Комуникација со клиентите

Внатрешните способности не се отворени за WooCommerce.

Чат Интерфејс​

Сите способности (Јавни, Внатрешни, Партнерски) се достапни во чат, в зависност од дозволите на корисниците:

  • Администраторите видат сите способности
  • Редовните корисници видат само Јавните способности
  • Партнерите видат Јавни + Партнерски способности (ако имаат одобрено списочен)

Најдобри Практики за Безбедност​

Принцип на Најмалната Привилегија​

  • Поставете способности на најстрог вид видимост кој 여у дозволува нивниот користење
  • Користете партнерски висилост за чувствителни операции
  • Испоразете способности што не ги користите

Редовни Аудити​

  • Прегледајте ја видимоста на способностите месечно
  • Проверете дали има некои неукласификувани способности
  • Убадете пристап за ненаведени партнери

Логирање и Мониторинг​

  • Следете кои способности се користат најмногу
  • Пратете мозоците на доступот на партнерите
  • Алармирајте при ненормално користење на способности

Третки Способи​

  • Прегледајте ги третките способности пред да ги овозможите
  • Ја класифицирајте ја експлицитно
  • Започнете со Внатрешна или Партнерска видимост
  • Промотирајте на Јавна само по тоа што ги проверите

Решавање проблеми​

Способност не се прикажува во списокот

  • Проверете дали способноста е инсталирана и активна
  • Проверете дали плагинот/додатокот е активиран
  • Освежи ја страницата

Не можам да променам видливоста на некоја способност

  • Проверете дали имате администраторски дозволи
  • Проверете дали способноста не е затворена од плагион
  • Обидете го деактивирањето на конфликтни плагиони

Партнерот не може да пристапи до некоја способност

  • Проверете дали партнерот е во листата за дозволени (allow-list)
  • Проверете дали видливоста на способноста е поставена на "Partner"
  • Потврдете дека податоците за партнерни информации се правилни
  • Проверете API лога за грешки при автентикација

Некласифицирани способности се продолжат да се појавуваат

  • Прегледајте и класифицирајте ги во административните пораки (admin notice)
  • Проверете дали вашата класификација е зачувана
  • Проверете дали плагинот што обезбедува способноста е ажуриран

Миграција од старата модел (Legacy Mode)​

Ако ажурирате од потасна верзија на Superdav AI Agent:

  • Сите постоечки способности се автоматски класифицирани како Публични (Public)
  • Прегледајте и прилагодете видливоста како што е потребно
  • Не е потребна никаква акција осме па сакате да ограничите пристапот

За повеќе детали за премин кон интеграција со нативниот API за способности, видите Миграција од модел за трети страни (Third-Party Mode Migration).

Следен чекори​

По конфигурирањето на видливоста на способностите:

  1. Прегледајте ги вашите способности: Аудирајте сите инсталирани способности
  2. Класифицирајте некласифицираните способности: Одговорете на административните пораки
  3. Поставете партнери: Додадете партнери ако користите видливост за партнер (Partner visibility)
  4. Направете следен надзор: Следете кои способности се користаат најмногу
  5. Документирајте одлуките: Држете забелешки зошто ја избралте секоја нивна ниво на видливост