Skip to main content

क्षमता दृश्यता (Ability Visibility)

Superdav AI Agent v1.12.0 ले क्षमता दृश्यता (Ability Visibility) नियन्त्रणहरू परिचय दिन्छ जसले कुन सतहहरूमा प्रत्येक क्षमता प्रदर्शन गरिनेछ भन्ने कुरालाई नियन्त्रण गर्दछ। यसले व्यवस्थापकहरूलाई REST API, MCP सर्भरहरू, WooCommerce एकीकरणहरू र अन्य इन्टरफेस मार्फत कुन एजेन्ट क्षमताहरू उपलब्ध छन् भनेर परिष्कृत गर्न अनुमति दिन्छ।

क्षमता दृश्यता के हो?​

क्षमता दृश्यता (Ability Visibility) एक अनुमति प्रणाली हो जसले निम्न कुराहरू नियन्त्रण गर्दछ:

  • कुन क्षमताहरू एजेन्टहरूका लागि उपलब्ध छन्
  • उनी कहाँ प्रदर्शन गरिएका छन् (REST API, MCP, WooCommerce आदि)
  • कसले तिनीहरूमा पहुँच गर्न सक्छन् (साझेदार अनुमति सूची मार्फत)
  • तिनीहरूको वर्गीकरण कसरी गरिन्छ (पहचाना गरिएको बनाम गैर-वर्गीकृत)

प्रत्येक क्षमताको एक दृश्यता स्तर हुन्छ जसले विभिन्न सतहहरूमा यसको उपलब्धता निर्धारण गर्दछ।

दृश्यता स्तरहरू (Visibility Levels)​

सार्वजनिक (Public)​

सार्वजनिक क्षमताहरू सबै ठाउँमा उपलब्ध छन्:

  • REST API endpoints
  • MCP सर्भरहरू
  • WooCommerce एकीकरणहरू
  • च्याट इन्टरफेसहरू
  • सबै प्रयोगकर्ता भूमिका (उचित अनुमतिहरूसँग)

उदाहरण: scaffold-block-theme, activate-theme, send-email

आन्तरिक (Internal)​

आन्तरिक क्षमताहरू तपाईंको वर्डप्रेस इन्स्टलेसन भित्र मात्र उपलब्ध छन्:

  • च्याट इन्टरफेसहरू
  • एडमिन प्यानेलहरू
  • केवल लग-इन गरिएका प्रयोगकर्ताहरू
  • REST API वा बाह्य एकीकरण मार्फत प्रदर्शन गरिँदैन

उदाहरण: manage-settings, view-analytics, export-data

साझेदार (Partner)​

साझेदार क्षमताहरू केवल सफ्टलिस्ट गरिएका साझेदारहरूका लागि उपलब्ध छन्:

  • स्पष्ट साझेदार अनुमति सूचीमा प्रवेश आवश्यक
  • साझेदार प्रमाणिकरण मार्फत REST API मार्फत उपलब्ध
  • साझेदार प्रमाणीकरण मार्फत MCP मार्फत उपलब्ध
  • नियमित प्रयोगकर्ताहरूका लागि उपलब्ध छैन

उदाहरण: bulk-import-users, modify-billing, access-analytics

अक्षम (Disabled)​

अक्षम क्षमताहरू कुनै पनि ठाउँमा उपलब्ध छैनन्:

  • कुनै सतह मार्फत प्रदर्शन गरिँदैन
  • च्याटमा उपलब्ध छैन
  • एडमिन प्यानेलमा उपलब्ध छैन
  • पुरानो वा प्रायोगिक क्षमताहरूको लागि उपयोगी

क्षमता दृश्य व्यवस्थापन (Managing Ability Visibility)​

क्षमता दृश्य सेटिङहरूमा पहुँच गर्ने (Accessing Ability Visibility Settings)​

१. WordPress Admin → Superdav AI Agent → Settings मा जानुहोस्। २. Abilities ट्याबमा क्लिक गर्नुहोस्। ३. यहाँ तपाईंले इन्स्टल गरिएका सबै क्षमताहरूको सूची र तिनीहरूको दृश्यता स्तर देख्नुहुनेछ।

क्षमता विवरण हेर्ने (Viewing Ability Details)​

कुनै पनि क्षमतामा क्लिक गरेर निम्न कुराहरू हेर्न सक्नुहुन्छ:

  • Name: त्यो क्षमताको पहिचानकर्ता
  • Description: त्यो क्षमताले के गर्छ भन्ने जानकारी
  • Current visibility: सार्वजनिक (Public), आन्तरिक (Internal), पार्टनर (Partner), वा अक्षम (Disabled)
  • Partner allow-list: कुन पार्टनरहरूले पहुँच गर्न सक्छन् (यदि पार्टनर दृश्यता छ भने)
  • Last updated: अन्तिम पटक दृश्यता परिवर्तन कहिले गरियो
  • Status: पहिचान गरिएको (Recognized) वा अवर्गीकृत (Unclassified)

