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

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

1. مقدمة

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

ما ستتعلمه

تثبيت Antigravity CLI وإعداده
فهم الاستخدام الأساسي لواجهة سطر الأوامر Antigravity CLI
استكشاف بعض حالات الاستخدام مع Antigravity CLI

المتطلبات

ستحتاج إلى ما يلي:

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

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

2. تثبيت

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

يمكنك إنشاء مجلد نموذجي (agy-cli-projects) والانتقال إليه باستخدام الأوامر الموضّحة أدناه. إذا كنت تفضّل استخدام اسم مجلد آخر، يمكنك إجراء ذلك.

mkdir agy-cli-projects

لننتقل إلى هذا المجلد:

cd agy-cli-projects

عملية التثبيت بسيطة، وتتوفّر الملفات الثنائية على جميع أنظمة التشغيل الرئيسية. وقد أخذتُ الأوامر التي يجب تنفيذها في الوحدة الطرفية مباشرةً من مستند التثبيت:

‫macOS | Linux

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

Windows PowerShell

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

من المفترض أن يؤدي ذلك إلى إعداد وتثبيت Antigravity CLI (agy) في نظامك وفي المسار.

في بعض الحالات، إذا لم يتمكّن برنامج التثبيت من إضافة الملف الثنائي ( agy إلى PATH)، سيتم إعلامك بذلك. على سبيل المثال، إليك نموذجًا لناتج على جهاز لم يتمكّن فيه برنامج التثبيت من إضافة الملف الثنائي إلى PATH واقترح ما يجب فعله.

% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
 echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.

ما عليك سوى الاطّلاع على إصدار Antigravity CLI من خلال الأمر التالي (الإصدار المعروض هو الإصدار المتوفّر في وقت كتابة هذا الدرس التطبيقي حول الترميز):

$ agy --version
1.0.7

عند تشغيل Antigravity CLI للمرة الأولى، سيُطلب منك تسجيل الدخول. شغِّل agy، ومن المفترض أن يظهر لك شيء مشابه لما يلي:

    ▄▀▀▄
   ▀▀▀▀▀▀
  ▀▀▀▀▀▀▀▀
 ▄▀▀    ▀▀▄
▄▀▀      ▀▀▄

Welcome to the Antigravity CLI. You are currently not signed in.

Select login method:
> 1. Google OAuth
  2. Use a Google Cloud project

[Use arrow keys to navigate, Enter to select]

استخدِم حسابك الشخصي في الوقت الحالي. اختَر 1. Google OAuth واضغط على Enter. سيؤدي ذلك إلى فتح متصفّح ويمكنك تسجيل الدخول باستخدام حسابك على Google. بعد إتمام عملية المصادقة والتفويض بنجاح، سيُطلب منك نسخ رمز. يُرجى الرجوع إلى نافذة Antigravity CLI ولصق الرمز.

بعد تسجيل الدخول بنجاح، تحدث بعض الإجراءات:

في البداية، سيُطلب منك اختيار نسق الألوان الذي تريده لواجهة سطر الأوامر Antigravity، كما هو موضّح أدناه. اختَر النسق الذي يعجبك.
بعد ذلك، عليك قبول بعض بنود الخدمة. اقبل هذه الطلبات.

أخيرًا، الأهم هو منح الإذن الذي تثق به للمجلد، كما هو موضّح أدناه:

Accessing workspace:

/Users/yourusername/agy-cli-projects

Do you trust the contents of this project?

Antigravity CLI requires permission to read, edit, and execute files here.

> Yes, I trust this folder
 No, exit

 ↑/↓ Navigate · enter Confirm

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

تهانينا! أنت الآن جاهز، وينتظرك Antigravity CLI لتلقّي طلبك.

3- تفاعلنا الأول مع Antigravity CLI

لنبدأ باستخدام Antigravity CLI ونكتب طلب البحث الأول كما هو موضّح أدناه:

Give me a famous quote on Artificial Intelligence and who said that?

