Προγραμματιστές

Zinn® Chat αναφορά δυνατοτήτων

Το Zinn® Chat καταχωρεί τις ενέργειές του στο WordPress Abilities API. Οι ίδιες δυνατότητες αποτελούν εργαλεία MCP στον δικό του διακομιστή του ιστότοπου και διαδρομές REST στη διεύθυνση /wp-json/wp-abilities/v1. Αυτή η σελίδα δημιουργείται από το μητρώο του ίδιου του πρόσθετου.

Εγχειρίδιο χρήστη: σύνδεση εφαρμογής τεχνητής νοημοσύνης

Τελικά σημεία

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
Απάντηση σε αίτημα υποστήριξης
Απαντά στον πελάτη μέσω email (text), ή προσθέτει μια εσωτερική σημείωση (note: true)· η κατάσταση αλλάζει προαιρετικά την κατάσταση του αιτήματος.
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/answer-ticket/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/ask-assistant
zinn-chat-ask-assistant
Ρωτήστε τον βοηθό
Κάνει μια ερώτηση στον βοηθό τεχνητής νοημοσύνης του ιστότοπου και επιστρέφει την απάντησή του μαζί με κάθε πηγή που βρήκε.
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/ask-assistant/runthe REST route's own per-item permission checkκανένα
zinn-chat/bulk-update-tickets
zinn-chat-bulk-update-tickets
Μαζική αλλαγή πολλών εισιτηρίων (Pro)
Αλλάζει την κατάσταση, την προτεραιότητα ή τον υπεύθυνο ανάθεσης έως και 100 δελτίων (ids). Κάθε δελτίο περνά από τους ίδιους ελέγχους όπως και η μεμονωμένη αλλαγή του· το αποτέλεσμα απαριθμεί το καθένα.
Έκδοση ProPOST …/abilities/zinn-chat/bulk-update-tickets/runzinn_chat_answerids: array (απαιτούμενο), status: open|pending|solved|closed, priority: low|normal|high|urgent, assignee_id: integer
zinn-chat/chat-to-ticket
zinn-chat-chat-to-ticket
Μετατρέψτε μια συνομιλία σε δελτίο υποστήριξης
Ανοίγει ένα ticket από μια συνομιλία ώστε να μπορεί να απαντηθεί μέσω email (απαιτεί τη διεύθυνση email του επισκέπτη).
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/chat-to-ticket/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/close-chat
zinn-chat-close-chat
Κλείσιμο συνομιλίας
Τερματίζει μια συνομιλία· ο επισκέπτης μπορεί ακόμα να ζητήσει την απομαγνητοφώνηση.
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/close-chat/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/create-ticket
zinn-chat-create-ticket
Άνοιγμα αιτήματος
Ανοίγει ένα εισιτήριο εξυπηρέτησης εκ μέρους ενός πελάτη (το email του, ένα θέμα και το πρώτο μήνυμα).
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/create-ticket/runthe REST route's own per-item permission checkκανένα
zinn-chat/delete-canned-reply
zinn-chat-delete-canned-reply
Διαγραφή αποθηκευμένης απάντησης (Pro)
Διαγράφει μια αποθηκευμένη απάντηση.
Έκδοση ProPOST …/abilities/zinn-chat/delete-canned-reply/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/delete-ticket
zinn-chat-delete-ticket
Διαγραφή αιτήματος υποστήριξης
Διαγράφει οριστικά ένα αίτημα υποστήριξης και τη συνομιλία του (μόνο για διαχειριστές).
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/delete-ticket/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/draft-kb-article
zinn-chat-draft-kb-article
Σύνταξη άρθρου βοήθειας από υποστήριξη (Pro)
Δημιουργεί ένα πρόχειρο άρθρο βάσης γνώσεων από ένα επιλυμένο δελτίο υποστήριξης· παραμένει πρόχειρο έως ότου το δημοσιεύσει κάποιος χρήστης.
Έκδοση ProPOST …/abilities/zinn-chat/draft-kb-article/runedit_posts (the REST route's own check)κανένα
zinn-chat/draft-kb-from-gaps
zinn-chat-draft-kb-from-gaps
Σύνταξη άρθρων βοήθειας για αναπάντητες ερωτήσεις (Pro)
Γράφει πρόχειρα άρθρα της βάσης γνώσεων που απαντούν στις επιλεγμένες ερωτήσεις (ids)· παραμένουν πρόχειρα.
Έκδοση ProPOST …/abilities/zinn-chat/draft-kb-from-gaps/runedit_posts (the REST route's own check)κανένα
zinn-chat/fill-canned-reply
zinn-chat-fill-canned-reply
Συμπλήρωση αποθηκευμένης απάντησης (Pro)
Επιστρέφει το κείμενο μιας αποθηκευμένης απάντησης με τα σύμβολα κράτησης θέσης συμπληρωμένα για μία συνομιλία ή ένα δελτίο.
Έκδοση ProPOST …/abilities/zinn-chat/fill-canned-reply/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/get-chat
zinn-chat-get-chat
Ανάγνωση συνομιλίας
Επιστρέφει τα μηνύματα μιας συνομιλίας και τα στοιχεία του επισκέπτη (after: μόνο μηνύματα νεότερα από αυτό το αναγνωριστικό).
Δωρεάν έκδοσηGET …/abilities/zinn-chat/get-chat/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/get-overview
zinn-chat-get-overview
Διαβάστε την επισκόπηση υποστήριξης
Επιστρέφει πόσα δεlτία υποστήριξης βρίσκονται σε κάθε κατάσταση και πόσες συνομιλίες αναμένουν έναν εκπρόσωπο (καθώς και τα μη αναγνωσμένα μηνύματά τους), καθώς και το αν η συνομιλία, ο βοηθός και τα δελτία είναι ενεργοποιημένα.
Δωρεάν έκδοσηGET …/abilities/zinn-chat/get-overview/runzinn_chat_answerκανένα
zinn-chat/get-settings
zinn-chat-get-settings
Ανάγνωση ρυθμίσεων συνομιλίας
Επιστρέφει κάθε ρύθμιση συνομιλίας: το widget, ο βοηθός, τα άτομα και οι ώρες λειτουργίας, τα αιτήματα υποστήριξης και το email, ο δείκτης του ιστότοπου, το απόρρητο και το spam.
Δωρεάν έκδοσηGET …/abilities/zinn-chat/get-settings/runzinn_chat_manageκανένα
zinn-chat/get-stats
zinn-chat-get-stats
Ανάγνωση στατιστικών υποστήριξης (Pro)
Επιστρέφει αριθμούς συνομιλιών και εισιτηρίων, χρόνους απόκρισης και αξιολογήσεις για τις τελευταίες N ημέρες (days).
Έκδοση ProGET …/abilities/zinn-chat/get-stats/runthe REST route's own per-item permission checkκανένα
zinn-chat/get-ticket
zinn-chat-get-ticket
Ανάγνωση δελτίου
Επιστρέφει ένα εισιτήριο με ολόκληρη τη συνομιλία του, την κατάσταση, την προτεραιότητα και τον υπεύθυνο ανάθεσης.
Δωρεάν έκδοσηGET …/abilities/zinn-chat/get-ticket/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/hand-chat-to-assistant
zinn-chat-hand-chat-to-assistant
Επιστροφή συνομιλίας στον βοηθό
Επιστρέφει μια συνομιλία στον βοηθό τεχνητής νοημοσύνης, ο οποίος απαντά στον επισκέπτη από το περιεχόμενο του ιστότοπου.
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/hand-chat-to-assistant/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/list-canned-replies
zinn-chat-list-canned-replies
Λίστα αποθηκευμένων απαντήσεων (Pro)
Παραθέτει τις αποθηκευμένες απαντήσεις που μπορούν να εισάγουν οι πράκτορες, μαζί με τις συντομεύσεις τους.
Έκδοση ProGET …/abilities/zinn-chat/list-canned-replies/runthe REST route's own per-item permission checkκανένα
zinn-chat/list-chats
zinn-chat-list-chats
Προβολή ενεργών συνομιλιών
Παραθέτει τις συνομιλίες που βρίσκονται σε αναμονή, σε εξέλιξη και έχουν κλείσει πρόσφατα, μαζί με το ποιος διαχειρίζεται την κάθε μία.
Δωρεάν έκδοσηGET …/abilities/zinn-chat/list-chats/runthe 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/runthe REST route's own per-item permission checkκανένα
zinn-chat/list-kb-gaps
zinn-chat-list-kb-gaps
Προβολή αναπάντητων ερωτήσεων (Pro)
Παραθέτει τις ερωτήσεις που έθεσαν οι επισκέπτες και στις οποίες η βάση γνώσεων δεν μπόρεσε να απαντήσει.
Έκδοση ProGET …/abilities/zinn-chat/list-kb-gaps/runthe REST route's own per-item permission checkκανένα
zinn-chat/list-tickets
zinn-chat-list-tickets
Λίστα αιtημάτων
Εμφανίζει τα εισιτήρια υποστήριξης, φιλτραρισμένα ανά κατάσταση ή αναζήτηση, μία σελίδα τη φορά.
Δωρεάν έκδοσηGET …/abilities/zinn-chat/list-tickets/runthe 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/runthe 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/runthe REST route's own per-item permission checkκανένα
zinn-chat/reply-chat
zinn-chat-reply-chat
Απάντηση σε συνομιλία
Στέλνει ένα μήνυμα στον επισκέπτη (text), ή προσθέτει μια εσωτερική σημείωση που βλέπουν μόνο οι πράκτορες (note: true).
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/reply-chat/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/save-canned-reply
zinn-chat-save-canned-reply
Αποθήκευση αποθηκευμένης απάντησης (Pro)
Δημιουργεί ή αλλάζει μια αποθηκευμένη απάντηση (τίτλος, συντόμευση, κείμενο, τμήμα· αναγνωριστικό για αλλαγή μίας).
Έκδοση ProPOST …/abilities/zinn-chat/save-canned-reply/runthe REST route's own per-item permission checkκανένα
zinn-chat/save-kb-article
zinn-chat-save-kb-article
Συγγραφή άρθρου βοήθειας (Pro)
Δημιουργεί ένα άρθρο βάσης γνώσεων ή τροποποιεί ένα (id): τίτλος, περιεχόμενο, απόσπασμα, κατηγορίες και κατάσταση (πρόχειρο ή δημοσίευση όταν επιτρέπεται η δημοσίευση).
Έκδοση ProPOST …/abilities/zinn-chat/save-kb-article/runedit_postsid: integer, title: string, content: string, excerpt: string, categories: array, status: draft|publish
zinn-chat/search-kb
zinn-chat-search-kb
Αναζήτηση στη βάση γνώσεων (Pro)
Βρίσκει άρθρα βοήθειας για σύνδεση σε απάντηση (q: η αναζήτηση).
Έκδοση ProGET …/abilities/zinn-chat/search-kb/runthe REST route's own per-item permission checkκανένα
zinn-chat/set-conversation-details
zinn-chat-set-conversation-details
Ορίστε το τμήμα και τις ετικέτες μιας συνομιλίας (Pro)
Ορίζει το τμήμα και τις ετικέτες μιας συνομιλίας ή ενός δελτίου (kind: chat ή ticket· id).
Έκδοση ProPOST …/abilities/zinn-chat/set-conversation-details/runthe REST route's own per-item permission checkκανένα
zinn-chat/set-kb-gap-status
zinn-chat-set-kb-gap-status
Σήμανση αναπάντητων ερωτήσεων (Pro)
Σημειώνει τις αναπάντητες ερωτήσεις ως ανοιχτές, προγραμματισμένες ή απορριφθείσες (ids, status).
Έκδοση ProPOST …/abilities/zinn-chat/set-kb-gap-status/runthe 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/runthe REST route's own per-item permission checkκανένα
zinn-chat/suggest-reply
zinn-chat-suggest-reply
Σύνταξη απάντησης με τεχνητή νοημοσύνη (Pro)
Συντάσσει μια απάντηση σε συνομιλία ή αίτημα υποστήριξης από το περιεχόμενο του ιστότοπου· τίποτα δεν αποστέλλεται.
Έκδοση ProPOST …/abilities/zinn-chat/suggest-reply/runthe REST route's own per-item permission checkκανένα
zinn-chat/summarise-conversation
zinn-chat-summarise-conversation
Σύνοψη συνομιλίας με AI (Pro)
Συνοψίζει μια συνομιλία ή ένα αίτημα υποστήριξης σε λίγες γραμμές.
Έκδοση ProPOST …/abilities/zinn-chat/summarise-conversation/runthe REST route's own per-item permission checkκανένα
zinn-chat/take-chat
zinn-chat-take-chat
Ξεκινήστε μια συνομιλία
Αναθέτει μια συνομιλία σε αναμονή στον συνδεδεμένο εκπρόσωπο, ώστε ο επισκέπτης να μιλήσει με κάποιο άτομο.
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/take-chat/runthe REST route's own per-item permission checkid: string (απαιτούμενο)
zinn-chat/update-settings
zinn-chat-update-settings
Αλλαγή ρυθμίσεων συνομιλίας
Αλλάζει τις ρυθμίσεις που στέλνετε (ρυθμίσεις: κλειδί σε τιμή) και διατηρεί τις υπόλοιπες. Κάθε τιμή ελέγχεται ακριβώς όπως στην οθόνη ρυθμίσεων· το get-settings παραθέτει τα κλειδιά.
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/update-settings/runzinn_chat_managesettings: object (απαιτούμενο)
zinn-chat/update-ticket
zinn-chat-update-ticket
Αλλαγή αιtήματος
Αλλάζει την κατάσταση, την προτεραιότητα ή τον υπεύθυνο ενός αιτήματος.
Δωρεάν έκδοσηPOST …/abilities/zinn-chat/update-ticket/runthe REST route's own per-item permission checkid: string (απαιτούμενο)