អ្នកអភិវឌ្ឍន៍

ឯកសារយោងសមត្ថភាព Zinn® Chat

Zinn® Chat ចុះឈ្មោះសកម្មភាពរបស់ខ្លួនជាមួយនឹង WordPress Abilities API។ សមត្ថភាពដូចគ្នាគឺឧបករណ៍ MCP នៅលើម៉ាស៊ីនបម្រើផ្ទាល់ខ្លួនរបស់គេហទំព័រ និង REST routes ក្រោម /wp-json/wp-abilities/v1។ ទំព័រនេះត្រូវបានបង្កើតឡើងពីបញ្ជីឈ្មោះរបស់កម្មវិធីជំនួយផ្ទាល់។

សៀវភៅដៃអ្នកប្រើ៖ ភ្ជាប់កម្មវិធី AI មួយ

ចំណុចបញ្ចប់

MCP តាមរយៈ HTTP (ដែលអាចចand stream បាន)

https://example.com/wp-json/zinn-chat/v1/mcp

MCP តាមរយៈ WP-CLI (លទ្ធផល និងបច្ច័យស្តង់ដារ)

wp mcp-adapter serve --server=zinn-chat --user=<login>

REST៖ បញ្ជីសមត្ថភាព

/wp-json/wp-abilities/v1/abilities?category=zinn-chat

REST៖ ដំណើរការសមត្ថភាព

