في Agents CLI من Google نظام إضافات يتيح، بحسب مدونة Google للمطورين، تجاوز الأوامر أو إضافة أوامر جديدة دون نسخ الأداة وتعديلها، أي fork. بدأ النظام في الإصدار 1.5.0، ويأتي الإصدار 1.8.0 بإضافة رسمية لـLangChain.
والنظام تجريبي: قد يتغير مخطط البيان وسطح الأوامر بتغييرات كاسرة، لذلك ثبّت إصدار Agents CLI.
الخلاصة أولًا
- ما الإضافة: مجلد في مستودع Git فيه ملف بيان اسمه agents-cli-extension.yaml.
- ما تفعله: تتجاوز أوامر مدمجة أو تضيف أوامر جديدة.
- الإصدارات: النظام بدأ في 1.5.0، وإضافة LangChain الرسمية في 1.8.0.
- الحالة: تجريبي، فثبّت الإصدار.
- الاختبار: لم تثبّت ClueTrove الأداة ولم تشغّلها.
ما الإضافة؟
يعلن البيان أي الأوامر المدمجة يتجاوزها وأي أوامر جديدة يضيفها. ويرفض التحقق الصارم المفاتيح غير المعروفة، فيفشل الخطأ الإملائي وقت التثبيت، لا وقت التشغيل.
| النمط | ماذا يفعل |
|---|---|
| تجاوز، Override | يستبدل أمرًا مدمجًا مثل playground أو deploy أو eval generate؛ ويستلم التجاوز وسائط المستخدم كما هي |
| إضافة، Add | ينشئ أمرًا جديدًا agents-cli <command> لسير عمل لا توفره الأداة |
كيف تثبّت إضافة؟
الأوامر التالية أمثلة من المنشور، وكلها تبدأ بـagents-cli extension add:
- agents-cli extension add <name>
- agents-cli extension add acme/platform-extensions
- agents-cli extension add acme/platform-extensions#soc2-deploy
- agents-cli extension add local@../my-extension
نطاق المشروع هو الافتراضي ويُودَع مع المشروع، فيحصل عليه كل من يستنسخ المستودع. ونطاق المستخدم، بالخيار —global، يسري على كل المشاريع في الجهاز. وإذا عرّف النطاقان الأمر نفسه يفوز نطاق المشروع.
وتتحول مراجع Git إلى معرّفات إيداع دقيقة، SHA، تُسجَّل في ملف قفل. يعيد agents-cli install الشيفرة المثبّتة دون تحريك التثبيت، ويقدّمه agents-cli extension update.
ماذا تفعل إضافة LangChain؟
بحسب المنشور، ينشئ الإصدار 1.8.0 هيكل مشروع LangChain أو LangGraph أو Deep Agents يعمل على دورة الحياة نفسها دون الاعتماد على google-adk. وأمر الإنشاء المذكور:
- agents-cli create my-agent —agent google/agents-cli/extensions/langchain/template@v1.8.0 –d cloud_run
وهي تتجاوز ستة أوامر: playground وrun وeval.generate وpublish.gemini-enterprise وeval.dataset وeval.optimize. وآخر اثنين يرفضان العمل في مشاريع LangChain لأنهما يحتاجان كائن وكيل ADK. ويستخدم النشر على Cloud Run الأمر الأصلي deploy دون تغيير.
مثال SBOM
إضافة نموذجية اسمها sbom-deploy تتجاوز deploy وتضيف sbom-report. يشغّل سكربتها syft وgrype ويمنع النشر عند وجود نتائج حرجة، ثم يستدعي النشر الأصلي.
ويضبط المحمّل AGENTS_CLI_DISABLE_OVERRIDES=1 كي لا يدور الاستدعاء المتكرر في حلقة. والفكرة العملية: يمكن لفريقك أن يفرض فحصًا أمنيًا قبل كل نشر دون أن يغيّر أحد أمر deploy الأصلي.
ما حدود النظام؟
- تستطيع تجاوز أمر فرعي مثل eval.generate، لكن لا مجموعة كاملة مثل eval.
- الحقل run: متجه أوامر يُنفَّذ دون صدفة، أي shell. فسلسلة الخطوات تحتاج سكربت تغليف.
- تُعلَن التجاوزات بتحذير وتوسَم بـ[↑ extension-name] في مخرجات المساعدة.
لمن يناسب ومن يتجاوزه؟
نقترح النظام لفريق يريد فرض خطوة ثابتة، مثل فحص SBOM قبل النشر، أو يريد العمل على LangChain أو LangGraph بلا ADK. ونقترح أن يتجاوزه من يحتاج استقرارًا مضمونًا الآن، لأن المنشور يصفه بأنه تجريبي وقد يتغير بتغييرات كاسرة.
ماذا تفعل بعد ذلك؟
- ثبّت إصدار Agents CLI قبل استخدام الإضافات، كما يطلب المنشور، لأن النظام تجريبي.
- نقترح أن تقرأ منشور مدونة Google للمطورين ووثائق Agents CLI لمعرفة تفاصيل البيان.
- إن أردت العمل بدون ADK، فابدأ بأمر الإنشاء الخاص بإضافة LangChain.
أسئلة وأجوبة حول إضافات Agents CLI
هل نظام الإضافات مستقر؟
لا. يصفه المنشور بأنه تجريبي في 1.8.0 ويطلب تثبيت الإصدار.
هل تتعارض إضافات المشروع والعامة؟
إذا عرّف الاثنان الأمر نفسه فالغلبة لنطاق المشروع بحسب المنشور.
هل أستطيع تجاوز مجموعة أوامر كاملة؟
لا. تستطيع تجاوز أمر فرعي مثل eval.generate، لكن لا مجموعة كاملة مثل eval.
كيف أنقل الإضافة إلى كل مشاريعي؟
أضفها بالخيار —global فتسري على كل المشاريع في الجهاز. ولو عرّف مشروع الأمر نفسه فنطاق المشروع هو الذي يفوز.
متى بدأ النظام؟
في الإصدار 1.5.0، وجاءت إضافة LangChain الرسمية في 1.8.0.
مصطلحات بلغة مبسطة
- الإضافة: حزمة صغيرة تغيّر أوامر الأداة أو تزيد عليها.
- البيان: ملف يصف ما تفعله الإضافة.
- التجاوز: أن يحل أمرك محل الأمر المدمج.
- ملف القفل: ملف يثبّت الإصدارات المستخدمة بدقة.
- SBOM: قائمة بمكونات البرنامج.
المصادر
- مدونة Google للمطورين: Powering the Agent Development Lifecycle with any framework (قُرئ في 22 أكتوبر 2026)
- وثائق Agents CLI
قُرئت المعلومات في 22 أكتوبر 2026.
