العودة إلى المدونة

الذكاء الاصطناعي للمبتدئيندليل

ما هو ACP (بروتوكول عميل الوكيل)؟ أحضر وكيلك الخاص

ACP هو المقبس بين محرر الشيفرة ووكيل البرمجة. إليك كيف يختلف عن MCP وأين يقف نموذجك ومفتاح API.

بواسطة CheapTokens Teamنُشر في 5 دقيقة قراءة

الغلاف: تدفق المحرر → ACP → الوكيل، البروتوكول بين محرر الشيفرة ووكيل البرمجة
في هذه الصفحة
  1. لماذا مقبس أصلًا؟
  2. كيف يعمل ACP، بكلمات بسيطة
  3. ACP مقابل MCP: أيّهما يربط ماذا
  4. أحضر وكيلك الخاص في Android Studio
  5. أين يقف النموذج ومفتاح API
  6. ماذا تفعل بعد ذلك

يوفّر Android Studio الآن قائمة تضم أكثر من 40 وكيل برمجة، والأخبار المتعلقة بذلك تذكر دائمًا ثلاثة أحرف: ACP. إليك الخلاصة. بروتوكول عميل الوكيل (ACP) هو مقبس مشترك بين محرر الشيفرة ووكيل البرمجة، أشبه إلى حد ما بـ USB بين الحاسوب وأي شيء توصله به. أي محرر يتحدث ACP يمكنه استضافة أي وكيل يتحدثه. أما MCP فهو كابل مختلف: يربط الوكيل بالأدوات والبيانات، لا بمحررك.

الخبر الذي أثار الاهتمام هو Android Studio. تقول مدونة Android Developers (28 أكتوبر 2026) إن Android Studio Rabbit 2، المستقر الآن، يأتي بميزة «أحضر وكيلك الخاص»: تختار من أكثر من 40 وكيل برمجة، بما في ذلك Claude Agent وCodex من OpenAI وJunie وGoogle Antigravity. لا يذكر المنشور «ACP» صراحةً أبدًا. الاسم والآلية يأتيان من مقدمة ACP (تم التحقق في 1 نوفمبر 2026).

لماذا مقبس أصلًا؟#

لنفترض وجود 5 محررات و8 وكلاء برمجة. إذا احتاج كل زوج إلى اتصاله المصنوع يدويًا، فذلك 5 × 8 = 40 عملية تكامل، وكل وكيل جديد يعني خمس مهام إضافية لخمسة فرق محررات. أما إذا اتفق الجميع على مقبس واحد، فيبنيه كل محرر مرة واحدة ويبنيه كل وكيل مرة واحدة: 5 + 8 = 13 قطعة عمل. هذه هي الفكرة كلها.

يقدّم موقع ACP المقارنة نفسها مع LSP، بروتوكول خادم اللغة، الذي يتيح لخادم لغة واحد العمل في محررات كثيرة. الحيلة نفسها، مطبقة على وكلاء البرمجة: أي وكيل ACP يعمل مع أي محرر ACP، دون تكامل مخصص لكل زوج.

بطاقات تعليمية

كلمات ستقابلها حول ACP

كيف يعمل ACP، بكلمات بسيطة#

تخيّل زميلين يتبادلان الملاحظات عبر فتحة بريد. يكتب المحرر طلبًا، ويكتب الوكيل ردًا بما يريد عرضه. بالنسبة لوكيل محلي، فتحة البريد هذه حرفية: يبدأ المحرر الوكيل كعملية فرعية على جهازك ويتبادلان رسائل JSON-RPC عبر stdio. لكل رسالة الشكل العام نفسه:

json
{ "jsonrpc": "2.0", "id": 1, "method": "…", "params": { … } }

أسماء الدوال يحددها ACP نفسه، لذا لا تكتبها يدويًا أبدًا. المحرر والوكيل هما من يفعل ذلك.

لا يلزم أن يعيش الوكلاء على حاسوبك المحمول. يستخدم الوكلاء البعيدون HTTP أو WebSocket، رغم أن موقع ACP يقول إن الدعم الكامل للوكلاء البعيدين لا يزال قيد العمل. ولأن البروتوكول مبني للبرمجة، فإنه يعيد استخدام تمثيلات JSON الخاصة بـ MCP حيثما أمكن ويضيف أنواعًا لأشياء يحتاج المحرر إلى رسمها، مثل الفروقات. لهذا يمكن أن يظهر التغيير المقترح كفرق في محررك بدلًا من جدار من النص.

المحرر، ACP، الوكيل وواجهة برمجة النموذج في صف واحد
ACP هو الرابط بين المحرر والوكيل. النموذج يقف خلف الوكيل، على اتصال منفصل.

ACP مقابل MCP: أيّهما يربط ماذا#

ضع الوكيل في المنتصف. على جانب واحد محررك، وهذا الرابط هو ACP. وعلى الجانب الآخر الأشياء التي يعمل عليها الوكيل: الملفات وقواعد البيانات والخدمات. هذا الرابط هو MCP. إنهما يقفان على جانبين مختلفين من الوكيل، لذا لا يتنافسان. إذا كان MCP جديدًا عليك، فابدأ بـ دليل MCP باللغة الواضحة.

