Skip to main content

ការមើលឃើញសមត្ថភាព (Ability Visibility)

Superdav AI Agent v1.12.0 បានណែនាំការគ្រប់គ្រង Ability Visibility ដែលគ្រប់គ្រងថាផ្ទៃ (surfaces) ណាខ្លះបង្ហាញសមត្ថភាពនីមួយៗ។ នេះអនុញ្ញាតឱ្យអ្នកគ្រប់គ្រងកែតម្រូវថាតើសមត្ថភាពរបស់ Agent ណាខ្លះដែលអាចប្រើបានតាមរយៈ REST APIs, MCP servers, WooCommerce integrations និងចំណុចប្រទាក់ផ្សេងទៀត។

Ability Visibility ជាអ្វី?​

Ability Visibility គឺជាប្រព័ន្ធអនុញ្ញាតមួយដែលគ្រប់គ្រង៖

  • សមត្ថភាពណាខ្លះ ដែលមានសម្រាប់ Agent
  • ទីតាំងដែលវាត្រូវបានបង្ហាញ (REST API, MCP, WooCommerce, ល)
  • អ្នកណាអាចចូលប្រើបាន (តាមរយៈ partner allow-lists)
  • របៀបដែលវាត្រូវបានចាត់ថ្នាក់ (ទទួលស្គាល់ vs. មិនទទួលស្គាល់)

សមត្ថភាពនីមួយៗមានកម្រិតនៃការមើលឃើញមួយ ដែលកំណត់ពីលទ្ធភាពរបស់វាឆ្លងកាត់ផ្ទៃផ្សេងៗគ្នា។

កម្រិតនៃការមើលឃើញ (Visibility Levels)​

សាធារណៈ (Public)​

សមត្ថភាពសាធារណៈ មានសម្រាប់ប្រើគ្រប់ទីកន្លែង៖

  • REST API endpoints
  • MCP servers
  • WooCommerce integrations
  • Chat interfaces
  • តួនាទីអ្នកប្រើប្រាស់ទាំងអស់ (ជាមួយនឹងការអនុញ្ញាតសមស្រប)

ឧទាហរណ៍: scaffold-block-theme, activate-theme, send-email

ផ្ទៃក្នុង (Internal)​

សមត្ថភាពផ្ទៃក្នុង មានសម្រាប់តែនៅក្នុងការដំឡើង WordPress របស់អ្នកប៉ុណ្ណោះ៖

  • Chat interfaces
  • Admin panels
  • អ្នកប្រើប្រាស់ដែលបានចូលគណនីរួចហើយប៉ុណ្ណោះ
  • មិនត្រូវបានបង្ហាញតាមរយៈ REST API ឬ integrations ខាងក្រៅទេ

ឧទាហរណ៍: manage-settings, view-analytics, export-data

ដៃគូ (Partner)​

សមត្ថភាពដៃគូ មានសម្រាប់តែដៃគូដែលបានបញ្ជីអនុញ្ញាតប៉ុណ្ណោះ៖

  • ទាមទារការបញ្ចូលទៅក្នុង partner allow-list ដោយច្បាស់លាស់
  • មានសម្រាប់ប្រើតាមរយៈ REST API ជាមួយនឹងព័ត៌មានសម្ងាត់របស់ដៃគូ
  • មានសម្រាប់ប្រើតាមរយៈ MCP ជាមួយនឹងការផ្ទៀងផ្ទាត់អត្តសញ្ញាណរបស់ដៃគូ
  • មិនមានសម្រាប់អ្នកប្រើប្រាស់ធម្មតាទេ

ឧទាហរណ៍: bulk-import-users, modify-billing, access-analytics

បិទ (Disabled)​

សមត្ថភាពដែលត្រូវបានបិទ មិនអាចប្រើបាននៅទីណាទាំងអស់៖

  • មិនត្រូវបានបង្ហាញតាមរយៈផ្ទៃណាមួយទេ
  • មិនមាននៅក្នុង chat
  • មិនមាននៅក្នុង admin panels
  • មានប្រយោជន៍សម្រាប់សមត្ថភាពដែលហួសសម័យ ឬកំពុងសាកល្បង

