تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

تسريع مسار التطوير باستخدام Antigravity CLI

1. نظرة عامة

يركّز هذا المختبر على استخدام واجهة سطر الأوامر Antigravity لتنفيذ مهام المطوّرين الشائعة. ‫Antigravity CLI هي واجهة مستخدم خفيفة الوزن في سطر الأوامر ضمن Antigravity. ستتعلّم كيفية استخدام Antigravity CLI لتنفيذ مهام مختلفة، بما في ذلك فهم قواعد الرموز البرمجية الحالية، وإنشاء المستندات واختبارات الوحدة، وإعادة تصميم مكوّنات الواجهات الأمامية والخلفية لتطبيقات الويب المصمّمة بلغة Python.

ما ستتعلمه

في هذه الميزة الاختبارية، ستتعرّف على كيفية إجراء ما يلي:

كيفية استخدام Antigravity CLI لتنفيذ مهام شائعة للمطوّرين

المتطلبات الأساسية

يفترض هذا التمرين العملي معرفة بيئتَي Cloud Console وCloud Shell.

2. الإعداد والمتطلبات

إعداد مشروع على السحابة الإلكترونية

سجِّل الدخول إلى Google Cloud Console وأنشِئ مشروعًا جديدًا أو أعِد استخدام مشروع حالي. إذا لم يكن لديك حساب على Gmail أو Google Workspace، عليك إنشاء حساب.

اسم المشروع هو الاسم المعروض للمشاركين في هذا المشروع. وهي سلسلة أحرف لا تستخدمها Google APIs. ويمكنك تعديلها في أي وقت.
رقم تعريف المشروع هو معرّف فريد في جميع مشاريع Google Cloud ولا يمكن تغييره (لا يمكن تغييره بعد ضبطه). تنشئ Cloud Console سلسلة فريدة تلقائيًا، ولا يهمّك عادةً ما هي. في معظم دروس البرمجة، عليك الرجوع إلى رقم تعريف مشروعك (يُشار إليه عادةً باسم PROJECT_ID). إذا لم يعجبك رقم التعريف الذي تم إنشاؤه، يمكنك إنشاء رقم آخر عشوائي. يمكنك بدلاً من ذلك تجربة اسم مستخدم من اختيارك ومعرفة ما إذا كان متاحًا. لا يمكن تغيير هذا الخيار بعد هذه الخطوة ويظل ساريًا طوال مدة المشروع.
للعلم، هناك قيمة ثالثة، وهي رقم المشروع، وتستخدمها بعض واجهات برمجة التطبيقات. يمكنك الاطّلاع على مزيد من المعلومات حول هذه القيم الثلاث في المستندات.

بعد ذلك، عليك تفعيل الفوترة في Cloud Console لاستخدام موارد/واجهات برمجة تطبيقات Cloud. لن تكلفك تجربة هذا الدرس البرمجي الكثير، إن وُجدت أي تكلفة. لإيقاف الموارد وتجنُّب تحمّل تكاليف فوترة تتجاوز هذا البرنامج التعليمي، يمكنك حذف الموارد التي أنشأتها أو حذف المشروع. يمكن لمستخدمي Google Cloud الجدد الاستفادة من برنامج الفترة التجريبية المجانية بقيمة 300 دولار أمريكي.

إعداد البيئة

افتح محادثة Gemini.

انقر على "تجربة Gemini Cloud Assist بدون أي تكلفة":

فعِّل "ميزة المساعدة من Gemini Cloud" في الشاشة التالية.

انقر على "Start chatting" واتّبِع أحد الأسئلة النموذجية أو اكتب طلبك الخاص لتجربته.

إليك بعض الطلبات التي يمكن تجربتها:

اشرح Cloud Run في 5 نقاط رئيسية.
أنا مدير منتج Cloud Run في Google Cloud، أريد شرح Cloud Run لطالب في 5 نقاط رئيسية قصيرة.
أنت مدير منتج في Google Cloud Run، اشرح خدمة Cloud Run لمطوّر معتمد في Kubernetes في 5 نقاط رئيسية قصيرة.
أنت مدير منتج في Google Cloud Run، اشرح متى تستخدم Cloud Run بدلاً من GKE لأحد كبار المطوّرين في 5 نقاط رئيسية قصيرة.

