Install
uvx google-agents-cli setupلمن هذا الدليل
هذا الدليل لمن يريد بناء Agents على Gemini Enterprise Agent Platform وتثبيت الـ CLI الرسمي والمهارات في مساعد برمجة قائم. يصف المستودع ذلك بأنه CLI وskills لبناء Agents على تلك المنصة.
قبل البدء، أكّد أن الشروط الثلاثة مكتملة: Python 3.11+ وuv وNode.js. إن نقص أحدها فلا تشغّل التثبيت. الصفحة تقول إنه يعمل مع Antigravity CLI وClaude Code وCodex وany other coding agent؛ هذه ملاحظة توافق وليست قائمة حصرية، ولا تعمم تثبيت uvx إلى تثبيت سوق غير ظاهر.
دور agents-cli setup هو تثبيت الـ CLI ووضع skills على coding agents. المحاولة الأولى تُكمل التثبيت والتحقق للقراءة فقط فقط؛ لا تنشر ولا تقيّم Agentًا مباشرًا غير مسمّى.
إكمال أول محاولة في 3 دقائق
استخدم فقط أمر التثبيت الموصى به الوارد في الصفحة:
uvx google-agents-cli setup
الشرط المسبق: هذا الجهاز فيه أصلًا Python 3.11+ وuv وNode.js، وأنت مستعد لكتابة الـ CLI والمهارات في coding agent المستخدم الآن. موضع التثبيت هو هؤلاء الـ Agents، يكتبه setup، وليس مسارًا آخر غير ظاهر في الصفحة.
نقطة تأكيد الأثر الجانبي: هذا الأمر يثبّت الـ CLI ويثبّت skills على coding agents. إذا لم تكن البيئة الحالية هي الـ Agent الذي تنوي تغييره، أو لم تُراجع الشروط الثلاثة بعد، فتوقف أولًا. أكّد ثم نفّذ.
إشارة النجاح: ينتهي الأمر بشكل طبيعي، ويستطيع الـ Agent المقابل رؤية المهارات المثبتة حديثًا أو CLI قابلًا للاستخدام. بعد ذلك تحقق فقط: في Agent متوافق افتح وصف تلك المهارة وأكّد أنه يتعرّف على مهارات Gemini Enterprise Agent Platform. لا تنشئ ولا تقيّم ولا تنشر أي Agent سحابي. إذا كان المعالج سيواصل إلى النشر، فتوقف عند نقطة التأكيد.
حالات الاستخدام
الحالة 1: إكمال تثبيت الـ CLI والمهارات بالأمر الرسمي. أكّد أولًا أن Python 3.11+ وuv وNode.js متاحة، ثم نفّذ uvx google-agents-cli setup. الدليل يغطي أمر التثبيت هذا، وأن agents-cli setup سينفّذ “Install CLI + skills to coding agents”. معيار الإنجاز يتوقف عند نجاح التثبيت وقدرة الـ Agent على رؤية المهارات. لا تضف أوامر ترقية أو إلغاء تثبيت غير ظاهرة.
الحالة 2: بعد التثبيت، إجراء تعرّف للقراءة فقط وليس إطلاقًا مباشرًا. الصفحة تموضع هذه الأداة كـ CLI وskills لبناء Agents على Gemini Enterprise Agent Platform، وتدرج أنها تعمل مع Antigravity CLI وClaude Code وCodex وcoding agents أخرى. المقتطف لا يعطي أوامر إنشاء أو نشر، لذلك في المرة الأولى أكّد فقط في أحد الـ Agents الذي ثُبّتت فيه المهارات أنها محمّلة. إشارة النجاح القابلة للملاحظة هي ظهور وصف المهارة. لا تقرأ “and any other coding agent” كأن كل بيئة غير مسمّاة لها تثبيت متحقَّق.
حدود الاستخدام
مسار التثبيت الأساسي هو فقط uvx google-agents-cli setup. لا تثبّت إذا نقص Python 3.11+ أو uv أو Node.js. الـ Agents المذكورة ليست النطاق الحصري المدعوم. يغيّر setup ملفات المهارات في جانب الـ Agent؛ والنشر والتقييم ليسا في أوامر هذا المقتطف. المسارات والصلاحيات غير المكتوبة لا تُتخذ خلاصة أمان.