ការគ្រប់គ្រងការមើលឃើញសមត្ថភាព (Managing Ability Visibility)​

ការចូលទៅកាន់ការកំណត់ការមើលឃើញសមត្ថភាព (Accessing Ability Visibility Settings)​

  1. ចូលទៅកាន់ WordPress Admin → Superdav AI Agent → Settings
  2. ចុចលើแท็บ Abilities (សមត្ថភាព)
  3. អ្នកនឹងឃើញបញ្ជីនៃសមត្ថភាពទាំងអស់ដែលបានដំឡើង រួមជាមួយកម្រិតនៃការមើលឃើញរបស់វា

ការមើលព័ត៌មានលម្អិតនៃសមត្ថភាព (Viewing Ability Details)​

ចុចលើសមត្ថភាពណាមួយដើម្បីមើល៖

  • Name (ឈ្មោះ): លេខសម្គាល់នៃសមត្ថភាពនោះ
  • Description (ការពិពណ៌នា): សមត្ថភាពនោះធ្វើអ្វីខ្លះ
  • Current visibility (ការមើលឃើញបច្ចុប្បន្ន): Public (សាធារណៈ), Internal (ផ្ទៃក្នុង), Partner (ដៃគូ), ឬ Disabled (មិនដំណើរការ)
  • Partner allow-list (បញ្ជីអនុញ្ញាតដៃគូ): តើដៃគូណាខ្លះអាចចូលប្រើបាន (ប្រសិនបើមានការមើលឃើញជា Partner)
  • Last updated (آخرការធ្វើបច្ចុប្បន្នភាព): កាលបរិច្ឆេទដែលការមើលឃើញត្រូវបានផ្លាស់ប្តូរចុងក្រោយ
  • Status (ស្ថានភាព): ត្រូវបានទទួលស្គាល់ ឬ Unclassified (មិនទាន់បានចាត់ថ្នាក់)

ការផ្លាស់ប្តូរកម្រិតនៃការមើលឃើញ (Changing Visibility Levels)​

ដើម្បីផ្លាស់ប្តូរកម្រិតនៃការមើលឃើញនៃសមត្ថភាពមួយ៖

  1. ចុចលើសមត្ថភាពនោះក្នុងបញ្ជី
  2. ជ្រើសរើសកម្រិតនៃការមើលឃើញថ្មីពីបញ្ជីទម្លាក់ចុះ (dropdown)
  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)​

partner allow-list គ្រប់គ្រងថាដៃគូខាងក្រៅណាខ្លះដែលអាចចូលប្រើសមត្ថភាពកម្រិត Partner បាន។

ការបន្ថែមដៃគូ (Adding Partners)​

  1. ចូលទៅកាន់ Superdav AI Agent → Settings → Partners
  2. ចុចលើ Add Partner (បន្ថែមដៃគូ)
  3. បញ្ចូលលេខសម្គាល់ដៃគូ (ជាធម្មតាគឺ API key ឬ organization ID)
  4. ជាជម្រើស សូមបន្ថែមឈ្មោះ និងការពិពណ៌នារបស់ដៃគូ
  5. ចុច Save (រក្សាទុក)

ការកំណត់សមត្ថភាពដល់ដៃគូ (Assigning Abilities to Partners)​

បន្ទាប់ពីបានបន្ថែមដៃគូ៖

១. ទៅកាន់แท็บ Abilities (ความสามารถ) ២. ค้นหาความสามารถที่มีการตั้งค่าให้มองเห็นโดย Partner (Partner visibility) ៣. คลิกเพื่อแก้ไข ៤. ในส่วน "Partner allow-list" ให้ติ๊กถูกที่ช่องสำหรับพาร์ทเนอร์ที่ควรจะเข้าถึงได้ ៥. คลิก Save (บันทึก)

การเพิกถอนสิทธิ์การเข้าถึงของ Partner​

หากต้องการนำการเข้าถึงของพาร์ทเนอร์ออก:

  1. แก้ไขความสามารถนั้น
  2. ยกเลิกการติ๊กช่องของพาร์ทเนอร์ในรายการอนุญาต (allow-list)
  3. คลิก Save (บันทึก)