أغلِق نافذة محادثة Gemini Cloud Assist بعد الانتهاء.

يمكنك الاطّلاع على دليل الطلبات لمعرفة المزيد حول كتابة طلبات أفضل.

كيف يستخدم "Gemini في Google Cloud" بياناتك؟

التزام Google بالخصوصية

كانت Google من أوائل الشركات في المجال التي نشرت التزامًا بشأن خصوصية الذكاء الاصطناعي/تعلُّم الآلة، يوضّح اعتقادنا بأنّه يجب أن يحصل العملاء على أعلى مستوى من الأمان والتحكّم في بياناتهم المخزّنة في السحابة الإلكترونية. وينطبق هذا الالتزام على منتجات الذكاء الاصطناعي التوليدي من Google Cloud. تساعد Google في ضمان التزام فِرقها بهذه الالتزامات من خلال ممارسات حوكمة البيانات الفعّالة، والتي تشمل مراجعات للبيانات التي تستخدمها Google Cloud في تطوير منتجاتها. يمكنك العثور على مزيد من التفاصيل حول كيفية معالجة Google للبيانات في ملحق معالجة بيانات العميل (CDPA) أو اتفاقية معالجة البيانات السارية على خدمة Google Cloud.

البيانات التي ترسلها وتتلقّاها

تُعرف الأسئلة التي تطرحها على Gemini، بما في ذلك أي معلومات أو رموز برمجية ترسلها إلى Gemini لتحليلها أو إكمالها، باسم الطلبات. تُعرف الإجابات أو عمليات إكمال الرمز البرمجي التي تتلقّاها من Gemini باسم الردود.

لا يستخدم Gemini طلباتك أو ردوده كبيانات لتدريب نماذجه. تتوفّر بعض الميزات فقط من خلال برنامج مختبري Gemini الموثوقين في Google Cloud، والذي يتيح لك مشاركة البيانات بشكل اختياري، ولكن تُستخدم البيانات لتحسين المنتج وليس لتدريب نماذج Gemini.

بما أنّ Gemini تكنولوجيا قيد التطوّر، يمكن أن يقدّم نواتج تبدو منطقية ولكنّها غير صحيحة من الناحية الواقعية. ننصحك بالتحقّق من صحة جميع النتائج التي تقدّمها Gemini قبل استخدامها. لمزيد من المعلومات، يمكنك الاطّلاع على ‫Gemini في Google Cloud والذكاء الاصطناعي المسؤول.

تشفير الطلبات

عند إرسال طلبات إلى Gemini، يتم تشفير بياناتك أثناء نقلها كمدخلات إلى النموذج الأساسي في Gemini. لمزيد من المعلومات حول تشفير بيانات Gemini، يُرجى الاطّلاع على مقالتَي التشفير التلقائي في حال عدم النشاط والتشفير أثناء نقل البيانات.

بيانات البرنامج من إنشاء Gemini

يتم تدريب Gemini على رمز Google Cloud للطرف الأول بالإضافة إلى رمز الطرف الثالث المحدّد. أنت المسؤول عن أمان الرمز البرمجي واختباره وفعاليته، بما في ذلك أي عملية إكمال أو إنشاء أو تحليل للرمز البرمجي يقدّمها لك Gemini.

يقدّم Gemini أيضًا اقتباسات من المصادر عندما تقتبس الاقتراحات مباشرةً من مصدر ما لمساعدتك في الامتثال لأي متطلبات ترخيص.

بما أنّ الردود في Gemini يتم إنشاؤها من نموذج تم تدريبه على العديد من أسطر الرموز البرمجية، عليك توخّي الحذر نفسه عند استخدام الرموز البرمجية التي يقدّمها Gemini كما تفعل مع أي رموز برمجية أخرى. احرص على اختبار الرمز بشكلٍ صحيح والتحقّق من الثغرات الأمنية وحالات عدم التوافق والمشاكل المحتملة الأخرى.

مزيد من المعلومات حول طريقة Google في معالجة طلباتك

3- خيارات لاختبار الطلبات

