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

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

1. مقدمة

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

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

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

ما ستتعلمه

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

المتطلبات

تتوفّر ميزة Antigravity حاليًا كمعاينة لحسابات Gmail الشخصية. يتضمّن حصة مجانية لاستخدام النماذج المميزة.

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

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

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

الإبلاغ عن المشاكل

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

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

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

يمكنك أيضًا الانتقال إلى المحرّر باستخدام الرابط Report Issue تحت رمز ملفك الشخصي:

2. تثبيت

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

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

شغِّل برنامج تثبيت التطبيق وثبِّته على جهازك. بعد اكتمال عملية التثبيت، شغِّل تطبيق Antigravity. من المفترض أن تظهر شاشة مشابهة لما يلي:

يُرجى المتابعة بالنقر على Next في كل مرة. في ما يلي الخطوات الرئيسية بالتفصيل:

اختيار مسار الإعداد: يتيح لك هذا الخيار استيراد الإعدادات من إعدادات VS Code أو Cursor الحالية. سنبدأ من جديد.
اختيار نوع مظهر "المحرّر": سنختار المظهر الداكن، ولكن الأمر يعود إليك تمامًا.
كيف تريد استخدام عامل "مضاد الجاذبية"؟

لنتعرّف على ذلك بمزيد من التفصيل. تذكَّر أنّه يمكن تغيير الإعدادات في أي وقت من خلال "إعدادات مستخدم Antigravity" (في Linux أو Windows: Ctrl + ,، وفي Mac: Cmd + ,).

قبل أن نتعمّق في الخيارات، لنلقِ نظرة على بعض السمات المحدّدة (التي تظهر على يسار مربّع الحوار).

سياسة التنفيذ في الوحدة الطرفية

يتعلّق هذا الإذن بمنح "الوكيل" القدرة على تنفيذ الأوامر (التطبيقات/الأدوات) في الوحدة الطرفية:

المتابعة دائمًا: تنفيذ أوامر الوحدة الطرفية تلقائيًا دائمًا (باستثناء تلك الواردة في قائمة الرفض القابلة للضبط)
طلب المراجعة: طلب مراجعة المستخدم والموافقة عليه قبل تنفيذ أوامر المحطة الطرفية

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

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

المتابعة دائمًا: لا يطلب الموظف منك أبدًا إجراء مراجعة.
يقرّر الوكيل: يقرّر الوكيل متى يطلب إجراء مراجعة.
طلب المراجعة: يطلب الوكيل دائمًا إجراء مراجعة.

سياسة تنفيذ JavaScript

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

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

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

هذه الخيارات الأربعة هي:

الوضع الآمن: يوفّر "الوضع الآمن" عناصر تحكّم محسّنة في الأمان لـ "الوكيل"، ما يتيح لك حصر وصوله إلى الموارد الخارجية والعمليات الحسّاسة. عند تفعيل "الوضع الآمن"، يتم فرض العديد من تدابير الأمان لحماية بيئتك.
التطوير المستند إلى المراجعة (يُنصح به): سيطلب الوكيل إجراء مراجعة بشكل متكرر.
التطوير المستند إلى Agent: لن يطلب Agent إجراء مراجعة أبدًا.
الإعدادات المخصّصة

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

بعد ذلك، ستظهر صفحة إعدادات ضبط المحرّر حيث يمكنك اختيار الإعدادات المفضّلة لما يلي:

ربط المفاتيح: يمكنك ضبط ربط المفاتيح.
الإضافات: يمكنك تثبيت إضافات شائعة للغة وإضافات أخرى مقترَحة.
سطر الأوامر: يمكنك تثبيت أداة سطر الأوامر لفتح Antigravity باستخدام agy.

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

أخيرًا، بنود الاستخدام يمكنك اتّخاذ قرار بشأن الموافقة على هذه الميزة أو عدم الموافقة عليها، ثم النقر على Next.