نحصل على نموذج استجابة كما هو موضّح أدناه:

  Here is a famous quote on Artificial Intelligence:                                                                           
                                                                                                                               
  │ "Artificial intelligence is the new electricity."                                                                          
  │ — Andrew Ng

بالإضافة إلى تقديم الطلبات هنا، ما هي الأوامر المختلفة التي يتيحها Antigravity CLI؟ يمكنك العثور على ذلك من خلال كتابة /help (شرطة مائلة للأمام). ستظهر لك 3 علامات تبويب : عام والأوامر والاختصارات. ستنتقل تلقائيًا إلى علامة التبويب عام، ويمكنك استخدام مفتاح التبويب للانتقال إلى الأوامر، حيث ستظهر لك مجموعة متنوعة من الأوامر. يمكنك أيضًا الانتقال إلى اختصارات لوحة المفاتيح.

في ما يلي قائمة بالأوامر المتاحة في وقت كتابة هذا المقال:

ملاحظة: يمكنك الخروج من Antigravity CLI في أي وقت باستخدام الأمر /quit أو يمكنك تنفيذ الأمر ctrl+d مرّتين في جلسة طرفية تفاعلية لـ Antigravity CLI.

4. ‫Antigravity CLI - بعض أوامر الصيانة

تأكَّد من أنّ واجهة سطر الأوامر Antigravity تعمل وتنتظر أمرك. إذا حاولت تنفيذ الأمر /quit في نهاية القسم السابق، يُرجى تشغيل Antigravity CLI مرة أخرى باستخدام الأمر agy.

لاحظ النموذج الذي يتم استخدامه، وسيظهر اسمه في أسفل يسار الشاشة. أولاً، من المفترض أن تعرف أنّ معظم عمليات التخصيص والإعدادات التي عليك إجراؤها متاحة من خلال الأمر /config أو /settings.

الإعدادات

واصِل العملية واستخدِم الأمر /config. سيؤدي ذلك إلى عرض أقسام مختلفة من Antigravity يمكنك تخصيصها استنادًا إلى إعداداتك المفضّلة. ويشمل ذلك نظام الألوان وإذن الأداة وإعدادات قياس استخدام المنتج والمزيد.

Settings
  Search:  
          ────────────────────
> Animation Speed      medium
  Artifact Review      asks for review
  Color Scheme         dark
  Editor               auto ($EDITOR)
  Enable Telemetry     on
  Non-Workspace Access off
  Notifications        off
  Rendering Mode       native terminal (inline)
  Sandbox Mode         off
  Show Feedback Survey on
  Show Tips            on
  Tool Permission      request-review
  Use AI Credits       off
  Verbosity            high

على سبيل المثال، يعرض "نظام الألوان" الخيارات التالية التي يمكنني من خلالها اختيار نظام الألوان المفضّل لديّ:

settings.json

يجب تخزين إعدادات الضبط في مكان ما، أليس كذلك؟ يتم تخزينها كلها في ملف ~/.gemini/antigravity-cli/settings.json. في ما يلي عيّنة:

{
      "colorScheme": "dark",
      "model": "Gemini 3.5 Flash (High)",
      "statusLine": {
        "type": "",
        "command": "",
        "enabled": true
      },
      "trustedWorkspaces": [
        "/Users/romin/antigravity-cli-projects",
        "/Users/romin/agy-cli-projects"
      ]
    }

يمكنك ملاحظة colorScheme الذي اخترته، والنموذج، والمجلدات المختلفة التي بدأت منها Antigravity CLI ووافقت على الوثوق بها.

ملاحظة: يمكنك تعديل settings.json مباشرةً أيضًا وإعادة تشغيل Antigravity CLI كأفضل ممارسة للاطّلاع على التغييرات، ولكن تأكَّد من الإعدادات، وإلا سيظهر خطأ عند بدء التشغيل. إذا لم تكن مرتاحًا لتعديل الملف مباشرةً، يُنصح باستخدام الأمر /settings أو /config في Antigravity CLI للتعامل مع هذا الملف.

إذن الأداة

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

 Tool Permission
  > request-review (current)
    proceed-in-sandbox
    always-proceed
    strict

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

