Vývojáři

Referat schopností pluginu Zinn® Chat

Zinn® Chat registruje své akce pomocí WordPress Abilities API. Stejné schopnosti jsou nástroji MCP na vlastním serveru webu a cestami REST pod /wp-json/wp-abilities/v1. Tato stránka je generována z vlastního registru pluginu.

Uživatelská příručka: připojení aplikace s umělou inteligencí

Koncové body

MCP přes HTTP (streamovatelné)

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

MCP přes WP-CLI (standardní vstup a výstup)

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

REST: vypsat funkce

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

REST: spustit schopnost

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

Autentizace a oprávnění

HTTP požadavky se ověřují pomocí aplikačního hesla WordPress (HTTP Basic). Připojení k serveru MCP vyžaduje níže zobrazenou oprávněnost; každá schopnost pak kontroluje své vlastní oprávnění pro každý objekt. Schopnosti pouze pro čtení běží s metodou GET a vstupem v řetězci dotazu; ostatní s metodou POST a tělem JSON {"input": {…}}.

Příklady

# REST: spustit schopnost
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":{}}}

Všechny oprávnění

Vygenerováno ze souboru abilities.json v pluginu, který se sám generuje z běžícího webu; test selže, pokud se tyto dva zdroje neshodují.

Oprávnění	Co to dělá	Edice	REST	Oprávnění	Parametry
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Zodpovědět tiket Odpoví zákazníkovi e-mailem (text), nebo přidá interní poznámku (note: true); stav volitelně změní stav tiketu.	Bezplatná edice	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Zeptejte se asistenta Položí dotaz umělé inteligenci webu a vrátí její odpověď včetně všech nalezených zdrojů.	Bezplatná edice	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	žádné
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Změnit mnoho tiketů najednou (Pro) Změní stav, prioritu nebo řešitele až 100 tiketů (ids). Každý tiket prochází stejnými kontrolami jako při samostatné změně; výsledný seznam uvádí každý z nich.	Edice Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (povinné), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Proměňte chat v tikety Otevře tiket z chatu, aby jej bylo možné vyřídit e-mailem (vyžaduje e-mailovou adresu návštěvníka).	Bezplatná edice	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Zavřít chat Ukončí chat; návštěvník může stále požádat o přepis.	Bezplatná edice	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Otevřít tiket Otevře tiket jménem zákazníka (jeho e-mail, předmět a první zprávu).	Bezplatná edice	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	žádné
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Smazat uloženou odpověď (Pro) Smaže uloženou odpověď.	Edice Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Smazat tiket Trvale odstraní tiket a celou konverzaci (pouze pro manažery).	Bezplatná edice	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Napsat nápovědový článek z ticketu (Pro) Napíše koncept článku znalostní báze z vyřešeného tiketu; zůstane konceptem, dokud jej někdo nezveřejní.	Edice Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	žádné
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Napište návrhy nápovědy pro nezodpovězené otázky (Pro) Píše koncepty článků znalostní báze, které odpovídají na vybrané otázky (ID); zůstávají jako koncepty.	Edice Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	žádné
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Vyplnit uloženou odpověď (Pro) Vrátí text uložené odpovědi s vyplněnými zástupnými symboly pro jeden chat nebo požadavek.	Edice Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Přečíst chat Vrací zprávy a podrobnosti o návštěvníkovi daného chatu (after: pouze zprávy novější než toto ID).	Bezplatná edice	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Přečíst si přehled podpory Vrací informaci o tom, kolik tiketů je v jednotlivém stavu, kolik chatů čeká na člověka (a jejich nepřečtených zprávách) a zda jsou chat, asistent a tikety zapnuté.	Bezplatná edice	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	žádné
`zinn-chat/get-settings` `zinn-chat-get-settings`	Přečíst nastavení chatu Vrátí všechna nastavení chatu: widget, asistenta, lidi a otevírací dobu, tikety a e-mail, index stránek, soukromí a spam.	Bezplatná edice	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	žádné
`zinn-chat/get-stats` `zinn-chat-get-stats`	Přečíst statistiky podpory (Pro) Vrací počty chatů a tiketů, doby odezvy a hodnocení za posledních N dnů (dny).	Edice Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	žádné
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Přečíst tiket Vrátí jeden tiket včetně celé jeho konverzace, stavu, priority a řešitele.	Bezplatná edice	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Předat chat zpět asistentovi Vrátí chat s AI asistentem, který odpovídá návštěvníkovi na základě obsahu stránek.	Bezplatná edice	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Seznam uložených odpovědí (Pro) Zobrazuje seznam uložených odpovědí, které mohou agenti vkládat, včetně jejich zástupců.	Edice Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	žádné
`zinn-chat/list-chats` `zinn-chat-list-chats`	Zobrazit živé chaty Zobrazuje čekající, probíhající a nedávno uzavřené chaty a uvádí, kdo každý z nich vyřizuje.	Bezplatná edice	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	žádné
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Zobrazit, co assistant ví Zobrazuje obsah, ze kterého asistent odpovídá, včetně stavu indexování, vždy po jedné stránce.	Bezplatná edice	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	žádné
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Seznam nezodpovězených otázek (Pro) Zobrazuje seznam otázek položených návštěvníky, na které znalostní báze nedokázala odpovědět.	Edice Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	žádné
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Seznam tiketů Zobrazuje požadavky podpory filtrované podle stavu nebo hledání, vždy po jedné stránce.	Bezplatná edice	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	žádné
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Přestavět vyhledávací index asistentky Znovu sestaví vyhledávací vektory pro jednu položku (item_id) nebo všechno (all: true) (pouze pro správce).	Bezplatná edice	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	žádné
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Načíst obsah znovu do asistenta Znovu načte jednu položku (item_id) nebo všechno (all: true) do indexu asistenta (pouze pro manažery).	Bezplatná edice	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	žádné
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Odpovědět v chatu Odešle návštěvníkovi zprávu (text) nebo přidá interní poznámku, kterou vidí pouze agenti (note: true).	Bezplatná edice	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Uložit uloženou odpověď (Pro) Vytvoří nebo upraví uloženou odpověď (název, zástupce, text, oddělení; ID pro úpravu jedné).	Edice Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	žádné
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Napsat nápovědu (Pro) Vytvoří článek báze znalostí nebo jej upraví (id): název, obsah, výňatek, kategorie a stav (koncept nebo publikovat, když můžete publikovat).	Edice 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`	Prohledat znalostní bázi (Pro) Vyhledá články nápovědy k připojení v odpovědi (q: hledaný výraz).	Edice Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	žádné
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Nastavit oddělení a štítky konverzace (Pro) Nastaví oddělení a štítky chatu nebo ticketu (typ: chat nebo ticket; id).	Edice Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	žádné
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Označit nezodpovězené otázky (Pro) Označuje nezodpovězené otázky jako otevřené, plánované nebo zamítnuté (ids, status).	Edice Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	žádné
`zinn-chat/set-presence` `zinn-chat-set-presence`	Nastavte svou dostupnost Označuje přihlášeného agenta jako dostupného nebo zaneprázdněného pro nové chaty (away: true nebo false).	Bezplatná edice	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	žádné
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Napsat odpověď pomocí AI (Pro) Připravuje návrh odpovědi na chat nebo tiket na základě obsahu stránek; nic se neodesílá.	Edice Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	žádné
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Shrnutí konverzace s umělou inteligencí (Pro) Shrne chat nebo tiket v několika řádcích.	Edice Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	žádné
`zinn-chat/take-chat` `zinn-chat-take-chat`	Zahájit chat Přiřadí čekající chat přihlášenému agentovi, takže návštěvník mluví s člověkem.	Bezplatná edice	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (povinné)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Změnit nastavení chatu Mění odesílaná nastavení (nastavení: klíč na hodnotu) a zachovává ostatní. Každá hodnota se kontroluje přesně jako na obrazovce nastavení; get-settings vypisuje klíče.	Bezplatná edice	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (povinné)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Změnit požadavek Změní stav, prioritu nebo řešitele ticketu.	Bezplatná edice	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (povinné)