ለአልሚዎች

Zinn® Chat ችሎታዎች ማጣቀሻ

Zinn® Chat የድርጊት ምዝገባውን ከ WordPress Abilities API ጋር ያከናውናል። እነሁኑ ችሎታዎች በጣቢያው የራስ አገልጋይ ላይ የ MCP መሣሪያዎች እና በ /wp-json/wp-abilities/v1 ስር የ REST መስመሮች ናቸው። ይህ ገጽ የተፈጠረው ከሰኪው የራሱ መዝገብ ነው።

የተጠቃሚ መመሪያ፡ የAI መተግበሪያን ያገናኙ

መድረሻዎች

MCP በ HTTP (ሊዥረጭ የሚችል)

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

MCP በ WP-CLI (መደበኛ ግብዓት እና ውፅዓት)

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 እና በ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 የተፈጠረ፣ እሱም ራሱ ከሚሰራ ድረ-ገጽ የሚመነጭ ነው፤ ሁለቱ ሲጣሉ ምርመራው ይወድቃል።

ችሎታ	ምን እንደሚሰራ	እትም	ዕረፍት	ፈቃድ	ልኬቶች
`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 የቲኬት (መታወቂያዎች) ሁኔታ፣ ቅድሚያ ሰጪነት ወይም ተመዳቢ ይቀይራል። እያንዳንዱ ቲኬት በራሱ ሲቀየር ከሚያልፍባቸው ምርመራዎች ጋር አንድ አይነት ምርመራዎችን ያልፋል፤ ውጤቱም እያንዳንዳቸውን ይዘረዝራል።	የፕሮ እትም	`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`	የተቀመጠ ምላሽ ሰርዝ (ፕሮ) የተቀመጠ ምላሽ ይሰርዛል።	የፕሮ እትም	`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`	ከቲኬት የእርዳታ ጽሑፍ ማዘጋጀት (ፕሮ) ከተፈታ ቲኬት የመሠረታዊ ዕውቀት መጣጥፍ ረቂቅ ይጽፋል፤ አንድ ሰው እስኪያትመው ድረስ ረቂቅ ሆኖ ይቆያል።	የፕሮ እትም	`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) የተመረጡትን ጥያቄዎች (መለያዎች) የሚመልሱ የእውቀት ማዕከል ንድፍ ጽሁፎችን ይጽፋል፤ እነሱም እንደ ንድፍ ይቆያሉ።	የፕሮ እትም	`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) ለአንድ ውይይት ወይም ቲኬት የተቀመጠ የምላሽ ጽሑፍ ቦታ ያዥዎቹ ተሞልተው ይመለሳል።	የፕሮ እትም	`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: ከዚህ መለያ (id) የሚበልጡ አዳዲስ መልዕክቶችን ብቻ)።	ነጻ እትም	`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`	የቻት ቅንብሮችን አንብብ ሁሉንም የውይይት ቅንብሮች ይመልሳል፡ ዊጅቱ፣ ረዳቱ፣ ሰዎች እና የስራ ሰዓቶች፣ ትኬቶች እና ኢሜይል፣ የጣቢያው ማውጫ፣ ግላዊነት እና ስፓም።	ነጻ እትም	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	ምንም
`zinn-chat/get-stats` `zinn-chat-get-stats`	የድጋፍ ስታቲስቲክስ አንብብ (ፕሮ) ለባለፉት N ቀናት (ቀናት) የቻት እና የቲኬት ቁጥሮችን፣ የምላሽ ጊዜዎችን እና ደረጃ አሰጣጦችን ይመልሳል።	የፕሮ እትም	`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`	የተቀመጡ መልሶችን ዘርዝር (ፕሮ) ወኪሎች ማስገባት የሚችሏቸውን የተቀመጡ መልሶች ከምህጻረ ቃሎቻቸው ጋር ይዘረዝራል።	የፕሮ እትም	`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) የዕውቀት ማከማቻው ሊመልሳቸው ያልቻላቸውን ጎብኚዎች የጠየቁትን ጥያቄዎች ይዘርዝራል።	የፕሮ እትም	`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`	በውይይት ምላሽ ስጥ ለጎብኚው መልእክት ይልካል (ጽሑፍ)፣ ወይም ወኪሎች ብቻ የሚዩአቸው የውስጥ ማስታወሻ ይጨምራል (ማስታወሻ፡ እውነት)።	ነጻ እትም	`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) የተቀመጠ ምላሽ ይፈጥራል ወይም ይቀይራል (ርዕስ፣ አቋራጭ፣ ዋና ጽሁፍ፣ ክፍል፤ ለመለወጥ መለያ)።	የፕሮ እትም	`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`	የእርዳታ ጽሑፍ ይጻፉ (ፕሮ) የእውቀት መሰረት ጽሑፍ ይፈጥራል፣ ወይም አንዱን (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-kb` `zinn-chat-search-kb`	የእውቀት መሰረቱን ይፈልጉ (ፕሮ) በምላሽ ውስጥ ሊያያዟቸው የሚችሏቸውን የእርዳታ ጽሁፎች ይፈልጋል (q: ፍለጋው)።	የፕሮ እትም	`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) የውይይት ወይም የቲኬት ክፍል እና መለያዎችን ያዘጋጃል (ዓይነት፡ ውይይት ወይም ቲኬት፤ መታወቂያ)።	የፕሮ እትም	`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) ያልተመለሱ ጥያቄዎችን እንደ ክፍት፣ የታቀዱ ወይም የተሰረዙ (መታወቂያዎች፣ ሁኔታ) ምልክት ያደርጋል።	የፕሮ እትም	`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`	የእርስዎን ተገኝነት ያዘጋጁ የገቡትን ወኪል ለአዲስ ውይይቶች ዝግጁ ወይም የሩቅ ያደርጋል (የሩቅ: እውነት ወይም ውሸት)።	ነጻ እትም	`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) ከጣቱ ይዘት በመነሳት ለውይይት ወይም ለቲኬት ምላሽ ያዘጋጃል፤ ምንም ነገር አይላክም።	የፕሮ እትም	`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) ውይይትን ወይም ቲኬትን በጥቂት መስመሮች ይጠቃለላል።	የፕሮ እትም	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	ምንም
`zinn-chat/take-chat` `zinn-chat-take-chat`	ውይይት ይጀምሩ ጎብኚው ከሰው ጋር እንዲነጋገር፣ በመለያ የገባውን ወኪል በመጥበቅ ላይ ያለ ውይይት ይመድባል።	ነጻ እትም	`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`	የውይይት ቅንብሮችን ይቀይሩ የሚልኳቸውንቼንጆችይቀይራል(ቼንጆች፡ቁልፍእውሴት)እናቀረውንያስቀራል።እያንዳንዱእሴትልክእንዲሁበቼንጆችስክሪንላይይረጋገጣል፤ጌት-ቼንጆችቁልፎቹንይዘረዝራል።	ነጻ እትም	`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 (ያስፈልጋል)