سيؤدي ذلك إلى لحظة الحقيقة، حيث سيكون تطبيق Antigravity في انتظار التعاون معك.

3- مدير وكالة

نحن جاهزون للبدء.

تستند Antigravity إلى أساس Visual Studio Code (VS Code) المفتوح المصدر، ولكنّها تغيّر تجربة المستخدم بشكل جذري لإعطاء الأولوية لإدارة الوكلاء على تعديل النصوص. تنقسم الواجهة إلى نافذتَين أساسيتَين مختلفتَين: Editor وAgent Manager. يعكس هذا الفصل بين المهام الفرق بين المساهمة الفردية وإدارة الهندسة.

Agent Manager: Mission Control

عند تشغيل Antigravity، تظهر للمستخدم عادةً الخيارات فتح مجلد (Open Folder) وفتح "مدير الوكيل" (Open Agent Manager) واستنساخ المستودع (Clone Repository).

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

في طريقة العرض هذه، يعمل المطوّر كمهندس معماري. وهي تحدّد الأهداف العامة، ويمكن أن تشمل الأمثلة ما يلي:

إعادة تصميم وحدة المصادقة
تحديث شجرة الاعتمادية
إنشاء مجموعة اختبارات لواجهة برمجة التطبيقات الخاصة بالفوترة

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

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

إذا نقرت على Open Folder، سيظهر لك خيار فتح مساحة عمل.

فكر في مساحة العمل كما عرفتها من VS Code وستنتهي. يمكننا فتح مجلد محلي من خلال النقر على الزر ثم اختيار مجلد للبدء به. في حالتي، كان لدي مجلد في مجلد المنزل باسم my-agy-projects واخترتُه. يمكنك استخدام مجلد مختلف تمامًا. يمكنك تخطّي هذه الخطوة تمامًا إذا أردت، ويمكنك فتح مساحة عمل في أي وقت لاحقًا أيضًا.

بعد إكمال هذه الخطوة، ستظهر لك نافذة "إدارة الوكلاء" (Agent Manager) كما هو موضّح أدناه:

ستلاحظ أنّ التطبيق موجّه على الفور لبدء محادثة جديدة في مجلد مساحة العمل (my-agy-projects) الذي تم اختياره. يمكنك الاستفادة من خبرتك الحالية في استخدام تطبيقات الذكاء الاصطناعي الأخرى (مثل Cursor وGemini CLI) واستخدام @ وطرق أخرى لتضمين سياق إضافي أثناء تقديم الطلب.

ألقِ نظرة على القوائم المنسدلة Model Selection. تتيح لك القائمة المنسدلة "اختيار النموذج" الاختيار من بين النماذج المتاحة في الوقت الحالي ليستخدمها "الوكيل". تظهر القائمة أدناه:

وبالمثل، نجد أنّ "الوكيل" سيكون في وضع Fast تلقائي. ولكن يمكننا أيضًا اختيار الوضع Plan.

لنلقِ نظرة على ما تقوله المستندات حول هذا الموضوع:

Planning: يمكن للوكيل التخطيط قبل تنفيذ المهام. يمكنك استخدامها لإجراء بحث معمّق أو إنجاز مهام معقّدة أو العمل بشكل تعاوني. في هذا الوضع، ينظّم "الوكيل" عمله في مجموعات مهام، وينتج "عناصر"، ويتّخذ خطوات أخرى للبحث بدقة والتفكير مليًا والتخطيط لعمله من أجل تحقيق أفضل جودة. سيظهر لك هنا الكثير من النتائج.
‫Fast: ينفّذ Agent المهام مباشرةً. استخدِمها للمهام البسيطة التي يمكن إكمالها بشكل أسرع، مثل إعادة تسمية المتغيّرات أو تنفيذ بعض أوامر bash أو غيرها من المهام الأصغر حجمًا والمحلية. يكون هذا الخيار مفيدًا عندما تكون السرعة عاملاً مهمًا، وتكون المهمة بسيطة بما يكفي لعدم القلق بشأن انخفاض الجودة.

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

