Redzamība redzība (Ability Visibility)
Superdav AI Agent v1.12.0 ieviesta Redzamības kontroles (Ability Visibility), kas norāda, kuras saskarenības atklāj katru iespēju. Tas ļauj administratoriem precīzi iestatīt, kuras agentu iespējas ir pieejamas REST API, MCP serveriem, WooCommerce integrācijām un citām interfeisām.
Kāds ir Redzamība? (What is Ability Visibility?)
Redzamība ir atļauju sistēma, kas kontrole:
- Kurās iespējas ir pieejamas agentiem
- Kur tās redzams (REST API, MCP, WooCommerce un tas)
- Kādam var piekļūt (partneru atļauju sarakstiem)
- Kā tās klasificē (atzītas vai neklassificētas)
Katras iespējas ir redzamības līmenis, kas noteik, kuras tās ir pieejamas dažādās saskarenībās.
Redzamības līmeņi (Visibility Levels)
Publiski (Public)
Publiskas iespējas ir pieejamas visur:
- REST API endpoints
- MCP serveri
- WooCommerce integrācijas
- Čata interfejsi
- Visām lietotāja roļiem (ar atbilstošajām atļaupām)
Piemērs: scaffold-block-theme, activate-theme, send-email
Īpaši (Internal)
Īpaši iespējas ir pieejamas tikai jūsu WordPress instalācijā:
- Čata interfejsi
- Administrācijas paneli
- Tikai ienākošajiem lietotājiem
- Nav redzams REST API vai ārējām integrācijām
Piemērs: manage-settings, view-analytics, export-data
Partneri (Partner)
Partneru iespējas ir pieejamas tikai atļautajiem partneriem:
- Prasīta ekspluatēta ienākšana partneru atļauju sarakstā
- Pieejams REST API ar partnera autentifikācijas datus
- Pieejams MCP ar partnera autentifikāciju
- Nav pieejams regulārām lietotājiem
Piemērs: bulk-import-users, modify-billing, access-analytics
Dislēgti (Disabled)
Dislēgtas iespējas nav pieejamas jebkurā vietā:
- Nav redzams kādu saskarenību
- Nav pieejams čatā
- Nav pieejams administrācijas paneliem
- Noderīgs atbalstītās vai eksperimentālās iespējās
Uzlabību iespēju pārvaldīšana
Iesniegšanās uz uzmanības redzamības iestatījumiem
- Atveriet WordPress Admin → Superdav AI Agent → Settings (Iestatījumi)
- Nospressiet Abilities (Uzlabības) tabu
- Jūs redzēsiet sarakstu visām instalēto uzmanībām un to redzamības līmeņiem
Uzlabību detaļu skatīšana
Nospressiet jebkuru uzlabību, lai redzētu:
- Name (Nosaukums): Uzlabības identifikators
- Description (Apraksts): Kas uzmanība dara
- Current visibility (Aktuālā redzamība): Public, Internal, Partner vai Disabled (Izvēlēta)
- Partner allow-list (Partneru atļauju saraksts): Kādi partneri var piekļūt (ja ir izvēlēta Partner vismazredzamība)
- Last updated (Pēdējā atjaunināšana): Kad redzamība tika pēdējā reizi mainīta
- Status: Pazināts vai Unclassified (Nklassificēts)
Redzamības līmeņu mainīšana
Lai mainītu uzlabības redzamību:
- Nospressiet uzmanību sarakstā
- Izvēlieties jaunu redzamības līmeni no dropdowna
- Ja izvēlaties "Partner", pievienojiet partneru identifikatorus atļauju sarakstam
- Nospressiet Save (Saglabāt)
Piemērs:
Ability: bulk-import-users
Current visibility: Public
Change to: Partner
Partner allow-list: partner-123, partner-456
Masīnas operācijas
Lai mainītu redzamību vairākām uzmanībām:
- Ievadi atzīmju kops uzlabībām
- Izvēlieties jaunu redzamības līmeni no masīnas darbības dropdowna
- Nospressiet Apply (Piemērot)
Partneru atļauju saraksts (Partner Allow-List)
Partneru atļauju saraksts liecina, kādi ārējie partneri var piekļūt Uzlabības līmeņa uzmanībām.
Partneru pievienošana
- Atveriet Superdav AI Agent → Settings (Iestatījumi) → Partners (Partneri)
- Nospressiet Add Partner (Pievienot partneri)
- Īrādieties partnera identifikatoru (parasti API kluāva vai organizācijas ID)
- Optiāli pievienojiet partnera nosaukumu un aprakstu
- Nospressiet Save (Saglabāt)
Uzlabību atzīšana partneriem
Partnera pievienošanas pēc tam:
- Ieiet uz Abilību tabu.
- Atrodiet abilību ar Partnera redzamību.
- Nospressiet, lai to izvēlētos rediģēt.
- "Partneru atļauju sarakstā" sadaļā atzīmējiet vakus tiem partneriem, kuriem ir pieejamība.
- Nospressiet Save (Saglabāt).
Partnera piekļuves atņemšana
Lai atņemtu partneram piekļuvi:
- Rediģējiet abilību.
- Atzīmējiet vakus partnera vakus sarakstā.
- Nospressiet Save (Saglabāt).
Partneram tūlīt zaudēs piekļuve šim abilībai.
Neklasificēti abilības
Kad instalējat tretspējas abilību, ko Superdav AI Agent nepoznā, tas tiek norādīts kā Neklasificēts.
Administrāta paziņojums par neklasificētām abilībām
Jūs redzēs administrācijas paziņojumu:
⚠️ Atrodītas neklasificētas abilības
Sejauši instalētas, bet nepoznātas abilības:
- custom-import-tool
- external-api-wrapper
Šie abiliti var radīt drošības vai compatibilitātes riskus.
Lūdzu, pārskatīt un klasificēt tos.
[Pārskatīt abilības] [Atbalstīt]
Neklasificēto abilību pārskatīšana
-
Nospressiet Review Abilities (Pārskatīt abilības) paziņojumā.
-
Katras neklasificētās abilības laikā jūs redzēs:
- Abilības nosaukumu un aprakstu
- Avotu (kurš plugin/addon to instalēja)
- Ieteikto redzamības līmeņa
- Drošības novērtējumu
-
Izvēlieties redzamības līmeni:
- Public (Publiskais): Uzticieties abilībai; atveriet to visur
- Internal (Iekšējais): ierobežojiet izmantošanu tikai iekšēji
- Partner: ierobežojiet specifiskajiem partneriem
- Disabled (Atbalstīts): neizmantojiet šo abilību
-
Nospressiet Classify (Klasificēt), lai saglabātu savu lēmumu.
Kāpēc klasificēt neklasificētas abilības?
Abilību klasificēšana:
- Uzlabo drošību: Jūs ekspluatāti apstiprināt to, kas ir atvērts
- Ievērš nepatiecības: Neklasificēti abiliti pēc defaulta ir atbalstīti
- Atver iespējas: Reiz klasificētas, abilība kļūst pieejama
- Dokumentē lēmumus: Jūs saglabājat savus izvēles audita mērķiem
Redzamība dažādās virsmas
REST API
Publikas iespējas ir pieejamas ar 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"}'
Iekšējās un partneru iespējas nav pieejamas ar REST API.
MCP Serveri
Publikas iespējas ir pieejamas ar MCP:
MCP Server: Superdav AI Agent
Pieejamas iespējas:
- scaffold-block-theme
- activate-theme
- send-email
Iekšējās iespējas nav atklātas ar MCP.
Partneru iespējas ir pieejamas tikai ar partneru autentifikācijas datus.
WooCommerce integrācija
Publikas iespējas, kas saistītas ar WooCommerce, ir pieejamas:
- Produkta pārvaldība
- Darba apstrāde (orders)
- Klientu komunikācija
Iekšējās iespējas nav atklātas WooCommerce.
Čata interfeiss
Visas iespējas (publiskās, iekšējās, partneru) ir pieejamas čatā, atkarībā no lietotāja iestatījumiem:
- Administrātori redz visus iespējas
- Normālajiem lietotāji redz tikai pubiskās iespējas
- Partneri redz pubiskās + partneru iespējas (ja tās ir saskaņotas ar sarakstu)
Drošības labākās praktikas
Mīlestības principa izmantošana (Principle of Least Privilege)
- Iestatiet iespējas visrestriktīvākai redzamībai, kas tos atļauj lietot.
- Izmantojiet partneru redzamību sensitīvās operācijās.
- Izslēdziet iespējas, ko neizmantojat.
Regulāras pārbaudes
- Pārbaudiet iespēju redzamību mēnesitām
- Pārbaudiet, vai ir nekategorizētas iespējas
- Atņemiet piekļuvi lietotajiem, kuriem nav nepieciešami partneri
Logēšana un uzraudzība (Logging and Monitoring)
- Uzraudziet, kādas iespējas tiek izmantotas visbiežāk
- Sekojiet partneru piekļuves modeļus
- Advarslieto, ja ir neparasti iespēju lietošanas modes
Tretpuses iespējas (Third-Party Abilities)
- Pārbaudiet tretpuses iespējas pirms to ieslēgšanas
- Izklāstiet tās kļūdu skaidri
- Sākiet ar iekšējām vai partneru redzamību
- Promovējiet publiski tikai pēc pārbaudes
Troubleshooting
Spēja neparāda sarakstā
- Pārbaudiet, vai spēja ir instalēta un aktīva
- Pārbaudiet, vai plugin/addon ir ieslēgts
- Atjauninājiet lapu (Refresh)
Es nevaram izveidot spējas redzamību
- Pārbaudiet, vai jums ir administratora iestatas
- Pārbaudiet, vai spēja nav bloccēta jebkura pluginas ar instrumentiem
- Mēģiniet desactivēt konfliktējo pluginus
Partneram nevar piekļūt spējai
- Pārbaudiet, vai partneris ir iekļauts atļauju sarakstā (allow-list)
- Pārbaudiet, vai spējas redzamība ir noteikta kā Partner
- Apstipriniet, ka partnera saturi ir pareizi
- Pārbaudiet API logus autentifikācijas kļūdu meklējot
Neklasificētas spējas turpināt parādīšanos
- Atzīmējiet un klasificējiet tās admina paziņojumos
- Pārbaudiet, vai jūsu klasifikācija ir saglabāta
- Pārbaudiet, vai spēja, kas to sniedz, ir aktuāla
Migrācija no veco režīma (Legacy Mode)
Ja jūs pārvēršaties no vecākas versijas Superdav AI Agent:
- Visi jau eksistējoši spēji automātiski tiek klasificēti kā Public
- Pārbaudiet un pielāgojiet redzamību, ja tas ir nepieciešams
- Nav nepieciešama nekāda darbība, ja jūs nevietojat piekļuves
Lietojiet Trešās puses režīma migrāciju lai saņemt vairāk informācijas par pāreju uz vietējo Abilities API integrāciju.
Nākamie soļi
Pēc spējai redzamības konfigurēšanas:
- Pārbaudiet savas spējas: Auditu visus instalētos spējus
- Klasificējiet neklasificētās spējas: Atbildiet uz admina paziņojumiem
- Iestatījiet partnerus: Pievienojiet partnerus, ja izmantojat Partner redzamību
- Pārbaudiet lietošanu: Sekojiet, kuras spējas tiek lietotas visbiežāk
- Dokumentējiet lēmumus: Saglabājiet paziņojumus par to, kāpēc jūs izvēltie katru redzamības līmeni