إذا أردت اختبار الطلبات الحالية، تتوفّر لك عدة خيارات لذلك.

Agent Studio

‫Agent Studio هو جزء من "منصة وكلاء Gemini Enterprise"، وقد تم تصميمه خصيصًا لتبسيط عملية تطوير نماذج الذكاء الاصطناعي التوليدي وتسريعها.

Google AI Studio

‫Google AI Studio هي أداة مستندة إلى الويب لإنشاء نماذج أولية وتجربة هندسة الطلبات وGemini API.

تطبيق Gemini للويب ‏ (gemini.google.com)

تطبيق Google Gemini للويب (gemini.google.com) هو أداة مستندة إلى الويب مصمّمة لمساعدتك في استكشاف إمكانات نماذج الذكاء الاصطناعي من Google Gemini والاستفادة منها.

تطبيق Google Gemini للأجهزة الجوّالة على Android وتطبيق Google على iOS

4. تنزيل التطبيق وفحصه

فعِّل Cloud Shell من خلال النقر على الرمز على يسار شريط البحث.

انقر على "متابعة":

إذا طُلب منك منح الإذن، انقر على "منح الإذن" للمتابعة.

في الوحدة الطرفية، شغِّل الأمر لتفعيل واجهات برمجة التطبيقات الخاصة بمنصة Agent.

gcloud services enable aiplatform.googleapis.com

نفِّذ الأوامر أدناه لاستنساخ مستودع Git على جهازك.

git clone https://github.com/gitrey/calendar-app-lab
cd calendar-app-lab

انقر على "Cloud Shell Editor".

افتح مجلد "calendar-app-lab".

ابدأ وحدة طرفية جديدة في "محرِّر Cloud Shell".

يجب أن تبدو بيئتك مشابهة للقطة الشاشة أدناه.

5- مقدمة عن Antigravity CLI

‫Antigravity CLI هي واجهة مستخدم خفيفة الوزن في نافذة الأوامر الخاصة بـ Antigravity. يوفّر هذا المنتج إمكانات بالذكاء الاصطناعي الوكيل الأساسية نفسها التي يوفّرها Antigravity، مثل الاستدلال المتعدّد الخطوات وتعديل الملفات المتعدّدة واستخدام الأدوات وسجلّ المحادثات، وذلك مباشرةً في نافذة الأوامر. ويتيح للمطوّرين تنفيذ مهام مختلفة مباشرةً من وحدة التحكّم، مثل فهم قواعد البيانات وإنشاء المستندات ووحدات الاختبار وإعادة تصميم الرموز البرمجية.

تتمثّل الفائدة الرئيسية من Antigravity CLI في قدرته على تبسيط عمليات تطوير التطبيقات من خلال الاستفادة من إمكانات Gemini مباشرةً في بيئة سطر الأوامر الخاصة بالمطوّر، ما يقلّل من الحاجة إلى التبديل بين السياقات ويسرّع وتيرة العمل.

نفِّذ الأمر التالي في الوحدة الطرفية لتثبيت Antigravity CLI:

curl -fsSL https://antigravity.google/cli/install.sh | bash

تحقَّق من الناتج وشغِّل الأمر المقدَّم لتفعيل الاستخدام العام لواجهة سطر الأوامر agy.

مثال:

echo 'export PATH="/home/student_01_7c9be0de109d/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

تأكَّد من أنّك في جذر مجلد المشروع:

cd ~/calendar-app-lab

ابدأ Antigravity CLI:

agy

لتسجيل الدخول، انقر على خيار "Use a Google Cloud project":

انقر على "Click here to authenticate" أو اختَر عنوان URL الكامل وانسَخه وافتحه في علامة تبويب متصفّح جديدة، ثم اتّبِع الخطوات لإنشاء الرمز. ارجع إلى نافذة الوحدة الطرفية للصق الرمز وتحديد مشروع Google Cloud.

اضبط الموقع الجغرافي لخدمة Google Cloud على "global"".

اضبط نظام الألوان المفضّل لديك وانقر على "Next" للمتابعة.

قبول بنود الخدمة واستخدام البيانات:

