ڈویلپرز

Zinn® Chat کی صلاحیتوں کا حوالہ

Zinn® Chat اپنے ایکشنز کو WordPress Abilities API کے ساتھ رجسٹر کرتا ہے۔ یہی abilities سائٹ کے اپنے سرور پر MCP ٹولز اور /wp-json/wp-abilities/v1 کے تحت REST روٹس ہیں۔ یہ صفحہ پلگ ان کی اپنی رجسٹری سے تیار کیا گیا ہے۔

صارف گائیڈ: ایک AI ایپ مربوط کریں

اینڈ پوائنٹس

MCP بذریعہ HTTP (اسٹریمیبل)

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

WP-CLI پر MCP (معیاری ان پٹ اور آؤٹ پٹ)

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 ایپلیکیشن پاس ورڈ (ایچ ٹی ٹی پی بیسک) کے ساتھ توثیق کرتی ہیں۔ ایم سی پی (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`	ٹکٹ کا جواب دیں گاہک کو ای میل (text) کے ذریعے جواب دیتا ہے، یا ایک داخلی نوٹ شامل کرتا ہے (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`	ایک ساتھ کئی ٹکٹ تبدیل کریں (پرو) 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`	محفوظ کردہ جواب حذف کریں (پرو) محفوظ کردہ جواب کو حذف کرتا ہے۔	پرو ایڈیشن	`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`	ٹکٹ سے ایک مدد کا مضمون تیار کریں (پرو) ایک حل شدہ ٹکٹ سے نالج بیس کے مسودے کا مقالہ تیار کرتا ہے؛ یہ اس وقت تک مسودہ رہتا ہے جب تک کوئی شخص اسے شائع نہیں کرتا۔	پرو ایڈیشن	`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`	سپورٹ کے اعداد و شمار پڑھیں (پرو) آخری 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`	چیٹ دوبارہ اسسٹنٹ کے حوالے کریں ایک چیٹ 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`	محفوظ شدہ جوابات کی فہرست (پرو) محفوظ کردہ جوابات کی فہرست دیتا ہے جنہیں ایجنٹس ان کے شارٹ کٹس کے ساتھ درج کر سکتے ہیں۔	پرو ایڈیشن	`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`	غیر جواب شدہ سوالات کی فہرست (پرو) ان سوالات کی فہرست بناتا ہے جو آنے والوں نے پوچھے جن کا جواب نالج بیس نہیں دے سکا۔	پرو ایڈیشن	`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`	محفوظ کردہ جواب محفوظ کریں (پرو) ایک محفوظ شدہ جواب بناتا ہے یا تبدیل کرتا ہے (عنوان، شارٹ کٹ، باڈی، ڈیپارٹمنٹ؛ تبدیل کرنے کے لیے ID)۔	پرو ایڈیشن	`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`	ایک مددگار مضمون لکھیں (پرو) علمی بنیاد کا ایک مقالہ بناتا ہے، یا کسی ایک کو تبدیل کرتا ہے (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) کسی چیٹ یا ٹکٹ کے محکمے اور ٹیگز سیٹ کرتا ہے (قسم: چیٹ یا ٹکٹ؛ شناخت/id)۔	پرو ایڈیشن	`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`	بغیر جواب کے سوالات کو نشان زد کریں (پرو) غیر جواب شدہ سوالات کو اوپن (open)، پلانڈ (planned) یا ڈسمسڈ (dismissed) کے طور پر نشان زد کرتا ہے (آئی ڈیز، اسٹیٹس)۔	پرو ایڈیشن	`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) کے ساتھ جواب کا مسودہ تیار کریں سائٹ کے مواد سے چیٹ یا ٹکٹ کے جواب کا مسودہ تیار کرتا ہے؛ کچھ بھی نہیں بھیجا جاتا۔	پرو ایڈیشن	`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) کے ساتھ گفتگو کا خلاصہ کریں چند سطروں میں چیٹ یا ٹکٹ کا خلاصہ پیش کرتا ہے۔	پرو ایڈیشن	`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`	چیٹ کی ترتیبات تبدیل کریں آپ جو ترتیبات (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 (لازمی)