दृश्यता स्तर परिवर्तन गर्ने (Changing Visibility Levels)​

कुनै पनि क्षमताको दृश्यता परिवर्तन गर्न:

१. सूचीमा भएको क्षमतामा क्लिक गर्नुहोस्। २. ड्रपडाउनबाट नयाँ दृश्यता स्तर चयन गर्नुहोस्। ३. यदि तपाईंले "Partner" चयन गर्नुभयो भने, अनुमति सूची (allow-list) मा पार्टनर पहिचानकर्ताहरू थप्नुहोस्। ४. Save मा क्लिक गर्नुहोस्।

उदाहरण:

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

सामूहिक कार्यहरू (Bulk Operations)​

धेरै क्षमताहरूको दृश्यता परिवर्तन गर्न:

१. ती क्षमताहरूको छेउमा रहेको बक्सहरू चेक गर्नुहोस्। २. सामूहिक कार्य (bulk action) ड्रपडाउनबाट नयाँ दृश्यता स्तर चयन गर्नुहोस्। ३. Apply मा क्लिक गर्नुहोस्।

पार्टनर अनुमति सूची (Partner Allow-List)​

पार्टनर अनुमति सूची ले कुन बाह्य पार्टनरहरूले पार्टनर-स्तरका क्षमताहरूमा पहुँच गर्न सक्छन् भन्ने नियन्त्रण गर्दछ।

पार्टनर थप्ने (Adding Partners)​

१. Superdav AI Agent → Settings → Partners मा जानुहोस्। २. Add Partner मा क्लिक गर्नुहोस्। ३. पार्टनर पहिचानकर्ता (सामान्यतया API key वा संगठन ID) प्रविष्ट गर्नुहोस्। ४. वैकल्पिक रूपमा, एक पार्टनरको नाम र विवरण थप्न सक्नुहुन्छ। ५. Save मा क्लिक गर्नुहोस्।

पार्टनरहरूलाई क्षमताहरू तोक्ने (Assigning Abilities to Partners)​

पार्टनर थपेपछि:

१. Abilities ट्याबमा जानुहोस् २. पार्टनर विजिबिलिटी भएको कुनै एबिलिटी फेला पार्नुहोस् ३. एडिट गर्न क्लिक गर्नुहोस् ४. "Partner allow-list" सेक्सनमा, कुन पार्टनरलाई पहुँच दिनुपर्छ ती पार्टनरहरूको लागि चेकबक्सहरू चिन्ह लगाउनुहोस् ५. Save मा क्लिक गर्नुहोस्

पार्टनरको पहुँच हटाउने (Revoking Partner Access)​

पार्टनरको पहुँच हटाउनका लागि:

१. एबिलिटी एडिट गर्नुहोस् २. अलाउ-लिस्टमा पार्टनरको चेकबक्स अनचेक गर्नुहोस् ३. Save मा क्लिक गर्नुहोस्

पार्टनरले तुरुन्तै त्यो एबिलिटीमा पहुँच गुमाउनेछ।

वर्गीकरण नगरिएका एबिलिटीज (Unclassified Abilities)​

जब तपाईं Superdav AI Agent ले चिन्न नसकेको कुनै थर्ड-पार्टी एबिलिटी इन्स्टल गर्नुहुन्छ, त्यसलाई Unclassified भनेर चिन्ह लगाइन्छ।

वर्गीकरण नगरिएका एबिलिटीजका लागि एडमिन सूचना (Admin Notice for Unclassified Abilities)​

तपाईंले निम्न एडमिन सूचना देख्नुहुनेछ:

⚠️ Unclassified Abilities Detected

निम्न एबिलिटीज इन्स्टल गरिए तर पहिचान गरिएको छैन:
- custom-import-tool
- external-api-wrapper

यी एबिलिटीजहरूले सुरक्षा वा अनुकूलता जोखिम निम्त्याउन सक्छन्।
कृपया तिनीहरूको समीक्षा गर्नुहोस् र वर्गीकरण गर्नुहोस्।

[Review Abilities] [Dismiss]

वर्गीकरण नगरिएका एबिलिटीजको समीक्षा गर्ने (Reviewing Unclassified Abilities)​