لنستغرق بعض الوقت الآن في "إدارة الوكلاء" (النافذة) هنا ونفهم بعض الأشياء، حتى يكون الأمر واضحًا بشأن اللبنات الأساسية وكيفية التنقّل في Antigravity والمزيد. تظهر نافذة "إدارة الوكلاء" أدناه:

يُرجى الرجوع إلى الرسم البياني أعلاه الذي يتضمّن الأرقام التالية:

Start Conversation: انقر على هذا الرمز لبدء محادثة جديدة. سينقلك هذا الإجراء مباشرةً إلى حقل الإدخال الذي يظهر فيه Ask anything.
Workspaces: ذكرنا مساحات العمل وإمكانية العمل في أي مساحة عمل تريدها. يمكنك إضافة المزيد من مساحات العمل في أي وقت واختيار أي مساحة عمل عند بدء المحادثة.
‫Editor View: يمكنك التبديل إلى عرض المحرِّر في أي وقت. سيؤدي ذلك إلى عرض مجلد مساحة العمل وأي ملفات تم إنشاؤها. يمكنك تعديل الملفات مباشرةً أو حتى تقديم إرشادات مضمّنة أو أوامر في أداة التعديل، ليتمكّن "الوكيل" من تنفيذ إجراء أو إجراء تغييرات وفقًا لاقتراحاتك أو تعليماتك المعدَّلة. سنتناول طريقة عرض المحرّر بالتفصيل في قسم لاحق.

4. متصفّح Antigravity

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

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

وهذا يعني أنّه علينا تشغيل إضافة Antigravity للمتصفّح وتثبيتها. لنبدأ محادثة ونستعرض الخطوات.

ابدأ محادثة جديدة في مساحة عمل وقدِّم المهمة التالية: go to antigravity.google

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

سيؤدي ذلك إلى فتح المتصفّح وعرض رسالة لتثبيت الإضافة كما هو موضّح أدناه:

انتقِل إلى إضافة Chrome التي يمكنك تثبيتها.

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

بدِّل طريقة العرض إلى "إدارة الوكلاء"، ومن المفترض أن يظهر لك ما يلي:

هذا ما توقّعنا حدوثه بالضبط لأنّنا طلبنا من Agent الانتقال إلى الموقع الإلكتروني antigravity.google وزيارته. امنح التطبيق الإذن وستلاحظ أنّه تم الانتقال إلى الموقع الإلكتروني بأمان، كما هو موضّح أدناه:

5- العناصر

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

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

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

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

يتم إنتاج القطع الأثرية وتظهر في كلّ من طريقتَي العرض "إدارة الوكلاء" و"المحرّر".

في "عرض المحرّر"، يمكنك النقر على Artifacts في أسفل يسار الصفحة:

في طريقة عرض "مدير البرامج الآلية"، في أعلى يسار الصفحة، بجانب Review changes، من المفترض أن يظهر لك زر لتبديل القطع الأثرية أو إذا كان الخيار مفعّلاً، يمكنك الاطّلاع على قائمة القطع الأثرية التي تم إنشاؤها:

من المفترض أن تظهر لك طريقة عرض "العناصر" كما هو موضّح أدناه. في حالتنا هنا، طلبنا من "الوكيل" الانتقال إلى الصفحة antigravity.google، وبالتالي التقط لقطة شاشة لها وأنشأ فيديو لها:

يمكنك الاطّلاع على اختلافات الرموز في Review Changes في طريقة عرض "المحرّر":

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

6. محرِّر

تحتفظ أداة التعديل بتصميم VS Code المألوف، ما يضمن احترام الذاكرة العضلية للمطوّرين المتمرّسين. ويشمل مستكشف الملفات العادي وتمييز بناء الجملة والنظام المتكامل للإضافات.

يمكنك النقر على الزر Open Editor في أعلى يسار "إدارة الوكلاء" (Agent Manager) للانتقال إلى "المحرّر" (Editor).