พาร์ทเนอร์จะสูญเสียสิทธิ์ในการเข้าถึงความสามารถนั้นทันที

ความสามารถที่ยังไม่ได้จัดประเภท (Unclassified Abilities)​

เมื่อคุณติดตั้งความสามารถจากภายนอก (third-party ability) ที่ Superdav AI Agent ไม่รู้จัก ระบบจะทำเครื่องหมายว่าเป็น Unclassified (ยังไม่ได้จัดประเภท)

ประกาศสำหรับผู้ดูแลระบบเกี่ยวกับความสามารถที่ยังไม่ได้จัดประเภท​

คุณจะเห็นประกาศของผู้ดูแลระบบดังนี้:

⚠️ Unclassified Abilities Detected

ความสามารถต่อไปนี้ถูกติดตั้งแล้วแต่ไม่ได้รับการจดจำ:
- custom-import-tool
- external-api-wrapper

ความสามารถเหล่านี้อาจก่อให้เกิดความเสี่ยงด้านความปลอดภัยหรือความเข้ากันได้ โปรดตรวจสอบและจัดประเภทใหม่

[Review Abilities] [Dismiss]

การตรวจสอบความสามารถที่ยังไม่ได้จัดประเภท​

  1. คลิก Review Abilities (ตรวจสอบความสามารถ) ในประกาศนั้น

  2. สำหรับความสามารถแต่ละรายการที่คุณจะเห็น:

    • ชื่อและความสามารถของความสามารถนั้น
    • แหล่งที่มา (ปลั๊กอิน/แอดออนที่ติดตั้งมัน)
    • ระดับการมองเห็นที่แนะนำ
    • การประเมินด้านความปลอดภัย

  3. เลือกระดับการมองเห็น:

    • Public (สาธารณะ): เชื่อมั่นในความสามารถนั้น เปิดเผยให้ทุกคนเข้าถึงได้
    • Internal (ภายใน): จำกัดการใช้งานเฉพาะภายในเท่านั้น
    • Partner (พาร์ทเนอร์): จำกัดเฉพาะพาร์ทเนอร์ที่ระบุไว้
    • Disabled (ปิดใช้งาน): ไม่ใช้ความสามารถนี้

  4. คลิก Classify (จัดประเภท) เพื่อบันทึกการตัดสินใจของคุณ

ทำไมต้องจัดประเภทความสามารถที่ยังไม่ได้จัดประเภท?​

การจัดประเภทความสามารถ:

  • เพิ่มความปลอดภัย: คุณอนุมัติอย่างชัดเจนว่าอะไรจะถูกเปิดเผย
  • ป้องกันอุบัติเหตุ: ความสามารถที่ยังไม่ได้จัดประเภทจะถูกปิดใช้งานโดยค่าเริ่มต้น
  • เปิดใช้งานฟีเจอร์: เมื่อจัดประเภทแล้ว ความสามารถนั้นก็จะพร้อมใช้งาน
  • บันทึกการตัดสินใจ: การเลือกของคุณจะถูกบันทึกไว้เพื่อวัตถุประสงค์ในการตรวจสอบ

ការមើលឃើញលើផ្ទៃផ្សេងៗគ្នា​

REST API​

សមត្ថភាពសាធារណៈ (Public abilities) អាចប្រើបានតាមរយៈ 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"}'

សមត្ថភាពផ្ទៃក្នុង និងដៃគូ (Internal and Partner abilities) មិនអាចប្រើបានតាមរយៈ REST API ទេ។

MCP Servers​

សមត្ថភាពសាធារណៈ (Public abilities) អាចប្រើបានតាមរយៈ MCP:

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

សមត្ថភាពផ្ទៃក្នុង (Internal abilities) មិនត្រូវបានបង្ហាញតាមរយៈ MCP ទេ។

សមត្ថភាពដៃគូ (Partner abilities) អាចប្រើបានតែជាមួយព័ត៌មានសម្ងាត់របស់ដៃគូរเท่านั้น។

