დეველოპერები

Zinn® Chat-ის შესაძლებლობების ცნობარი

Zinn® Chat აფიქსირებს თავის მოქმედებებს WordPress Abilities API-ის გამოყენებით. ესვე შესაძლებლობები წარმოადგენს MCP ინსტრუმენტებს საიტის საკუთარ სერვერზე და REST მარშრუტებს /wp-json/wp-abilities/v1 მისამართზე. ეს გვერდი გენერირებულია თავად მოდულის რეესტრიდან.

მომხმარებლის სახელმძღვანელო: AI აპის დაკავშირება

საბოლოო წერტილები

MCP over 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 ფაილიდან, რომელიც თავის მხრივ გენერირებულია მუშა საიტიდან; ტესტი ვერ გადის, როდესაც ეს ორი ერთმანეთს არ ემთხვევა.

შესაძლებლობა	რას აკეთებს	გამოცემა	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`	სთხოვეთ ასისტენტს საიტის ხელოვნური ინტელექტის ასისტენტს უსვამს შეკითხვას და აბრუნებს მის პასუხს ნაპოვნი ყველა წყაროთი.	უფლებანი გამოვიდა	`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-მდე ტიკეტის (იდენტიფიკატორის) სტატუსს, პრიორიტეტს ან დამნიშნავს. თითოეული ტიკეტი გადის იგივე შემოწმებას, როგორც ინდივიდუალურად შეცვლისას; შედეგად თითოეული მათგანი ჩამოითვლება.	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) წერს ცოდნის ბაზის შავნიშნებს, რომლებიც პასუხობენ არჩეულ კითხვებს (ids); ისინი რჩება შავნიშნებად.	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: მხოლოდ ამ 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`	მხარდაჭერის სტატისტიკის წაკითხვა (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`	პასუხი ჩატში visitors-ისთვის შეaტყობინების გაგზავნა (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) ქმნის ან ცვლის შენახულ პასუხს (სათაური, მალსახმობი, ტექსტი, დეპარტამენტი; იდენტიფიკატორი ერთ-ერთის შესაცვლელად).	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) აყენებს ჩეთის ან ბილეთის დეპარტამენტს და ტეგებს (kind: chat ან ticket; 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`	დააყენეთ თქვენი ხელმისაწვდომობა ნიშნავს სისტემაში შესულ აგენტს ხელმისაწვდომად ან გასულად ახალი ჩატებისთვის (away: 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) საიტის შიგთავსიდან ამზადებს ჩატის ან თიკეთის პასუხის პროექტს; არაფერი იგზავნება.	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`	ჩათის დაწყება მოლოდინში მყოფ ჩატს მიაკუთვნებს შესულ აგენტს, რათა ვიზიტორმა დაელაპარაკოს ადამიანს.	უფლებანი გამოვიდა	`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 (სავალდებულო)