الإعدادات والإضافات

في عملية الإعداد النموذجية، ستظهر أداة التعديل ومحطة الدفع والوكيل:

إذا لم يكن الأمر كذلك، يمكنك تبديل لوحات الجهاز الطرفي والوكيل على النحو التالي:

لتبديل لوحة Terminal، استخدِم الاختصار Ctrl + `.
لتبديل لوحة الوكيل، استخدِم الاختصار Cmd + L.

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

محرِّر

إكمال تلقائي

أثناء كتابة الرمز في المحرّر، يتم تفعيل ميزة الإكمال التلقائي الذكي التي يمكنك قبولها بالضغط على Tab:

الضغط على مفتاح التبويب (Tab) للاستيراد

يظهر لك اقتراح علامة التبويب للاستيراد لإضافة التبعيات الناقصة:

الضغط على مفتاح التبويب (Tab) للانتقال

يمكنك الحصول على اقتراحات الضغط على المفتاح Tab للانتقال لنقل المؤشر إلى الموضع المنطقي التالي في الرمز:

الطلبات الصوتية

يمكنك تشغيل الأوامر باستخدام Cmd + I في المحرّر أو الوحدة الطرفية للحصول على عمليات إكمال مضمّنة باستخدام اللغة الطبيعية.

في المحرّر، يمكنك طلب طريقة لاحتساب أرقام فيبوناتشي ثم قبولها أو رفضها:

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

لوحة الموظّف الجانبية

من المحرّر، يمكنك إظهار اللوحة الجانبية الخاصة بالوكيل أو إخفاؤها بعدة طرق.

الفتح يدويًا

يمكنك التبديل بين لوحة الوكيل على اليسار باستخدام الاختصار Cmd + L.

يمكنك البدء بطرح الأسئلة، أو استخدام @ لتضمين المزيد من السياق، مثل الملفات أو الدلائل أو خوادم MCP، أو استخدام / للإشارة إلى سير عمل (طلب محفوظ):

يمكنك أيضًا الاختيار بين وضعَي المحادثة: Fast أو Planning :

يُنصح باستخدام Fast للمهام السريعة، بينما يُنصح باستخدام Planning للمهام الأكثر تعقيدًا التي ينشئ فيها الوكيل خطة يمكنك الموافقة عليها.

يمكنك أيضًا اختيار نماذج مختلفة للمحادثة:

تفسير وتصحيح

هناك طريقة أخرى لتفعيل الوكيل وهي تمرير مؤشر الماوس فوق مشكلة والنقر على Explain and fix:

إرسال المشاكل إلى الوكيل

يمكنك أيضًا الانتقال إلى القسم Problems والنقر على Send all to Agent لكي يحاول الوكيل حلّ هذه المشاكل:

إرسال ناتج الوحدة الطرفية إلى الوكيل

يمكنك حتى اختيار جزء من ناتج الجهاز وإرساله إلى الوكيل باستخدام Cmd + L:

التبديل بين "المحرّر" و"مدير الوكيل"

في أي وقت، يمكنك التبديل بين وضع أداة التعديل ووضع "إدارة الوكلاء" الكامل من خلال النقر على الزر Open Agent Manager في أعلى يسار الصفحة عندما تكون في وضع أداة التعديل، والعودة إلى وضع "إدارة الوكلاء" من خلال النقر على الزر Open Editor في أعلى يسار الصفحة.

يمكنك أيضًا استخدام اختصار لوحة المفاتيح Cmd + E للتبديل بين الوضعين.

7. تقديم تعليق

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

خطة التنفيذ وقائمة المهام (قبل الترميز)
اختلافات الرموز البرمجية (أثناء إنشاء الرمز البرمجي)
شرح تفصيلي للتحقّق من النتائج (بعد الترميز)

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

لنحاول إنشاء تطبيق بسيط لقائمة المهام ونرى كيف يمكننا تقديم ملاحظات إلى Antigravity أثناء ذلك.

وضع التخطيط

أولاً، عليك التأكّد من أنّ Antigravity في وضع Planning (بدلاً من وضع Fast).يمكنك اختيار ذلك في لوحة الدردشة الجانبية الخاصة بالوكيل. يضمن ذلك أن تنشئ Antigravity خطة إعداد وقائمة مهام قبل الانتقال إلى الرمز البرمجي. بعد ذلك، جرِّب إدخال طلب، مثل: Create a todo list web app using Python. سيؤدي ذلك إلى بدء عمل الوكيل لبدء التخطيط وإنشاء خطة تنفيذ.

خطة التنفيذ

خطة التنفيذ هي نظرة عامة على ما تنوي شركة Antigravity فعله، وحزمة التكنولوجيا التي ستستخدمها، ووصف عام للتغييرات المقترَحة.

Implementation Plan - Python Todo App
Goal
Create a simple, functional, and aesthetically pleasing Todo List web application using Python (Flask).

Tech Stack
Backend: Python with Flask
Frontend: HTML5, CSS3 (Vanilla), Jinja2 templates
...

وهذا هو المكان الأول الذي يمكنك تقديم ملاحظات فيه. في حالتنا، يريد الوكيل استخدام Flask كإطار عمل ويب بلغة Python. يمكننا إضافة تعليق إلى خطة التنفيذ لاستخدام FastAPI بدلاً من ذلك. بعد إضافة التعليق، أرسِله أو اطلب من Antigravity Proceed مع خطة التنفيذ المعدَّلة.

قائمة المهام

بعد تعديل خطة التنفيذ، تنشئ Antigravity قائمة مهام. هذه قائمة محددة بالخطوات التي ستتّبعها Antigravity لإنشاء التطبيق والتحقّق منه.

Task Plan
 Create requirements.txt
 Create directory structure (static/css, templates)
 Create static/css/style.css
 Create templates/index.html
 Create main.py with FastAPI setup and Database logic
 Verify application

هذا هو الموضع الثاني الذي يمكنك فيه تقديم الملاحظات.

على سبيل المثال، في حالة الاستخدام هذه، يمكنك إضافة تعليمات أكثر تفصيلاً لإثبات الملكية من خلال إضافة التعليق التالي: Verify application by adding, editing, and deleting a todo item and taking a screenshot.

إليك بعض النصائح أثناء العمل على الملاحظات:

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

تغييرات الرمز

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

يمكنك أيضًا النقر على Review changes للاطّلاع على تفاصيل التغييرات وإضافة تعليقات تفصيلية على الرمز. على سبيل المثال، يمكننا إضافة التعليق التالي في main.py: Add basic comments to all methods

هذه طريقة رائعة لتكرار الرمز البرمجي باستخدام Antigravity.

جولة تفصيلية

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

يمكنك أيضًا التعليق على لقطة الشاشة أو تسجيل المتصفّح في الجولة الإرشادية. على سبيل المثال، يمكننا إضافة تعليق Change the blue theme to orange theme وإرساله. بعد إرسال التعليق، تجري Antigravity التغييرات وتتحقّق من النتائج وتعدّل الإرشادات.

التراجع عن التغييرات

أخيرًا، بعد كل خطوة، إذا لم تكن راضيًا عن التغيير، يمكنك التراجع عنه من المحادثة. ما عليك سوى النقر على ↩️ Undo changes up to this point في المحادثة.

8. القواعد وسير العمل

تتضمّن Antigravity خيارَين للتخصيص: القواعد وعمليات سير العمل.

أثناء استخدام وضع المحرّر، انقر على ... في أعلى يسار الصفحة واختَر Customizations، وسيظهر لك Rules وWorkflows:

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

مهام سير العمل هي طلبات محفوظة يمكنك تشغيلها عند الطلب باستخدام / أثناء تفاعلك مع الوكيل. وهي توجّه أيضًا سلوك الوكيل، ولكن يتم تفعيلها من قِبل المستخدم عند الطلب.

التشبيه المناسب هو أنّ القواعد تشبه تعليمات النظام، بينما تشبه "عمليات سير العمل" الطلبات المحفوظة التي يمكنك اختيارها عند الحاجة.

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

قاعدة عامة: ~/.gemini/GEMINI.md
سير العمل العام: ~/.gemini/antigravity/global_workflows/<YOUR_WORKFLOW_NAME>.md
قواعد مساحة العمل: your-workspace/.agents/rules/
سير العمل في Workspace: your-workspace/.agents/workflows/

لنضِف بعض القواعد وسير العمل في مساحة العمل.

إضافة قاعدة

أولاً، لنضِف قاعدة نمط الرمز البرمجي. انتقِل إلى Rules وانقر على الزر +Workspace. امنحه اسمًا مثل code-style-guide مع قواعد نمط الرمز البرمجي التالية:

* Make sure all the code is styled with PEP 8 style guide
* Make sure all the code is properly commented

ثانيًا، لنضِف قاعدة أخرى للتأكّد من إنشاء الرمز بطريقة نموذجية مع أمثلة في قاعدة code-generation-guide:

* The main method in main.py is the entry point to showcase functionality.
* Do not generate code in the main method. Instead generate distinct functionality in a new file (eg. feature_x.py)
* Then, generate example code to show the new functionality in a new method in main.py (eg. example_feature_x) and simply call that method from the main method.

تم حفظ القاعدتين وأصبحتا جاهزتين:

إضافة سير عمل

لنحدّد أيضًا سير عمل لإنشاء اختبارات الوحدة. سيسمح لنا ذلك بتشغيل اختبارات الوحدات بعد أن نكون راضين عن الرمز (بدلاً من أن ينشئ الوكيل اختبارات الوحدات طوال الوقت).

انتقِل إلى Workflows وانقر على الزر +Workspace. امنحه اسمًا مثل generate-unit-tests مع ما يلي:

* Generate unit tests for each file and each method
* Make sure the unit tests are named similar to files but with test_ prefix

أصبح سير العمل جاهزًا أيضًا الآن:

للتجربة:

لنطّلِع الآن على القواعد وسير العمل في أرض الواقع. أنشئ ملف main.py هيكليًا في مساحة العمل:

def main():
    pass

if __name__ == "__main__":
    main()

الآن، انتقِل إلى نافذة المحادثة مع الوكيل واطرح السؤال التالي: Implement binary search and bubble sort.

بعد دقيقة أو دقيقتين، من المفترض أن تتلقّى ثلاثة ملفات في مساحة العمل: main.py وbubble_sort.py وbinary_search.py. ستلاحظ أيضًا أنّه تم تنفيذ جميع القواعد: الملف الرئيسي غير مزدحم ويتضمّن نموذج الرمز البرمجي، وتم تنفيذ كل ميزة في ملفها الخاص، وتم توثيق كل الرمز البرمجي وتنسيقه بشكل جيد:

from binary_search import binary_search, binary_search_recursive
from bubble_sort import bubble_sort, bubble_sort_descending


def example_binary_search():
    """
    Demonstrate binary search algorithm with various test cases.
    """
    ...

def example_bubble_sort():
    """
    Demonstrate bubble sort algorithm with various test cases.
    """
    ...

def main():
    """
    Main entry point to showcase functionality.
    """
    example_binary_search()
    example_bubble_sort()
    print("\n" + "=" * 60)


if __name__ == "__main__":
    main()

بعد أن أصبحنا راضين عن الرمز البرمجي، لنرَ ما إذا كان بإمكاننا بدء سير عمل إنشاء اختبار الوحدة.

انتقِل إلى المحادثة وابدأ بكتابة /generate، وسيتعرّف Antigravity على سير العمل:

انقر على generate-unit-tests وأدخِل الرمز. بعد بضع ثوانٍ، ستتلقّى ملفات جديدة في مساحة عملك: test_binary_search.py وtest_bubble_sort.py مع عدد من الاختبارات التي تم تنفيذها مسبقًا.

أحسنت.

9- المهارات

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

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

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

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

النطاق العام (~/.gemini/antigravity/skills/): متاح في جميع مشاريعك (مثل "تنسيق JSON" و"مراجعة عامة للرمز").
نطاق مساحة العمل (<workspace-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.

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

Code Review Skill

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

أولاً، أنشئ الدليل الذي سيحتوي على هذه المهارة العالمية.

mkdir -p ~/.gemini/antigravity/skills/code-review

أنشئ ملف SKILL.md في الدليل أعلاه يتضمّن المحتوى الموضّح أدناه:

---
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 أعلاه يحتوي على البيانات الوصفية (الاسم والوصف) في الأعلى ثم التعليمات. عند تحميل "الوكيل"، سيقرأ البيانات الوصفية للمهارات التي أعددتها فقط، ولن يتم تحميل تعليمات المهارة إلا عند الحاجة إليها.

للتجربة:

أنشئ ملفًا باسم demo_bad_code.py يتضمّن المحتوى الموضّح أدناه:

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()

اطرح سؤالاً على الوكيل: review the @demo_bad_code.py file. على الوكيل تحديد المهارة code-review، وتحميل التفاصيل، ثم تنفيذ الإجراء وفقًا للتعليمات الواردة في الملف code-review/SKILL.md.

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

مهارة "نموذج عنوان الرمز"

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

أولاً، أنشئ الدليل الذي سيحتوي على مهارة مساحة العمل هذه.

mkdir -p .agents/skills/license-header-adder/resources

أنشئ .agents/skills/license-header-adder/resources/HEADER.txt باستخدام نص الترخيص:

/*
 * Copyright (c) 2026 YOUR_COMPANY_NAME LLC.
 * All rights reserved.
 * This code is proprietary and confidential.
 */

أنشئ ملف .agents/skills/license-header-adder/SKILL.md يتضمّن المحتوى الموضّح أدناه:

---
name: license-header-adder
description: Adds the standard corporate license header to new source files.
---

# License Header Adder

This skill ensures that all new source files have the correct copyright header.

## Instructions
1. **Read the Template**: Read the content of `resources/HEADER.txt`.
2. **Apply to File**: When creating a new file, prepend this exact content.
3. **Adapt Syntax**: 
   - For C-style languages (Java, TS), keep the `/* */` block.
   - For Python/Shell, convert to `#` comments.