WooCommerce Integration​

សមត្ថភាពសាធារណៈ (Public abilities) ដែលទាក់ទងនឹង WooCommerce មានដូចជា:

  • ការគ្រប់គ្រងផលិតផល (Product management)
  • ការដំណើរការការបញ្ជាទិញ (Order processing)
  • ការទំនាក់ទំនងជាមួយអតិថិជន (Customer communication)

សមត្ថភាពផ្ទៃក្នុង (Internal abilities) មិនត្រូវបានបង្ហាញទៅកាន់ WooCommerce ទេ។

Chat Interface​

សមត្ថភាពទាំងអស់ (សាធារណៈ, ផ្ទៃក្នុង, ដៃគូ) មាននៅក្នុងការជជែក (chat) ដោយអាស្រ័យលើសិទ្ធិរបស់អ្នកប្រើប្រាស់៖

  • អ្នកគ្រប់គ្រង (Administrators) មើលឃើញសមត្ថភាពទាំងអស់
  • អ្នកប្រើប្រាស់ធម្មតា (Regular users) មើលឃើញតែសមត្ថភាពសាធារណៈប៉ុណ្ណោះ
  • ដៃគូ (Partners) មើលឃើញសមត្ថភាពសាធារណៈ + សមត្ថភាពដៃគូ (ប្រសិនបើត្រូវបានអនុញ្ញាត)

ការអនុវត្តល្អបំផុតด้านសន្តិសុខ (Security Best Practices)​

គោលការណ៍ផ្តល់សិទ្ធិអប្បបរមា (Principle of Least Privilege)​

  • កំណត់សមត្ថភាពឱ្យមានការមើលឃើញដែលតឹងរ៉ឹងបំផុតដែលអាចអនុញ្ញាតឱ្យប្រើប្រាស់វាបាន
  • ប្រើការមើលឃើញរបស់ដៃគូ (Partner visibility) សម្រាប់ប្រតិបត្តិការរសើប (sensitive operations)
  • បិទសមត្ថភាពដែលអ្នកមិនប្រើ

ការត្រួតពិនិត្យជាទៀងទាត់ (Regular Audits)​

  • ពិនិត្យមើលការមើលឃើញនៃសមត្ថភាពរៀងរាល់ខែ
  • ពិនិត្យមើលសមត្ថភាពដែលមិនត្រូវបានចាត់ថ្នាក់ (unclassified abilities)
  • លុបការចូលប្រើសម្រាប់ដៃគូដែលមិនបានប្រើប្រាស់

ការកត់ត្រា និងការតាមដាន (Logging and Monitoring)​

  • តាមដានថាសមត្ថភាពណាដែលត្រូវបានប្រើច្រើនជាងគេ
  • តាមដានលំនាំនៃការចូលប្រើរបស់ដៃគូ
  • បង្ហាញការជូនដំណឹងអំពីការប្រើប្រាស់សមត្ថភាពមិនធម្មតា

សមត្ថភាពភាគីទីបី (Third-Party Abilities)​

  • ពិនិត្យមើលសមត្ថភាពភាគីទីបីមុនពេលបើកដំណើរការ
  • ចាត់ថ្នាក់វាឱ្យច្បាស់លាស់
  • ចាប់ផ្តើមដោយការមើលឃើញផ្ទៃក្នុង ឬដៃគូ (Internal or Partner visibility)
  • លើកកម្ពស់ទៅជាសាធារណៈ (Public) នៅពេលដែលបានពិនិត្យរួចហើយ

ការដោះស្រាយបញ្ហា​

មិនអាចបង្ហាញសមត្ថភាព (ability) នៅក្នុងបញ្ជីបានទេ

  • សូមពិនិត្យមើលថាតើសមត្ថភាពនោះត្រូវបានដំឡើង និងបើកដំណើរការហើយឬនៅ
  • ចុចមើលថាតើ plugin/addon នោះត្រូវបានបើកដំណើរការហើយឬនៅ
  • សូមធ្វើបច្ចុប្បន្នភាព (Refresh) ទំព័រ

