بدء استخدام Google Antigravity

1. مقدمة

في هذا الدرس التطبيقي حول الترميز، ستتعرّف على Google Antigravity، وهي منصة تطوير قائمة على وكلاء الذكاء الاصطناعي ومصمَّمة لمساعدتك في التطوير في عصر الوكلاء. تعمل Antigravity 2.0 كمركز تحكّم مركزي لوكلاء الذكاء الاصطناعي، وتوفّر منصة موحّدة لتشغيل أنشطتهم وتتبُّعها وتنظيمها.

مع إطلاق الإصدار 2.0، لم يعُد Antigravity مجرّد "مدير وكلاء" مدمج مع بيئة تطوير متكاملة (IDE). أصبح الآن نظامًا شاملاً للمنتجات المصمّمة لعصر الذكاء الاصطناعي:

• ‫Antigravity: التطبيق المستقل الرئيسي لأنظمة التشغيل macOS وLinux وWindows هذا هو مركز التحكّم الخاص بك لإدارة العديد من الوكلاء المحليين بالتوازي وتنفيذ المهام المُجدوَلة وغير ذلك. على عكس الإصدار السابق، أي "أداة إدارة الوكلاء"، فإنّ Antigravity 2.0 هو تطبيق مستقل يعمل بشكل منفصل عن بيئة التطوير المتكاملة (IDE).
• بيئة تطوير متكاملة (IDE) من Antigravity: تظل بيئة التطوير المتكاملة الأصلية التي تتضمّن جميع الميزات والمستندة إلى الذكاء الاصطناعي الوكيل متاحة (وننصح المطوّرين باستخدامها). ويأتي مزوّدًا بأداة إدارة الوكلاء والنتائج وفهم عميق لقاعدة الرموز البرمجية.
• ‫Antigravity CLI: واجهة سطر أوامر للتفاعلات المستندة إلى المحطة الطرفية لن نتناول هذا الموضوع في هذا البرنامج التعليمي.
• ‫Antigravity SDK: أدوات للمطوّرين لدمج Antigravity في أنظمتهم بشكل آلي لن نتناول هذا الموضوع في هذا البرنامج التعليمي.
• Antigravity for IDEs: تم إطلاق هذه الميزة مؤخرًا. تدمج هذه الأداة إمكانات الوكيل المستقل من Antigravity مباشرةً في المحرّر المفضّل لديك من خلال إضافات رسمية لـ Visual Studio Code وJetbrains وZed وغيرها. في حال عدم الرغبة في استخدام أيّ من هذه الإضافات، يمكنك استخدام بيئة التطوير المتكاملة Antigravity المستقلة المذكورة أعلاه.

في هذا الدرس التطبيقي حول الترميز، سنركّز بشكل كبير على Antigravity وسنتناول بإيجاز بيئة تطوير Antigravity المتكاملة. ولا يشمل ذلك المكوّنَين الآخرَين، وهما Antigravity CLI وAntigravity SDK.

إذا كنت مهتمًا بدرس تطبيقي حول الترميز حول Antigravity CLI، وهو تطبيق يستند إلى الجهاز الطرفي، يمكنك الرجوع إلى درس تطبيقي حول الترميز: بدء استخدام Antigravity CLI.

ما ستتعلمه

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

المتطلبات

يجب تثبيت Antigravity على نظامك. يتوفّر المنتج على أجهزة Mac وWindows وبعض توزيعات Linux. بالإضافة إلى جهازك، ستحتاج إلى ما يلي:

• متصفّح الويب Chrome
• حساب Gmail (حساب Gmail شخصي)

تم تصميم هذا الدرس التطبيقي حول الترميز للمستخدمين والمطوّرين من جميع المستويات.

مشاكل إعداد التقارير

أثناء العمل على الدرس العملي واستخدام Antigravity، قد تواجه مشاكل.

بالنسبة إلى المشاكل المتعلّقة ببرنامج codelab (مثل الأخطاء الإملائية أو التعليمات الخاطئة)، يُرجى فتح خطأ باستخدام الزر Report a mistake في أسفل يسار برنامج codelab هذا:

للإبلاغ عن أخطاء أو طلب ميزات متعلقة بتطبيق Antigravity، يُرجى الإبلاغ عن المشكلة داخل التطبيق. يمكنك الإبلاغ عن ملاحظاتك بشأن المنتج من خلال النقر على "الإعدادات" في أسفل يمين منتج Antigravity. ثم اختيار الخيار Provide Feedback.

2. تثبيت

تثبيت Antigravity

انتقِل إلى صفحة تنزيل Google Antigravity. نزِّل تطبيق Antigravity لنظام التشغيل (macOS أو Linux أو Windows).

شغِّل أداة التثبيت. تظهر الشاشة التالية:

يتوفّر خياران:

• المتابعة باستخدام Google: يمكنك استخدام حسابك الشخصي على Google هنا، وتوفّر Antigravity حزمة للمبتدئين مع Gmail شخصي. في حال شراء حِزم Google AI Pro أو Ultra على حسابك على Google، سيتم تطبيق حدود الحصة المناسبة في Antigravity.
• استخدام حساب العمل: ينطبق ذلك إذا كنت تستخدم هذه الميزة في مشروع Enterprise، حيث لديك مشروع على Google Cloud واشترت مؤسستك تراخيص. بدلاً من ذلك، يمكنك استخدام "مشروع Google Cloud" مع "منصة Agent Platform" بنظام الدفع حسب الاستخدام. لن نستخدم هذا الخيار هنا.

انقر على "المتابعة باستخدام Google" وسجِّل الدخول باستخدام حسابك على Google. أكمِل عملية المصادقة، وسيظهر لك ما يلي:

انقر على فتح Antigravity وستستمر بقية العملية.

يمكنك اختيار مظهر وواحد أو أكثر من مكوّنات Google الإضافية التي يمكنك استخدامها مع Antigravity (يمكنك تجاهل كل ذلك في الوقت الحالي) وشاشة البنود / الشروط. اقبل التثبيت، ثم انقر على إنهاء، ومن المفترض أن تظهر لك واجهة Antigravity بالشكل التالي:

سنتناول الواجهة بعد قليل، ولكننا جاهزون في الوقت الحالي.

تثبيت Antigravity IDE

في الشاشة أعلاه، من المفترض أن يظهر لك زر تثبيت Antigravity IDE في أعلى يسار الصفحة. سيتم نقلك إلى صفحة تنزيل بيئة التطوير المتكاملة في Google Antigravity، ويمكنك الانتقال إليها مباشرةً أيضًا.

انقر على الزر تنزيل. سينقلك هذا إلى صفحة يمكنك من خلالها تنزيل إضافة Antigravity لبيئات التطوير المتكاملة المفضّلة لديك (Visual Studio Code وZed وJetbrains وما إلى ذلك) أو يمكنك تنزيل برنامج تثبيت بيئة التطوير المتكاملة المستقلة Antigravity كما هو موضّح أدناه:

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

سيظهر لك رمزان في شريط التطبيقات: Antigravity 2.0 (خلفية بيضاء) وAntigravity IDE (خلفية شبكة سوداء).

ملاحظة لمطوّري Linux: إذا كنت تنشر التطبيق من خلال حزمة ثنائية ‎ .tar.gz لنظام التشغيل Linux، سيقوم مشغّل الإعداد تلقائيًا بضبط بيئة Antigravity IDE الكاملة وتشغيلها بشكلٍ أصلي. سيظهر لك رمز واحد مدمج فقط في قائمة التطبيقات، وهو يتعامل مع مساحة عمل الرمز وإدارة الوكيل في الخلفية.

3- واجهة Antigravity 2.0

ابدأ تشغيل Antigravity إذا لم يسبق لك ذلك. من المفترض أن تظهر لك شاشة على النحو التالي. إذا كنت قد ثبّت بيئة تطوير متكاملة (IDE) مستقلة من Antigravity، سيكون الزر في أعلى يسار الصفحة فتح بيئة تطوير متكاملة (IDE) من Antigravity وليس تثبيت بيئة تطوير متكاملة (IDE).

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