يجب أن تبدو بيئتك مشابهة للقطة الشاشة أدناه. تم إغلاق لوحة Gemini Code Assist لأنّها لن تكون مطلوبة في هذه التجربة.

للتحقّق من عملية الإعداد، شغِّل الأمر التالي:

/config

انقر على "Color Scheme" أو اكتبه، ثم أكِّد اختيارك الجديد.

نفِّذ الأمر التالي للتحقّق من النماذج المتاحة:

/model

6. فهم قاعدة الرموز البرمجية

يمكنك استخدام Antigravity CLI للتعرّف بسرعة على قاعدة رموز برمجية جديدة من خلال الطلب منها تلخيص الغرض من الملفات أو الأدلة وشرح الدوال المعقّدة أو أقسام الرموز البرمجية. يتيح ذلك للمطوّرين الانتقال بسرعة إلى مشاريع جديدة أو فهم أجزاء غير مألوفة من الرموز الحالية بدون استكشاف يدوي معمّق.

لمزيد من المعلومات حول قاعدة الرموز البرمجية، أرسِل الطلب التالي في Antigravity CLI:

Explain this codebase to me, including its overall architecture, key dependencies, and the main entry points for the application.

راجِع الناتج:

7. بدء التطبيق

يمكن أن تبسّط واجهة سطر الأوامر Antigravity CLI عملية تشغيل تطبيق Python محليًا بشكل كبير من خلال مساعدتك في إنشاء ملفات الإعداد الأساسية تلقائيًا، مثل requirements.txt أو Dockerfile الأساسي. بالإضافة إلى ذلك، إنّها أداة ممتازة لإدارة تبعيات Python وتحديد المشاكل وحلّها، إذ يمكنها أن تشرح بسرعة أخطاء التتبّع الناتجة عن الحِزم المفقودة أو تعارض الإصدارات، وغالبًا ما تقترح الأمر pip install الدقيق لحلّ المشكلة.

لتشغيل التطبيق محليًا، أدخِل الطلب التالي في نافذة Antigravity CLI:

Setup a local virtual environment and run this app locally.

تأكيد طلبات الأدوات، عند تشغيل التطبيق، انقر على الرابط لفتح المعاينة:

مثال على الناتج:

اكتب 25 واضغط على Enter.

8. إضافة مستندات

تسهّل واجهة سطر الأوامر Antigravity عملية إنشاء المستندات وإضافة التعليقات من خلال إتاحة إنشاء سلاسل المستندات على الفور للفئات والدوال. تتيح لك هذه الميزة أيضًا إدراج تعليقات توضيحية مضمّنة بسرعة في مقاطع الرموز البرمجية المعقّدة أو غير المألوفة، ما يعزّز بشكل كبير إمكانية صيانة قاعدة الرموز البرمجية ووضوحها.

نفِّذ الأمر التالي ضمن واجهة سطر الأوامر Antigravity لإدراج مستندات تلقائيًا في كل ملف Python في مشروعك:

Add detailed docstrings to all files.

عدِّل ملف .gitignore باستخدام الطلب التالي:

Update .gitignore: add __pycache__ and .venv folders.

انتقِل إلى عرض Source Control وراجِع التغييرات التي أجريتها حتى الآن:

يسمح لك الطلب التالي بالتحقّق من جميع التعديلات مباشرةً في الوحدة الطرفية:

/diff

9. إضافة اختبارات الوحدات

تساعد واجهة سطر الأوامر Antigravity بشكل كبير في إنشاء اختبارات الوحدة من خلال السماح للمطوّرين بإنشاء دوال اختبار مشتقة من توقيع ووظائف الدوال الحالية. على الرغم من أنّها توفّر تأكيدات أولية شاملة وإعدادات وهمية، يظل من الضروري أن يقيّم المطوّرون النتائج ويؤكّدونها. يضمن ذلك أن تقدّم الاختبارات الناتجة تغطية قوية لحالات الاستخدام المعقّدة بدلاً من مجرد تأكيد مسارات التنفيذ الأساسية.

بالنسبة إلى هذه المهمة، سنستخدم أحد الأوامر التي تأتي مع واجهة سطر الأوامر Antigravity /goal - Run until the specified goal is completely finished.

استخدِم الطلب أدناه لإنشاء اختبارات الوحدة:

/goal Generate unit tests for @calendar.py

اقبل طلب استخدام الأدوات وراجِع النتائج.

لضمان صحة الرمز البرمجي وتحقيق نتائج اختبار ناجحة، تراقب واجهة سطر الأوامر Antigravity الرمز البرمجي الذي تم إنشاؤه وتصلحه وتنفّذه بشكل متكرّر إلى أن يتم اجتياز جميع الاختبارات. انتقِل إلى العرض Source Code لفحص آخر التعديلات.

10. تحديد عيوب المنطق

تساعد واجهة سطر الأوامر Antigravity في تحديد الأخطاء المنطقية من خلال مراجعة مقتطفات الرمز البرمجي وتحليلها. يمكنه رصد مشاكل مختلفة، مثل المعالجة الشرطية غير الصحيحة، والأخطاء المنطقية المحتملة، وأخطاء "الفرق بمقدار واحد". من خلال شرح السلوك المقصود للرمز البرمجي لواجهة سطر الأوامر، يمكنك الكشف عن العيوب الطفيفة ومعالجة التناقضات قبل تنفيذ الرمز.

لتقييم منطق التحويل في مشروعك، استخدِم الطلب التالي في Antigravity CLI:

Are there any bugs in the conversion logic? Check if negative numbers are handled properly.

راجِع الناتج.

11. Refactor UI

تعمل واجهة سطر الأوامر Antigravity على تبسيط عملية إعادة تصميم واجهة المستخدم من خلال تسهيل الانتقال من الأنماط القديمة، مثل مكوّنات الفئات، إلى النماذج الوظيفية الحديثة مثل خطافات React. وتحدّد أيضًا التحسينات الهيكلية لزيادة قابلية الصيانة. من خلال الاستفادة من واجهة سطر الأوامر لتحليل الرمز الحالي لواجهة المستخدم وتقسيمه إلى مكونات نمطية قابلة لإعادة الاستخدام، يمكن للمطوّرين تحقيق تصميم أكثر توحيدًا ووضوحًا لواجهة المستخدم.

استخدام الأمر /plan الحالي لتخطيط إعادة تصميم واجهة المستخدم باستخدام مكتبة Bootstrap:

/plan Refactor UI to use Bootstrap library

راجِع خطة التنفيذ باستخدام الأمر /artifacts:

ابدأ التنفيذ من خلال الموافقة على الخطة.

راجِع طلب تفعيل الأدوات واقبَله:

أرسِل طلبًا لبدء التطبيق.

Start the application

أعِد تحميل الصفحة وتحقّق من التغييرات.

أرسِل طلبًا لتنفيذ معالجة الأخطاء لضمان عرض صفحة خطأ عند حدوث مشاكل.

Implement error handling to display an error page when issues occur.

مثال على الناتج:

يُرجى إعادة تحميل الصفحة للاطّلاع على التعديلات.

افتح نقطة نهاية (مثل /convert1 ) للتحقّق من صفحة الخطأ.

12. إعادة هيكلة الخلفية

تعمل واجهة سطر الأوامر Antigravity على تبسيط عملية إعادة تصميم الخلفية من خلال تسهيل الانتقال من الأُطر القديمة إلى الحِزم الحديثة والمساعدة في تقسيم التطبيقات المتكاملة إلى خدمات مصغّرة. من خلال تقييم منطق الخادم، يقترح تحسين طلبات البحث في قاعدة البيانات وتصميمات واجهة برمجة التطبيقات الفائقة للحفاظ على أداء النظام وقابلية التوسّع أو تحسينهما.

عدِّل الخادم الخلفي لحفظ طلبات الإحالات الناجحة في الذاكرة.

/goal Store requests in memory and create a page to display conversion history. Add links on all pages to view the history.

في أي وقت، يمكنك الاطّلاع على استخدام السياق الحالي عن طريق إرسال الأمر /context:

راجِع التغييرات في المحادثة واقبلها:

راجِع نتائج طلب التنفيذ:

أرسِل عدّة طلبات إلى التطبيق، ثم راجِع صفحة سجلّ الإحالات الناجحة.

مراجعة سجلّ طلبات تتبُّع الإحالات الناجحة

