Әзірлеушілер

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 (standard input және standard output)

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 әдісімен және {"input": {…}} JSON негізгі бөлігімен жұмыс істейді.

Мысалдар

# 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`	Тикетке жауап беру Клиентке электрондық пошта арқылы жауап береді (мәтін) немесе ішкі жазба қосады (note: true); күйі міндетті емес тіркелген билеттің күйін өзгертеді.	Тегін шығарылым	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (міндетті)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Көмекшіге сұрақ қою Сайттың AI көмекшісіне сұрақ қояды және ол тапқан әрбір дереккөзбен бірге жауабын қайтарады.	Тегін шығарылым	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	жоқ
`zinn-chat/bulk-update-tickets` `zinn-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-ticket` `zinn-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-chat` `zinn-chat-close-chat`	Чатты жабу Чатты аяқтайды; келуші әлі де көшірмесін сұрай алады.	Тегін шығарылым	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (міндетті)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Тикет ашу Тұтынушының атынан тикет ашады (оның электрондық поштасы, тақырыбы және бірінші хабарламасы).	Тегін шығарылым	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	жоқ
`zinn-chat/delete-canned-reply` `zinn-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-ticket` `zinn-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-article` `zinn-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-gaps` `zinn-chat-draft-kb-from-gaps`	Жауапсыз қалған сұрақтарға арналған анықтамалық мақалалардың жобасын жасау (Pro) Таңдалған сұрақтарға (id) жауап беретін білім базасының мақала жобаларын жазады; олар жоба күйінде қалады.	Pro шығарылымы	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	жоқ
`zinn-chat/fill-canned-reply` `zinn-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-chat` `zinn-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-overview` `zinn-chat-get-overview`	Қолдау көрсету шолуын оқу Әр күйде қанша билет бар екенін, қанша чат адамды күтіп тұрғанын (және олардың оқылмаған хабарларын), сондай-ақ чат, көмекші мен билеттердің қосылғанын не қосылмағанын қайтарады.	Тегін шығарылым	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	жоқ
`zinn-chat/get-settings` `zinn-chat-get-settings`	Чат параметрлерін оқу Барлық чаt параметрлерін қайтарады: виджет, көмекші, адамдар мен жұмыс уақыты, тикеттер мен электрондық пошта, сайт индексі, құпиялылық және спам.	Тегін шығарылым	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	жоқ
`zinn-chat/get-stats` `zinn-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-ticket` `zinn-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-assistant` `zinn-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-replies` `zinn-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-chats` `zinn-chat-list-chats`	Белсенді чаттарды тізімдеу Күтіп тұрған, орындалып жатқан және жақында жабылған чаттарды, сондай-ақ олардың әрқайсысын кім басқарып жатқанын көрсетеді.	Тегін шығарылым	`GET …/abilities/zinn-chat/list-chats/run`	the 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/run`	the REST route's own per-item permission check	жоқ
`zinn-chat/list-kb-gaps` `zinn-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-tickets` `zinn-chat-list-tickets`	Тикеттерді тізімдеу Күйі немесе іздеу бойынша сүзгіден өткізілген қолдау қызметінің өтінімдерін бір уақытта бір беттен тізімдейді.	Тегін шығарылым	`GET …/abilities/zinn-chat/list-tickets/run`	the 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/run`	the 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/run`	the REST route's own per-item permission check	жоқ
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Чатта жауап беру Кeluңшіге хабарлама жібереді (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-reply` `zinn-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-article` `zinn-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-kb` `zinn-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-details` `zinn-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-status` `zinn-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-presence` `zinn-chat-set-presence`	Қолжетімділігіңізді орнатыңыз Кudіктелген агентті жаңа чаттар үшін қолжетімді немесе кетіп қалған деп белгілейді (кетіп қалды: true немесе false).	Тегін шығарылым	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	жоқ
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	AI көмегімен жауап жобасын жасау (Pro) Site контентінен чаt немесе билет үшін жауап жобасын жасайды; ештеңе жіберілмейді.	Pro шығарылымы	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	жоқ
`zinn-chat/summarise-conversation` `zinn-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-chat` `zinn-chat-take-chat`	Чат бастау Кiriген агентке күтіп тұрған чатты тағайындайды, осылайша келуші тірі адаммен сөйлеседі.	Тегін шығарылым	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (міндетті)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Чат параметрлерін өзгерту Жіберетін параметрлеріңізді өзгертеді (параметрлер: мәнге арналған кілт) және қалғанын сақтайды. Әрбір мән параметрлер экранындағыдай дәл тексеріледі; get-settings кілттерді көрсетеді.	Тегін шығарылым	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (міндетті)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Тикетті өзгерту Тикеттің күйін, басымдығын немесе жауапты тұлғаны өзгертеді.	Тегін шығарылым	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (міндетті)