Fejlesztők

Zinn® Chat képességreferencia

A Zinn® Chat regisztrálja műveleteit a WordPress Abilities API-val. Ugyanezek a képességek MCP-eszközök a webhely saját szerverén és REST-útvonalak a /wp-json/wp-abilities/v1 alatt. Ez az oldal a bővítmény saját regiszteréből generálódik.

Felhasználói útmutató: AI-alkalmazás csatlakoztatása

Végpontok

MCP HTTP-n keresztül (streamelhető)

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

MCP a WP-CLI-n keresztül (szabványos bemenet és kimenet)

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

REST: képességek listázása

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

REST: képesség futtatása

/wp-json/wp-abilities/v1/abilities/<name>/run

Hitelesítés és jogosultságok

A HTTP-kérések egy WordPress alkalmazásjelszóval (HTTP Basic) hitelesítik magukat. Az MCP-szerverhez való csatlakozáshoz az alábbi jogosultság szükséges; ezután minden egyes képesség objektumunkként ellenőrzi a saját engedélyét. Az írásvédett képességek GET metódussal futnak, bemenetük a lekérdezési sztringben szerepel; a többi POST metódussal és egy JSON törzzsel ({"input": {…}}).

Példák

# REST: képesség futtatása
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":{}}}

Minden képesség

A bővítmény abilities.json fájlából generálva, amely maga is egy futó webhelyből készül; egy teszt sikertelen, ha a kettő eltér egymástól.