request-review (الإعداد التلقائي الحالي)

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

proceed-in-sandbox

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

always-proceed

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

strict

هذا وضع أمان عالٍ يعتمد على "نهج الثقة المعدومة". تقتصر إمكانات الوكيل على تنفيذ أدوات القراءة. ستتطلّب جميع الأدوات غير المخصّصة للقراءة أن يُطلب من المستخدم اتّخاذ إجراء.

5- Antigravity CLI - Command Parameters

يمكن تقديم بعض مَعلمات سطر الأوامر عند بدء تشغيل Antigravity CLI. للحصول على قائمة كاملة بالخيارات، يمكنك استخدام --help كما هو موضّح أدناه.

agy --help

من المفترض أن يعرض هذا الخيار النطاق الكامل للخيارات المتاحة. في ما يلي نموذج لبطاقة بيانات:

لنلقِ نظرة على بعضها.

وضع عدم التفاعل (الوضع الذاتي)

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

يمكنك استخدام المَعلمة -p لتقديم الطلب إلى Antigravity CLI كما هو موضّح أدناه:

agy -p "What is the gcloud command to deploy to Cloud Run"

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

اختيار نموذج محدّد

الطريقة الأولى هي أن تطلب من Antigravity CLI استخدام وضع Gemini معيّن. يمكنك استخدام المَعلمة --model لإخبار Antigravity CLI باستخدام نموذج معيّن خلال جلسته فقط. يكون ذلك مفيدًا جدًا للوضع غير التفاعلي الذي ذكرناه في القسم السابق، حيث تريد تشغيل عدّة جلسات agy واستخدام نماذج معيّنة لمهام معيّنة.

ولكن أولاً، عليك معرفة النماذج المتاحة في Antigravity CLI. يمكنك إجراء ذلك باستخدام الأمر الفرعي models كما هو موضّح أدناه:

agy models

سيؤدي ذلك إلى إدراج النماذج المتاحة لواجهة سطر الأوامر Antigravity. في ما يلي نموذج لقائمة:

‫Gemini 3.5 Flash (متوسط)
‫Gemini 3.5 Flash (عالي)
‫Gemini 3.5 Flash (منخفض)
‫Gemini 3.1 Pro (منخفض)
‫Gemini 3.1 Pro (عالي)
‫Claude Sonnet 4.6 (المفكِّر)
‫Claude Opus 4.6 (التفكير)
GPT-OSS 120B (متوسط)

يمكنك استخدام أيّ من أسماء النماذج هذه لتحديد النموذج الذي سيتم استخدامه في الجلسة. يمكنك إجراء ذلك باستخدام الأمر --model الموضّح أدناه:

agy --model "Gemini 3.5 Flash (Low)"

بعد تشغيل Antigravity CLI، يمكنك التحقّق من ذلك إما من خلال الأمر /model بشأن النموذج المحدّد الذي طلبت استخدامه أو من خلال النظر إلى أسفل يسار الشاشة حيث يظهر النموذج المستخدَم للجلسة.

Living dangerously

إذا كنت من محبّي المغامرة، يمكنك البحث عن مَعلمة تحمل اسمًا مناسبًا جدًا وهو --dangerously-skip-permissions. سيؤدي ذلك إلى الموافقة تلقائيًا على جميع أذونات الأدوات. لن تظهر لك رسالة تطلب منك منح الأذونات. لذا، يُرجى استخدامه بعناية.

شغِّل Antigravity CLI باستخدام الأمر التالي:

agy --dangerously-skip-permissions

بعد ذلك، وجِّه الطلب التالي. تأكَّد من أنّه لم يطلب مني أي أذونات كتابة في الملف.

> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.

● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)

▸ Thought for 2s, 95 tokens
 Processing News Information

● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)

 I have fetched the latest world news headlines and created the requested files in your workspace:                                                                  
                                                                                                                                                                    
 1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S. 
 security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.                                                           
 2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.

يمكن أن يكون هذا الوضع مفيدًا في الحالات التي تكون فيها الأمور محلية ويمكن التحكّم فيها، ولكن يجب الاستعداد للمفاجآت واستخدامه بحذر.