ខ្ញុំមិនអាចផ្លាស់ប្តូរការមើលឃើញ (visibility) នៃសមត្ថភាពមួយបានទេ

  • សូមពិនិត្យមើលថាតើអ្នកមានសិទ្ធិជា administrator ឬអត់
  • ចុចមើលថាតើសមត្ថភាពនោះត្រូវបានរារាំងដោយ plugin ណាមួយឬអត់
  • សូមសាកល្បងបិទ plugin ដែលអាចនឹងជះឥទ្ធិពលគ្នា

ដៃគូ (partner) មិនអាចចូលប្រើសមត្ថភាពមួយបានទេ

  • សូមពិនិត្យមើលថាតើដៃគូនោះស្ថិតនៅក្នុងបញ្ជីអនុញ្ញាត (allow-list) ឬអត់
  • ចុចមើលថាតើសមត្ថភាពនោះត្រូវបានកំណត់ការមើលឃើញជា Partner ដែរឬទេ
  • សូមផ្ទៀងផ្ទាត់ថាព័ត៌មានសម្ងាត់ (credentials) របស់ដៃគូគឺត្រឹមត្រូវហើយឬនៅ
  • សូមពិនិត្យមើល API logs សម្រាប់កំហុសនៃការផ្ទៀងផ្ទាត់ (authentication errors)

សមត្ថភាពដែលមិនត្រូវបានចាត់ថ្នាក់បែងចែកនៅតែបង្ហាញឡើងវិញ

  • សូមពិនិត្យមើល និងចាត់ថ្នាក់ពួកវានៅក្នុង admin notice
  • សូមពិនិត្យមើលថាតើការចាត់ថ្នាក់របស់អ្នកត្រូវបានរក្សាទុកហើយឬនៅ
  • សូមផ្ទៀងផ្ទាត់ថាតើសមត្ថភាពដែលផ្តល់ដោយ plugin នោះគឺទាន់សម័យបំផុតឬអត់

ការផ្លាស់ប្តូរពីរបៀបចាស់ (Legacy Mode Migration)​

ប្រសិនបើអ្នកកំពុងធ្វើបច្ចុប្បន្នភាពពីកំណែចាស់នៃ Superdav AI Agent៖

  • សមត្ថភាពដែលមានស្រាប់ទាំងអស់នឹងត្រូវបានចាត់ថ្នាក់ជា Public ដោយស្វ័យប្រវត្តិ
  • សូមពិនិត្យមើល និងកែសម្រួលការមើលឃើញតាមតម្រូវការ
  • មិនចាំបាច់ធ្វើអ្វីទេ ប្រសិនបើអ្នកមិនចង់រឹតបន្តឹងការចូលប្រើនោះទេ

សូមមើល Third-Party Mode Migration ដើម្បីទទួលបានព័ត៌មានលម្អិតបន្ថែមអំពីការផ្លាស់ប្តូរទៅការរួមបញ្ចូល API នៃ Abilities ដែលជាធម្មជាតិ។

ជំហានបន្ទាប់ (Next Steps)​

បន្ទាប់ពីកំណត់ការមើលឃើញនៃសមត្ថភាពរួច៖

  1. ពិនិត្យមើលសមត្ថភាពរបស់អ្នក: ស៊ើបអង្កេតសមត្ថភាពទាំងអស់ដែលបានដំឡើង
  2. ចាត់ថ្នាក់សមត្ថភាពដែលមិនទាន់ត្រូវបានចាត់ថ្នាក់: ឆ្លើយតបទៅនឹង admin notices
  3. រៀបចំដៃគូ: បន្ថែមដៃគូ ប្រសិនបើអ្នកប្រើការមើលឃើញ Partner
  4. តាមដានការប្រើប្រាស់: កត់ត្រាថាតើសមត្ថភាពណាដែលត្រូវបានប្រើច្រើនជាងគេ
  5. កត់ត្រាចំណាត់វិធាន: រក្សាទុកកំណត់សម្គាល់អំពីមូលហេតុដែលអ្នកជ្រើសរើសកម្រិតនៃការមើលឃើញនីមួយៗ