13. الوكلاء الفرعيون في Antigravity CLI

تتضمّن واجهة سطر الأوامر Antigravity إطارًا غير متزامن للوكلاء الفرعيين يتيح للوكيل الرئيسي تفويض العمل المتوازي وإجراء بحث في الخلفية وتشغيل اختبارات النظام بدون حظر محادثتك النشطة.

استخدِم الأمر /agents لعرض البرامج النشطة، أو /tasks لمراقبة العمليات التي تعمل في الخلفية والتي لا تستند إلى برامج.

إذا كنت بحاجة إلى بدء مناقشة جانبية أو طرح سؤال، يتوفّر الأمر /btw لهذا الغرض.

يمكنك أيضًا إرسال مهمة طويلة الأمد إلى الخلفية من خلال الضغط على Ctrl+b.

14. الموافقة على الخطة

تتضمّن واجهة سطر الأوامر Antigravity CLI الأمر /grill-me الذي يمكنك استخدامه للتخطيط التفصيلي بأسلوب المقابلة قبل الانتقال إلى التنفيذ.

نفِّذ الأمر التالي في الوحدة الطرفية:

/grill-me Refactor UI to use Bootstrap library

مثال على الناتج:

Question 1/1: How would you like to structure the user flow and design theme for this Roman Numeral converter?

> 1. (Recommended) Keep the multi-page template structure with the majestic, imperial glassmorphic dark theme.
  2. Convert the flow into a modern Single-Page Application (SPA) using AJAX/Fetch, rendering results dynamically on the same page.
  3. Adopt a standard minimalist Bootstrap light/dark theme with corporate colors (blue primary, clean white cards) instead of the
imperial-themed style.
  4. Write-in...
.
.
Question 1/1: Which visual theme and color palette would you prefer for the Roman Numerals Converter?

> 1. (Recommended) Sleek Dark Mode with Glassmorphism: Deep space/midnight background, glowing neon blue/purple
gradients, and semi-transparent frosted-glass cards.
  2. Roman Antique / Golden-Ivory theme: Warm cream/marble background, rich gold highlights, deep crimson/burgundy
accents, and elegant serif typography.
  3. Clean Modern Tech: Slate gray and vibrant emerald green accents, minimalist clean white cards, and smooth micro-
interactions.
  4. Write-in...
.
.
Question 1/1: Which interactive features would you like to incorporate to make this a premium user experience? (Select
all that apply)

> 1. [ ] (Recommended) Dynamic Live Validation: Instantly validate input (range 1-3999) as the user types with helper
messages.
  2. [ ] (Recommended) "Surprise Me" Button: Instantly generates a random integer and converts it to its Roman numeral
counterpart.
  3. [ ] (Recommended) Quick-Copy Clipboard Button: A one-click button to copy the roman numeral result with a
toast/notification checkmark.
  4. [ ] (Recommended) Interactive Reference Table: A beautiful Cheat Sheet showing standard Roman numeral symbols (I, V,
X, etc.) with responsive hover effects.
  5. [ ] Keep it extremely minimal with only the conversion card.
  6. Write-in.

15. تعديل المستندات

لتعديل ملف README.md باستخدام حالة قاعدة الرموز الحالية، أرسِل هذا الطلب عبر واجهة سطر الأوامر Antigravity:

/goal Analyze README.md file and update it with latest codebase changes.

راجِع الناتج في وحدة التحكّم وافتح أيضًا README.md في وضع معاينة Markdown للتحقّق.

16. وضع عدم التفاعل في Antigravity CLI

عند تشغيل Antigravity CLI في وضع غير تفاعلي في بيئة محلية أو ضمن مسار CI/CD، يمكنك إعداد العديد من المهام تلقائيًا من خلال تمرير الطلبات والأوامر مباشرةً إلى واجهة سطر الأوامر بدون الحاجة إلى تدخل يدوي. يتيح ذلك إمكانية الدمج السلس في مهام سير العمل الآلية لتحليل الرموز البرمجية وإنشاء المستندات ومهام التطوير الأخرى.

افتح نافذة Terminal جديدة أو أغلق جلسة Antigravity CLI الحالية ونفِّذ هذا الأمر.