Jogosultság	Mit csinál	Kiadás	REST	Jogosultság	Paraméterek
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Válaszolás a jegyre Válaszol az ügyfélnek e-mailben (szöveg), vagy belső jegyzetet ad hozzá (note: true); az állapot opcióvá teszi a jegy státuszának megváltoztatását.	Ingyenes kiadás	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Kérdezze meg az asszisztenst Megkérdezi a webhely mesterséges intelligencia asszisztensét, és visszaadja a válaszát az összes megtalált forrásával együtt.	Ingyenes kiadás	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	nincs
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Több jegy egyszerre történő módosítása (Pro) Módosítja legfeljebb 100 jegy (azonosítók) státuszát, prioritását vagy felelősét. Mindegyik jegy ugyanazon ellenőrzéseken megy keresztül, mint amikor egyenként módosítják őket; az eredmény felsorolja az egyes jegyeket.	Pro kiadás	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (kötelező), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Alakítson át egy csevegést jeggyé Egy csevegésből nyit meg egy jegyet, hogy azt e-mailben lehessen megválaszolni (szükséges hozzá a látogató e-mail címe).	Ingyenes kiadás	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Csevegés bezárása Bezárja a csevegést; a látogató továbbra is kérheti az átiratot.	Ingyenes kiadás	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Jegy nyitása Jegyet nyit egy ügyfél nevében (az e-címe, egy tárgy és az első üzenet).	Ingyenes kiadás	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	nincs
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Mentett válasz törlése (Pro) Töröl egy mentett választ.	Pro kiadás	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Ticket törlése Véglegesen törli a jegyet és a hozzá tartozó beszélgetést (csak vezetőknek).	Ingyenes kiadás	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Segítségnyújtási cikk tervezet készítése jegy alapján (Pro) Egy megoldott jegyzet alapján piszkozat tudásbázis-cikket ír; az emberi közzétételig piszkozat marad.	Pro kiadás	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	nincs
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Segítségnyújtási cikkek vázlata megválaszolatlan kérdésekhez (Pro) Piszkozat tudásbáziscikkeket ír, amelyek megválaszolják a kiválasztott kérdéseket (ids); ezek piszkozat maradnak.	Pro kiadás	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	nincs
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Mentett válasz kitöltése (Pro) Visszaadja a mentett válasz szövegét a helykitöltőivel együtt kitöltve egy csevegéshez vagy hibajegyhez.	Pro kiadás	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Csevegés olvasása Visszaadja az egyik csevegés üzeneteit és a látogató adatait (after: csak az ennél az azonosítónál újabb üzenetek).	Ingyenes kiadás	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Olvassa el a támogatási áttekintést Visszaadja, hogy hány jegy van egyes státuszokban, hány csevegés vár ügyintézőre (és mennyi a olvasatlan üzeneteik száma), valamint hogy a csevegés, az asszisztens és a jegyek be vannak-e kapcsolva.	Ingyenes kiadás	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	nincs
`zinn-chat/get-settings` `zinn-chat-get-settings`	Csevegési beállítások olvasása Visszaadja az összes csevegési beállítást: a widgetet, az asszisztenst, a személyzetet és a nyitvatartási időt, a jegyeket és az e-maileket, a webhelyindexet, valamint az adatvédelmet és a spamszűrést.	Ingyenes kiadás	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	nincs
`zinn-chat/get-stats` `zinn-chat-get-stats`	Támogatási statisztikák olvasása (Pro) Visszaadja a chatek és jegyek számát, a válaszidőket és az értékeléseket az elmúlt N napra (nap).	Pro kiadás	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	nincs
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Jegy megtekintése Egy jegyet ad vissza a teljes beszélgetésével, állapotával, prioritásával és felelősével együtt.	Ingyenes kiadás	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Adja vissza a csevegést az asszisztensnek Visszaküld egy csevegést a mesterséges intelligencia asszisztensnek, amely az oldal tartalma alapján válaszol a látogatónak.	Ingyenes kiadás	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Mentett válaszok listázása (Pro) Felsorolja az ügyintézők által beszúrható elmentett válaszokat a hozzájuk tartozó billentyűparancsokkal együtt.	Pro kiadás	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	nincs
`zinn-chat/list-chats` `zinn-chat-list-chats`	Élő csevegések listázása Felsorolja a várakozó, a folyamatban lévő és a nemrég lezárt csevegéseket, valamint azt, hogy ki kezeli az egyes csevegéseket.	Ingyenes kiadás	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	nincs
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Sorolja fel, amit az asszisztens tud Felsorolja azt a tartalmat, amelyből az asszisztens válaszol, az indexelési státuszával együtt, oldalanként.	Ingyenes kiadás	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	nincs
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Megválaszolatlan kérdések listázása (Pro) Felsorolja azokat a látogatók által feltett kérdéseket, amelyekre a tudásbázis nem tudott válaszolni.	Pro kiadás	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	nincs
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Jegyek listázása A támogatási jegyeket listázza státusz vagy keresés szerint szűrve, oldalanként.	Ingyenes kiadás	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	nincs
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	A asszisztens keresési indexének újraépítése Újraépíti a keresési vektorokat egyetlen elemhez (item_id) vagy mindenhez (all: true) (csak kezelőknek).	Ingyenes kiadás	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	nincs
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Olvassa újra a tartalmat az asszisztensbe Újraolvassa az egyik elemet (item_id) vagy mindent (all: true) az asszisztens indexébe (csak vezetőknek).	Ingyenes kiadás	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	nincs
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Válasz a csevegésben Üzenetet küld az látogatónak (text), vagy belső jegyzetet ad hozzá, amelyet csak az ügyintézők látanak (note: true).	Ingyenes kiadás	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Mentett válasz mentése (Pro) Létrehoz vagy módosít egy elmentett választ (cím, gyorsbillentyű, szövegtörzs, részleg; az azonosító egy módosításához).	Pro kiadás	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	nincs
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Segítségnyújtási cikk írása (Pro) Tudásbázis-cikk létrehozása vagy módosítása (id): cím, tartalom, kivonat, kategóriák és státusz (piszkozat, vagy közzététel, ha közzéteheti).	Pro kiadás	`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`	Tudásbázis keresése (Pro) Súgócikkek keresése válaszban való hivatkozáshoz (q: a keresés).	Pro kiadás	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	nincs
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Beszélgetés részlegének és címkéinek beállítása (Pro) Beállítja egy csevegés vagy jegy részlegét és címkéit (típus: chat vagy ticket; azonosító).	Pro kiadás	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	nincs
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Megválaszolatlan kérdések megjelölése (Pro) Megjelöli a megválaszolatlan kérdéseket nyitottnak, tervezettnek vagy elutasítottnak (azonosítók, státusz).	Pro kiadás	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	nincs
`zinn-chat/set-presence` `zinn-chat-set-presence`	Állítsa be a elérhetőségét Megjelöli a bejelentkezett ügyfélszolgálatos elérhetőként vagy távollévőként az új csevegésekhez (távollévő: true vagy false).	Ingyenes kiadás	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	nincs
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Válasz tervezet készítése mesterséges intelligenciával (Pro) Válasz-tervezetet készít egy csevegéshez vagy jegyhez a webhely tartalma alapján; semmi sem kerül elküldésre.	Pro kiadás	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	nincs
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Mesterséges intelligenciával folytatott beszélgetés összefoglalása (Pro) Egy csevegést vagy jegyet foglal össze néhány sorban.	Pro kiadás	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	nincs
`zinn-chat/take-chat` `zinn-chat-take-chat`	Csevegés indítása Egy várakozó csevegést rendel a bejelentkezett ügyintézőhöz, így a látogató egy személlyel beszél.	Ingyenes kiadás	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (kötelező)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Csevegési beállítások módosítása Módosítja az elküldött beállításokat (beállítások: kulcs-érték párok), a többit pedig változatlanul hagyja. Minden egyes érték ellenőrzése pontosan úgy történik, mint a beállítások képernyőjén; a get-settings parancs listázza a kulcsokat.	Ingyenes kiadás	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (kötelező)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Jegy módosítása Megváltoztatja egy jegy státuszát, prioritását vagy felelősét.	Ingyenes kiadás	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (kötelező)