นักพัฒนา

ข้อมูลอ้างอิงความสามารถของ Zinn® Chat

Zinn® Chat ลงทะเบียนการดำเนินการผ่าน WordPress Abilities API ความสามารถเดียวกันนี้คือเครื่องมือ MCP บนเซิร์ฟเวอร์ของเว็บไซต์เองและเป็นเส้นทาง REST ใต้ /wp-json/wp-abilities/v1 หน้านี้สร้างขึ้นจากรีจิสทรีของปลั๊กอินเอง

คู่มือผู้ใช้: เชื่อมต่อแอป 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 ของปลั๊กอิน ซึ่งสร้างขึ้นจากเว็บไซต์ที่กำลังทำงานอยู่; การทดสอบจะล้มเหลวเมื่อทั้งสองอย่างไม่ตรงกัน

ความสามารถ	การทำงานอย่างไร	ฉบับพิมพ์	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`	ถามผู้ช่วย ถามคำถามกับผู้ช่วย 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) เปลี่ยนสถานะ ความสำคัญ หรือผู้รับผิดชอบของตั๋ว (ids) สูงสุด 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: เฉพาะข้อความที่ใหม่กว่ารหัสนี้)	รุ่นฟรี	`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`	ตอบกลับในการแชท ส่งข้อความถึงผู้เข้าชม (ข้อความ) หรือเพิ่มบันทึกภายในที่เฉพาะเจ้าหน้าที่มองเห็นเท่านั้น (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) สร้างหรือแก้ไขการตอบกลับที่บันทึกไว้ (ชื่อ, ทางลัด, เนื้อหา, แผนก; ระบุ id เพื่อแก้ไขรายการเดียว)	รุ่น 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) ตั้งค่าแผนกและแท็กของแชทหรือทิกเก็ต (ชนิด: แชทหรือทิกเก็ต; 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`	กำหนดสถานะว่างของคุณ กำหนดสถานะของเจ้าหน้าที่ที่เข้าสู่ระบบว่าพร้อมหรือไม่อยู่สำหรับแชทใหม่ (ไม่อยู่: 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 (จำเป็นต้องมี)