१. सूचनामा Review Abilities मा क्लिक गर्नुहोस् २. हरेक वर्गीकरण नगरिएको एबिलिटीको लागि, तपाईंले निम्न कुराहरू देख्नुहुनेछ:

  • एबिलिटीको नाम र विवरण
  • स्रोत (कुन प्लगइन/अडअनले यसलाई इन्स्टल गरेको छ)
  • सुझाव गरिएको विजिबिलिटी स्तर
  • सुरक्षा मूल्याङ्कन

३. एक विजिबिलिटी स्तर रोज्नुहोस्:

  • Public: एबिलिटीमा विश्वास गर्नुहोस्; सबै ठाउँमा प्रदर्शन गर्नुहोस्
  • Internal: केवल आन्तरिक प्रयोगका लागि सीमित गर्नुहोस्
  • Partner: विशिष्ट पार्टनरहरूमा सीमित गर्नुहोस्
  • Disabled: यो एबिलिटी प्रयोग नगर्नुहोस्

४. आफ्नो निर्णय सुरक्षित गर्न Classify मा क्लिक गर्नुहोस्

वर्गीकरण नगरिएका एबिलिटीज किन वर्गीकृत गर्ने? (Why Classify Unclassified Abilities?)​

एबिलिटीजलाई वर्गीकरण गर्नुको कारणहरू:

  • सुरक्षा सुधार गर्छ: तपाईंले के प्रदर्शन गरिने छ भने स्पष्ट रूपमा स्वीकृति दिनुहुन्छ
  • दुर्घटनाहरू रोक्छ: वर्गीकरण नगरिएका एबिलिटीज डिफल্ট रूपमा बन्द हुन्छन्
  • सुविधा सक्षम गर्छ: एक पटक वर्गीकृत भएपछि, त्यो एबिलिटी उपलब्ध हुन्छ
  • निर्णयहरूको दस्तावेज गर्छ: लेखापरीक्षण (audit) प्रयोजनका लागि तपाईंको छनोटहरू रेकर्ड गरिन्छ

विभिन्न सतहहरूमा दृश्यता (Visibility in Different Surfaces)​

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 सर्भरहरू (MCP Servers)​

सार्वजनिक क्षमताहरू MCP मार्फत उपलब्ध छन्:

MCP Server: Superdav AI Agent
उपलब्ध क्षमताहरू:
- scaffold-block-theme
- activate-theme
- send-email

आन्तरिक क्षमताहरू MCP मार्फत प्रदर्शन गरिएका छैनन्।

पार्टनर क्षमताहरू केवल पार्टनर क्रेडेंशियल्सको साथ उपलब्ध छन्।

WooCommerce एकीकरण (WooCommerce Integration)​

WooCommerce सम्बन्धी सार्वजनिक क्षमताहरू उपलब्ध छन्:

  • उत्पादन व्यवस्थापन (Product management)
  • अर्डर प्रशोधन (Order processing)
  • ग्राहक सञ्चार (Customer communication)

आन्तरिक क्षमताहरू WooCommerce मा प्रदर्शन गरिएका छैनन्।

च्याट इन्टरफेस (Chat Interface)​

प्रयोगकर्ता अनुमतिहरूमा निर्भर गर्दै सबै क्षमताहरू (सार्वजनिक, आन्तरिक, पार्टनर) च्याटमा उपलब्ध छन्:

  • व्यवस्थापक सबै क्षमताहरू देख्छन्
  • सामान्य प्रयोगकर्ताहरूले केवल सार्वजनिक क्षमताहरू मात्र देख्छन्
  • पार्टनरहरूले सार्वजनिक + पार्टनर क्षमताहरू (यदिWHITELIST गरिएको छ भने) देख्छन्

सुरक्षा उत्तम अभ्यासहरू (Security Best Practices)​

न्यूनतम विशेषाधिकारको सिद्धान्त (Principle of Least Privilege)​

  • आफ्नो प्रयोगका लागि अनुमति दिने सबैभन्दा कम restricitive दृश्यता सेट गर्नुहोस्
  • संवेदनशील कार्यहरूको लागि पार्टनर दृश्यता प्रयोग गर्नुहोस्
  • तपाईंले प्रयोग नगर्ने क्षमताहरूलाई अक्षम गर्नुहोस्

नियमित लेखापरीक्षणहरू (Regular Audits)​

  • मासिक रूपमा क्षमताको दृश्यताको समीक्षा गर्नुहोस्
  • अवर्गीकृत (unclassified) क्षमताहरूको जाँच गर्नुहोस्
  • प्रयोग नगरिएका पार्टनरहरूको पहुँच हटाउनुहोस्

