შესაძლებლობის ხილვადობა (Ability Visibility)

Superdav AI Agent v1.12.0-ის დანერგვისას შემოვიდა Ability Visibility კონტროლი, რომელიც განსაზღვრავს, თუ რომელი ზედაპირები (surfaces) გამოაჩენს თითოეულ შესაძლებლობას. ეს საშუალებას აძლევს ადმინისტრატორებს და finely-tune possano scegliere, რომელ აგენტის შესაძლებლობებს ხელმისაწვდომი ხდის REST API-ის მეშვეობით, MCP სერვერებზე, WooCommerce ინტეგრაციებზე და სხვა ინტერფეისებზე.

რა არის Ability Visibility?

Ability Visibility არის ნებართვის სისტემა, რომელიც აკონტროლებს:

• რომელი შესაძლებლობები ხელმისაწვდომია აგენტებისთვის
• სადაა გამოჩენილი (REST API, MCP, WooCommerce და ა.შ.)
• ვინ შეიძლება მათ მიუწვდებოდეს (პარტნიორების ნებართვის სია - allow-lists-ის მეშვეობით)
• როგორ არის კლასიფიცირებული (ამოცნობილი თუ არასაკლასიფიცირებული)

თითოეულ შესაძლებლობას აქვს ხილვადობის დონე, რომელიც განსაზღვრავს მის ხელმისაწვდომობას სხვადასხვა ზედაპირებზე.

ხილვადობის დონეები (Visibility Levels)

საჯარო (Public)

საჯარო შესაძლებლობები ხელმისაწვდომია ყველგან:

• REST API endpoinቶች
• MCP სერვერები
• WooCommerce ინტეგრაციები
• ჩატის ინტერფეისები
• ყველა მომხმარებლის როლი (საკანცო ნებართவுகளுடன்)

მაგალითი: scaffold-block-theme, activate-theme, send-email

შიდა (Internal)

შიდა შესაძლებლობები ხელმისაწვდომია მხოლოდ თქვენს WordPress ინსტალაციაში:

• ჩატის ინტერფეისები
• ადმინისტრაციული პანელები
• მხოლოდ შესული მომხმარებლები
• არ არის გამოჩენილი REST API-ით ან გარე ინტეგრაციებით

მაგალითი: manage-settings, view-analytics, export-data

პარტნიორი (Partner)

პარტნიორული შესაძლებლობები ხელმისაწვდომია მხოლოდ ნებართვის სიაში მყოფი პარტნიორებისთვის:

• საჭიროებს პარტნიორის ცალკე დამატებას allow-list-ში
• ხელმისაწვდომია REST API-ის მეშვეობით პარტნიორის საკრედencoებით
• ხელმისაწვდომია MCP-ის მეშვეობით პარტნიორული ავთენტიფიკაციით
• არ არის ხელმისაწვდომი ჩვეულებრივი მომხმარებლებისთვის

მაგალითი: bulk-import-users, modify-billing, access-analytics

გამორთული (Disabled)

გამორთული შესაძლებლობები არ არის ხელმისაწვდომი სადმე:

• არ არის გამოჩენილი რაიმე ზედაპირის მეშვეობით
• არ არის ხელმისაწვდომი ჩატში
• არ არის ხელმისაწვდომი ადმინისტრაციულ პანელებში
• სასარგებლოა მოძველებული ან ექსპერიმენტული შესაძლებლობებისთვის

შესაძლებლობების ხილვადობის მართვა

შესაძლებლობების ხილვადობის პარამეტრების მიღება

1. გადადით WordPress Admin → Superdav AI Agent → Settings-ზე
2. დააწკაპუნეთ Abilities (შესაძლებლობები) ტაბზე
3. თქვენ დაინახავთ ყველა დანერგილი შესაძლებლობის სია და მათი ხილვადობის დონეები

შესაძლებლობების დეტალების ნახვა

დააწკაპუნეთ ნებისმიერ შესაძლებლობაზე, რომ ნახოთ:

