អ្នកអភិវឌ្ឍន៍
ឯកសារយោងសមត្ថភាព Zinn® Chat
Zinn® Chat ចុះឈ្មោះសកម្មភាពរបស់ខ្លួនជាមួយនឹង WordPress Abilities API។ សមត្ថភាពដូចគ្នាគឺឧបករណ៍ MCP នៅលើម៉ាស៊ីនបម្រើផ្ទាល់ខ្លួនរបស់គេហទំព័រ និង REST routes ក្រោម /wp-json/wp-abilities/v1។ ទំព័រនេះត្រូវបានបង្កើតឡើងពីបញ្ជីឈ្មោះរបស់កម្មវិធីជំនួយផ្ទាល់។
ចំណុចបញ្ចប់
MCP តាមរយៈ HTTP (ដែលអាចចand stream បាន)
https://example.com/wp-json/zinn-chat/v1/mcpMCP តាមរយៈ WP-CLI (លទ្ធផល និងបច្ច័យស្តង់ដារ)
wp mcp-adapter serve --server=zinn-chat --user=<login>REST៖ បញ្ជីសមត្ថភាព
/wp-json/wp-abilities/v1/abilities?category=zinn-chatREST៖ ដំណើរការសមត្ថភាព
/wp-json/wp-abilities/v1/abilities/<name>/runការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ និងសិទ្ធិអំណាច
សំណើ HTTP ផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវជាមួយពាក្យសម្ងាត់កម្មវិធី WordPress (HTTP Basic)។ ការតភ្ជាប់ទៅកាន់ម៉ាស៊ីនមេ MCP ត្រូវការសមត្ថភាពដែលបង្ហាញខាងក្រោម។ បន្ទាប់មក សមត្ថភាពនីមួយៗពិនិត្យមើលសិទ្ធិផ្ទាល់ខ្លួន ក្នុងមួយគោលវត្ថុ។ សមត្ថភាពអានតែប៉ុណ្ណោះដំណើរការជាមួយ GET និងការបញ្ចូលរបស់វាគ្ហទំព័រក្នុងប្រអប់សំណួរ ចំណែកឯសមត្ថភាពផ្សេងទៀតដំណើរការជាមួយ POST និងតួ JSON {"input": {…}}។
ឧទាហរណ៍
# REST៖ ដំណើរការសមត្ថភាព
curl -u your-username:your-application-password \
"https://example.com/wp-json/wp-abilities/v1/abilities/zinn-chat/get-overview/run"# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-chat-get-overview","arguments":{}}}សមត្ថភាពទាំងអស់
បង្កើតចេញពី abilities.json របស់ជំនួយការ ដែលវាផ្ទាល់ត្រូវបានបង្កើតចេញពីគេហទំព័រដែលកំពុងដំណើរការ។ ការធ្វើតេស្តមួយបរាជ័យនៅពេលដែលរបស់ទាំងពីរនេះមិនស៊ីគ្នា។
| សមត្ថភាព | វាធ្វើអ្វីខ្លះ | ជំនាន់ | REST | សិទ្ធិ | ប៉ារ៉ាម៉ែត្រ |
|---|---|---|---|---|---|
zinn-chat/answer-ticketzinn-chat-answer-ticket | ឆ្លើយតបសំណួរជំនួយ ឆ្លើយតបទៅកាន់អតិថិជនតាមរយៈអ៊ីមែល (text) ឬបន្ថែមចំណាំផ្ទៃក្នុង (note: true) ហើយ status អាចផ្លាស់ប្តូរស្ថានភាពរបស់សំបុត្រជាជម្រើស។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/answer-ticket/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/ask-assistantzinn-chat-ask-assistant | សួរជំនួយការ សួរអ្នកជំនួយការ AI របស់គេហទំព័រនូវសំណួរមួយ ហើយបញ្ជូនចម្លើយរបស់វាត្រឡប់មកវិញ រួមជាមួយនឹងរាល់ប្រភពដែលវាបានរកឃើញ។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/ask-assistant/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/bulk-update-ticketszinn-chat-bulk-update-tickets | ផ្លាស់ប្តូរការគាំទ្រជាច្រើនក្នុងពេលតែមួយ (Pro) ផ្លាស់ប្តូរស្ថានភាព កម្រិតអទិភាព ឬអ្នកទទួលខុសត្រូវនៃសំបុត្រ (ids) រហូតដល់ 100។ សំបុត្រនីមួយៗឆ្លងកាត់ការពិនិត្យដូចគ្នានឹងការផ្លាស់ប្តូរវាដោយខ្លួនឯងដែរ ហើយលទ្ធផលនឹងបង្ហាញបញ្ជីសំបុត្រនីមួយៗ។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/bulk-update-tickets/run | zinn_chat_answer | ids: array (ទាមទារ), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer |
zinn-chat/chat-to-ticketzinn-chat-chat-to-ticket | ប្តូរការជជែកទៅជាទីតុក្កតា បើកសំបុត្រគាំទ្រពីការជជែកកំសាន្ត ដើម្បីវាអាចត្រូវបានឆ្លើយតបតាមអ៊ីមែល (ទាមទារអាសយដ្ឋានអ៊ីមែលរបស់អ្នកទស្សនា)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/chat-to-ticket/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/close-chatzinn-chat-close-chat | បិទការជជែក បញ្ចប់ការជជែកដេញដោល; អ្នកទស្សនានៅតែអាចស្នើសុំកំណត់ហេតុការសន្ទនាបាន។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/close-chat/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/create-ticketzinn-chat-create-ticket | បើកសំណើជំនួយ បើកសំបុត្រជំនួយក្នុងនាមអតិថិជន (អ៊ីមែល ប្រធានបទ និងសារដំបូងរបស់ពួកគេ)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/create-ticket/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/delete-canned-replyzinn-chat-delete-canned-reply | លុបចម្លើយដែលបានរក្សាទុក (Pro) លុបចោលការឆ្លើយតបដែលបានរក្សាទុក។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/delete-canned-reply/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/delete-ticketzinn-chat-delete-ticket | លុបសំបុត្រសំណួរ លុបទីតុក្ក និងកិច្ចសន្ទនារបស់វាចោលជាអចិន្ត្រៃយ៍ (សម្រាប់តែអ្នកគ្រប់គ្រងប៉ុណ្ណោះ)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/delete-ticket/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/draft-kb-articlezinn-chat-draft-kb-article | ព្រាងអត្ថបទជំនួយពីសំបុត្រគាំទ្រ (Pro) សរសេរអត្ថបទពង្រឹងចំណេះដឹងព្យាករណ៍ពីសំណើសុំជំនួយដែលបានដោះស្រាយ។ វាស្ថិតក្នុងទម្រង់ជាសេចក្តីព្រាងរហូតដល់មានអ្នកផ្សាយវា។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/draft-kb-article/run | edit_posts (the REST route's own check) | គ្មាន |
zinn-chat/draft-kb-from-gapszinn-chat-draft-kb-from-gaps | សរសេរបឋមកិច្ចការជំនួយសម្រាប់សំណួរដែលមិនទាន់បានឆ្លើយ (Pro) សរសេរសេចក្តីព្រាងអត្ថបទមូលដ្ឋានចំណេះដឹងដែលឆ្លើយសំណួរដែលបានជ្រើសរើស (ids) ពួកវានៅតែជាសេចក្តីព្រាង។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/draft-kb-from-gaps/run | edit_posts (the REST route's own check) | គ្មាន |
zinn-chat/fill-canned-replyzinn-chat-fill-canned-reply | បំពេញចម្លើយដែលបានរក្សាទុក (Pro) បញ្ជូនត្រឡប់អត្ថបទនៃចម្លើយដែលបានរក្សាទុក ដោយបានបំពេញចន្លោះជំនួសសម្រាប់ជជែក ឬសំបុត្រមួយ។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/fill-canned-reply/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/get-chatzinn-chat-get-chat | អានការជជែក សងសារជាវ និងព័ត៌មានលម្អិតរបស់អ្នកទស្សនាពីការជជែកមួយ (after៖ មានតែសារថ្មីជាងលេខសម្គាល់នេះ)។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-chat/get-chat/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/get-overviewzinn-chat-get-overview | អានទិដ្ឋភាពទូទៅនៃការគាំទ្រ ត្រឡប់មកវិញនូវចំនួនសំបុត្រដែលមាននៅក្នុងស្ថានភាពនីមួយៗ និងចំនួនការសន្ទនាដែលកំពុងរង់ចាំមនុស្ស (រួមទាំងសារដែលមិនទាន់អានរបស់ពួកគេ) ព្រមទាំងបង្ហាញថាការសន្ទនា ជំនួយការ និងសំបុត្រ ត្រូវបានបើកដំណើរការដែរឬទេ។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-chat/get-overview/run | zinn_chat_answer | គ្មាន |
zinn-chat/get-settingszinn-chat-get-settings | អានការកំណត់ការជជែក ប្រគល់រាល់ការកំណត់ជជែកទាំងអស់៖ កម្មវិធីតូច (widget) ជំនួយការ មនុស្ស និងម៉ោងធ្វើការ សំបុត្រ និងអ៊ីមែល លិបិក្រមគេហទំព័រ ភាពឯកជន និងសារឥតបានការ។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | គ្មាន |
zinn-chat/get-statszinn-chat-get-stats | អានស្ថិតិជំនួយ (Pro) បង្ហាញចំនួនការជជែកផ្ទាល់ និងសំបុត្រគាំទ្រ រយៈពេលឆ្លើយតប និងការវាយតម្លៃសម្រាប់ N ថ្ងៃចុងក្រោយ (ថ្ងៃ)។ | បោះពុម្ព Pro | GET …/abilities/zinn-chat/get-stats/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/get-ticketzinn-chat-get-ticket | អានសំបុត្រគាំទ្រ បញ្ជូនត្រឡប់សំបុត្រមួយដែលមានការសន្ទនាទាំងមូល ស្ថានភាព អាទិភាព និងអ្នកទទួលខុសត្រូវរបស់វា។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-chat/get-ticket/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/hand-chat-to-assistantzinn-chat-hand-chat-to-assistant | ប្រគល់ការជជែកត្រឡប់ទៅជំនួយការវិញ បញ្ជូនការជជែកទៅកាន់ជំនួយការ AI ដែលនឹងឆ្លើយតបអ្នកទស្សនាផ្អែកលើខ្លឹមសាររបស់គេហទំព័រ។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/hand-chat-to-assistant/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/list-canned-replieszinn-chat-list-canned-replies | បង្ហាញចម្លើយដែលបានរក្សាទុក (Pro) រាយបញ្ជីចម្លើយដែលបានរក្សាទុក ដែលភ្នាក់ងារអាចបញ្ជូលបាន ព្រមទាំងផ្លូវកាត់របស់វា។ | បោះពុម្ព Pro | GET …/abilities/zinn-chat/list-canned-replies/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/list-chatszinn-chat-list-chats | បង្ហាញការជជែកផ្ទាល់ រាយបញ្ជីការជជែកដែលកំពុងរង់ចាំ កំពុងដំណើរការ និងទើបតែបានបិទថ្មីៗនេះ រួមទាំងអ្នកដែលកំពុងគ្រប់គ្រងនីមួយៗ។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-chat/list-chats/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/list-indexed-contentzinn-chat-list-indexed-content | រាយបញ្ជីអ្វីដែលជំនួយការដឹង បង្ហាញបញ្ជីមាតិកាដែលជំនួយការឆ្លើយតប ដោយរួមបញ្ចូលទាំងស្ថានភាពលិបិក្រមរបស់វា ក្នុងមួយទំព័រម្ដង។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-chat/list-indexed-content/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/list-kb-gapszinn-chat-list-kb-gaps | បញ្ជីសំណួរដែលពុំទាន់បានឆ្លើយ (Pro) បង្ហាញបញ្ជីសំណួរដែលអ្នកចូលទស្សនាបានសួរ ប៉ុន្តែមូលដ្ឋានចំណេះដឹងមិនអាចឆ្លើយបាន។ | បោះពុម្ព Pro | GET …/abilities/zinn-chat/list-kb-gaps/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/list-ticketszinn-chat-list-tickets | បញ្ជីសំបុត្រសំណូមពរ បង្ហាញបញ្ជីសំបុត្រជំនួយ ដែលបានត្រងតាមស្ថានភាព ឬការស្វែងរក ម្ដងមួយទំព័រ។ | ជំនាន់ឥតគិតថ្លៃ | GET …/abilities/zinn-chat/list-tickets/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/reembed-contentzinn-chat-reembed-content | បង្កើតលិបិក្រមស្វែងរករបស់ជំនួយការឡើងវិញ បង្កើតវ៉ិចទ័រស្វែងរកឡើងវិញសម្រាប់ធាតុមួយ (item_id) ឬទាំងអស់ (all: true) (សម្រាប់តែអ្នកគ្រប់គ្រងប៉ុណ្ណោះ)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/reembed-content/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/reindex-contentzinn-chat-reindex-content | អានមាតិកាឡើងវិញចូលទៅក្នុងជំនួយការ អានធាតុមួយឡើងវិញ (item_id) ឬអ្វីៗទាំងអស់ (all: true) ចូលទៅក្នុងលិបិក្រមរបស់ជំនួយការ (សម្រាប់តែអ្នកគ្រប់គ្រងប៉ុណ្ណោះ)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/reindex-content/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/reply-chatzinn-chat-reply-chat | ឆ្លើយតបក្នុងការជជែកកំសាន្ត ផ្ញើសារទៅកាន់អ្នកទស្សនា (text) ឬបន្ថែមចំណាំផ្ទៃក្នុងដែលមើលឃើញតែដោយភ្នាក់ងារប៉ុណ្ណោះ (note: true)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/reply-chat/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/save-canned-replyzinn-chat-save-canned-reply | រក្សាទុកការឆ្លើយតបដែលបានរក្សាទុក (Pro) បង្កើត ឬផ្លាស់ប្តូរចម្លើយដែលបានរក្សាទុក (ចំណងជើង អក្សរកាត់តម្រូវ ខ្លឹមសារ ផ្នែក; លេខសម្គាល់សម្រាប់កែប្រែមួយ)។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/save-canned-reply/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/save-kb-articlezinn-chat-save-kb-article | សរសេរអត្ថបទជំនួយ (Pro) បង្កើតអត្ថបទមូលដ្ឋានចំណេះដឹងមួយ ឬកែប្រែមួយ (id)៖ ចំណងជើង មាតិកា សេចក្តីសង្ខេប ប្រភេទ និងស្ថានភាព (សេចក្តីព្រាង ឬផ្សាយពេលដែលអ្នកអាចផ្សាយបាន)។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/save-kb-article/run | edit_posts | id: integer, title: string, content: string, excerpt: string, categories: array, status: draft|publish |
zinn-chat/search-kbzinn-chat-search-kb | ស្វែងរកមូលដ្ឋានចំណេះដឹង (Pro) ស្វែងរកអត្ថបទជំនួយដើម្បីភ្ជាប់ក្នុងសារឆ្លើយតប (q: ការស្វែងរក)។ | បោះពុម្ព Pro | GET …/abilities/zinn-chat/search-kb/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/set-conversation-detailszinn-chat-set-conversation-details | កំណត់ផ្នែកនិងស្លាកនៃការសន្ទនា (Pro) កំណត់ផ្នែក និងស្លាកនៃជជែក ឬសំបុត្រ (ប្រភេទ៖ ជជែក ឬសំបុត្រ; id)។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/set-conversation-details/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/set-kb-gap-statuszinn-chat-set-kb-gap-status | ចំណាំសំណួរដែលមិនទាន់បានឆ្លើយ (Pro) សម្គាល់សំណួរដែលមិនទាន់បានឆ្លើយថាជាបើកចំហ បានគ្រោងទុក ឬបានច្រានចោល (លេខសម្គាល់ ស្ថានភាព)។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/set-kb-gap-status/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/set-presencezinn-chat-set-presence | កំណត់ភាពទំនេររបស់អ្នក កំណត់ភ្នាក់ងារដែលបានចូលប្រព័ន្ធថាមានវត្តមាន ឬអវត្តមានសម្រាប់ជជែកកំសាន្តថ្មី (away: true ឬ false)។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/set-presence/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/suggest-replyzinn-chat-suggest-reply | សwងគូសពាក្យឆ្លើយតបដោយប្រើ AI (Pro) ព្រាងចម្លើយតបទៅកាន់ការជជែកដេញដោល ឬសំបុត្រគាំទ្រពីមាតិកាគេហទំព័រ ដោយគ្មានការបញ្ជូនចេញអ្វីទាំងអស់។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/suggest-reply/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/summarise-conversationzinn-chat-summarise-conversation | សង្ខេបការសន្ទនាជាមួយ AI (Pro) សង្ខេបការជជែក ឬសំបុត្រគាំទ្រក្នុងរយៈពេលប៉ុន្មានបន្ទាត់។ | បោះពុម្ព Pro | POST …/abilities/zinn-chat/summarise-conversation/run | the REST route's own per-item permission check | គ្មាន |
zinn-chat/take-chatzinn-chat-take-chat | ចាប់ផ្តើមការជជែក កំណត់ការជជែកដែលកំពុងរង់ចាំឱ្យភ្នាក់ងារដែលបានចូលប្រព័ន្ធ ដើម្បីឱ្យអ្នកទស្សនាអាចនិយាយផ្ទាល់ជាមួយមនុស្សបាន។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/take-chat/run | the REST route's own per-item permission check | id: string (ទាមទារ) |
zinn-chat/update-settingszinn-chat-update-settings | ផ្លាស់ប្តូរការកំណត់ជជែក ផ្លាស់ប្ដូរការកំណត់ដែលអ្នកផ្ញើ (ការកំណត់៖ សោរទៅតម្លៃ) និងរក្សាការកំណត់ដែលនៅសល់។ តម្លៃនីមួយៗត្រូវបានពិនិត្យយ៉ាងពិតប្រាកដដូចនៅលើអេក្រង់ការកំណត់ដែរ។ get-settings រាយបញ្ជីសោរ។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/update-settings/run | zinn_chat_manage | settings: object (ទាមទារ) |
zinn-chat/update-ticketzinn-chat-update-ticket | ផ្លាស់ប្តូរសំបុត្រសំណូមពរ ផ្លាស់ប្តូរស្ថានភាព ភាពបន្ទាន់ ឬអ្នកទទួលបន្ទុករបស់សំបុត្រសំណូមពរ។ | ជំនាន់ឥតគិតថ្លៃ | POST …/abilities/zinn-chat/update-ticket/run | the REST route's own per-item permission check | id: string (ទាមទារ) |