Nhà phát triển

Tài liệu tham khảo tính năng của Zinn® Chat

Zinn® Chat đăng ký các hành động của mình với WordPress Abilities API. Các khả năng tương tự là các công cụ MCP trên máy chủ riêng của trang web và các tuyến REST dưới /wp-json/wp-abilities/v1. Trang này được tạo từ sổ đăng ký của chính plugin.

Hướng dẫn sử dụng: kết nối ứng dụng AI

Điểm cuối

MCP qua HTTP (có thể phát trực tuyến)

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

MCP qua WP-CLI (đầu vào và đầu ra chuẩn)

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

REST: liệt kê các khả năng

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

REST: chạy một kỹ năng

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

Xác thực và quyền truy cập

Các yêu cầu HTTP được xác thực bằng mật khẩu ứng dụng WordPress (HTTP Basic). Việc kết nối với máy chủ MCP cần có khả năng hiển thị bên dưới; mọi tính năng sau đó sẽ kiểm tra quyền riêng của chính nó, theo từng đối tượng. Các tính năng chỉ đọc chạy với phương thức GET và đầu vào nằm trong chuỗi truy vấn; các tính năng còn lại chạy với phương thức POST và phần thân JSON {"input": {…}}.

Ví dụ

# REST: chạy một kỹ năng
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":{}}}

Tất cả quyền hạn

Được tạo từ abilities.json của plugin, tệp này tự động được tạo từ một trang web đang chạy; một bài kiểm tra sẽ thất bại khi cả hai không khớp nhau.