6. Antigravity CLI - Shell mode

هذا هو الوقت المناسب لتعلُّم كيفية العمل مباشرةً مع Shell من داخل واجهة سطر الأوامر في Antigravity. يمكنك الانتقال إلى وضع الصدفة من خلال الضغط على ! في مربّع الرسالة. سيؤدي ذلك إلى التبديل إلى وضع Shell. يمكنك الرجوع إلى الصفحة السابقة بالضغط على ! مرة أخرى أو على المفتاح ESC.

عندما تكون في وضع shell، سترى ! في بداية الطلب كما هو موضّح أدناه:

يمكنك التحقّق مباشرةً باستخدام الأوامر العادية، مثل pwd وls. يُرجى العِلم أنّ الأوامر تفترض استخدام نظام تشغيل من نوع Linux. إذا كنت تستخدم نظام تشغيل آخر (Windows)، يُرجى استخدام الأوامر المكافئة، مثل (cd وdir وtype).

7. حالات استخدام يمكنك تجربتها

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

في كلّ من هذه الحالات، يتم تقديم الطلب. يمكنك تجربة ذلك في وضع Antigravity CLI التفاعلي لفهم كيفية تنفيذ Antigravity CLI لمهمته بشكل أفضل.

البرمجة الحدسية باستخدام Antigravity CLI

لنستخدِم Antigravity CLI لإنشاء رمز تطبيق. في هذه المهمة، ستطلب من Antigravity CLI إنشاء تطبيق ثم إرسال الإصدار الأولي إلى مستودع GitHub.

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

لإجراء المهام في هذا القسم، يجب استيفاء بعض الشروط المسبقة:

Git
Antigravity CLI
بيئة Python 3
إعداد gh ( أداة GitHub CLI)
الإلمام بأساسيات Git ومعرفة بعض المعلومات عن البرمجة

سنفترض أنّك شغّلت Antigravity CLI في مجلد محدّد من اختيارك. في حالتنا، أطلقنا Antigravity CLI من مجلد الصفحة الرئيسية الأولي : agy-cli-projects ومجلد آخر bq-releases-notes بداخله.

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

Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me. 

A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details. 

I would also like the ability to take any specific update, select it and then Tweet about it.

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

I will start by exploring the workspace to see if there is an existing structure or if this is a brand new project.                                                                   

● ListDir(/Users/romin/agy-cli-projects/bq-release-notes) (ctrl+o to expand)

 I will read the BigQuery release notes XML feed to understand its structure (Atom/RSS elements, entry/item elements, namespaces, dates, titles, content) so that we can parse it      
 correctly in the Python Flask backend.                                                                                                                                                

● ReadURL(https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) (ctrl+o to expand)

 I will view the fetched feed content saved locally to understand its format and structure.                                                                                            

● Read(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/.system_generated/steps/6/content.md) (ctrl+o to expand)

▸ Thought for 2s, 2.3k tokens
 Analyzing XML Feed Structure
 I will write the implementation plan detailing the architecture, design aesthetic, components, and verification steps for the BigQuery Release Notes Web Application. This plan will be
 written to the artifacts directory.                                                                                                                                                   

● Create(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/implementation_plan.md) (ctrl+o to expand)

 I have created the implementation_plan.md to outline the design and architecture of the BigQuery Release Notes Web Application.
                                                                                                                                                                                       
 Please review the plan, especially the approach for the Twitter Composer & Preview Card, and let me know if you approve or if there are any adjustments you'd like to make!           

                                                                                                                                                           1 artifact · /artifact to review

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

بعد ذلك، سيقول: "لقد أنشأتُ implementation_plan.md لتحديد تصميم وبنية تطبيق الويب الخاص بملاحظات إصدار BigQuery. يُرجى مراجعة الخطة، خاصةً طريقة التعامل مع "أداة إنشاء التغريدات" و"بطاقة المعاينة" على Twitter، وإعلامي بموافقتك أو إذا كانت هناك أي تعديلات تريد إجراءها".