• Name (სახელი): შესაძლებლობის იდენტიფიკატორი
• Description (აღწერა): რა აკეთებს ეს შესაძლებლობა
• Current visibility (მიმდინარე ხილვადობა): Public (საჯარო), Internal (შიდა), Partner (პარტნიორი) ან Disabled (გამორთული)
• Partner allow-list (პარტნიორის დაშვების სია): რომელი პარტნიორებს შეუძლიათ წვდომა (თუ Partner ხილვადობაა)
• Last updated (ბოლო განახლება): როდის შეიცვალა ხილვადობა
• Status (სტატუსი): აღიარებული თუ და வகைப்படுத்தული არ არის

ხილვადობის დონეების შეცვლა

შესაძლებლობის ხილვადობის შესაცვლელად:

1. დააწკაპუნეთ სიაში არსებულ შესაძლებლობაზე
2. აირჩიეთ ახალი ხილვადობის დონე ჩამDesc-დან (dropdown)
3. თუ აირჩევთ "Partner"-ს, დაამატეთ პარტნიორის იდენტიფიკატორები დაშვების სიაში
4. დააწკაპუნეთ Save (შენახვა)

მაგალითი:

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

მასობრივი ოპერაციები

მრავალი შესაძლებლობის ხილვადობის შესაცვლელად:

1. დაამოწმეთ ყუთები იმ შესაძლებლობების გვერდით, რომელზეც გსურთ ცვლილების შეტანა
2. აირჩიეთ ახალი ხილვადობის დონე მასობრივი მოქმედებების ჩამDesc-დან (dropdown)
3. დააწკაპუნეთ Apply (დადება)

პარტნიორის დაშვების სია (Partner Allow-List)

პარტნიორის დაშვების სია განსაზღვრავს, რომელ გარე პარტნიორებს შეუძლიათ Partner-ლეველ შესაძლებლობებზე წვდომა.

პარტნიორების დამატება

1. გადადით Superdav AI Agent → Settings → Partners
2. დააწკაპუნეთ Add Partner (პარტნიორის დამატება)
3. შეიყვანეთ პარტნიორის იდენტიფიკატორი (ჩვეულებრივ API-клюვი ან ორგანიზაციის ID)
4. შეარჩიეთ, სურს თუ არა პარტნიორის სახელი და აღწერა
5. დააწკაპუნეთ Save (შენახვა)

შესაძლებლობების პარტნიორებზე მიწოდება

პარტნიორის დამატების შემდეგ:

1. გადადითეთ Abilities ტაბაში
2. იპოვეთ შესაძლებლობა პარტნიორებისთვის (Partner visibility)
3. დააწკაპუნეთ რედაქტირებისთვის
4. "Partner allow-list" სექციაში, გააკეთეთ ბוקსების ჩამოწერა იმ პარტნიორებისთვის, რომლებსაც წვდომა უნდა ჰქონდეთ
5. დააჭირეთ Save

პარტნიორის წვდომის შეწყვეტა (Revoking Partner Access)

პარტნიორის წვდომის აღმოსაფხვრელად:

1. გადადით ability-ს რედაქტირებაზე
2. გაუქმეთ პარტნიორის ბוקსი allow-list-დან
3. დააჭირეთ Save

პარტნიორმა დაუყოვნებლივ დაკარგავს ამ შესაძლებლობის წვდომას.

კლასიფიცირებადი არასაკლასიფიკებლური შესაძლებლობები (Unclassified Abilities)

როდესაც თქვენ დაამატებთ მესამე მხარის ability-ს, რომელსაც Superdav AI Agent აღიარებს, ის აღინიშნება როგორც Unclassified (არასაკლასიფიცირებული).

ადმინისტრაციული შეტყობინება არასაკლასიფიცირებულ შესაძლებლობებზე

თქვენ დაინახავთ ადმინისტრაციულ შეტყობინებას:

⚠️ Unclassified Abilities Detected

