پراخه کونکي
د Zinn® Chat وړتیاوې حواله
Zinn® Chat خپل کړنې د WordPress Abilities API سره ثبتوي. ورته وړتیاوې د سایټ په خپل سرور کې د MCP وسیلې او د /wp-json/wp-abilities/v1 لاندې د REST لارې دي. دا پاڼه د پلگ ان د خپل راجستر څخه جوړه شوې ده.
پای ټکي
د HTTP له لارې MCP (د سیند وړ)
https://example.com/wp-json/zinn-chat/v1/mcpد WP-CLI له لارې MCP (معیاري ان پټ او آوټ پټ)
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 او د هغو ورودی په پوښتنې پټه (query string) کې چلیږي؛ نورې د 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)؛ حالت په اختیاري توګه د ټکټ حالت بدلوي. | وړیا نسخه | 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 | له مرستیال څخه پوښتنه وکړئ د سایټ د مصنوعي استخباراتو مرستیال څخه پوښتنه کوي او د هغې ځواب د ټولو هغو سرچینو سره راستنوي چې هغه موندلي دي. | وړیا نسخه | 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) حالت، لومړیتوب یا مؤظف کس بدلوي. هر ټکټ د هغو چکونو له لارې تیریږي چې د خپلواک بدلون په وخت کې پرې کیږي؛ پایله یې هر یو په ګوته کوي. | پرو نسخه | 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) saved reply حذفوي. | پرو نسخه | 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) د حل شوي ټکټ څخه د پوهې د اډې (knowledge-base) د مسودې مقاله لیکي؛ دا تر هغه وخته مسوده پاتې کیږي ترڅو چې یو څوک یې خپره کړي. | پرو نسخه | 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) د پوهې د اډې (knowledge-base) مسوده مقالې چې ټاکل شوې پوښتنې (شناسې) ځوابوي، لیکي؛ دوی مسودې پاتې کیږي. | پرو نسخه | 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) د یو چیټ یا ټکټ لپاره د ځای پر ځای شویو نښو (placeholder) په ډکولو سره د یوه خوندي شوي ځواب متن بیرته راګرځوي. | پرو نسخه | 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 | چټ ولولئ د یوو چټ پیغامونه او د لیدونکي تفصیالت بیرته راګرځوي (وروسته: یوازې د دې آی ډي څخه نوي پیغامونه). | وړیا نسخه | 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 | د چپې تنظیمات ولولئ د خبرو اترو ټول تنظیمات بیرته راګرځوي: ویجټ، مرستیال، خلک او د پرانیستلو ساعتونه، ټکټونه او برېښنالیک، د سایټ شاخص، محرمیت او سپیم. | وړیا نسخه | GET …/abilities/zinn-chat/get-settings/run | zinn_chat_manage | هیڅ یو |
zinn-chat/get-statszinn-chat-get-stats | د ملاتړ احصایې ولولئ (Pro) د تیرو N ورځو لپاره د چیټ او ټکټ شمیرې، د ځواب ویلو وختونه او درجه بندي بیرته راګرځوي (ورځې). | پرو نسخه | 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) هغه خوندي شوي ځوابونه لیست کوي چې استازي یې د لنډلارو سره داخلولی شي. | پرو نسخه | 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) د هغه پوښتنو لست کوي چې لیدونکو کړې وې او پوهنغونډ یې ځواب نه شو ورکولای. | پرو نسخه | 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) یوه خوندي شوې ځوابیه جوړوي یا بدلوي (سرلیک، شارټ کټ، متن، څانګه؛ د یو د بدلولو لپاره آی ډي). | پرو نسخه | 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): سرلیک، منځپانګه، لنډیز، کټګورۍ او حالت (مسوده، یا خپرول کله چې تاسو خپرولی شئ). | پرو نسخه | 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: لټون). | پرو نسخه | 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). | پرو نسخه | 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) نامعلوم پوښتنې د پرانیستې، پلان شوې یا رد شوې په توګه په نښه کوي (ids، status). | پرو نسخه | 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 | خپله شتون وټاکئ د نویو خبرو اترو لپاره لاسلیک شوی استازی شتون لرونکی یا لیرې په نښه کوي (لیرې: 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 | د AI په مرسته ځواب مسوده کړئ (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) یوې خبرې اترې یا ټکټ په څو کرښو کې لنډوي. | پرو نسخه | POST …/abilities/zinn-chat/summarise-conversation/run | the REST route's own per-item permission check | هیڅ یو |
zinn-chat/take-chatzinn-chat-take-chat | 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 (ضروري) |