Pembangun

Rujukan keupayaan Zinn® Chat

Zinn® Chat mendaftarkan tindakannya dengan WordPress Abilities API. Kebolehan yang sama ialah alat MCP pada pelayan tapak itu sendiri dan laluan REST di bawah /wp-json/wp-abilities/v1. Halaman ini dijana daripada pendaftaran plugin itu sendiri.

Panduan pengguna: sambungkan apl AI

Titik Akhir

MCP melalui HTTP (boleh strim)

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

MCP melalui WP-CLI (input dan output standard)

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

REST: senaraikan keupayaan

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

REST: jalankan kebolehan

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

Pengesahan dan kebenaran

Permintaan HTTP disahkan menggunakan kata laluan aplikasi WordPress (Asas HTTP). Menyambungkan ke pelayan MCP memerlukan keupayaan yang ditunjukkan di bawah; setiap keupayaan kemudian menyemak kebenarannya sendiri, mengikut objek. Keupayaan baca sahaja berjalan dengan GET dan inputnya dalam rentetan pertanyaan; yang lain dengan POST dan badan JSON {"input": {…}}.

Contoh

# REST: jalankan kebolehan
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":{}}}

Semua kebolehan

Dijana daripada abilities.json palam, yang dijana sendiri daripada tapak web yang sedang berjalan; ujian gagal apabila kedua-duanya tidak sepadan.