ქვემოთ მოცემული ability-ები დაინსტალირებულია, მაგრამ არ არის ცნობილი:
- custom-import-tool
- external-api-wrapper

ეს ability-ები შეიძლება წარმოადგენდეს უსაფრთხოების ან თავსებადობის რისკებს.
გთხოვთ, შეამოწმოთ და დაასაკლფიციროთ ისინი.

[Review Abilities] [Dismiss]

არასაკლასიფიცირებულ ability-ებზე მიმოხილვა (Reviewing Unclassified Abilities)

1. დააჭირეთ შეტყობინებაში Review Abilities-ს

2. თითოეული არასაკლასიფიცირებული ability-ზე თქვენ დაინახავთ:

   • Ability-ის სახელი და აღწერა
   • წყარო (რომელი plugin/addon დაამატა ის)
   • შემოთავაზებული ხილვადობის დონე
   • უსაფრთხოების შეფასება

3. აირჩიეთ ხილვადობის დონე:

   • Public (საჯარო): დაენდეთ ability-ს; გამოაქვეყნეთ ყველგან
   • Internal (내შესახული): შეზღუდეთ მხოლოდ შინაგან გამოყენებისთვის
   • Partner (პარტნიორი): შეზღუდეთ კონკრეტულ პარტნიორებისთვის
   • Disabled (გამორთული): არ გამოიყენოთ ეს ability

4. დააჭირეთ Classify-ს გადაწყვეტილების შენახვისთვის

რატომ უნდა დაასაკლფიციროთ არასაკლასიფიცირებული ability-ები?

ability-ების კლასიფიკაცია:

• გამופრავლობს უსაფრთხოება: თქვენ ექსპლიციტურად ამტკიცებთ, თუ რა არის გამოფენილი
• ვინერგავს ავარიას: არასაკლასიფიცირებული ability-ები ნაგულისხმევად გამორთულია
• מאפשר ფუნქციონალს: კლასიფიცირების შემდეგ, ability გახდება ხელმისაწვდომი
• დოკუმენტირებს გადაწყვეტილებებს: თქვენი არჩევანი ჩაიწერება აუდიტის მიზნებისთვის

ხილვადობა სხვა ზედაპირებზე

REST API

საჯარო შესაძლებლობები ხელმისაწვდომია REST endpoinტით:

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 ხელმისაწვდომი შესაძლებლობები:

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

შიდა შესაძლებლობები MCP-ის საშუალებით არ არის გამოფენილი.

პარტნიორული შესაძლებლობები ხელმისაწვდომია მხოლოდ პარტნიორული საკრედencoნტებით.

WooCommerce ინტეგრაცია

საჯარო შესაძლებლობები, რომლებიც დაკავშირებულია WooCommerce-თან, ხელმისაწვდომია:

• პროდუქტის მართვა
• შეკვეთების დამუშავება
• მომხმარებელთან კომუნიკაცია

შიდა შესაძლებლობები არ არის გამოფენილი WooCommerce-ისთვის.

ჩატის ინტერფეისი

ყველა შესაძლებლობა (საჯარო, შიდა, პარტნიორული) ხელმისაწვდომია ჩატში, რაც დამოკიდებულია მომხმარებლის უფლებებზე:

• ადმინისტრატორებს შეუძლიათ ყველა შესაძლებლობის ნახვა
• ჩვეულებრივ მომხმარებლებს მხოლოდ საჯარო შესაძლებლობები აინახავთ
• პარტნიორებს აინახავთ საჯარო + პარტნიორული შესაძლებლობები (თუ ისინი დაშვებულნი არიან)

უსაფრთხოების საუკეთესო პრაქტიკა

მინიმალური პრივილეგიის პრინციპი

• დააყენეთ შესაძლებლობები ყველაზე მკაცრი ხილვადობის დონეზე, რომელიც მათ გამოყენებას მაინც թույლით აძლევს
• სენსიტიური ოპერაციებისთვის გამოიყენეთ პარტნიორული ხილვადობა
• გამორთეთ ის შესაძლებლობები, რომელთა გამოყენებაც არ გჭირდებათ