للتجربة:

اطرح على "الوكيل" السؤال التالي: Create a new Python script named data_processor.py that prints 'Hello World'.

سيقرأ الوكيل النموذج ويحوّل التعليقات بنمط C إلى نمط Python ويضيفها تلقائيًا إلى بداية ملفك الجديد.

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

10. الأمان والتحكّم

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

انتقِل إلى إعدادات Antigravity واطّلِع على الإعدادات ضمن الوكيل.

سياسة العناصر

الأولى هي "سياسة مراجعة الأعمال الفنية". تحدّد هذه السمة سلوك الوكيل عند طلب مراجعة العناصر.

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

ننصحك بضبط هذه السياسة على Asks for Review.

سياسة المحطة ووضع الحماية

السياسة التالية هي السياسة المتعلّقة بأوامر الوحدة الطرفية.

تتوفّر سياسة Terminal Command Auto Execution. يحدّد هذا الإعداد مستوى استقلالية الوكيل في ما يتعلّق بأوامر shell:

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

يجب اختيار Request Review في البداية والسماح للوكيل تدريجيًا بتنفيذ المزيد من أوامر الوحدة الطرفية لكل مساحة عمل.

هناك أيضًا قسم Enable Terminal Sandbox يجب تفعيله. عند تفعيل هذا الخيار، يتم تنفيذ أوامر الجهاز الطرفي مع تطبيق قيود وضع الحماية.