يمكنك ملاحظة أنّه يذكر أيضًا في أسفل يسار الشاشة أنّه يجب مراجعة قطعة أثرية واحدة، وهي في هذه الحالة implementation_plan.md.

وجِّه الطلب /artifact. سيؤدي ذلك إلى عرض العنصر الذي تم إنشاؤه implementation_plan.md ويمكنك استخدام مفاتيح الأسهم لفتحه والموافقة عليه ورفضه وما إلى ذلك. ما عليك سوى الضغط على Escape والعودة إلى الطلب، ويمكنك الموافقة عليه هنا إذا أردت.

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

في حالتنا، منحنا الموافقة على إنشاء بيئة Python الافتراضية وتثبيت التبعيات من خلال requirements.txt وما إلى ذلك.

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

يمكننا التوقف الآن. كان الهدف هو عرض إمكانات هذه الأداة والتحقّق منها باستخدام متطلبات بسيطة.

(اختياري) إرسال التغييرات إلى مستودع Github

إذا كنت لا تريد نشر الموقع الإلكتروني للفعالية الذي أنشأناه على Github، يمكنك تجاهل هذا القسم والانتقال إلى القسم التالي.

أولاً، لننشئ ملف .gitignore، ويمكنك الاستعانة بواجهة سطر الأوامر Antigravity.

Create a .gitignore file for this project.

الخطوة التالية هي تقديم تعليمات إلى واجهة سطر الأوامر Antigravity CLI لنقل هذا المستودع إلى حسابنا على GitHub، ويجب أن تستخدم هذه التعليمات أداة المساعدة Github (gh) التي من المفترض أن تكون متاحة وتم إعدادها على جهازك.

قدِّم طلبًا مشابهًا للطلب أدناه:

Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app

سيتم تنفيذ عدد من الأوامر هنا:

أنشئ المستودع.
سيتم استخدام أوامر Git متعددة : init وadd وcommit لإدارة مستودع Git المحلي.
سيتم بعد ذلك إعداد Git عن بُعد وتنفيذ عملية دفع

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

يُرجى العِلم أنّك لم تنشئ README.md لهذا المشروع، وهذا تمرين جيد للقسم التالي، حيث سنعمل الآن مع هذا المستودع الذي أنشأته للتو.

استخدام Antigravity CLI للعمل مع مستودع الرموز البرمجية

في حالة الاستخدام هذه، عليك استخدام Antigravity CLI للعمل مع مستودع الرموز البرمجية. ستنفّذ مهام متعددة تشمل ما يلي:

فهم قاعدة الرموز البرمجية
إنشاء مستندات
تنفيذ ميزة جديدة

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

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

لتنفيذ المهام الواردة في هذا القسم، عليك إجراء ما يلي:

Antigravity CLI
يجب أن تكون قد أكملت القسم السابق وأن يكون لديك الرمز الذي تم إنشاؤه في متناول يدك، حيث أنشأنا قارئًا لملاحظات إصدار BigQuery.

لنواصل استخدام Antigravity CLI من المجلد أو الدليل الذي استخدمته لإنشاء تطبيق "ملاحظات إصدار BigQuery".

جرِّب الطلبات التالية كما هو موضّح أدناه:

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

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

إنشاء ملف README

أنشئ ملف README لهذا المشروع.

تنفيذ ميزة جديدة

يُرجى تنفيذ ميزتَين بسيطتَين للأدوات المساعدة: زر "نسخ إلى الحافظة" على كل بطاقة وزر "تصدير إلى ملف CSV".
يُرجى إضافة مفتاح تبديل بسيط في العنوان يغيّر نظام ألوان الصفحة من الوضع الداكن إلى الوضع الفاتح من خلال إلغاء قيم متغيرات CSS الجذرية.

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

إنشاء مشاكل استنادًا إلى الميزات المقترَحة

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

جرِّب الطلب التالي:

أريد منك تقييم التطبيق من وجهة نظر تجربة المستخدم، أي سهولة الاستخدام والاستجابة والرسائل المفيدة وغير ذلك. يُرجى تقديم قائمة بالتحسينات.

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

