الانتقال إلى المحتوى الرئيسي
لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ النسخة الإنجليزية.
Agent Client Protocol بروتوكول يتيح للمحرر أن يقود agent للبرمجة يعمل كعملية فرعية: المحرر يكتب طلبات JSON-RPC 2.0 على stdin الخاص بالـ agent، رسالة JSON واحدة في كل سطر، ويقرأ ردوده وتحديثاته الـ streamed من stdout. Zed ومحررات أخرى تتكلم بهذا البروتوكول. lousho acp يقدّم أي Lousho agent بهذه الطريقة، فيمكنك أن تحادثه وتتابع الـ tool calls وتوافق عليها من لوحة الـ agent في المحرر.

الأمر

يُحمَّل الـ <path> بطريقة lousho chat نفسها، و--model يعمل بالشكل نفسه. بادئة vendor/ في الـ model تختار الـ provider؛ ومع OpenRouter استخدم openrouter/<vendor>/<model> (مثلاً openrouter/openai/gpt-4o). المحرر هو الذي يبدأ العملية، وتظل تعمل حتى يُغلق stdin. لا يحمل stdout إلا رسائل البروتوكول: الأخطاء، وأي شيء يطبعه كود الـ agent بـ console.log، تذهب إلى stderr الذي تعرضه المحررات في سجلاتها. مسار أو خيار خاطئ ينهي العملية برمز خروج 1 مع الخطأ المرمّز (LOUSHO_CONFIG_INVALID، …) على stderr.

Zed

أضف الـ agent إلى settings.json في Zed، ثم اختره من لوحة الـ agent:
شغّله من المشروع المثبَّت فيه lousho (أو استخدم مسارًا مطلقًا إلى node_modules/.bin/lousho كـ command). مفاتيح الـ provider تأتي من env أو من البيئة التي شُغِّل Zed فيها.

المدعوم

الإصدار 1 من البروتوكول. الـ agent يرد على: طوال تنفيذ الدورة يرسل الـ agent إشعارات session/update:
  • agent_message_chunk مع كتلة محتوى text لكل قطعة نص يكتبها الـ model؛
  • agent_thought_chunk مع كتلة محتوى text لكل جزء من استدلال الـ model؛
  • tool_call (status: 'in_progress'، وkind: 'other'، واسم الـ tool في title، ومعاملاتها في rawInput) عند بدء tool call؛
  • tool_call_update مع status: 'completed' (النتيجة كمحتوى نصي وكـ rawOutput) أو 'failed' (الخطأ) عند انتهائه.
الـ sub-agent runs التي يبدأها الـ tool task لا تُمرَّر إلى المحرر؛ الـ task نفسه يظهر كـ tool call واحد. الصلاحيات. عندما تحتاج tool إلى approval (موافقة) — needsApproval أو قواعد permissions التي تطلب ذلك — يرسل الـ agent للمحرر طلب session/request_permission يتضمّن الـ tool call وخيارين: allow (Allow، allow_once) وreject (Reject، reject_once). الإجابة تحسم الـ approval عبر agent.approvals.streamResolve() والدورة المستأنفة تكمل بث التحديثات؛ والرفض يعلّم الـ tool call بـ failed ويكمل الـ model عمله. يمكن أن تسأل الدورة الواحدة عدة مرات. الأسئلة. التوقف من نوع ask_question (askQuestion: true) لا يتحوّل إلى طلب صلاحية، لأن إجابة المستخدم يمكن أن تكون نصًا حرًا. بدلًا من ذلك ينهي الدورة بـ end_turn، ويصبح السؤال مع خياراته المرقّمة رسالة الـ agent؛ والـ prompt التالي في الـ session هو الإجابة (agent.approvals.streamAnswer()). أسباب التوقف. end_turn للانتهاء الطبيعي، وmax_turn_requests عندما ينفد maxSteps، وmax_tokens عندما تُستنفد إحدى ميزانيات limits أو يتوقف الـ model عند حدّ مخرجاته، وrefusal عندما يمنع guardrail أو فلتر المحتوى عند الـ provider يوقف الـ model، وcancelled بعد session/cancel. الأخطاء. الـ method غير المعروفة يُرَدّ عليها بخطأ JSON-RPC رقم -32601، وسطر ليس JSON بـ -32700، وسطر هو JSON لكنه ليس كائن طلب (null، أو مصفوفة، أو نص، أو رقم، أو method ليست نصًا) بـ -32600، وsessionId غير معروف أو prompt فارغ بـ -32602، وprompt ثانٍ بينما آخر يعمل في الـ session نفسها بـ -32600. والـ run الذي يفشل يُرَدّ عليه بـ -32603 مع رسالة الخطأ، ورمز خطأ الـ SDK الخاص به (مثلاً LOUSHO_PROVIDER_RATE_LIMITED) في error.data.code. والـ params التي قيمتها null أو ليست object تُقرأ كـ {}. والسطر المشوّه لا يوقف السيرفر أبدًا.

غير المدعوم

  • session/load (loadSession: false) وأوضاع الـ session.
  • طرق fs/* وterminal/* الخاصة بالعميل: الـ agent يقرأ الملفات ويشغّل الأوامر بأدواته هو (أدوات مساحة العمل)، وليس عبر المحرر.
  • كتل الـ prompt من نوع الصور والصوت والموارد المضمَّنة (prompts نصية فقط).
  • تحديثات plan، وخيارا الصلاحية allow_always / reject_always.
  • المصادقة (authMethods فارغة): مفاتيح الـ provider تأتي من البيئة.

في الكود

نواة البروتوكول هي serveAcp(agent, { input, write }): تقرأ أسطر JSON-RPC من أي async iterable وتسلّم كل سطر صادر إلى write، فيمكنك تقديمها على transport آخر أو تشغيلها في الاختبارات دون عملية. وتُنجَز عندما ينتهي input، بعد إلغاء أي دورة جارية.
مرّر store لتحفظ سجلات محادثات sessions الـ ACP في AgentStore (مثل SqliteStore)؛ افتراضيًا تستخدم store الخاص بالـ agent أو الذاكرة.