سياسة الوصول إلى الملفات

بشكلٍ تلقائي، يمكن للوكيل الوصول إلى الملفات في مساحة عملك فقط. هذا الإجراء فكرة جيدة ويحدّ من الملفات التي يمكن للوكيل الوصول إليها. إذا احتجت إلى المزيد، يمكنك استخدام زر التبديل Agent Non-Workspace File Access. عند تفعيل هذا الخيار، يمكن للوكيل عرض الملفات وتعديلها تلقائيًا خارج مساحة العمل الحالية.

أذونات الوكيل

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

السماح: تتم الموافقة على الإجراء تلقائيًا بدون طلب تأكيد.
الرفض: يتم حظر الإجراء على الفور.
الاستفسار: يتوقف الوكيل مؤقتًا ويطلب موافقتك قبل المتابعة.

يتّبع كل إدخال في قائمة "السماح" أو "الرفض" أو "السؤال" التنسيق التالي: action(target)

حيث action هو أحد أنواع الإجراءات المتوافقة وtarget هو نمط يصف ما يغطّيه الإذن.

الإجراء	تنسيق الاستهداف	المطابقة
`command`	`command(prefix) or command(*)`	يطابق الأوامر حسب البادئة. يطابق الأمر(git) `git add` و`git commi`t وما إلى ذلك.
`read_file`	`read_file(/path)`	يطابق الملف أو كل ما يندرج ضمن الدليل. يجب أن تكون المسارات حرفية ومطلقة. لا يمكن استخدام Globs (`*.go`) والتعبيرات العادية و`~`.
`write_file`	`write_file(/path)`	هو مطابق لـ `read_file`. يشمل ذلك أيضًا `read_file` للمسار نفسه.
`read_url`	`read_url(domain) or read_url(*)`	تتم مطابقة النطاق وجميع النطاقات الفرعية. لا يتطابق مع مسارات عناوين URL.
`mcp`	`mcp(server/tool), mcp(server/ ), or mcp()`	تتم المطابقة حسب اسم الخادم التام. `server/*` تغطي جميع الأدوات على هذا الخادم.