agy -p "Explain the architecture of this codebase"

راجِع الناتج.

من خلال الاستفادة من Antigravity CLI في الوضع غير التفاعلي، يمكنك تحسين إمكانات التشغيل الآلي لعمليات CI/CD بشكل كبير، ما يؤدي إلى دورات تطوير أكثر كفاءة وتحسين جودة الرموز البرمجية.

17. Antigravity CLI Bash Mode

مع أنّ Gemini يتعامل مع المهام المعقّدة، تكون الأوامر المباشرة أكثر فعالية لتنفيذ الإجراءات البسيطة. تتيح ! prefix التبديل بسلاسة بين المحادثة وواجهات سطر الأوامر التقليدية. اكتب ! أولاً، ثم أمر git status.

! git status

راجِع الناتج.

18 توافق Antigravity CLI مع MCP

يمكن أن تتكامل واجهة سطر الأوامر Antigravity، من خلال بروتوكول Model Context Protocol ‏ (MCP)، مع أنظمة تابعة لجهات خارجية، مثل Jira أو Confluence أو GitHub. يتم تحقيق ذلك من خلال عمليات دمج أدوات مخصّصة لخادم MCP، ما يتيح لواجهة سطر الأوامر Antigravity CLI إنشاء أو تعديل تذاكر JIRA، واسترداد المعلومات من صفحات Confluence، وإنشاء طلبات سحب، وما إلى ذلك.

إعدادات الخادم على مستوى العالم وعلى مستوى مساحة العمل:

إعدادات الخادم العامة: يتم ضبطها في ~/.gemini/antigravity-cli/mcp_config.json.
عمليات الإعداد المحلية في Workspace: يتم ضبطها في مشروعك النشط ضمن .agents/mcp_config.json.

نفِّذ هذا الأمر في الوحدة الطرفية الجديدة لإنشاء ملف الإعداد أو استخدام وضع الصدفة.

echo '{
    "mcpServers": {
        "context7": {
            "serverURL": "https://mcp.context7.com/mcp"
        }
    }
}' > ~/.gemini/antigravity-cli/mcp_config.json

ابدأ جلسة Antigravity CLI:

agy

التحقّق من خوادم MCP التي تم إعدادها:

/mcp

راجِع الناتج:

أرسِل الطلب لاختبار خادم MCP الذي تم إعداده:

Use context7 tools to look up how to implement flex grid in react mui library

الموافقة على الأدوات ومراجعة النتائج

19. مثال على إعدادات خوادم MCP لبيئتك المحلية

يمكنك إعداد عدة خوادم MCP في بيئتك المحلية باستخدام الإعدادات التالية.

{
    "mcpServers": {
        "Snyk Security Scanner": {
            "command": "snyk",
            "args": [
                "mcp",
                "-t",
                "stdio",
                "--experimental"
            ],
            "env": {}
        },
        "atlassian": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://mcp.atlassian.com/v1/sse"
            ]
        },
        "playwright": {
            "command": "npx",
            "args": [
                "@playwright/mcp@latest"
            ]
        },
        "github": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-github"
            ],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": "******"
            }
        }
    }
}

تحوّل خوادم MCP في هذا الإعداد وكيل Antigravity CLI إلى أداة ديناميكية للتطوير والتعاون من خلال توفير وصول موحّد إلى الأنظمة الخارجية.

على وجه التحديد، يتيح خادم Snyk Security Scanner للوكيل التحقّق من الرموز والتبعيات بحثًا عن الثغرات الأمنية بدون مغادرة مساحة العمل الحالية، بينما يتصل خادم Atlassian بـ Jira وConfluence، ما يتيح لواجهة سطر الأوامر Antigravity إنشاء المشاكل أو المستندات والبحث فيها وتعديلها باستخدام اللغة الطبيعية.

يمنح خادم Playwright الوكيل إمكانات التشغيل الآلي للمتصفّح، ما يسمح له بالتنقّل والتفاعل مع الويب لأداء مهام مثل الاختبار أو استخراج البيانات. أخيرًا، يمنح خادم Github الوكيل إذن وصول مباشر ومناسب للسياق إلى مستودعاتك، ما يتيح له إدارة طلبات الدمج وتحديد أولويات المشاكل وتحليل قاعدة الرموز البرمجية، ما يقلّل بشكل كبير من تبديل السياق ويعزّز الإنتاجية في جميع مراحل سير عمل التطوير.