(اختياري) المهام اليومية

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

يمكنك استكشاف أي من حالات الاستخدام التي تعجبك.

تنظيم الملفات/المجلدات

يمكنك استخدام Antigravity CLI لتنظيم الملفات حسب الأنواع في مجلدات مختلفة حسب الحاجة. انتقِل إلى مجلد على جهازك يحتوي على عدة ملفات بتنسيقات ‎ .txt و‎.png و‎.jpg و‎.pdf و‎.mp4 وغيرها. من المحتمل أن يكون هذا هو سطح المكتب أو مجلد "عمليات التنزيل".

انتقِل إلى هذا المجلد وابدأ Antigravity CLI. ستطلب من Antigravity CLI إنشاء بعض المجلدات أولاً: "الصور" و"المستندات" و"الفيديوهات"، ثم ستطلب من Antigravity CLI تنظيم الملفات في المجلدات.

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

Create the following folders "Images","Documents","Videos"

بعد ذلك، وجِّه الطلب التالي:

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

في ما يلي مثال على عملية تشغيل على جهازنا:

I have completed organizing your files into their respective folders. Here is a summary of the files moved:                                          
                                                                                                                                                       
  • Images: Moved 95 files ending in  .jpg  or  .jpeg  (no  .gif  files were present).                                                         
  • Documents: Moved 1 file ending in  .txt  ( 12March_Live_chat_transcript.txt ).                                                                
  • Videos: Moved 26 files ending in  .mp4 .

في ما يلي بعض سيناريوهات التنظيم الأخرى (يتم تقديم الطلبات بجانب كل سيناريو):

التلخيص: لكل مستند في مجلد "المستندات"، أنشئ ملف txt في المجلد نفسه باسم "summary_ORIGINAL_FILENAME.txt" يتضمّن ملخّصًا من 3 جمل للنقاط الرئيسية في المستند.
التصنيف حسب النوع: يتم فحص جميع ملفات PDF وDOCX في هذا الدليل. انقل جميع الملفات التي تتضمّن كلمة "فاتورة" في اسمها أو محتواها إلى المجلد "الشؤون المالية/الفواتير". نقل الملفات التي تتضمّن كلمة "إيصال" إلى مجلد "المستندات المالية/الإيصالات" يتم نقل أي ملفات docx .أخرى إلى مجلد "التقارير".
استخراج المعلومات الأساسية (و"وضع العلامات"): لكل ملف PDF في مجلد "المستندات المالية/الفواتير"، اقرأ محتواه. إذا عثرت على تاريخ، أعِد تسمية الملف لتضمين هذا التاريخ بالتنسيق YYYY-MM-DD، مثلاً، "invoice_2025-07-26_original_name.pdf".

تلخيص المقالات (الملفات المحلية أو الويب)

في كل سيناريو من السيناريوهات أدناه، يمكنك تغيير عنوان URL وموضوع الاهتمام وأسماء الملفات المحلية حسب الاقتضاء. أسماء الملفات المقدَّمة هي أسماء ملفات نموذجية، ويمكنك استبدالها بأسماء ملفات لديك على نظامك.

جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):

تلخيص مقالة على الويب (عنوان URL واحد): انتقِل إلى https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 ولخِّص أهم 3 نقاط رئيسية من هذه المقالة الإخبارية.
تلخيص مقالات ويب متعددة (مثل تلك التي تظهر في نتائج البحث): ابحث عن أحدث المقالات الإخبارية حول "Antigravity CLI" باستخدام "بحث Google". بالنسبة إلى أهم 5 مقالات ذات صلة، يجب تلخيص كل مقالة في جملتين أو ثلاث جمل وإدراج عناوين URL الخاصة بها.
تلخيص ملف نصي محلي: أريد تلخيص النقاط الرئيسية في المقالة في الملف my_research_paper.txt. ركِّز على المنهجية والاستنتاجات.
تلخيص ملف PDF محلي: اقرأ "التقرير_المالي_الربع_الثاني_2025.pdf". قدِّم ملخّصًا للأداء المالي والتحديات الرئيسية المذكورة.