المشاريع

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

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

لننشئ مشروعنا الأول. في مجلدك الرئيسي على جهازك المحلي، أنشئ مجلدًا باسم $HOME/agy2-projects/my-first-project . يُرجى العِلم أنّه ليس من الضروري أن يكون المجلد فارغًا.

سننشئ الآن مشروعنا الأول في Antigravity من خلال تحديد المجلدات التي يتألف منها المشروع. في حالتنا الأولية هنا، سيكون هناك مجلد واحد فقط، أي $HOME/agy2-projects/my-first-project.

في شريط التنقّل الأيمن، سيظهر قسم المشاريع. انقر على الزر إنشاء مشروع جديد كما هو موضّح أدناه:

ستظهر لك الخيارات كما هو موضّح أدناه، انقر على مشروع جديد:

سيُطلب منك اختيار مجلد لمشروعك من خلال فتح "المجلد" أو "مستكشف الملفات". اختَر المجلد، وهو $HOME/agy2-projects/my-first-project في حالتنا.

لذا، حدّدنا حاليًا مشروعًا باسم my-first-project يشير إلى مجلد، أي $HOME/agy2-projects/my-first-project.

قد تسأل عمّا إذا كان بإمكان المشروع أن يحتوي على مجلد واحد فقط. ماذا لو أردت إنشاء مشروع يتضمّن مجلدات لكل من الرمز البرمجي للواجهة الأمامية والخلفية؟ يمكنك إضافة المزيد من المجلدات ليتمكّن Antigravity من فهم السياق الكامل أثناء العمل على مشاريعك. انقر على إعدادات المشروع للمشروع المحدّد (my-first-project) كما هو موضّح أدناه:

سيؤدي ذلك إلى فتح مربّع الحوار إعدادات المشروع للمشروع المحدّد، وستلاحظ أنّه يتضمّن خيار إضافة المزيد من المجلدات من خلال الخيار إضافة مجلد.

لا يزال بإمكانك إضافة المزيد من المجلدات إلى المشروع، كما تلاحظ (من خلال إضافة مجلد)، ولكن في الوقت الحالي، لا بأس بذلك ويمكننا النقر على الزر "إنشاء".

يمكنك إغلاق صفحة الإعدادات الآن.

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

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

في الوقت الحالي، لنرحّب بموظف الدعم الرائع من خلال النقر على بدء المحادثة الأولى. بعد ذلك، ستظهر لك الشاشة التالية ومشروعنا الأول الذي يظهر الآن في قائمة المشاريع على اليمين وكالمشروع الذي سيعمل فيه الوكيل عندما ترسل إليه رسائل من خلال واجهة المحادثة. يُرجى العِلم أنّه يمكنك اختيار "النموذج"، وتمرير سياق إضافي من خلال علامة الجمع (+) أو علامة @ أو إجراءات الشرطة المائلة (/) وما إلى ذلك.

لنرسل رسالة إلى "الوكيل" وسيردّ علينا وفقًا لذلك.

لديّ طلب آخر للحصول على الأخبار وهو يؤدي وظيفة جيدة.

المحادثات

ما فعلناه هنا هو أنّنا بدأنا سلسلة محادثات في مشروعنا (my-first-project)، وتتضمّن السلسلة حاليًا مجموعة من الرسائل (رسالة المستخدم وردود الوكيل).

ستلاحظ أنّ سلسلة المحادثات هذه تظل واحدة وتظهر على الجانب الأيمن مجمّعة ضمن المشروع.

لنقم الآن بشيء مثير للاهتمام ونضع اسمًا لسلسلة المحادثات هذه. لنسمِّها conv-introduction.

لإجراء ذلك، انقر على النقاط الثلاث العمودية بجانب المحادثة. سيظهر لك 3 خيارات. اختَر إجراء إعادة التسمية.

أدخِل القيمة conv-introduction أو أي اسم آخر يبدو منطقيًا بالنسبة إليك.