20. نموذج قابلية التوسعة

تم تصميم Antigravity CLI لتوفير إمكانية تخصيص بلا حدود. يمكنك تحسين نظام توجيه الوكلاء المشترك من خلال تثبيت وحدات حِزم منظَّمة تُعرف باسم "المكوّنات الإضافية" أو إنشاء مخططات أولية محلية بتنسيق Markdown تُعرف باسم "المهارات".

تسمح عمليات التخصيص هذه للوكلاء بالوصول إلى أوامر خاصة مملوكة، واستدعاء وكلاء فرعيين خاصين بمجالات معيّنة، والرجوع إلى قيود الأسلوب المخصّصة.

المكوّنات الإضافية في Antigravity

المكوّنات الإضافية هي حِزم ذات مساحات أسماء تتضمّن مهارات مخصّصة، وعناصر فرعية تعمل في الخلفية، وقواعد تدقيق، وتعريفات "بروتوكول سياق النموذج"، وخطافات الأحداث في أصل واحد قابل للنشر.

مهارات الوكيل

"المهارات" هي ملفات markdown وصفية يمكن للبشر قراءتها وتوضّح بروتوكولات التعليمات والبرامج النصية والمراجع المستهدَفة لمهام هندسية متخصّصة.

بعد التسجيل، يتم تحويل Skills تلقائيًا إلى أوامر شرطة مائلة داخل واجهة المستخدم النصية، ما يتيح لك استدعاءها يدويًا (على سبيل المثال، كتابة /refactor-ui).

إدارة العُقَد

تعترض الخطافات إجراءات الوكيل قبل التنفيذ مباشرةً أو بعده مباشرةً. وهي مفيدة لتنفيذ عمليات التحقّق الآلية قبل النشر أو تنسيقات ما بعد الإنشاء (مثل تشغيل prettier بعد كتابة الملفات).

يتم تحديد الخطافات داخل hooks.json أحد المكوّنات الإضافية أو ضبطها داخل ملف settings.json الأساسي. يمكنك فحص جميع الخطافات النشطة والتي تم تحميلها داخل Antigravity CLI عن طريق كتابة: /hooks.

21. الخاتمة

في النهاية، يثبت أنّ Antigravity CLI هو وكيل ذكاء اصطناعي قابل للتكيّف وقوي يعمل جنبًا إلى جنب مع نماذج Gemini لتسريع إنتاجية المطوّرين. وقد أثبت هذا المختبر فعاليته في تحسين سير عمل الهندسة الروتينية، مثل تعلُّم قواعد الرموز البرمجية الجديدة، وإنتاج المستندات اللازمة، وإنشاء اختبارات الوحدات. لقد رأينا كيف يسهّل إعادة تصميم العناصر من جهة العميل ومن جهة الخادم في تطبيق ويب مستند إلى Python. ومن خلال استخدام Antigravity CLI، يمكن للمهندسين تقليل تبديل السياق وأتمتة المهام اليدوية وإنتاج رمز برمجي عالي الجودة بشكل أسرع. إنّ دمج إمكانات Gemini الذكية مباشرةً في بيئة نافذة الأوامر بهذه الطريقة يغيّر بشكل جذري ممارسات التطوير الحديثة.

22. تهانينا!

تهانينا، لقد أكملت درس البرمجة.

المواضيع التي تناولناها:

استخدام Antigravity CLI لتنفيذ مهام المطوّرين الشائعة

الخطوة التالية:

سنقدّم المزيد من الجلسات العملية قريبًا.

تَنظيم

لتجنُّب تحمّل رسوم في حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا البرنامج التعليمي، احذف المشروع الذي يحتوي على الموارد أو احتفظ بالمشروع واحذف الموارد الفردية.

حذف المشروع

أسهل طريقة لإيقاف الفوترة هي حذف المشروع الذي أنشأته لتنفيذ البرنامج التعليمي.