რეგულარული შემოწმებები

• ყოველთვიურად გადახედეთ შესაძლებლობების ხილვადობას
• შეამოწმეთ და კლასიფიცირეთ დაუმასპინებელი შესაძლებლობები
• მოაშორეთ წვდომა არასავარგულო პარტნიორებისთვის

ჟურნალრება და მონიტორინგი

• აკონტროლეთ, რომელი შესაძლებლობები გამოიყენება ყველაზე ხშირად
• відслеუდეთ პარტნიორების წვდომის ნიმუშები
• გააფრთხილეთ უჩვეულო შესაძლებლობის გამოყენების შესახებ

მესამე მხარის შესაძლებლობები

• შეამოწმეთ მესამე მხარის შესაძლებლობები დანერგვის წინ
• მათ მკაფიოდ დაასახელეთ (კლასიფიცირება)
• დაიწყეთ შიდა ან პარტნიორული ხილვადობით
• საჯარო დონეზე გადაიტანეთ მხოლოდ შემოწმების შემდეგ

პრობლემების მოგვარება

უნარობა არ ჩანს სიაში

• შეამოწმეთ, არის თუ არა უნარობა დაინსტალირებული და აქტიური
• გადაამოწმეთ, გააქტიურებულია თუ არა პლაგინი/ add-on
• განაახლეთ გვერდი

უნარობის ხილვადობის შეცვლა ვერ ვახერხებ

• შეამოწმეთ, რომ გექნებათ ადმინისტრატორის უფლებები
• გადაამოწმეთ, რომ უნარობა არ არის დაბლოკილი პლაგინით
• სცადეთ კონფლიქტური პლაგინების გამორთვა

პარტნიორს არ შეუძლია უნარის მიღება

• შეამოწმეთ, არის თუ არა პარტნიორი დაშვების სიის (allow-list) წევრთა სიაში
• გადაამოწმეთ, რომ უნარის ხილვადობა დაყენებულია "Partner"-ზე
• დაადასტურეთ, რომ პარტნიორის მონაცემები სწორია
• შეამოწმეთ API-ის лог-ებში ავთენტიფიკაციის შეცდომები

არასახელებლივი უნარები კვლავ ჩნდება

• გადახედეთ და დაასახელეთ ისინი ადმინისტრაციული შეტყობინების საშუალებით
• შეამოწმეთ, შენახულია თუ არა თქვენი კლასიფიკაცია
• გადაამოწმეთ, არის თუ არა უნარის მომწოდებელი პლაგინი განახლებული

მიგრაცია ძველ რეჟიმიდან (Legacy Mode)

თუ ახალ ვერსიაზე აപുთენტირებთ Superdav AI Agent:

• ყველა არსებული უნარი ავტომატურად დაასახელებს "Public"
• გადახედეთ და საჭიროების შემთხვევაში შეცვალეთ ხილვადობა
• არ არის საჭირო რაიმე ქმედება, თუ არ გსურთ წვდომის შეზღუდვა

მეტი დეტალებისთვის ნახეთ Third-Party Mode Migration ნამდვილ API ინტეგრაციაზე გადასვლის შესახებ.

შემდეგი ნაბიჯები

უნარობის ხილვადობის კონფიგურირების შემდეგ:

1. გადახედეთ თქვენს უნარებს: შეამოწმეთ ყველა დაინსტალირებული უნარი
2. დაასახელეთ არასახელებლივი უნარები: უპასუხეთ ადმინისტრაციულ შეტყობინებებს
3. დაამატეთ პარტნიორები: დაამატეთ პარტნიორები, თუ იყენებთ Partner ხილვადობას
4. აკონტროლეთ გამოყენება: გაიგეთ, რომელი უნარები გამოიყენება ყველაზე მეტად
5. დააფიქსირეთ გადაწყვეტილებები: შეინახეთ შენიშვნები იმის შესახებ, თუ რატომ აირჩიეთ თითოეული ხილვადობის დონე