Преминете към основното съдържание

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

Superdav AI Agent v1.12.0 въвежда контроли за Видимост на Способностите (Ability Visibility), които управляват кои интерфейси показват всяка способност. Това позволява на администраторите да прецизират кои възможности на агента са достъпни чрез REST API, MCP сървъри, WooCommerce интеграции и други интерфейси.

Какво е Видимост на Способностите?​

Видимостта на Способностите е система за разрешаване, която контролира:

  • Кои способности са налични за агентите
  • Къде са изложени (REST API, MCP, WooCommerce и др.)
  • Кой може да има достъп (чрез списък с разрешени партньори)
  • Как са класифицирани (разпознати или неразпознати)

Всяка способност носи ниво на видимост, което определя нейната наличност в различните интерфейси.

Нива на Видимост​

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

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

  • Крайности (endpoints) на REST API
  • MCP сървъри
  • WooCommerce интеграции
  • Чат интерфейси
  • Всички ролии на потребители (с подходящи права)

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

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

Вътрешните способности са налични само в рамките на вашата WordPress инсталация:

  • Чат интерфейси
  • Административни панели
  • Само за потребители, които са влезли в системата
  • Не са изложени чрез REST API или външни интеграции

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

Partner (Партньорска)​

Партньорските способности са налични само за партньори, добавени в списък с разрешени:

  • Изисква изрично добавяне в списък с разрешени партньори (allow-list)
  • Налични чрез REST API с потребителски данни на партньора
  • Налични чрез MCP с автентикация на партньора
  • Не са налични за обикновени потребители

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

Disabled (Изключена)​

Изключените способности не са налични никъде:

  • Не са изложени чрез никакъв интерфейс
  • Не са налични в чата
  • Не са налични в административните панели
  • Полезни за остарели или експериментални способности

Управление на Видимостта на Способностите​

Достъп до Настройки на Видимостта на Способностите​

  1. Отидете на WordPress Admin → Superdav AI Agent → Settings
  2. Кликнете върху таба Abilities
  3. Ще видите списък на всички инсталирани способности с техните нива на видимост

Преглед на Детайлите на Способността​

Кликнете върху която и да е способност, за да видите:

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

Промяна на Нивата на Видимост​

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

  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. Изберете ново ниво на видимост от падащото меню за масови действия
  3. Кликнете Apply

Списък с Разрешени Партньори (Partner Allow-List)​

Списъкът с разрешени партньори контролира кои външни партньори могат да имат достъп до способности на партньорско ниво.

Добавяне на Партньори​

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

Присвояване на Способности на Партньори​

След добавяне на партньор:

  1. Отидете на таба Abilities
  2. Намерете способност с Партньорска видимост
  3. Кликнете за редактиране
  4. В секцията "Partner allow-list", отбележете полетата за партньори, които трябва да имат достъп
  5. Кликнете Save

Оттегляне на Достъпа на Партньора​

За да премахнете достъпа на партньора:

  1. Редактирайте способността
  2. Отбележете полето на партньора в allow-list
  3. Кликнете Save

Партньорът незабавно губи достъпа до тази способност.

Неразпознати Способности (Unclassified Abilities)​

Когато инсталирате способност от трета страна, която Superdav AI Agent не разпознава, тя е маркирана като Unclassified.

Уведомление за Администратори за Неразпознати Способности​

Ще видите административно известие:

⚠️ 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]

Преглед на Неразпознати Способности​

  1. Кликнете върху Review Abilities в известието

  2. За всяка неразпозната способност ще видите:

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

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

    • Public: Доверявате се на способността; я излагате навсякъде
    • Internal: Ограничавате само за вътрешно ползване
    • Partner: Ограничавате за специфични партньори
    • Disabled: Не използвайте тази способност

  4. Кликнете Classify (Класифицирай), за да запазите решението си

Защо да Класифицирате Неразпознати Способности?​

Класифицирането на способностите:

  • Подобрява сигурността: Вие изрично одобрявате какво е изложено
  • Предотвратява инциденти: Неразпознатите способности са изключени по подразбиране
  • Включва функции: След класифициране, способността става налична
  • Документира решенията: Вашите избори се записват за цели на одитиране

Видимост в Различни Интерфейси​

REST API​

Публичните способности са налични чрез REST endpoints:

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 Servers​

Публичните способности са налични чрез MCP:

MCP Server: Superdav AI Agent
Available abilities:
- scaffold-block-theme
- activate-theme
- send-email

Вътрешните способности не са изложени чрез MCP.

Партньорските способности са налични само с потребителски данни на партньора.

WooCommerce Integration​

Публичните способности, свързани с WooCommerce, са налични:

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

Вътрешните способности не са изложени към WooCommerce.

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

Всички способности (Публични, Вътрешни, Партньорски) са налични в чата, в зависимост от правата на потребителя:

  • Администраторите виждат всички способности
  • Обикновените потребители виждат само Публичните способности
  • Партньорите виждат Публични + Партньорски способности (ако са в allow-list)

Най-добри Практики за Сигурност​

Принцип на Най-малките Привилегии (Principle of Least Privilege)​

  • Настройвайте способностите на най-ограничителната видимост, която все пак позволява тяхното използване
  • Използвайте Партньорска видимост за чувствителни операции
  • Изключвайте способностите, които не използвате

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

  • Преглеждайте видимостта на способностите месечно
  • Проверявайте за неразпознати способности
  • Премахвайте достъпа за неактивни партньори

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

  • Следете кои способности се използват най-често
  • Проследявайте моделите на достъп на партньорите
  • Изпращайте предупреждения при необичайно използване на способности

Способности от Трети Страни​

  • Преглеждайте способностите от трети страни, преди да ги активирате
  • Класифицирайте ги изрично
  • Започнете с Вътрешна или Партньорска видимост
  • Премигратирайте до Публична само след проверка

Отстраняване на Проблеми (Troubleshooting)​

Способността не се показва в списъка

  • Проверете дали способността е инсталирана и активна
  • Проверете дали плъгинът/допълнението е активирано
  • Направете Refresh на страницата

Не мога да променя видимостта на способност

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

Партньорът не може да има достъп до способността

  • Проверете дали партньорът е в allow-list
  • Проверете дали видимостта на способността е зададена на Partner
  • Потвърдете, че потребителските данни на партньора са коректни
  • Проверете API логовете за грешки при автентикацията

Неразпознатите способности продължават да се появяват

  • Прегледайте и класифицирайте ги в административното известие
  • Проверете дали вашата класификация е запазена
  • Проверете дали плъгинът, предоставящ способността, е актуален

Миграция от Легаси Режим (Legacy Mode)​

Ако премивате от по-стара версия на Superdav AI Agent:

  • Всички съществуващи способности автоматично се класифицират като Public
  • Прегледайте и коригирайте видимостта по нужда
  • Няма действие е необходимо, освен ако не искате да ограничите достъпа

Вижте Third-Party Mode Migration за повече подробности относно прехода към нативната интеграция с Abilities API.

Следващи Стъпки​

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

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