استخراج معلومات محدّدة (الملفات المحلية أو الويب)

جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):

استخراج الكيانات من مقالة محلية: من الملف biography.txt، أدرِج جميع الأشخاص المذكورين والتواريخ المهمة المرتبطة بهم.
استخراج البيانات من جدول في ملف PDF: في الملف quarterly_sales.pdf، استخرِج البيانات من الجدول في الصفحة 3 الذي يعرض "مبيعات المنتجات حسب المنطقة" وقدِّمها بتنسيق جدول Markdown.
استخراج عناوين الأخبار ومصادرها من موقع إلكتروني للأخبار: انتقِل إلى "https://news.google.com/" (أو موقع إلكتروني مشابه للأخبار). استخراج العناوين الرئيسية من الصفحة الأولى ومصادر الأخبار المقابلة قدِّمها على شكل قائمة نقطية.
العثور على مواصفات المنتج من صفحة للتجارة الإلكترونية: انتقِل إلى "https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441" (مثال على كتاب). استخرِج عنوان الكتاب والمؤلف والتفاصيل الأخرى. يجب عرض ذلك بتنسيق JSON منظَّم.
استخراج المدة من فيديو بتنسيق معيّن (مثلاً "2h37m42s")

الإجابة عن الأسئلة استنادًا إلى المحتوى (سلوك مشابه لنموذج RAG)

جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):

سؤال وجواب حول مستند محلي: أرفقتُ الملف user_manual.pdf. ما هي خطوات تحديد مشاكل الاتصال بالشبكة وحلّها؟
سؤال وجواب على صفحة ويب: استنادًا إلى المحتوى من الرابط"https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health"، ما هي المخاطر الصحية الأساسية المرتبطة بتغيّر المناخ وفقًا لمنظمة الصحة العالمية؟
مقارنة المعلومات من مصادر متعددة: لديّ مقالتان إخباريتان: article1.txt وarticle2.txt، وكلتاهما تتناولان التغييرات الأخيرة في السياسة الاقتصادية. قارِن بين وجهات نظرهم حول التأثير المحتمَل في الأنشطة التجارية الصغيرة.

إنشاء المحتوى استنادًا إلى المعلومات المستخرَجة

في كل سيناريو من السيناريوهات أدناه، يمكنك تغيير عنوان URL وموضوع الاهتمام وأسماء الملفات المحلية حسب الاقتضاء.

جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):

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

تتيح Antigravity CLI استخدام نماذج متعددة من خلال Gemini، ويمكنك أن تطلب منها معالجة ملفات بتنسيقات محتوى مختلفة وفقًا لمتطلباتك.

ستعالج مجموعة من صور الفواتير باستخدام Antigravity CLI وتستخرج منها المعلومات الرئيسية. يُرجى اتّباع الخطوات التالية:

أنشئ مجلدًا على جهازك ونزِّل بعض الفواتير من المستودع التالي على GitHub.
تشغيل Antigravity CLI من هذا المجلد

قدِّم الطلب التالي لاستخراج المعلومات من الفواتير في شكل جدول.

The current folder contains a list of invoice files in Image format. Go through all the files in this folder and extract the following invoice information in the form of a table: Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount.

من المفترض أن تحصل على نتيجة بالشكل التالي:

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

list all files with .png extension in this folder. Extract the invoice information from it by reading them locally and display it in a table format containing the following column headers: : Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount. Add a column at the end of the table that shows a red cross emoji in case the due date is in the past.

يؤدي ذلك إلى ظهور الناتج التالي:

يمكنك تطبيق ذلك على أي من ملفاتك بتنسيقات أخرى غير النص.

استخدام Antigravity CLI لإنشاء البيانات

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

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

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

Generate a JSON array of 3 synthetic customer reviews for a new smartphone. Each review should have 'reviewId' (string, UUID-like), 'productId' (string, e.g., 'SMARTPHONE_X'), 'rating' (integer, 1-5), 'reviewText' (string, 20-50 words), and 'reviewDate' (string, YYYY-MM-DD format).