يمكنك الاطّلاع على مزيد من المعلومات في المستندات.

قائمة المستخدمين المسموح لهم بإجراء الاختبارات

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

انتقِل إلى Permissions ثم إلى قسم Always Allow وأضِف ما يلي: command(ls)

بعد ذلك، اطرح السؤال على الوكيل وراقِب سلوكه:

اطرح سؤالاً على الوكيل: List the files in this directory.
يتم تشغيل الوكيل ls تلقائيًا.
اطرح سؤالاً على الوكيل: Delete the <some file>.
سيحاول الوكيل تنفيذ rm <filepath>، ولكن ستفرض Antigravity مراجعة من المستخدم لأنّ rm غير مُدرَج في القائمة المسموح بها. من المفترض أن يطلب منك تطبيق Antigravity الإذن قبل تنفيذ الأمر.

قائمة الرفض الخاصة بالاختبارات

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

انتقِل إلى Permissions ثم إلى قسم Always Deny وأضِف ما يلي:

command(rm)

بعد ذلك، اطرح السؤال على الوكيل وراقِب سلوكه:

طرح سؤال على الوكيل: Create a main.py
ينشئ الوكيل الملف بدون أي مشاكل.
اطرح السؤال على الوكيل: Delete the main.py file.
تمنع ميزة "مكافحة الجاذبية" تنفيذ الحظر، وتطلب منك الموافقة يدويًا.

سياسة المتصفّح

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

يمكنك الاطّلاع على إعداداتك الحالية لهذا الخيار من خلال الانتقال إلى Antigravity — Settings ثم Browser. سيظهر لك القسم Browser URL Allowlist حيث يمكنك إضافة عناوين URL إضافية:

11. الخاتمة

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

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

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

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

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