الآن، إذا أردت إجراء محادثة جديدة تمامًا في المشروع، انقر على علامة + (محادثة جديدة في المشروع) بجانب المشروع كما هو موضّح أدناه.

أنت الآن في محادثة جديدة تمامًا.

لنطلب بعض الأخبار الرياضية من جميع أنحاء العالم. يُرجى العِلم أنّنا ما زلنا في my-first-project، أي "أريد بعض الأخبار الرياضية من جميع أنحاء العالم".

يقدّم لي هذا بعض الأخبار حول عالم الرياضة، ويمكنك ملاحظة أنّ لدينا الآن سلسلتَي محادثات في المشروع نفسه.

لنعد تسمية هذه المحادثة إلى conv-sportsnews. إذا أردت الاطّلاع على جميع المحادثات التي أجريتها حتى الآن، يمكنك الانتقال إلى سجلّ المحادثات في أعلى يسار الصفحة كما هو موضّح أدناه:

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

إعدادات المشروع

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

للوصول إلى إعدادات مشروع معيّن، انقر على رمز ترس الإعدادات بجانب المشروع المعيّن في شريط التنقّل الأيمن كما هو موضّح أدناه، ثم انقر على إعدادات المشروع:

سيؤدي ذلك إلى الانتقال إلى إعدادات المشروع المحدّد (أي my-first-project) كما هو موضّح أدناه:

لاحظ على يمين الصفحة ضِمن المشاريع أنّه تم اختيار my-first-project. إذا كانت هناك مشاريع أخرى، ستظهر ضمن هذه القائمة ويمكنك بسهولة اختيار أي من المشاريع وتعديل إعداداتها حسب الحاجة.

لنركّز الآن على الجانب الأيسر، أي إعدادات المشروع المعروضة my-first-project. ستلاحظ أنّه يحتوي على المجلد الفردي الذي أضفناه إلى هذا المشروع. يمكنك أيضًا إضافة المزيد من المجلدات من هنا.

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

ومن بينها:

• إعدادات الأمان المُسبَقة: يمكنك تحديد ما إذا كنت تريد أن تتم مراجعة جميع أوامر الجهاز وعمليات الوصول إلى الملفات أولاً من قِبلِك قبل أن يتمكّن الوكيل من تنفيذ الإجراءات.
• سلوك الوكيل: في حال إنشاء عناصر، مثل implementation_plan.md، حيث تريد مراجعتها قبل أن تطلب من الوكيل المتابعة وتنفيذ الخطة.
• أذونات محلية متنوعة، مثل مسارات الملفات المسموح بالوصول إليها وعناوين URL المسموح بها أو المحظورة على "برنامج Google للتسوق" وما إلى ذلك
• يمكنك حتى ضبط أدوات MCP المحدّدة المسموح بها لهذا المشروع. ويكون ذلك مفيدًا جدًا لمنع إتاحة جميع خوادم MCP التي تم ضبطها على مستوى العالم للوكيل في هذا المشروع.

ملاحظة: في أي وقت، يمكنك الانتقال إلى إعدادات Antigravity أو حتى إعدادات المشروع من خلال خيار الإعدادات الرئيسية في واجهة Antigravity.

4. الأوامر التي تبدأ بشرطة مائلة

تتوفّر بعض الأوامر المثيرة للاهتمام التي تبدأ بشرطة مائلة / في Antigravity. في واجهة محادثتك، إذا كتبت / ، ستظهر لك الأوامر كما هو موضّح أدناه:

يُعدّ الأمر /plan مهمًا إذا كنت تريد أن ينشئ النموذج خطة تنفيذ قبل التنفيذ.

يُستخدم الأمر /browser لتشغيل المتصفّح وطلب تنفيذ إجراء معيّن.

حاوِل الانتقال إلى موقع إلكتروني كما هو موضّح أدناه:

ملاحظة: يتطلّب الأمر /browser أن يكون متصفّح Google Chrome هو المتصفّح التلقائي لبدء جلسة تصحيح الأخطاء.