Keupayaan	Fungsinya	Edisi	REHAT	Kebenaran	Parameter
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Jawab tiket Membalas pelanggan melalui e-mel (teks), atau menambah nota dalaman (note: true); status boleh ditukar secara pilihan.	Edisi percuma	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Tanya pembantu Bertanya kepada pembantu AI tapak web dan mengembalikan jawapannya beserta setiap sumber yang ditemui.	Edisi percuma	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	tiada
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Ubah banyak tiket sekaligus (Pro) Mengubah status, keutamaan atau pegawai yang ditugaskan bagi sehingga 100 tiket (id). Setiap tiket melalui semakan yang sama seperti apabila ia diubah secara individu; hasilnya menyenaraikan setiap satu.	Edisi Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (diperlukan), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Tukar sembang kepada tiket Membuka tiket daripada sembang supaya ia boleh dijawab melalui e-mel (memerlukan alamat e-mel pelawat).	Edisi percuma	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Tutup sembang Mengakhiri perbualan; pelawat masih boleh meminta transkrip tersebut.	Edisi percuma	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Buka tiket Membuka tiket bagi pihak pelanggan (e-mel mereka, subjek dan mesej pertama).	Edisi percuma	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	tiada
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Padamkan balasan tersimpan (Pro) Padam balasan yang disimpan.	Edisi Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Padamkan tiket Memadamkan tiket dan perbualan secara kekal (pengurus sahaja).	Edisi percuma	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Draf artikel bantuan daripada tiket (Pro) Menulis draf artikel pangkalan pengetahuan daripada tiket yang telah diselesaikan; ia kekal sebagai draf sehingga seseorang menerbitkannya.	Edisi Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	tiada
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Draf artikel bantuan untuk soalan yang belum dijawab (Pro) Menulis draf artikel pangkalan pengetahuan yang menjawab soalan yang dipilih (ids); ia kekal sebagai draf.	Edisi Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	tiada
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Isikan balasan yang disimpan (Pro) Mengembalikan teks balasan yang disimpan dengan tempat pegasnya diisi untuk satu sembang atau tiket.	Edisi Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Baca sembang Mengembalikan mesej satu perbualan dan butiran pelawat (after: hanya mesej yang lebih baharu daripada id ini).	Edisi percuma	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Baca gambaran keseluruhan sokongan Mengembalikan bilangan tiket dalam setiap status dan bilangan chat yang sedang menunggu ejen (serta mesej belum dibaca mereka), dan sama ada chat, pembantu, serta tiket diaktifkan.	Edisi percuma	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	tiada
`zinn-chat/get-settings` `zinn-chat-get-settings`	Baca tetapan sembang Mengembalikan setiap tetapan sembang: widget, pembantu, orang dan waktu operasi, tiket dan e-mel, indeks tapak, privasi dan spam.	Edisi percuma	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	tiada
`zinn-chat/get-stats` `zinn-chat-get-stats`	Baca statistik sokongan (Pro) Mengembalikan nombor sembang dan tiket, masa respons dan penilaian untuk N hari terakhir (hari).	Edisi Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	tiada
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Baca tiket Mengembalikan satu tiket beserta keseluruhan perbualan, status, keutamaan dan pemegangnya.	Edisi percuma	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Serahkan semula perbualan kepada pembantu Mengembalikan sembang kepada pembantu AI, yang menjawab pelawat daripada kandungan tapak.	Edisi percuma	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Senarai balasan disimpan (Pro) Senaraikan balasan tersimpan yang boleh dimasukkan oleh ejen, berserta pintasannya.	Edisi Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	tiada
`zinn-chat/list-chats` `zinn-chat-list-chats`	Senaraikan sembang langsung Senarai sembang yang menunggu, sedang berjalan dan baru ditutup, berserta pengendali setiap satu.	Edisi percuma	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	tiada
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Senaraikan perkara yang diketahui oleh pembantu Senaraikan kandungan yang dijawab oleh pembantu, berserta status indeksnya, satu halaman pada satu masa.	Edisi percuma	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	tiada
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Senaraikan soalan belum dijawab (Pro) Senaraikan soalan yang ditanya oleh pelawat yang tidak dapat dijawab oleh pangkalan pengetahuan.	Edisi Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	tiada
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Senaraikan tiket Senaraikan tiket sokongan, ditapis mengikut status atau carian, satu halaman pada satu masa.	Edisi percuma	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	tiada
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Bina semula indeks carian pembantu Membina semula vektor carian untuk satu item (item_id) atau semuanya (all: true) (pengurus sahaja).	Edisi percuma	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	tiada
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Baca semula kandungan ke dalam pembantu Membaca semula satu item (item_id) atau semuanya (all: true) ke dalam indeks pembantu (pengurus sahaja).	Edisi percuma	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	tiada
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Balas dalam sembang Menghantar mesej kepada pelawat (text), atau menambah nota dalaman yang hanya dilihat oleh ejen (note: true).	Edisi percuma	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Simpan balasan tersimpan (Pro) Mencipta atau menukar balasan yang disimpan (tajuk, pintasan, badan, jabatan; id untuk menukar satu).	Edisi Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	tiada
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Tulis artikel bantuan (Pro) Mencipta artikel pangkalan pengetahuan, atau mengubah suai artikel sedia ada (id): tajuk, kandungan, petikan, kategori dan status (draf, atau terbitkan apabila anda boleh menerbitkan).	Edisi 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`	Cari pangkalan pengetahuan (Pro) Mencari artikel bantuan untuk dipautkan dalam balasan (q: carian).	Edisi Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	tiada
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Tetapkan jabatan dan tag perbualan (Pro) Menetapkan jabatan dan tanda sembang atau tiket (jenis: sembang atau tiket; id).	Edisi Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	tiada
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Tanda soalan yang belum dijawab (Pro) Menanda soalan yang belum dijawab sebagai terbuka, dirancang atau ditolak (id, status).	Edisi Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	tiada
`zinn-chat/set-presence` `zinn-chat-set-presence`	Tetapkan ketersediaan anda Menandakan ejen yang telah log masuk tersedia atau tiada untuk sembang baharu (away: true atau false).	Edisi percuma	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	tiada
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Draf balasan dengan AI (Pro) Menulis draf balasan kepada sembang atau tiket daripada kandungan tapak; tiada apa-apa yang dihantar.	Edisi Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	tiada
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Ringkaskan perbualan dengan AI (Pro) Meringkaskan sembang atau tiket dalam beberapa baris.	Edisi Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	tiada
`zinn-chat/take-chat` `zinn-chat-take-chat`	Mulakan perbualan Menugaskan sembang yang menunggu kepada ejen yang telah log masuk, supaya pelawat bercakap dengan seseorang.	Edisi percuma	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (diperlukan)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Tukar tetapan sembang Mengubah tetapan yang anda hantar (tetapan: kunci kepada nilai) dan mengekalkan yang selebihnya. Setiap nilai disemak persis seperti pada skrin tetapan; get-settings menyenaraikan kunci.	Edisi percuma	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (diperlukan)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Tukar tiket Mengubah status, keutamaan atau pemegang tiket.	Edisi percuma	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (diperlukan)