מפתחים

הפניות ליכולות של 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 והקלט שלהן במחרוזת השילתא (query string); השאר פועלות עם 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`	מענה לפנייה עונה ללקוח באמצעות דוא״ל (טקסט), או מוסיף הערה פנימית (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: רק הודעות חדשות מזהה זה).	מהדורה חינמית	`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`	קרא את הגדרות הצ'אט מחזיר את כל הגדרות הצ'אט: הווידג'ט, עוזר ה-AI, אנשים ושעות פתיחה, פניות ואימייל, מפתח האתר, פרטיות וספאם.	מהדורה חינמית	`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`	העבר את השיחה בחזרה לעוזר מחזיר צ'אט לעוזר הבינה המלאכותית, העונה למבקר מתוך תוכן האתר.	מהדורה חינמית	`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`	השב בצ'אט שולח הודעה למבקר (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) מגדיר את המחלקה והתגים של צ'אט או פנייה (סוג: צ'אט או פנייה; מזהה).	מהדורת 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`	הכן טיוטת תשובה באמצעות בינה מלאכותית (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`	סיכום שיחה עם בינה מלאכותית (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 (נדרש)