سيؤدي ذلك إلى إنشاء وكيل فرعي للمتصفّح يحاول بدء جلسة تصحيح الأخطاء باستخدام Chrome ويطلب إذنك أولاً:

بعد السماح بذلك، سينتقل المتصفّح إلى الموقع الإلكتروني ويحصل على آخر الأخبار، ثم ستصلك البيانات في Antigravity.

يكون الأمر /schedule مفيدًا إذا أردت إعداد مهام متكررة أو لمرة واحدة ينفّذها الوكيل على فترات زمنية ثابتة أو وفقًا لجدول زمني (مثل الساعة 9:00 صباحًا يوم الاثنين والأربعاء).

في الوقت نفسه، يتم توفير التسهيل نفسه لك لإجراء ذلك من خلال واجهة المستخدم، ويتم تناول ذلك في قسم جدولة الأوامر في الخطوة التالية.

5- جدولة الأوامر

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

لننشئ مهمة يومية تذكّرنا باجتماعنا اليومي في الساعة 6 مساءً. انقر على جديد وأدخِل التفاصيل كما هو موضّح أدناه:

انقر على إضافة مهمة مجدولة، ثم ستتم إضافة المهمة إلى قائمة المهام المجدولة كما هو موضّح أدناه:

لنضِف تذكيرًا آخر يذكّرنا بأخذ استراحة كل 20 دقيقة:

لدينا الآن مهمتان مُجدوَلتان، كما هو موضّح أدناه:

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

6. خوادم بروتوكول سياق النموذج (MCP)

"بروتوكول سياق النموذج" (MCP) هو المعيار الذي يساعد في ربط الوكلاء بالأنظمة الخارجية. وتلعب دورًا رئيسيًا في ضمان أن يظلّ الوكيل مستندًا إلى بياناتك وعمليات الدمج.

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

أتاح الإصدار الأخير من Antigravity 2.0 إضافة خوادم MCP إلى Antigravity بسهولة.

انتقِل إلى الإعدادات → التخصيصات، وسيظهر لك إعداد خادم MCP كما هو موضّح أدناه:

انتقِل إلى قسم "خوادم MCP المثبَّتة" في الإعدادات أعلاه كما هو موضّح أدناه:

إذا نقرت على الزر "فتح إعدادات MCP"، سيتم توجيهك إلى الملف الموجود في $HOME/.gemini/config/mcp_config.json، وهو المكان الذي يتم فيه حفظ جميع إعداداتك. إذا كنت على دراية بملف إعدادات خوادم MCP، يمكنك تعديل المحتوى في الملف وحفظه مباشرةً.

يمكنك ملاحظة أنّها فارغة في هذه المرحلة.

لضبط إعدادات خادم MCP، ما عليك سوى النقر على الزر إضافة MCP.

يؤدي ذلك إلى عرض قائمة كبيرة من الإعدادات المُسبَقة المتاحة للعديد من خوادم MCP، وخاصةً خدمات Google Cloud التي تم تجميعها كخوادم MCP. تظهر شاشة أدناه:

يمكنك إضافة أي منها. على سبيل المثال، نقرتُ على إضافة بجانب خادم MCP على Google Cloud Run وتم تثبيته.

تتم إضافته إلى قائمة خوادم MCP كما هو موضّح أدناه، بالإضافة إلى الأدوات التي يعرضها خادم MCP. يمكنك ببساطة تفعيل/إيقاف أداة من خلال النقر على تلميح اسم الأداة المحدّدة أدناه أو حتى إيقاف خادم MCP بالكامل من خلال النقر على مفتاح التبديل "تفعيل / إيقاف".

إذا نقرت على الزر فتح إعدادات MCP، سيظهر لك أنّه تمّت إضافة الإدخال إلى الملف mcp_config.json، كما هو موضّح أدناه:

{
 "mcpServers": {
   "cloudrun": {
     "command": "npx",
     "args": [
       "-y",
       "@google-cloud/cloud-run-mcp"
     ]
   }
 }
}