Quyền hạn	Chức năng	Phiên bản	REST	Quyền hạn	Tham số
`zinn-chat/answer-ticket` `zinn-chat-answer-ticket`	Trả lời ticket Trả lời khách hàng qua email (text) hoặc thêm ghi chú nội bộ (note: true); trạng thái tùy chọn thay đổi trạng thái của yêu cầu hỗ trợ.	Bản miễn phí	`POST …/abilities/zinn-chat/answer-ticket/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/ask-assistant` `zinn-chat-ask-assistant`	Hỏi trợ lý Đặt câu hỏi cho trợ lý AI của trang web và trả về câu trả lời cùng với mọi nguồn mà nó tìm thấy.	Bản miễn phí	`POST …/abilities/zinn-chat/ask-assistant/run`	the REST route's own per-item permission check	không có
`zinn-chat/bulk-update-tickets` `zinn-chat-bulk-update-tickets`	Thay đổi nhiều phiếu hỗ trợ cùng lúc (Pro) Thay đổi trạng thái, mức độ ưu tiên hoặc người được giao của tối đa 100 ticket (id). Mỗi ticket đều trải qua các bước kiểm tra giống như khi thay đổi riêng lẻ; kết quả sẽ liệt kê từng ticket một.	Bản Pro	`POST …/abilities/zinn-chat/bulk-update-tickets/run`	zinn_chat_answer	ids: array (Bắt buộc), status: open\|pending\|solved\|closed, priority: low\|normal\|high\|urgent, assignee_id: integer
`zinn-chat/chat-to-ticket` `zinn-chat-chat-to-ticket`	Biến cuộc trò chuyện thành một phiếu hỗ trợ Mở một yêu cầu hỗ trợ từ cuộc trò chuyện để có thể trả lời qua email (cần có địa chỉ email của khách truy cập).	Bản miễn phí	`POST …/abilities/zinn-chat/chat-to-ticket/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/close-chat` `zinn-chat-close-chat`	Đóng một đoạn chat Kết thúc một cuộc trò chuyện; khách truy cập vẫn có thể yêu cầu bản ghi.	Bản miễn phí	`POST …/abilities/zinn-chat/close-chat/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/create-ticket` `zinn-chat-create-ticket`	Gửi yêu cầu hỗ trợ Mở một phiếu hỗ trợ thay mặt cho khách hàng (email, tiêu đề và tin nhắn đầu tiên của họ).	Bản miễn phí	`POST …/abilities/zinn-chat/create-ticket/run`	the REST route's own per-item permission check	không có
`zinn-chat/delete-canned-reply` `zinn-chat-delete-canned-reply`	Xóa câu trả lời đã lưu (Pro) Xóa một phản hồi đã lưu.	Bản Pro	`POST …/abilities/zinn-chat/delete-canned-reply/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/delete-ticket` `zinn-chat-delete-ticket`	Xóa vé hỗ trợ Xóa vĩnh viễn một phiếu hỗ trợ và cuộc trò chuyện của phiếu đó (chỉ dành cho quản lý).	Bản miễn phí	`POST …/abilities/zinn-chat/delete-ticket/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/draft-kb-article` `zinn-chat-draft-kb-article`	Soạn một bài viết trợ giúp từ một phiếu hỗ trợ (Pro) Viết một bài viết nháp trên cơ sở kiến thức từ một phiếu hỗ trợ đã được giải quyết; bài viết sẽ giữ nguyên trạng thái nháp cho đến khi được con người xuất bản.	Bản Pro	`POST …/abilities/zinn-chat/draft-kb-article/run`	edit_posts (the REST route's own check)	không có
`zinn-chat/draft-kb-from-gaps` `zinn-chat-draft-kb-from-gaps`	Soạn thảo bài viết trợ giúp cho các câu hỏi chưa có câu trả lời (Pro) Viết các bài viết nháp trong cơ sở tri thức để trả lời các câu hỏi đã chọn (ids); các bài viết này vẫn giữ nguyên trạng thái nháp.	Bản Pro	`POST …/abilities/zinn-chat/draft-kb-from-gaps/run`	edit_posts (the REST route's own check)	không có
`zinn-chat/fill-canned-reply` `zinn-chat-fill-canned-reply`	Điền câu trả lời đã lưu (Pro) Trả về nội dung của một câu trả lời đã lưu với các chỗ giữ chỗ đã được điền cho một cuộc trò chuyện hoặc phiếu hỗ trợ.	Bản Pro	`POST …/abilities/zinn-chat/fill-canned-reply/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/get-chat` `zinn-chat-get-chat`	Đọc cuộc trò chuyện Trả về tin nhắn và thông tin chi tiết của khách truy cập cho một đoạn chat (after: chỉ lấy các tin nhắn mới hơn ID này).	Bản miễn phí	`GET …/abilities/zinn-chat/get-chat/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/get-overview` `zinn-chat-get-overview`	Đọc tổng quan hỗ trợ Trả về số lượng vé trong mỗi trạng thái, số lượng đoạn chat đang chờ nhân viên (cùng với tin nhắn chưa đọc của họ), và trạng thái bật/tắt của đoạn chat, trợ lý ảo và vé hỗ trợ.	Bản miễn phí	`GET …/abilities/zinn-chat/get-overview/run`	zinn_chat_answer	không có
`zinn-chat/get-settings` `zinn-chat-get-settings`	Đọc cài đặt trò chuyện Trả về mọi cài đặt trò chuyện: tiện ích, trợ lý, con người và giờ mở cửa, phiếu hỗ trợ và email, chỉ mục trang web, quyền riêng tư và thư rác.	Bản miễn phí	`GET …/abilities/zinn-chat/get-settings/run`	zinn_chat_manage	không có
`zinn-chat/get-stats` `zinn-chat-get-stats`	Xem thống kê hỗ trợ (Pro) Trả về số lượng cuộc trò chuyện và phiếu hỗ trợ, thời gian phản hồi và đánh giá cho N ngày qua (ngày).	Bản Pro	`GET …/abilities/zinn-chat/get-stats/run`	the REST route's own per-item permission check	không có
`zinn-chat/get-ticket` `zinn-chat-get-ticket`	Đọc phiếu hỗ trợ Trả về một phiếu hỗ trợ kèm theo toàn bộ cuộc trò chuyện, trạng thái, mức độ ưu tiên và người được phân công.	Bản miễn phí	`GET …/abilities/zinn-chat/get-ticket/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/hand-chat-to-assistant` `zinn-chat-hand-chat-to-assistant`	Chuyển lại đoạn chat cho trợ lý Trả lại một cuộc trò chuyện cho trợ lý AI, trả lời khách truy cập từ nội dung của trang web.	Bản miễn phí	`POST …/abilities/zinn-chat/hand-chat-to-assistant/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/list-canned-replies` `zinn-chat-list-canned-replies`	Danh sách câu trả lời đã lưu (Pro) Liệt kê các câu trả lời đã lưu mà nhân viên hỗ trợ có thể chèn vào, kèm theo phím tắt của chúng.	Bản Pro	`GET …/abilities/zinn-chat/list-canned-replies/run`	the REST route's own per-item permission check	không có
`zinn-chat/list-chats` `zinn-chat-list-chats`	Liệt kê trò chuyện trực tiếp Liệt kê các cuộc trò chuyện đang chờ, đang diễn ra và mới đóng, kèm theo người xử lý từng cuộc.	Bản miễn phí	`GET …/abilities/zinn-chat/list-chats/run`	the REST route's own per-item permission check	không có
`zinn-chat/list-indexed-content` `zinn-chat-list-indexed-content`	Liệt kê những gì trợ lý biết Liệt kê nội dung mà trợ lý dùng để trả lời, cùng với trạng thái chỉ mục của nội dung đó, theo từng trang một.	Bản miễn phí	`GET …/abilities/zinn-chat/list-indexed-content/run`	the REST route's own per-item permission check	không có
`zinn-chat/list-kb-gaps` `zinn-chat-list-kb-gaps`	Liệt kê các câu hỏi chưa được trả lời (Pro) Liệt kê các câu hỏi mà khách truy cập đã đặt ra nhưng cơ sở kiến thức không thể trả lời.	Bản Pro	`GET …/abilities/zinn-chat/list-kb-gaps/run`	the REST route's own per-item permission check	không có
`zinn-chat/list-tickets` `zinn-chat-list-tickets`	Danh sách phiếu hỗ trợ Liệt kê các ticket hỗ trợ, được lọc theo trạng thái hoặc tìm kiếm, từng trang một.	Bản miễn phí	`GET …/abilities/zinn-chat/list-tickets/run`	the REST route's own per-item permission check	không có
`zinn-chat/reembed-content` `zinn-chat-reembed-content`	Xây dựng lại chỉ mục tìm kiếm của trợ lý Xây dựng lại các vectơ tìm kiếm cho một mục (item_id) hoặc toàn bộ (all: true) (chỉ dành cho người quản lý).	Bản miễn phí	`POST …/abilities/zinn-chat/reembed-content/run`	the REST route's own per-item permission check	không có
`zinn-chat/reindex-content` `zinn-chat-reindex-content`	Đọc lại nội dung cho trợ lý Đọc lại một mục (item_id) hoặc toàn bộ (all: true) vào chỉ mục của trợ lý (chỉ dành cho người quản lý).	Bản miễn phí	`POST …/abilities/zinn-chat/reindex-content/run`	the REST route's own per-item permission check	không có
`zinn-chat/reply-chat` `zinn-chat-reply-chat`	Trả lời trong một cuộc trò chuyện Gửi tin nhắn tới khách truy cập (text) hoặc chỉ thêm một ghi chú nội bộ mà các nhân viên mới thấy (note: true).	Bản miễn phí	`POST …/abilities/zinn-chat/reply-chat/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/save-canned-reply` `zinn-chat-save-canned-reply`	Lưu câu trả lời đã lưu (Pro) Tạo hoặc thay đổi một câu trả lời đã lưu (tiêu đề, phím tắt, nội dung, phòng ban; id để thay đổi một câu).	Bản Pro	`POST …/abilities/zinn-chat/save-canned-reply/run`	the REST route's own per-item permission check	không có
`zinn-chat/save-kb-article` `zinn-chat-save-kb-article`	Viết bài viết trợ giúp (Pro) Tạo một bài viết cơ sở kiến thức hoặc sửa đổi một bài viết (id): tiêu đề, nội dung, đoạn trích, danh mục và trạng thái (bản nháp, hoặc xuất bản khi bạn có thể xuất bản).	Bản 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`	Tìm kiếm cơ sở kiến thức (Pro) Tìm các bài viết trợ giúp để liên kết trong câu trả lời (q: nội dung tìm kiếm).	Bản Pro	`GET …/abilities/zinn-chat/search-kb/run`	the REST route's own per-item permission check	không có
`zinn-chat/set-conversation-details` `zinn-chat-set-conversation-details`	Đặt bộ phận và thẻ cho cuộc trò chuyện (Pro) Thiết lập phòng ban và các thẻ của cuộc trò chuyện hoặc phiếu hỗ trợ (loại: cuộc trò chuyện hoặc phiếu hỗ trợ; id).	Bản Pro	`POST …/abilities/zinn-chat/set-conversation-details/run`	the REST route's own per-item permission check	không có
`zinn-chat/set-kb-gap-status` `zinn-chat-set-kb-gap-status`	Đánh dấu các câu hỏi chưa trả lời (Pro) Đánh dấu các câu hỏi chưa được trả lời là đang mở, đã lên kế hoạch hoặc đã bỏ qua (id, trạng thái).	Bản Pro	`POST …/abilities/zinn-chat/set-kb-gap-status/run`	the REST route's own per-item permission check	không có
`zinn-chat/set-presence` `zinn-chat-set-presence`	Đặt trạng thái sẵn sàng của bạn Đánh dấu tác viên đã đăng nhập là có sẵn hoặc vắng mặt cho các đoạn chat mới (vắng mặt: true hoặc false).	Bản miễn phí	`POST …/abilities/zinn-chat/set-presence/run`	the REST route's own per-item permission check	không có
`zinn-chat/suggest-reply` `zinn-chat-suggest-reply`	Soạn thảo câu trả lời bằng AI (Pro) Soạn thảo bản nháp trả lời cho đoạn chat hoặc phiếu hỗ trợ từ nội dung của trang web; không có nội dung nào được gửi đi.	Bản Pro	`POST …/abilities/zinn-chat/suggest-reply/run`	the REST route's own per-item permission check	không có
`zinn-chat/summarise-conversation` `zinn-chat-summarise-conversation`	Tóm tắt cuộc trò chuyện với AI (Pro) Tóm tắt cuộc trò chuyện hoặc phiếu hỗ trợ trong vài dòng.	Bản Pro	`POST …/abilities/zinn-chat/summarise-conversation/run`	the REST route's own per-item permission check	không có
`zinn-chat/take-chat` `zinn-chat-take-chat`	Mở cuộc trò chuyện Gán một đoạn chat đang chờ cho nhân viên đã đăng nhập, để khách truy cập có thể trò chuyện với một người thật.	Bản miễn phí	`POST …/abilities/zinn-chat/take-chat/run`	the REST route's own per-item permission check	id: string (Bắt buộc)
`zinn-chat/update-settings` `zinn-chat-update-settings`	Thay đổi cài đặt trò chuyện Thay đổi các cài đặt bạn gửi (cài đặt: khóa tương ứng với giá trị) và giữ nguyên các cài đặt còn lại. Mỗi giá trị được kiểm tra chính xác như trên màn hình cài đặt; get-settings liệt kê các khóa.	Bản miễn phí	`POST …/abilities/zinn-chat/update-settings/run`	zinn_chat_manage	settings: object (Bắt buộc)
`zinn-chat/update-ticket` `zinn-chat-update-ticket`	Đổi một yêu cầu hỗ trợ Thay đổi trạng thái, mức độ ưu tiên hoặc người được giao của một phiếu hỗ trợ.	Bản miễn phí	`POST …/abilities/zinn-chat/update-ticket/run`	the REST route's own per-item permission check	id: string (Bắt buộc)