المطورون

مرجع قدرات Zinn® Chat

يسجل الإضافة Zinn® Chat إجراءاته باستخدام واجهة برمجة تطبيقات القدرات في WordPress. القدرات ذاتها هي أدوات MCP على خادم الموقع نفسه ومسارات REST ضمن /wp-json/wp-abilities/v1. يتم إنشاء هذه الصفحة من السجل الخاص بالإضافة.

دليل المستخدم: توصيل تطبيق ذكاء اصطناعي

نقاط النهاية

بروتوكول تحكم متعدد عبر بروتوكول نقل النص الفائق (قابل للبث)

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`	الرد على تذكرة يرد على العميل عبر البريد الإلكتروني (نص)، أو يضيف ملاحظة داخلية (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 تذكرة (المعرفات). تخضع كل تذكرة لنفس عمليات التحقق كما لو تم تغييرها بمفردها؛ وتعرض النتيجة كل واحدة منها.	إصدار المحترفين	`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) يحذف ردّاً محفوضاً.	إصدار المحترفين	`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) يكتب مسودة مقالة لقاعدة المعرفة من تذكرة محلولة؛ وتظل مسودة حتى ينشرها شخص ما.	إصدار المحترفين	`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)؛ وتبقى مسودات.	إصدار المحترفين	`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`	املأ ردًا محفوظًا (احترافي) يعيد نص رد محفوظ مع تعبئة العناصر النائية الخاصة به لمحادثة أو تذكرة واحدة.	إصدار المحترفين	`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 يوم (أيام).	إصدار المحترفين	`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) يعرض الردود المحفوظة التي يمكن للممثلين إدراجها، مع اختصاراتها.	إصدار المحترفين	`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) يعرض الأسئلة التي طرحها الزوار والتي لم تتمكن قاعدة المعارف من الإجابة عنها.	إصدار المحترفين	`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`	حفظ رد محفوض (احترافي) ينشيء أو يغير ردّاً محفوظاً (العنوان، والاختصار، والنص، والقسم؛ والمعرّف لتغيير ردّ واحد).	إصدار المحترفين	`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): العنوان، المحتوى، المقتطف، التصنيفات والحالة (مسودة، أو نشر عندما يُسمح لك بالنشر).	إصدار المحترفين	`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`	البحث في قاعدة المعارف (احترافي) البحث عن مقالات المساعدة لربطها في رد (q: البحث).	إصدار المحترفين	`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) يُعِدُّ القِسمَ والوَسومَ الخاصةَ بمُحادَثَةٍ أو تَذْكِرَةٍ (النوعُ: مُحادَثَةٌ أو تَذْكِرَةٌ؛ المُعرِّفُ).	إصدار المحترفين	`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`	تحديد الأسئلة التي لم يتم الرد عليها (برو) تحديد الأسئلة التي لم يُرد عليها كـ مفتوحة، أو مخطط لها، أو مرفوضة (المعرفات، الحالة).	إصدار المحترفين	`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) يكتب مسودة رد على محادثة أو تذكرة بناءً على محتوى الموقع؛ ولا يتم إرسال أي شيء.	إصدار المحترفين	`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) يلخص محادثة أو تذكرة في بضع أسطر.	إصدار المحترفين	`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 (مطلوب)