ACP يربط المحرر والوكيل، وMCP يربط الوكيل والأدوات
البروتوكولان جنبًا إلى جنب. ACP يواجه المحرر، وMCP يواجه الأدوات.

إنهما قريبان جدًا أيضًا: كما ذُكر أعلاه، يستعير ACP تمثيلات JSON الخاصة بـ MCP حيثما يستطيع. جرّب مطابقتهما بنفسك:

طابق الأزواج

طابق كل اسم بما يربطه

  • ACPالمحرر ⇄ وكيل البرمجة
  • MCPالوكيل ⇄ الأدوات والبيانات
  • JSON-RPC عبر stdioكيف يتحدث وكيل ACP محلي إلى المحرر
  • واجهة برمجة النموذج (base URL + مفتاح)الوكيل ⇄ النموذج اللغوي

أحضر وكيلك الخاص في Android Studio#

دون بروتوكول مشترك، إضافة وكيل إلى محرر هي مهمة بائع المحرر. مع Android Studio Rabbit 2 تختار الوكيل بنفسك. وفقًا لمنشور Android Developers، تفتح نافذة الوكيل وتختار وكيلًا، أو تختار واحدًا في Settings > Tools > AI > Agents. ثم تصادق وترسل أول طلب. يقول المنشور فقط «صادق»؛ وما يطلبه ذلك يعتمد على الوكيل الذي اخترته، لذا فإن وثائق الوكيل نفسه هي المكان الذي يجب أن تنظر فيه.

إليك الترتيب، إذا أردت التحقق بنفسك:

رتّب بالترتيب

رتّب خطوات Android Studio

  1. افتح Android Studio Rabbit 2
  2. اختر وكيلًا (نافذة الوكيل أو Settings > Tools > AI > Agents)
  3. صادق
  4. أرسل أول طلب

أين يقف النموذج ومفتاح API#

هذا هو الجزء الذي يربك معظم المبتدئين. يحمل رابط ACP المحادثة بين المحرر والوكيل. لا يزال الوكيل بحاجة إلى نموذج لغوي ليفكر به، وذلك اتصال منفصل، عادةً بتسجيل دخول أو مفتاح API خاص به. تغيير المحرر لا يغيّر النموذج، وتغيير النموذج لا يغيّر المحرر. لا يذكر منشور Android Studio شيئًا عن مفاتيح أو نماذج مخصصة، لذا فإن ما يمكنك تغييره يعتمد على الوكيل الذي تختاره.

تتيح لك بعض الوكلاء توجيهها إلى نقطة نهاية متوافقة مع OpenAI: base URL ومفتاح ومعرّف نموذج. عندما يفعل وكيلك ذلك، فهذا هو اتصال جانب النموذج بأكمله، ويمكنك اختباره في طرفية قبل لمس أي إعدادات (المفتاح عنصر نائب في متغير بيئة):

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain ACP in one sentence."}]
  }'

ستحصل على إجابة JSON فيها النص في choices[0].message.content وأعداد الرموز في usage. يعيد وكلاء البرمجة إرسال قدر كبير من السياق في كل خطوة، لذا يناسبها نموذج ذو سياق طويل. في CheapTokens هذا هو DeepSeek-V4-Flash: نافذة سياق 380K، وحتى 32,768 رمز إخراج لكل إجابة، وسعر واحد في أي ساعة من اليوم ورصيد واحد عبر جميع النماذج. واجهة API متوافقة مع OpenAI وAnthropic. خذ معرّف النموذج الدقيق من وثائق CheapTokens؛ فالمعرّفات تختلف بين المزوّدين. صفحة نماذج DeepSeek فيها التفاصيل.

لست متأكدًا أي أداة تقبل مفتاحًا مخصصًا؟ دليلنا أين تُدخل مفتاح API الخاص بك يشرح الدردشة والمحرر والطرفية والشيفرة. وإذا كان «base URL» مصطلحًا جديدًا عليك، فاقرأ ما هو base_url وكيف تبدّله.

جرّب بنفسكجرّب: ثبّتت وكيل ACP. أي اتصال تغيّره لتبديل النموذج الذي يستخدمه؟إظهار الإجابة

ليس اتصال ACP. يبقى مقبس المحرر إلى الوكيل كما هو. النموذج إعداد خاص بالوكيل: base URL والمفتاح ومعرّف النموذج في إعدادات الوكيل، إذا كان الوكيل يعرضها.

ماذا تفعل بعد ذلك#

افتح وثائق الوكيل الذي تريده وابحث عن المكان الذي يضبط فيه النموذج. إذا كنت فضوليًا بشأن كيفية عمل الوكيل من الداخل، فـ كيف يعمل وكيل الذكاء الاصطناعي: الحلقة يعرضه خطوة بخطوة. يجيب ACP عن سؤال واحد فقط: كيف يتحدث المحرر والوكيل. كل شيء آخر يبقى بين الوكيل وأدواته ونموذجه.