Ծրագրավորողներ
Zinn® Chat-ի հնարավորությունների ուղեցույց
Zinn® Chat-ը գրանցում է իր գործողությունները WordPress Abilities API-ում: Նույն հնարավորությունները MCP գործիքներ են կայքի սեփական սերվերում և REST երթուղիներ՝ /wp-json/wp-abilities/v1 հասցեով: Այս էջը գեներացվում է հավելվածի սեփական գրանցամատյանից:
Վերջնակետեր
MCP HTTP-ի միջոցով (հոսքային)
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":{}}}Բոլոր հնարավորությունները
Ստեղծված է plugin-ի 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) Փոխում է մինչև 100 տոմսերի (id-ների) կարգավիճակը, առաջնահերթությունը կամ պատասխանատուին: Յուրաքանչյուր տոմս անցնում է նույն ստուգումները, ինչ առանձին փոխելու դեպքում. արդյունքում նշվում է յուրաքանչյուրը: | 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՝ միայն այս ID-ից նոր հաղորդագրությունները): | Անվճար տարբերակ | 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 օրերի (օր) համար: | 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) Ստեղծում կամ փոխում է պահպանված պատասխանը (վերնագիր, դյուրանցում, բնագիր, բաժին. id՝ որևէ մեկը փոխելու համար): | 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) Չպատասխանված հարցերը նշում է որպես բաց, պլանավորված կամ մերժված (id-ներ, կարգավիճակ): | 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 | Սևագրել պատասխանը արհեստական բանականությամբ (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 | Փոխել չատի կարգավորումները Փոխում է ձեր ուղարկված կարգավորումները (կարգավորումներ՝ բանալին արժեքին) և պահպանում մնացածը։ Jուրաքանչյուր արժեք ստուգվում է ճիշտ այնպես, ինչպես կարգավորումների էկրանին. 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 (պարտադիր) |