लगिङ र निगरानी (Logging and Monitoring)​

  • कुन क्षमताहरू सबैभन्दा बढी प्रयोग गरिन्छ भनेर निगरानी गर्नुहोस्
  • पार्टनरको पहुँच ढाँचाहरू ट्र्याक गर्नुहोस्
  • असामान्य क्षमता प्रयोगमा अलर्ट गर्नुहोस्

तेस्रो-पक्ष क्षमताहरू (Third-Party Abilities)​

  • सक्षम गर्नुअघि तेस्रो-पक्ष क्षमताहरूको समीक्षा गर्नुहोस्
  • तिनीहरूलाई स्पष्ट रूपमा वर्गीकरण गर्नुहोस्
  • आन्तरिक वा पार्टनर दृश्यताबाट सुरु गर्नुहोस्
  • जाँच गरिसकेपछि मात्र सार्वजनिक गर्न प्रवर्द्धन गर्नुहोस्

समस्या निवारण​

सूचीमा कुनै क्षमता देखिँदैन

  • त्यो क्षमता इन्स्टल गरिएको छ र सक्रिय (active) छ कि छैन जाँच गर्नुहोस्।
  • प्लगइन/एडअन सक्षम (enabled) छ कि छैन हेर्नुहोस्।
  • पेज रिफ्रेश गर्नुहोस्।

म कुनै क्षमताको दृश्यता (visibility) परिवर्तन गर्न सक्दिनँ

  • तपाईंसँग एडमिन अनुमतिहरू छन् कि छैनन् जाँच गर्नुहोस्।
  • केही प्लगइनले त्यो क्षमता लक (lock) गरेको छैन भनेर जाँच गर्नुहोस्।
  • विरोधाभासी (conflicting) प्लगइनहरू बन्द गर्ने प्रयास गर्नुहोस्।

साझेदारले कुनै क्षमतामा पहुँच गर्न सक्दैन

  • साझेदार अनुमति सूची (allow-list) मा छन् कि छैनन् जाँच गर्नुहोस्।
  • त्यो क्षमताको दृश्यता 'Partner' मा सेट गरिएको छ कि छैन हेर्नुहोस्।
  • साझेदारको विवरण सही छ वा छैन पुष्टि गर्नुहोस्।
  • प्रमाणीकरण त्रुटिहरूका लागि API लगहरू (API logs) जाँच गर्नुहोस्।

वर्गीकृत नभएका क्षमताहरू लगातार देखिँदैछन्

  • एडमिन सूचनाहरूमा तिनीहरूको समीक्षा गर्नुहोस् र वर्गीकरण (classify) गर्नुहोस्।
  • तपाईंको वर्गीकरण सुरक्षित भएको छ कि छैन जाँच गर्नुहोस्।
  • त्यो क्षमता प्रदान गर्ने प्लगइन अद्यावधिक (up to date) छ वा छैन हेर्नुहोस्।

लेगेसी मोडबाट माइग्रेशन​

यदि तपाईं Superdav AI Agent को पुरानो संस्करणबाट अपग्रेड गर्दै हुनुहुन्छ भने:

  • सबै विद्यमान क्षमताहरू स्वचालित रूपमा 'Public' मा वर्गीकरण हुन्छन्।
  • आवश्यकता अनुसार दृश्यताको समीक्षा गर्नुहोस् र समायोजन गर्नुहोस्।
  • यदि तपाईं पहुँच सीमित गर्न चाहनुहुन्न भने कुनै कार्य आवश्यक छैन।

नेटिभ Abilities API एकीकरणमा संक्रमणका बारेमा थप विवरणको लागि Third-Party Mode Migration हेर्नुहोस्।

आगामी चरणहरू​

क्षमता दृश्यता कन्फिगर गरेपछि:

  1. तपाईंको क्षमताहरूको समीक्षा गर्नुहोस्: सबै इन्स्टल गरिएका क्षमताहरूको लेखाजोखा (Audit) गर्नुहोस्।
  2. वर्गीकृत नभएका क्षमताहरू वर्गीकरण गर्नुहोस्: एडमिन सूचनाहरूको जवाफ दिनुहोस्।
  3. साझेदारहरू सेटअप गर्नुहोस्: यदि तपाईं Partner दृश्यता प्रयोग गर्दै हुनुहुन्छ भने साझेदारहरू थप्नुहोस्।
  4. प्रयोगको निगरानी गर्नुहोस्: कुन क्षमताहरू सबैभन्दा बढी प्रयोग गरिन्छ भनेर ट्र्याक गर्नुहोस्।
  5. निर्णयहरूको दस्तावेज गर्नुहोस्: तपाईंले प्रत्येक दृश्यता स्तर किन रोज्नुभयो भन्ने बारे नोट राख्नुहोस्।