/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-ticket
zinn-chat-answer-ticket
ឆ្លើយតបសំណួរជំនួយ
ឆ្លើយតបទៅកាន់អតិថិជនតាមរយៈអ៊ីមែល (text) ឬបន្ថែមចំណាំផ្ទៃក្នុង (note: true) ហើយ status អាចផ្លាស់ប្តូរស្ថានភាពរបស់សំបុត្រជាជម្រើស។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
សួរជំនួយការ
សួរអ្នកជំនួយការ AI របស់គេហទំព័រនូវសំណួរមួយ ហើយបញ្ជូនចម្លើយរបស់វាត្រឡប់មកវិញ រួមជាមួយនឹងរាល់ប្រភពដែលវាបានរកឃើញ។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
ផ្លាស់ប្តូរការគាំទ្រជាច្រើនក្នុងពេលតែមួយ (Pro)
ផ្លាស់ប្តូរស្ថានភាព កម្រិតអទិភាព ឬអ្នកទទួលខុសត្រូវនៃសំបុត្រ (ids) រហូតដល់ 100។ សំបុត្រនីមួយៗឆ្លងកាត់ការពិនិត្យដូចគ្នានឹងការផ្លាស់ប្តូរវាដោយខ្លួនឯងដែរ ហើយលទ្ធផលនឹងបង្ហាញបញ្ជីសំបុត្រនីមួយៗ។
បោះពុម្ព ProPOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (ទាមទារ), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-chat-chat-to-ticket
ប្តូរការជជែកទៅជាទីតុក្កតា
បើកសំបុត្រគាំទ្រពីការជជែកកំសាន្ត ដើម្បីវាអាចត្រូវបានឆ្លើយតបតាមអ៊ីមែល (ទាមទារអាសយដ្ឋានអ៊ីមែលរបស់អ្នកទស្សនា)។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/chat-to-ticket/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/close-chat
zinn-chat-close-chat
បិទការជជែក
បញ្ចប់ការជជែកដេញដោល; អ្នកទស្សនានៅតែអាចស្នើសុំកំណត់ហេតុការសន្ទនាបាន។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/create-ticket
zinn-chat-create-ticket
បើកសំណើជំនួយ
បើកសំបុត្រជំនួយក្នុងនាមអតិថិជន (អ៊ីមែល ប្រធានបទ និងសារដំបូងរបស់ពួកគេ)។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
លុបចម្លើយដែលបានរក្សាទុក (Pro)
លុបចោល​ការឆ្លើយតប​ដែល​បាន​រក្សាទុក។
បោះពុម្ព ProPOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
លុបសំបុត្រសំណួរ
លុបទីតុក្ក និងកិច្ចសន្ទនារបស់វាចោលជាអចិន្ត្រៃយ៍ (សម្រាប់តែអ្នកគ្រប់គ្រងប៉ុណ្ណោះ)។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
ព្រាងអត្ថបទជំនួយពីសំបុត្រគាំទ្រ (Pro)
សរសេរអត្ថបទពង្រឹងចំណេះដឹងព្យាករណ៍ពីសំណើសុំជំនួយដែលបានដោះស្រាយ។ វាស្ថិតក្នុងទម្រង់ជាសេចក្តីព្រាងរហូតដល់មានអ្នកផ្សាយវា។
បោះពុម្ព ProPOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)គ្មាន
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
សរសេរបឋមកិច្ចការជំនួយសម្រាប់សំណួរដែលមិនទាន់បានឆ្លើយ (Pro)
សរសេរសេចក្តីព្រាងអត្ថបទមូលដ្ឋានចំណេះដឹងដែលឆ្លើយសំណួរដែលបានជ្រើសរើស (ids) ពួកវានៅតែជាសេចក្តីព្រាង។
បោះពុម្ព ProPOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)គ្មាន
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
បំពេញចម្លើយដែលបានរក្សាទុក (Pro)
បញ្ជូនត្រឡប់អត្ថបទនៃចម្លើយដែលបានរក្សាទុក ដោយបានបំពេញចន្លោះជំនួសសម្រាប់ជជែក ឬសំបុត្រមួយ។
បោះពុម្ព ProPOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/get-chat
zinn-chat-get-chat
អានការជជែក
សងសារជាវ និងព័ត៌មានលម្អិតរបស់អ្នកទស្សនាពីការជជែកមួយ (after៖ មានតែសារថ្មីជាងលេខសម្គាល់នេះ)។
ជំនាន់ឥតគិតថ្លៃGET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/get-overview
zinn-chat-get-overview
អានទិដ្ឋភាពទូទៅនៃការគាំទ្រ
ត្រឡប់មកវិញនូវចំនួនសំបុត្រដែលមាននៅក្នុងស្ថានភាពនីមួយៗ និងចំនួនការសន្ទនាដែលកំពុងរង់ចាំមនុស្ស (រួមទាំងសារដែលមិនទាន់អានរបស់ពួកគេ) ព្រមទាំងបង្ហាញថាការសន្ទនា ជំនួយការ និងសំបុត្រ ត្រូវបានបើកដំណើរការដែរឬទេ។
ជំនាន់ឥតគិតថ្លៃGET …/abilities/zinn-chat/get-overview/runzinn_chat_answerគ្មាន
zinn-chat/get-settings
zinn-chat-get-settings
អានការកំណត់ការជជែក
ប្រគល់រាល់ការកំណត់ជជែកទាំងអស់៖ កម្មវិធីតូច (widget) ជំនួយការ មនុស្ស និងម៉ោងធ្វើការ សំបុត្រ និងអ៊ីមែល លិបិក្រមគេហទំព័រ ភាពឯកជន និងសារឥតបានការ។
ជំនាន់ឥតគិតថ្លៃGET …/abilities/zinn-chat/get-settings/runzinn_chat_manageគ្មាន
zinn-chat/get-stats
zinn-chat-get-stats
អានស្ថិតិជំនួយ (Pro)
បង្ហាញចំនួនការជជែកផ្ទាល់ និងសំបុត្រគាំទ្រ រយៈពេលឆ្លើយតប និងការវាយតម្លៃសម្រាប់ N ថ្ងៃចុងក្រោយ (ថ្ងៃ)។
បោះពុម្ព ProGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/get-ticket
zinn-chat-get-ticket
អានសំបុត្រគាំទ្រ
បញ្ជូនត្រឡប់សំបុត្រមួយដែលមានការសន្ទនាទាំងមូល ស្ថានភាព អាទិភាព និងអ្នកទទួលខុសត្រូវរបស់វា។
ជំនាន់ឥតគិតថ្លៃGET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
ប្រគល់ការជជែកត្រឡប់ទៅជំនួយការវិញ
បញ្ជូនការជជែកទៅកាន់ជំនួយការ AI ដែលនឹងឆ្លើយតបអ្នកទស្សនាផ្អែកលើខ្លឹមសាររបស់គេហទំព័រ។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
បង្ហាញចម្លើយដែលបានរក្សាទុក (Pro)
រាយបញ្ជីចម្លើយដែលបានរក្សាទុក ដែលភ្នាក់ងារអាចបញ្ជូលបាន ព្រមទាំងផ្លូវកាត់របស់វា។
បោះពុម្ព ProGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/list-chats
zinn-chat-list-chats
បង្ហាញការជជែកផ្ទាល់
រាយបញ្ជីការជជែកដែលកំពុងរង់ចាំ កំពុងដំណើរការ និងទើបតែបានបិទថ្មីៗនេះ រួមទាំងអ្នកដែលកំពុងគ្រប់គ្រងនីមួយៗ។
ជំនាន់ឥតគិតថ្លៃGET …/abilities/zinn-chat/list-chats/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/list-indexed-content
zinn-chat-list-indexed-content
រាយបញ្ជីអ្វីដែលជំនួយការដឹង
បង្ហាញបញ្ជីមាតិកាដែលជំនួយការឆ្លើយតប ដោយរួមបញ្ចូលទាំងស្ថានភាពលិបិក្រមរបស់វា ក្នុងមួយទំព័រម្ដង។
ជំនាន់ឥតគិតថ្លៃGET …/abilities/zinn-chat/list-indexed-content/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
បញ្ជីសំណួរដែលពុំទាន់បានឆ្លើយ (Pro)
បង្ហាញបញ្ជីសំណួរដែលអ្នកចូលទស្សនាបានសួរ ប៉ុន្តែមូលដ្ឋានចំណេះដឹងមិនអាចឆ្លើយបាន។
បោះពុម្ព ProGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/list-tickets
zinn-chat-list-tickets
បញ្ជីសំបុត្រសំណូមពរ
បង្ហាញបញ្ជីសំបុត្រជំនួយ ដែលបានត្រងតាមស្ថានភាព ឬការស្វែងរក ម្ដងមួយទំព័រ។
ជំនាន់ឥតគិតថ្លៃGET …/abilities/zinn-chat/list-tickets/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/reembed-content
zinn-chat-reembed-content
បង្កើតលិបិក្រមស្វែងរករបស់ជំនួយការឡើងវិញ
បង្កើតវ៉ិចទ័រស្វែងរកឡើងវិញសម្រាប់ធាតុមួយ (item_id) ឬទាំងអស់ (all: true) (សម្រាប់តែអ្នកគ្រប់គ្រងប៉ុណ្ណោះ)។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/reembed-content/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/reindex-content
zinn-chat-reindex-content
អានមាតិកាឡើងវិញចូលទៅក្នុងជំនួយការ
អានធាតុមួយឡើងវិញ (item_id) ឬអ្វីៗទាំងអស់ (all: true) ចូលទៅក្នុងលិបិក្រមរបស់ជំនួយការ (សម្រាប់តែអ្នកគ្រប់គ្រងប៉ុណ្ណោះ)។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/reindex-content/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/reply-chat
zinn-chat-reply-chat
ឆ្លើយតបក្នុងការជជែកកំសាន្ត
ផ្ញើសារទៅកាន់អ្នកទស្សនា (text) ឬបន្ថែមចំណាំផ្ទៃក្នុងដែលមើលឃើញតែដោយភ្នាក់ងារប៉ុណ្ណោះ (note: true)។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
រក្សាទុកការឆ្លើយតបដែលបានរក្សាទុក (Pro)
បង្កើត ឬផ្លាស់ប្តូរចម្លើយដែលបានរក្សាទុក (ចំណងជើង អក្សរកាត់តម្រូវ ខ្លឹមសារ ផ្នែក; លេខសម្គាល់សម្រាប់កែប្រែមួយ)។
បោះពុម្ព ProPOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/save-kb-article
zinn-chat-save-kb-article
សរសេរអត្ថបទជំនួយ (Pro)
បង្កើតអត្ថបទមូលដ្ឋានចំណេះដឹងមួយ ឬកែប្រែមួយ (id)៖ ចំណងជើង មាតិកា សេចក្តីសង្ខេប ប្រភេទ និងស្ថានភាព (សេចក្តីព្រាង ឬផ្សាយពេលដែលអ្នកអាចផ្សាយបាន)។
បោះពុម្ព ProPOST …/abilities/zinn-chat/save-kb-article/runedit_postsid: integer, title: string, content: string, excerpt: string, categories: array, status: draft|publish
zinn-chat/search-kb
zinn-chat-search-kb
ស្វែងរកមូលដ្ឋានចំណេះដឹង (Pro)
ស្វែងរកអត្ថបទជំនួយដើម្បីភ្ជាប់ក្នុងសារឆ្លើយតប (q: ការស្វែងរក)។
បោះពុម្ព ProGET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
កំណត់ផ្នែកនិងស្លាកនៃការសន្ទនា (Pro)
កំណត់ផ្នែក និងស្លាកនៃជជែក ឬសំបុត្រ (ប្រភេទ៖ ជជែក ឬសំបុត្រ; id)។
បោះពុម្ព ProPOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
ចំណាំសំណួរដែលមិនទាន់បានឆ្លើយ (Pro)
សម្គាល់សំណួរដែលមិនទាន់បានឆ្លើយថាជាបើកចំហ បានគ្រោងទុក ឬបានច្រានចោល (លេខសម្គាល់ ស្ថានភាព)។
បោះពុម្ព ProPOST …/abilities/zinn-chat/set-kb-gap-status/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/set-presence
zinn-chat-set-presence
កំណត់ភាពទំនេររបស់អ្នក
កំណត់ភ្នាក់ងារដែលបានចូលប្រព័ន្ធថាមានវត្តមាន ឬអវត្តមានសម្រាប់ជជែកកំសាន្តថ្មី (away: true ឬ false)។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/set-presence/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/suggest-reply
zinn-chat-suggest-reply
សwងគូសពាក្យឆ្លើយតបដោយប្រើ AI (Pro)
ព្រាងចម្លើយតបទៅកាន់ការជជែកដេញដោល ឬសំបុត្រគាំទ្រពីមាតិកាគេហទំព័រ ដោយគ្មានការបញ្ជូនចេញអ្វីទាំងអស់។
បោះពុម្ព ProPOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
សង្ខេបការសន្ទនាជាមួយ AI (Pro)
សង្ខេបការជជែក ឬសំបុត្រគាំទ្រក្នុងរយៈពេលប៉ុន្មានបន្ទាត់។
បោះពុម្ព ProPOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkគ្មាន
zinn-chat/take-chat
zinn-chat-take-chat
ចាប់ផ្តើមការជជែក
កំណត់ការជជែកដែលកំពុងរង់ចាំឱ្យភ្នាក់ងារដែលបានចូលប្រព័ន្ធ ដើម្បីឱ្យអ្នកទស្សនាអាចនិយាយផ្ទាល់ជាមួយមនុស្សបាន។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (ទាមទារ)
zinn-chat/update-settings
zinn-chat-update-settings
ផ្លាស់ប្តូរការកំណត់ជជែក
ផ្លាស់ប្ដូរការកំណត់ដែលអ្នកផ្ញើ (ការកំណត់៖ សោរទៅតម្លៃ) និងរក្សាការកំណត់ដែលនៅសល់។ តម្លៃនីមួយៗត្រូវបានពិនិត្យយ៉ាងពិតប្រាកដដូចនៅលើអេក្រង់ការកំណត់ដែរ។ get-settings រាយបញ្ជីសោរ។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (ទាមទារ)
zinn-chat/update-ticket
zinn-chat-update-ticket
ផ្លាស់ប្តូរសំបុត្រសំណូមពរ
ផ្លាស់ប្តូរស្ថានភាព ភាពបន្ទាន់ ឬអ្នកទទួលបន្ទុករបស់សំបុត្រសំណូមពរ។
ជំនាន់ឥតគិតថ្លៃPOST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: string (ទាមទារ)