إنشاء ردود وهمية من واجهة برمجة التطبيقات (JSON)

Generate a JSON array representing 7 daily sales records for a mock API endpoint. Each record should include 'date' (YYYY-MM-DD, chronologically increasing), 'revenue' (float, between 5000.00 and 20000.00), 'unitsSold' (integer, between 100 and 500), and 'region' (string, either 'North', 'South', 'East', 'West').

إنشاء عبارات إدراج قاعدة بيانات نموذجية (SQL)

Generate 5 SQL INSERT statements for a table named 'users' with columns: 'id' (INTEGER, primary key), 'username' (VARCHAR(50), unique), 'email' (VARCHAR(100)), 'password_hash' (VARCHAR(255)), 'created_at' (DATETIME, current timestamp). Ensure the password_hash is a placeholder string like 'hashed_password_X'.

إنشاء بيانات CSV لتحميل البيانات/تحليلها

Generate 10 lines of CSV data, including a header row, for customer transactions. Columns should be: 'TransactionID' (unique string), 'CustomerID' (integer), 'ItemPurchased' (string, e.g., 'Laptop', 'Monitor', 'Keyboard'), 'Quantity' (integer, 1-3), 'UnitPrice' (float, between 100.00 and 1500.00), 'TransactionDate' (YYYY-MM-DD).

إنشاء ملف إعدادات (YAML)

Generate a sample YAML configuration for a 'user_service'. Include sections for 'database' with 'host', 'port', 'username', 'password', 'database_name'. Also include a 'api_keys' section with 'payment_gateway' and 'email_service' placeholders. Use realistic default values.

إنشاء بيانات اختبار للحالات الحدّية/التحقّق من الصحة

Generate a JSON array of 8 email addresses for testing purposes. Include a mix of: 2 valid standard emails, 2 with missing '@', 2 with invalid domains (e.g., '.com1'), and 2 with special characters in the local part that are usually invalid (e.g., spaces or multiple dots).

8. تهانينا

تهانينا، لقد استكشفتَ بنجاح Antigravity CLI وإمكاناتها وطبّقتها على بعض حالات الاستخدام.

الحصول على شارة "وكلاء الذكاء الاصطناعي في 5 أيام" على Kaggle

هل أكملت هذا المختبر كجزء من دورة تدريبية مكثّفة لمدة 5 أيام حول وكلاء الذكاء الاصطناعي: ترميز المشاعر باستخدام Google في Kaggle؟ احصل على شارة "وكلاء الذكاء الاصطناعي في 5 أيام".

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

1. مقدمة

المتطلبات

2. تثبيت

3- تفاعلنا الأول مع Antigravity CLI

4. ‫Antigravity CLI - بعض أوامر الصيانة

الإعدادات

settings.json

إذن الأداة

5- Antigravity CLI - Command Parameters

وضع عدم التفاعل (الوضع الذاتي)

اختيار نموذج محدّد

Living dangerously

6. Antigravity CLI - Shell mode

7. حالات استخدام يمكنك تجربتها

البرمجة الحدسية باستخدام Antigravity CLI

(اختياري) إرسال التغييرات إلى مستودع Github

استخدام Antigravity CLI للعمل مع مستودع الرموز البرمجية

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

إنشاء ملف README

تنفيذ ميزة جديدة

إنشاء مشاكل استنادًا إلى الميزات المقترَحة

(اختياري) المهام اليومية

تنظيم الملفات/المجلدات

تلخيص المقالات (الملفات المحلية أو الويب)

استخراج معلومات محدّدة (الملفات المحلية أو الويب)

الإجابة عن الأسئلة استنادًا إلى المحتوى (سلوك مشابه لنموذج RAG)

إنشاء المحتوى استنادًا إلى المعلومات المستخرَجة

دعم الوسائط المتعددة في Antigravity CLI

استخدام Antigravity CLI لإنشاء البيانات

8. تهانينا

الحصول على شارة "وكلاء الذكاء الاصطناعي في 5 أيام" على Kaggle

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