إذا كنت تستخدم خوادم MCP بعيدة حالية، يمكنك ببساطة إضافة التفاصيل إلى ملف $HOME/.gemini/config/mcp_config.json.

لاستخدام خوادم MCP التي تم ضبطها، يمكنك أن تطلب من Antigravity شيئًا يتطلّب خادم MCP. على سبيل المثال، يمكنك تفعيل خادم cloudrun-mcp وطرح السؤال التالي على Antigravity: Build and deploy a Cloud Run service. من المفترض أن يؤدي ذلك إلى توجيه Antigravity للبحث عن الخادم cloudrun-mcp واستخدامه من أجل ضبط خدمة Cloud Run ونشرها.

7. النواتج

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

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

في ما يلي العناصر الرئيسية التي قد تنتجها Antigravity:

• Task Lists: قبل كتابة الرمز، يمكن للوكيل اختيار إنشاء خطة منظَّمة. لا تحتاج عادةً إلى تعديل هذه الخطة، ولكن يمكنك مراجعتها وفي بعض الحالات إضافة تعليق لتغييرها إذا لزم الأمر.
• Implementation Plan: يتم إنشاء خطة تنفيذ قبل البدء في إنجاز مهمة عند استخدام الأمر /plan. تحتوي هذه الخطط على تفاصيل فنية حول التعديلات اللازمة، ومن المفترض أن يراجعها المستخدم، ما لم تكن سياسة مراجعة العناصر قد تم ضبطها على المتابعة دائمًا.
• Walkthrough: قد يتم إنشاء هذا المستند بعد أن يكمل الوكيل تنفيذ المهمة، وهو يتضمّن ملخّصًا للتغييرات وطريقة اختبارها.
• Code diffs: على الرغم من أنّ Antigravity ليس قطعة أثرية من الناحية الفنية، إلا أنّه ينتج أيضًا اختلافات في الرموز البرمجية يمكنك مراجعتها والتعليق عليها.
• Screenshots: قد يسجّل الوكيل حالة واجهة المستخدم قبل التغيير وبعده.

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

لفهم القطع الأثرية بشكل أفضل، يمكنك إنشاء محادثة مع مشروع جديد أو حالي باستخدام الطلب والأمر /plan التاليَين:

/plan Design a Node application that I can run from the command line to get me the latest news from Google.

ينطلق الوكيل ويعود بأول قطعة أثرية: خطة التنفيذ.

ملاحظة: في بعض الأحيان، قد لا يظهر لك زر متابعة وقد تستمر أداة Antigravity بدون انتظار إدخالك.

يمكنك الاطّلاع على أي من العناصر التي أنشأتها Antigravity من خلال تفعيل اللوحة الإضافية المعروضة في أعلى يسار الصفحة.

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

انقر على خطة التنفيذ للاطّلاع على التفاصيل، كما هو موضّح أدناه:

في الوقت الحالي، لا بأس في الخطة، ما عليك سوى النقر على الزر متابعة للمضي قدمًا.

قد يُطلب منك منح أذونات للمتابعة، لذا يُرجى الموافقة على ذلك.

عندما يكمل الوكيل كل الخطوات ويختبرها ويتأكّد منها، ستصلك رسالة تفيد بأنّ المهمة قد اكتملت.

من العناصر الأخرى التي قد تظهر لك الجولة الإرشادية بالإضافة إلى اختلافات الملفات كما هو موضّح أدناه.

قد لا تحتاج إلى محرر أو بيئة تطوير متكاملة (IDE) كاملة لعرض الملفات التي تم إنشاؤها. يمكنك النقر على الملفَين package.json أو index.js وستتمكّن من الاطّلاع على المحتوى والتعليق عليه.

8. Antigravity IDE

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

انقر على ذلك الرمز لفتح Antigravity IDE. قد يظهر لك تحذير عند تشغيل بيئة التطوير المتكاملة Antigravity، ويكون على النحو التالي:

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

9. المهارات

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

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

البنية والنطاق

