شرح Agent Plugins 1.0: معيار قابل للنقل للمهارات وخوادم MCP عبر وكلاء الذكاء الاصطناعي

الاسم: تحية
الوصف: تقديم التحية للمستخدم وعرض المساعدة.

تقديم تحية موجزة للمستخدم والسؤال عن كيفية تقديم المساعدة.

### الخطوة 4: إضافة MCP فقط عند الحاجة

إذا كانت الإضافة تحتاج إلى أدوات، فقم بإضافة:

```Plaintext
mcp.json

ليست الإضافات مضطرة لتهيئة MCP فارغ لمجرد الفعالية.

عدم وجود مكونات اختيارية في أماكنها لن يُعتبر خطأً.

الخطوة 5: الاختبار في عملاء متوافقين

اختبر النواة المحمولة في كل عميل تخطط لدعمه.

لا تفترض أن "توافق إضافات الوكيل" يعني أن كل مكوّن وناقل اتصال قد تم تنفيذه.

يمكن للعملاء تبني المكونات تدريجيًا.

مثال على إضافة مع خادم MCP محلي

حزمة أكثر فائدة قد تبدو كالتالي:

reporting-plugin/
├── plugin.json
├── skills/
│   └── weekly-report/
│       └── SKILL.md
├── mcp.json
└── bin/
    └── reporting-server

البيان:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "reporting-plugin",
  "version": "1.0.0",
  "description": "سير عمل وأدوات تقارير محمولة."
}

إعداد MCP:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "reporting": {
      "type": "stdio",
      "command": "./bin/reporting-server",
      "cwd": "${PLUGIN_ROOT}"
    }
  }
}

يمكن للعميل المتوافق مع المعيار اكتشاف:

• هوية الإضافة
• مهارة التقرير الأسبوعي
• خادم تقارير MCP

دون حاجة المؤلف إلى وضع هذه المكونات المحمولة في هياكل مختلفة تمامًا لكل عميل.

عزل الأخطاء يجعل الإضافات أكثر مرونة

جزء مدروس جيدًا في المواصفة هو أن العديد من أعطال المكونات تكون موضعية وليست كارثية.

على سبيل المثال:

• يمكن تخطي مهارة غير صالحة بينما تستمر المهارات الأخرى في التحميل.
• إدخال خادم MCP غير صالح لا يعطل بالضرورة جميع الخوادم.
• فشل اتصال MCP لا ينبغي أن يمنع تحميل المهارات المستقلة.
• يمكن للعملاء تجاهل أنواع المكونات غير المدعومة.

هذا أمر بالغ الأهمية في نظام بيئي حقيقي متعدد العملاء.

يمكن للإضافة أن توفر:

المهارة أ
المهارة ب
خادم MCP أ
خادم MCP ب
ملحقات العميل

إذا كان عميل معين لا يدعم ناقل اتصال محدد، فيجب أن يظل الجزء المحمول المفيد يعمل بشكل طبيعي حيثما أمكن.

وإلا فإن قابلية التشغيل البيني ستصبح هشة: ميزة اختيارية غير مدعومة ستعطل الإضافة بأكملها.

العملاء المتوافقون مع المعيار يمكنهم اعتماده تدريجيًا

لا يُطلب من العميل تنفيذ كل ميزة في الإصدار الأول.

العميل الذي يدعم المهارات فقط يمكنه أن يظل متوافقًا مع المعيار إذا قام بتحميل البيان بشكل صحيح ونفّذ سلوكيات المهارات ذات الصلة.

العميل الذي يدعم MCP يجب أن يفي بقواعد النقل السارية.

هذا النمط المتدرج يقلل من حاجز التبني.

يمكن للعملاء الأصغر البدء بـ:

plugin.json
+
skills/

وإضافة MCP لاحقًا.

يمكن للعملاء الأكبر تنفيذ النواة المحمولة الكاملة بالإضافة إلى مساحات أسمائهم الخاصة بالملحقات.

المشروع تُديره المجتمع وليس بائعًا واحدًا

العنوان في AIBase يصف أن OpenAI قدّمت الإضافات الوكيلة.

OpenAI لاعب مهم بوضوح.

وثيقة الحوكمة الرسمية تجعل نمط الملكية أوسع.

إضافات الوكيل تقدّم نفسها

كمشروع مُدار من المجتمع ومحايد تجاه البائعين.

تتكون لجنتها الفنية التوجيهية من مطوّرين أساسيين مستقلين، دون مقاعد مخصصة للشركات.

ينص الميثاق على:

• لا يجوز لأي بائع واحد السيطرة على أغلبية مقاعد المطوّرين الأساسيين.
• المقترحات الفنية والنقاشات علنية.
• المشاركة في المشروع مفتوحة وفق قواعد واضحة.
• مواد المواصفات والتوثيق مرخّصة افتراضيًا بموجب CC BY 4.0.
• الأنماط والكود ومواد البرمجيات مرخّصة افتراضيًا بموجب Apache 2.0.

الصفحة الرئيسية للمشروع تدرج حاليًا المطوّرين الأساسيين الأوليين ممثلين عن:

• أمازون
• كيرسور
• مايكروسوفت
• OpenAI
• فيرسيل

هذا الهيكل متعدد البائعين مهم لأن معايير التشغيل البيني تكون أكثر مصداقية عندما يكون لدى العملاء المنافسين مسار للمشاركة.

المعيار لديه بالفعل عدة عملاء متوافقين

صفحة التوافق الرسمية تدرج حاليًا:

• VS Code
• كيرسور
• GitHub Copilot
• ChatGPT مع Codex
• كيرو

هذه بداية أقوى من معيار مدعوم فقط من مؤلفه الأصلي.

مصفوفة الدعم ليست متطابقة تمامًا بعد.

على سبيل المثال، الصفحة الحالية تدرج عدة عملاء يدعمون SSE التقليدي، بينما ChatGPT مع Codex يدرج حاليًا stdio وStreamable HTTP.

النتيجة المهمة هي أن تنسيق الحزمة قد عبر بالفعل حدود البائعين.

يمكن لمؤلفي الإضافات الآن استهداف نواة مشتركة دون افتراض أن كل بيئة وكيل نظام بيئي منفصل تمامًا.

لماذا يصبح هذا أكثر أهمية مع تحول الوكلاء إلى أنظمة طويلة الأمد

عندما ينفذ الوكلاء عملًا فعليًا، تكون مشكلة تجزئة الإضافات أكثر وضوحًا.

روبوت الدردشة البسيط يمكن أن يعمل بقائمة أدوات صغيرة ثابتة.

الوكيل الجاد قد يحتاج إلى:

• عمليات خاصة بالشركة
• وصول إلى قواعد البيانات
• أتمتة المتصفح
• أدوات النشر
• فحوصات أمنية
• سير عمل التوثيق
• تعليمات مجال قابلة لإعادة الاستخدام
• نصوص برمجية مخصصة
• خدمات MCP متعددة

مع تضاعف هذه المكونات، تصبح قابلية النقل بنية تحتية.

بدون آلية تغليف مشتركة، تواجه كل شركة خطر الحفاظ على مصفوفة مثل:

القدرات × عملاء الوكلاء × الإصدارات × المنصات

تنسيق الحزمة المحمولة يقلل بُعدًا واحدًا من هذه المصفوفة.

إنه لا يلغي العمل الخاص بالعميل.

لكنه يقلل من الجهد المكرر المطلوب للحفاظ على النواة القابلة لإعادة الاستخدام متسقة.

إضافات الوكيل وMCP ومهارات الوكيل تحل مشاكل مختلفة

هذه المفاهيم الثلاثة مترابطة لكن لا ينبغي الخلط بينها.

المعيار	الوظيفة الرئيسية
مهارات الوكيل	تعريف أصول التعليمات/سير العمل القابلة لإعادة الاستخدام للوكيل
MCP	تعريف الاتصال بين عميل الذكاء الاصطناعي وخوادم الأدوات/البيانات الخارجية
إضافات الوكيل	تعريف كيفية تجميع المهارات وإعدادات MCP معًا بشكل محمول

نموذج ذهني مفيد هو:

المهارات
= ما يجب أن يعرفه الوكيل أو كيف يجب أن يعمل

MCP
= كيف يتصل الوكيل بالقدرات الخارجية

إضافات الوكيل
= كيف تُحزم هذه الأجزاء القابلة لإعادة الاستخدام لتناسب العملاء المتوافقين

لذلك، إضافات الوكيل هي طبقة تعلو معايير المكونات الحالية، وليست بديلًا عنها.

ما لا تحله إضافات الوكيل

نطاق المعيار ضيق عمدًا.

إنه لا يحل جميع مشاكل التوافق عبر الوكلاء.

لا يوحّد النماذج

قد يتصرف نفس الإضافة بشكل مختلف عند تحميلها بنماذج مختلفة.

لا يوحّد واجهات الأذونات

قد يطلب عميل تأكيدًا قبل تنفيذ إجراء بينما يستخدم عميل آخر سياسات على مستوى مساحة العمل.

لا يوحّد المصادقة

OAuth وتخزين بيانات الاعتماد تظلان من مسؤولية العميل.

لا يضمن دعم جميع ناقلات اتصال MCP

يمكن للعملاء تنفيذ مجموعات فرعية مختلفة.

لا يوحّد الخطافات أو الأوامر في الإصدار الأول

تظل هذه معرّفة من قبل العميل نفسه.

لا ينشئ سوق تطبيقات موحدًا

التوزيع لا يزال خارج نطاق المواصفة الأساسية.

لا يعزل عمليات MCP في صندوق رمل

احتواء مسار الحزمة لا يعادل العزل أثناء التشغيل.

لا يضمن سلوكًا متطابقًا تمامًا

قابلية النقل تعني أن العملاء يمكنهم اكتشاف المكونات وتحميلها وفق عقد مشترك. هذا لا يعني أن كل بيئة وكيل ستستنتج أو تستدعي ذلك المكوّن بنفس الطريقة تمامًا.

اعتبارات الأمان لمؤلفي الإضافات

الإضافات المحمولة يمكن أن توسّع نطاق التوزيع.

هذا يزيد أيضًا من أهمية إعدادات الأمان الافتراضية.

لا تقم بتضمين معلومات سرية

تجنب تخزين بيانات الاعتماد في الأماكن التالية:

plugin.json
ترويسة mcp.json
قيم متغيرات البيئة في mcp.json
ملفات الحزمة

يرجى استخدام المصادقة المدارة من قبل العميل.

حافظ على تقييد مسار الحزمة

لا تعتمد على الخروج من الدليل الجذر للمكوّن الإضافي للوصول إلى ملفات المضيف التعسفية.

تعامل مع خوادم MCP المحلية كرمز قابل للتنفيذ

يمكن لخوادم stdio تشغيل عمليات.

يجب أن يكون المستخدمون ومسؤولو المؤسسات على دراية بما يقومون بتثبيته.

تقليل الصلاحيات المطلوبة إلى الحد الأدنى

المكوّن الإضافي الذي يحتاج فقط إلى صلاحيات القراءة يجب ألا يطلب عمليات الكتابة.

توثيق الخدمات الخارجية

يجب أن يكون لخوادم MCP البعيدة سياسات واضحة للملكية والخصوصية واستخدام البيانات.

توخَّ الحذر في إدارة الإصدارات

حتى إذا ظل هيكل الدليل صالحًا، فإن التغييرات في سلوك الخادم قد تشكل تغييرات جذرية.

ما الذي يجب على المطورين فعله الآن

الخطوة 1: التمييز بين الأجزاء القابلة للنقل والأجزاء الخاصة بالعميل

حدد الأجزاء القابلة لإعادة الاستخدام حقًا في المكوّن الإضافي الحالي:

المهارات
خوادم MCP
البيانات الوصفية المشتركة

انقل السلوكيات الخاصة بالعميل فقط إلى مساحات الأسماء الخاصة بالامتدادات المقابلة.

الخطوة 2: إضافة نمط برقم إصدار

صرّح صراحةً بـ Agent Plugins 1.0.0 في plugin.json.

الخطوة 3: توحيد مكان وضع المهارات

ضع مهارات الوكيل القابلة للنقل في:

skills/<اسم-المهارة>/SKILL.md

الخطوة 4: توحيد تكوين MCP

استخدم ملفًا على المستوى الجذري:

mcp.json

بدلاً من الاعتماد فقط على ملفات التكوين الأصلية الخاصة بالعميل.

الخطوة 5: إزالة المعلومات السرية القابلة للنقل

انقل بيانات الاعتماد إلى أنظمة المصادقة الخاصة بكل عميل.

الخطوة 6: اختبار الحزمة عبر عدة عملاء

يجب التحقق من قابلية التشغيل البيني عبر عروض توضيحية فعلية، وليس افتراضًا.

الخطوة 7: متابعة تحديثات المواصفات

نظرًا لأن المواصفات الحالية لا تزال موسومة كمسودة عمل، تابع التغييرات في مستودع المشروع والمناقشات والأنماط وصفحات التوافق.

المحتوى المؤكد والمحتوى الذي يحتاج إلى مزيد من التوضيح

البيان	الحالة
تم إصدار مواصفات Agent Plugins 1.0.0	مؤكد
تُعرِّف المواصفات طريقة التعبئة المحمولة للمهارات وخوادم MCP	مؤكد
ملف plugin.json في الجذر إلزامي	مؤكد
skills/ هو الموقع الثابت للمهارات	مؤكد
ملف mcp.json في الجذر هو موقع تكوين MCP	مؤكد
نقل stdio و Streamable HTTP هما نوعا نقل MCP القياسيان	مؤكد
يتم الاعتراف بـ SSE التقليدي، لكنه اختياري للعملاء	مؤكد
تستخدم امتدادات العميل الخاصة مساحات أسماء بأسماء نطاقات معكوسة	مؤكد
التوزيع والتثبيت والصلاحيات وتجربة المستخدم موحَّدة	لا؛ تم استبعادها عن قصد من النطاق
الخطافات هي مكونات محمولة في Agent Plugins v1	لا؛ يمكن أن تكون امتدادات خاصة بالعميل
OpenAI تمتلك أو تدير Agent Plugins حصريًا	لا
المشروع محايد تجاه البائعين وتديره المجتمع	مؤكد عبر الحوكمة الرسمية
إصدار 1.0.0 هو معيار نهائي مجمّد تمامًا	لا؛ صفحة المواصفات مصنفة حاليًا كمسودة عمل
يدعم كل عميل متوافق جميع المكونات ونقل MCP	لا
تم إدراج ChatGPT و Codex و VS Code و Cursor و GitHub Copilot و Kiro كعملاء متوافقين	مؤكد في صفحة التوافق الحالية

الأسئلة الشائعة

ما هو Agent Plugins 1.0؟

Agent Plugins 1.0 هو تنسيق حزمة مفتوح ومحايد تجاه البائعين لامتدادات وكلاء الذكاء الاصطناعي القابلة لإعادة الاستخدام. إنه يوحد كيفية وضع مهارات الوكيل وتكوينات خوادم MCP في دليل مكوّن إضافي محمول.

هل Agent Plugins معيار خاص بـ OpenAI فقط؟

لا. تشارك OpenAI في المشروع وتدعم التنسيق في ChatGPT و Codex، لكن المشروع الرسمي تُديره المجتمع وهو محايد تجاه البائعين. يضم فريق القائمين الأوليين أشخاصًا مرتبطين بـ Amazon و Cursor و Microsoft و OpenAI و Vercel.

ما الملفات المطلوبة للمكوّن الإضافي للوكيل؟

يتطلب كل مكوّن إضافي ملف plugin.json في الجذر. يمكن تخزين المهارات تحت skills/، بينما يمكن وصف خوادم MCP في ملف mcp.json في الجذر؛ ويمكن تنفيذ الوظائف الخاصة بالعميل باستخدام امتدادات مساحات الأسماء.

هل سيحل Agent Plugins محل MCP؟

لا. لا يزال MCP يعرّف البروتوكول المستخدم بين العملاء وخوادم MCP. يعرّف Agent Plugins طريقة محمولة لتعبئة تكوينات خوادم MCP بالإضافة إلى مكونات الوكيل القابلة لإعادة الاستخدام الأخرى.

هل الخطافات جزء من Agent Plugins 1.0؟

لا كعنصر أساسي محمول. يعمل الإصدار 1 على توحيد المهارات وخوادم MCP؛ يمكن تنفيذ الخطافات عبر مساحات أسماء الامتدادات الخاصة بالعميل حيثما كان ذلك مدعومًا.

ما العملاء الذين يدعمون Agent Plugins؟

تدرج صفحة التوافق الرسمية حاليًا VS Code و Cursor و GitHub Copilot و ChatGPT مع Codex و Kiro. تختلف أنواع نقل MCP التي يدعمونها، لذا يجب على المؤلفين الاطلاع على المصفوفة المباشرة.

هل يتصرف المكوّن الإضافي للوكيل بنفس الطريقة في كل عميل؟

لا. يغطي المعيار اكتشاف الحزمة والمكونات المحمولة، ولا يتناول النماذج أو واجهات الصلاحيات أو تدفقات المصادقة أو الأسواق أو سلوكيات وقت التشغيل الخاصة بالعميل. يمكن أن تكون المكوّنات الإضافية محمولة، لكنها لن تنتج بالضرورة نفس سلوك التنفيذ.

هل يُعتبر Agent Plugins 1.0 إصدارًا نهائيًا؟

1.0.0 هو الإصدار المعلن حاليًا ويوفّر الأنماط المعيارية. تصنف صفحة المواصفات حاليًا حالة المشروع على أنها "مسودة عمل"، لذلك يجب على المطورين مواصلة متابعة عمليات الحوكمة والتحكم في الإصدارات العلنية.

الأدوات ذات الصلة

• Agent Plugins: الموقع الرسمي للوثائق لحزم Agent Plugins المحمولة حسب التنسيق.
• Agent Skills: مواصفات مفتوحة لمكونات المهارات القابلة لإعادة الاستخدام في المكوّنات الإضافية للوكيل.
• Model Context Protocol: البروتوكول المستخدم من قبل عملاء وخوادم MCP المعبأين عبر mcp.json.
• مكوّنات ChatGPT الإضافية: نظام المكوّنات الإضافية الحالي من OpenAI لسير عمل ChatGPT و Codex.
• مكوّنات VS Code الإضافية للوكيل: وثائق Microsoft حول تحميل المكوّنات الإضافية للوكيل في VS Code.
• مكوّنات GitHub Copilot الإضافية: وثائق GitHub حول حزم المكوّنات الإضافية ودعم مواصفات المكوّنات الإضافية المفتوحة.

الروابط ذات الصلة

• مواصفات Agent Plugins 1.0.0: القيود المعيارية الكاملة للتنسيق المحمول الحالي.

• بناء مكوّن إضافي للوكيل: البرنامج التعليمي الرسمي لأصغر مكوّن إضافي ودليل تخطيط الحزمة.

• [العملاء المتوافقون](https://agent-plugins.

• org/compatible-clients: مصفوفة الدعم الحالية لـ VS Code وCursor وGitHub Copilot وChatGPT مع Codex وKiro.

• مستودع مواصفات إضافات الوكلاء: الأنماط العامة، والحوكمة، والقضايا، والمناقشات، ومصدر المواصفات.

• حوكمة إضافات الوكلاء: ميثاق حوكمة المجتمع وقواعد الحياد تجاه الموردين.

• ترخيص إضافات الوكلاء: شروط الترخيص للمواصفات والوثائق والأنماط والكود.

• إضافات OpenAI في ChatGPT وCodex: توثيق منتج OpenAI حول الإضافات والتطبيقات والمهارات والتحكم في مساحات العمل.

الملخص

حلّت إضافات الوكلاء 1.0 مشكلة عملية في النظام البيئي المتنامي للوكلاء: حيث كان المطورون يعيدون حزم نفس المهارات وتكاملات MCP بطرق مختلفة لكل عميل.

يعرّف هذا المواصفة نواة صغيرة قابلة للنقل — ملف plugin.json الإلزامي، والمهارات في دليل skills/، وإعدادات MCP في mcp.json، وقواعد تغليف الحزم، ونمط الإصدارات، وامتدادات العملاء المعتمدة على مساحات الأسماء. يبقى التوزيع والأسواق والأذونات والمصادقة وواجهة المستخدم تحت سيطرة العملاء.

أدرج المشروع دعمًا لعدة عملاء وكلاء رئيسيين، بما في ذلك VS Code وCursor وGitHub Copilot وChatGPT مع Codex وKiro. وهذا يجعله أكثر من مجرد تنسيق إضافات خاص بـ OpenAI، على الرغم من أن OpenAI من بين الأطراف المشاركة في الصيانة.

الإصدار 1.0.0 هو العقد الحالي المنشور، بينما لا تزال صفحة المواصفات تصنّفه كمسودة عمل. يمكن للمطورين اعتماده الآن، لكن يجب متابعة عمليات الحوكمة والإصدار العلنية.

التحول الرئيسي بسيط: بدلاً من إعادة كتابة نفس ملحقات الوكلاء لكل منصة، يمكن للمطورين اعتبار المهارات وتكاملات MCP مكونات قابلة للنقل بهيكل حزم موحد.