Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

1. نظرة عامة

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

ما ستتعلمه

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

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

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

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

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

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

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

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

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

إعداد البيئة

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

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

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

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

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

اشرح Cloud Run في 5 نقاط رئيسية.
أنا مدير منتج Google Cloud Run، أريد شرح 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 الموثوقين في 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

‫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 للتعرّف بسرعة على قاعدة رموز جديدة من خلال الطلب منها تلخيص الغرض من الملفات أو الأدلة وشرح الوظائف المعقّدة أو أقسام الرموز. يتيح ذلك للمطوّرين الانضمام بسرعة إلى مشاريع جديدة أو فهم الأجزاء غير المألوفة من الرموز الحالية بدون استكشاف يدوي معمّق.

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

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

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

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

يمكن لواجهة سطر الأوامر Antigravity تبسيط عملية تشغيل تطبيق 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:

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 الأمر /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، يمكنك إنجاز مهام مختلفة تلقائيًا عن طريق تمرير الطلبات والأوامر مباشرةً إلى CLI بدون الحاجة إلى تدخل يدوي، ما يتيح الدمج السلس في مسارات العمل المبرمَجة لتحليل الرموز البرمجية وإنشاء المستندات ومهام التطوير الأخرى.

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

agy -p "Explain the architecture of this codebase"

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

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

17. وضع Bash في Antigravity CLI

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

! git status

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

18 توافق Antigravity CLI مع MCP

يمكن دمج Antigravity CLI مع أنظمة تابعة لجهات خارجية، مثل Jira أو Confluence أو GitHub، من خلال بروتوكول Model Context Protocol ‏ (MCP). ويتم ذلك من خلال عمليات دمج مخصّصة لأدوات خادم 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 لتوفير إمكانية تخصيص غير محدودة. يمكنك تحسين أداة الوكيل المشتركة من خلال تثبيت وحدات حزمة منظَّمة تُعرف باسم "الإضافات" أو إنشاء مخططات أولية محلية بتنسيق 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 مقابل الموارد المستخدَمة في هذا البرنامج التعليمي، احذف المشروع الذي يحتوي على الموارد أو احتفظ بالمشروع واحذف الموارد الفردية.

حذف المشروع

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