المهارات هي حِزم مستندة إلى الدليل. يمكنك تحديدها في نطاقَين حسب احتياجاتك:

• النطاق العام (~/.gemini/config/skills/): متاح في جميع منتجات Antigravity (‫Antigravity وAntigravity IDE وAntigravity CLI) والمشاريع.
• نطاق المشروع/مساحة العمل (<project-root>/.agents/skills/): سيؤدي ذلك إلى إتاحة المهارة ضمن مشروع معيّن فقط.

بنية المهارة

يبدو دليل المهارات النموذجي على النحو التالي :

my-skill/
├── SKILL.md    #(Required) metadata & instructions.
├── scripts/    # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/     # (Optional) Images or logos.

لنضِف بعض المهارات الآن.

مهارة مراجعة الرموز البرمجية

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

بافتراض أنّك في مجلد مشروع معيّن (مثل $HOME/agy2-projects/my-skills-project))، الخطوة الأولى هي إنشاء دليل في مجلد المشروع يحتوي على المهارة.

mkdir -p .agents/skills/code-review

أنشئ ملف SKILL.md في مجلد المشروع، مثلاً .agents/skills/code-review الذي أنشأناه للتو، مع المحتوى الموضّح أدناه:

---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?

## How to provide feedback

- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible

لاحظ أنّ الملف SKILL.md أعلاه يحتوي على البيانات الوصفية (الاسم والوصف) في الأعلى ثم التعليمات. عندما يحمّل الوكيل، سيقرأ البيانات الوصفية للمهارات فقط، ولن يحمّل تعليمات المهارات الكاملة إلا عند الحاجة.

لنثبت صحة مهارة مراجعة التعليمات البرمجية. افتح محادثة في Antigravity في مشروع محدّد من اختيارك وقدِّم الطلب التالي.

يجب أن تعرض مهارة مراجعة الرمز.

للتجربة:

أنشئ ملفًا جديدًا باسم demo_bad_code.py في $HOME/agy2-projects/my-skills-project يتضمّن المحتوى الموضّح أدناه:

import time

def get_user_data(users, id):
   # Find user by ID
   for u in users:
       if u['id'] == id:
            return u
   return None

def process_payments(items):
   total = 0
   for i in items:
       # Calculate tax
       tax = i['price'] * 0.1
       total = total + i['price'] + tax
       time.sleep(0.1) # Simulate slow network call
  
   return total

def run_batch():
   users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
   items = [{'price': 10}, {'price': 20}, {'price': 100}]
  
   u = get_user_data(users, 3)
   print("User found: " + u['name']) # Will crash if None
  
   print("Total: " + str(process_payments(items)))

if __name__ == "__main__":
   run_batch()

افتح محادثة جديدة في مشروع محدّد في Antigravity وأدخِل الطلب التالي: review the @demo_bad_code.py file.

على "الوكيل" تحديد المهارة code-review، وتحميل التفاصيل، ثم تنفيذ الإجراء وفقًا للتعليمات الواردة في الملف code-review/SKILL.md.

يظهر أدناه نموذج للناتج:

10. الخاتمة

تهانينا! لقد ثبَّت الآن Antigravity 2.0 بنجاح، وأعددت بيئتك، وتعرّفت على كيفية التحكّم في البرامج.

الخطوات التالية للاطّلاع على Antigravity 2.0 أثناء إنشاء تطبيقات في العالم الحقيقي، يمكنك الاطّلاع على درس تطبيقي حول الترميز التالي:

• إنشاء التطبيقات ونشرها على Google Cloud باستخدام Antigravity: يوضّح هذا الدرس التطبيقي حول الترميز كيفية تصميم تطبيق بدون خادم وإنشائه ونشره على Google Cloud.

المستندات المرجعية

• الموقع الإلكتروني الرسمي : https://antigravity.google/
• المستندات: https://antigravity.google/docs/home
• حالات الاستخدام : https://antigravity.google/use-cases
• تنزيل : https://antigravity.google/download
• قناة Google Antigravity على YouTube : https://www.youtube.com/@googleantigravity