ACP وكلاء البرمجة

يربط Agent Client Protocol واجهةَ برمجةٍ بوكيل برمجة. قد تكون الواجهة محررًا، أو تطبيق سطح مكتب، أو CLI، أو وكيل ADK-Rust آخر. وكيل البرمجة هو عملية منفصلة تستدل على مشروع وتُبلغ عن عملها عبر جلسة مشتركة.

تُنفّذ ADK-Rust كلا جانبي إصدار البروتوكول الثابت ACP رقم 1:

استخدام وكيل برمجة ACP خارجي من تطبيق ADK-Rust؛
إتاحة وكيل ADK-Rust كعملية ACP يمكن للمحرر تشغيلها.

تستخدم عملية التنفيذ أداة agent-client-protocol Rust الرسمية SDK. إن إصدار الحزمة SDK وإصدار السلك ACP منفصلان: تستخدم ADK-Rust حاليًا SDK 1.2 أثناء التفاوض على إصدار البروتوكول 1 خلال initialize.

اقرأ هذا القسم

البنية والمفاهيم يشرح الدورين ومسار الطلب الكامل.
أنشئ عميلًا أو مضيفًا ACP يغطي التفويض أحادي الاستخدام، والجلسات المستمرة، والبث المتدفق، والإلغاء، والأذونات، والملفات، والمحطات الطرفية، وخوادم MCP للجلسات.
إتاحة وكيل ADK-Rust ACP يغطي إنشاء الخادم، وتعيين دورة الحياة، وبث الأحداث، واستمرارية الجلسة، والنشر.
الاختبار ومصفوفة الدعم يسرد السلوك المُتحقق منه والميزات التي لا تعلنها ADK-Rust عمدًا.

أي بروتوكول ينبغي أن أستخدم؟

الحدود	استخدمه لـ
ACP	واجهة برمجة تفاعلية تعمل مع وكيل برمجة داخل جلسة مشروع
A2A	وكلاء أعمال منشورون بشكل مستقل يتبادلون المهام والمواد عن بُعد
MCP	الأدوات والمطالبات والموارد المتاحة خلف وكيل

ACP قد يحمل تكوين خادم MCP عند فتح جلسة برمجة. هذا لا يجعل ACP وMCP قابلين للتبادل: ACP يملك محادثة وكيل البرمجة؛ MCP يوفّر الأدوات والموارد المستخدمة أثناء تلك المحادثة.

أمثلة

المثال	ما يثبته
`examples/acp_client_host`	واجهة مستخدم عميل مُبثّة، أذونات غير متزامنة، ونظام ملفات للقراءة فقط مقيّد بنطاق مساحة العمل
`examples/acp_kiro`	التفويض المباشر، وكيل ACP كأداة ADK، جلسات دائمة، تهيئة البيئة، والإلغاء المتزامن
`examples/acp_server`	وكيل ADK-Rust LLM يستخدم الأدوات ومتاح للمحررين عبر ACP v1
`examples/acp_full_protocol`	مرجع داخل العملية، بدون مفتاح API، مدعوم بـ `Runner` ويختبر سطح الخادم الكامل للمرحلة 2 (الموارد المضمنة + مطالبات الصور/الصوت، جسر الأذونات، إعادة تشغيل `session/load`، تحديثات الاستخدام/استدعاء الأدوات) مع اختبار متحقق

السابق: ← القياس المعياري | التالي: إعادة المحاولة والتأمل →