1. מבוא
בשיעור Codelab הזה נסביר על Antigravity CLI, ממשק משתמש קל משקל לטרמינל (TUI) של Antigravity. הוא כולל את אותן יכולות ליבה של סוכן כמו Antigravity 2.0 (למשל, הסקת מסקנות מרובת שלבים, עריכה של כמה קבצים, שימוש בכלים והיסטוריית שיחות) ישירות בטרמינל.
מה תלמדו
- התקנה והגדרה של Antigrabity CLI
- הסבר על שימוש בסיסי ב-Antigravity CLI
- בדיקת כמה תרחישי שימוש באמצעות Antigravity CLI
מה תצטרכו
תצטרכו את הפרטים הבאים:
- דפדפן האינטרנט Chrome
- חשבון Gmail
שיעור ה-Codelab הזה מיועד למשתמשים ולמפתחים בכל הרמות (כולל מתחילים). תרחישי השימוש ב-codelab מחולקים לקטגוריות של משימות למפתחים ולמשימות שלא דורשות ידע בפיתוח. תרחישי השימוש למפתחים מדגימים איך להשתמש ב-Antigravity CLI כדי לכתוב קוד ואיך לעבוד עם מאגר GitHub כדי לבצע משימות פיתוח נפוצות כמו הסבר על קוד, יצירת תיעוד, תיקון בעיות ועוד. מומלץ להשלים את תרחישי השימוש האלה ב-Codelab. בסוף יש קטע אופציונלי שכולל כמה משימות יומיומיות שלא מיועדות למפתחים.
2. לפני שמתחילים
יצירת פרויקט
- ב-מסוף Google Cloud, בדף לבחירת הפרויקט, בוחרים או יוצרים פרויקט ב-Google Cloud.
- מוודאים שהחיוב מופעל בפרויקט ב-Cloud. כך בודקים אם החיוב מופעל בפרויקט
- תשתמשו ב-Cloud Shell, סביבת שורת פקודה שפועלת ב-Google Cloud ומגיעה עם bq שנטען מראש. לוחצים על 'הפעלת Cloud Shell' בחלק העליון של מסוף Google Cloud.
- אחרי שמתחברים ל-Cloud Shell, בודקים שכבר בוצע אימות ושהפרויקט מוגדר למזהה הפרויקט באמצעות הפקודה הבאה:
gcloud auth list
- מריצים את הפקודה הבאה ב-Cloud Shell כדי לוודא שפקודת gcloud מכירה את הפרויקט.
gcloud config list project
- אם הפרויקט לא מוגדר, משתמשים בפקודה הבאה כדי להגדיר אותו:
gcloud config set project <YOUR_PROJECT_ID>
3. התקנה
לפני שמגדירים ומריצים את Antigravity CLI, ניצור תיקייה שתשמש כתיקיית הבית לכל הפרויקטים שייווצרו בתוכה. זו נקודת התחלה לעבודה עם Antigravity CLI, אבל הוא יתייחס גם לתיקיות אחרות במערכת, שתגיעו אליהן בהמשך לפי הצורך.
יוצרים תיקיית לדוגמה (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 לנתיב), היא תציין זאת. לדוגמה, הנה פלט לדוגמה במחשב שבו תוכנת ההתקנה לא הצליחה להוסיף את הקובץ הבינארי לנתיב, והיא הציעה מה לעשות.
% 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 (הגרסה שמוצגת היא הגרסה שהייתה זמינה בזמן כתיבת ה-Codelab הזה):
$ agy --version
1.0.5
כשמפעילים את 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 CLI, כמו שמוצג בהמשך. בוחרים את האפשרות הרצויה.
- בשלב הבא, צריך לאשר כמה תנאים והגבלות. מאשרים את ההרשאות.
לבסוף, הדבר הכי חשוב הוא לתת הרשאה לתיקייה שאתם סומכים עליה, כמו שמוצג בהמשך:
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 CLI. בהמשך הסדרה נסביר על זה יותר, אבל בינתיים, לוחצים על Yes, I trust this folder (כן, אני בוטח בתיקייה הזו).
מעולה! הכול מוכן עכשיו, ו-Antigravity CLI מחכה להנחיה שלכם.
4. האינטראקציה הראשונה שלנו עם Antigravity CLI
נתחיל עם Antigravity CLI ונזין את השאילתה הראשונה כמו בדוגמה הבאה:
Give me a famous quote on Artificial Intelligence and who said that?
התגובה הצפויה מוצגת בהמשך:
● WebSearch(famous quotes on Artificial Intelligence) (ctrl+o to expand)
Here is one of the most famous quotes on Artificial Intelligence:
│ "AI is the new electricity."
│ — Andrew Ng (Co-founder of Coursera and Google Brain, Adjunct Professor at Stanford University)
Another widely cited perspective on the potential risks of AI is:
│ "The development of full artificial intelligence could spell the end of the human race. It would take off on its
│ own, and re-design itself at an ever-increasing rate."
│ — Stephen Hawking
אפשר לראות ש-Antigravity השתמש באחד מהכלים הפנימיים שלו, WebSearch, כדי לקבל את הציטוט.
אילו פקודות שונות נתמכות ב-Antigravity CLI, מלבד מתן הנחיות? כדי לראות את רשימת הפקודות ומקשי הקיצור, פשוט מקלידים /help (קו נטוי). כמה מהפקודות בזמן הכתיבה מוצגות בהמשך:
Antigravity CLI general commands shortcuts (←/→ or tab to cycle)
Available Commands
> /add-dir Add a directory to the workspace
/agents List available custom agents
/artifact View and review artifacts
/btw Ask a side question without interrupting the current task
/changelog Show release notes and changes
/clear (new) Clear conversation and start a new one
/config (settings) Open settings panel
/context Visualize current context usage
/copy Copy the last planner response to the clipboard (may require allowing clipboard ac...
/credits Show remaining G1 credits and purchase link
/diff View uncommitted changes and per-turn diffs
/exit (quit) Exit the CLI
/fast Agent will execute tasks directly. Use for simple tasks that can be completed faster
/feedback Submit qualitative feedback to improve the agent
/fork (branch) Create a branch of the current conversation at this point
/help Show available commands and keybindings
/hooks Manage hook configurations for tool events
/keybindings Set custom keybindings
/logout Log out
/mcp Manage MCP servers
/model Set a model
/open Open a file or view opened/edited files
/permissions Manage tool permissions
/planning Agent can plan before executing tasks. Use for deep research, complex tasks, or co...
<MORE_COMMANDS>
נצא מ-Antigravity CLI בינתיים. אפשר לעשות את זה באמצעות הפקודה /quit או להריץ את הפקודה ctrl+d פעמיים בסשן אינטראקטיבי של טרמינל Antgravity CLI.
5. Antigravity CLI – כמה פקודות לניהול
מוודאים שה-CLI של Antigravity הופעל והוא ממתין לפקודה שלכם.
שימו לב למודל שבו נעשה שימוש, שהשם שלו יוצג בפינה השמאלית התחתונה. הדבר הראשון שחשוב להבין הוא שרוב ההתאמות האישיות וההגדרות שצריך לבצע זמינות באמצעות הפקודה /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
לדוגמה, ערכת הצבעים מציגה את האפשרויות הבאות, שמהן אפשר לבחור את ערכת הצבעים המועדפת:
Color Scheme ╭─────────────────────────────────────────────────────────────╮
terminal │
light │
solarized light │
colorblind-friendly light │
> dark (current) │
solarized dark │
colorblind-friendly dark │
tokyo night
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 ב-CLI של Antigravity כדי לעבוד עם הקובץ הזה.
הרשאת כלי
הגדרה חשובה שכדאי להכיר היא Tool Permission (הרשאת כלי). ההגדרה הזו קובעת אם צריך אישור שלכם לפני הפעלת פקודות בטרמינל. אפשר להגיע לזה באמצעות הפקודה /config.
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
כברירת מחדל, הערך שמוגדר הוא request-review. בואו נבין את זה בצורה מפורטת יותר. ב-Antigravity, הגדרות הרשאות הכלים קובעות את האיזון בין אבטחה (הגנה על מערכת המארח מפני שינויים לא מכוונים) לבין מהירות (עד כמה הסוכן יכול לפעול באופן אוטונומי בלי להשהות את הפעולה כדי לקבל את הקלט שלכם). אלה האפשרויות:
request-review (ברירת המחדל הנוכחית)
במצב הזה, הסוכן נחשב לשותף שעוזר לכם, והוא יבקש אישור לפני שהוא מבצע פעולה כלשהי שיכולה להשפיע על המערכת או על קובצי הפרויקט מחוץ לגבולות שאושרו מראש. בכל פעם שהסוכן מנסה להריץ פקודה בטרמינל, לבצע פעולה בקובץ (כמו כתיבה או מחיקה) או לקרוא לשירות חיצוני שלא אושר מראש, הביצוע מושהה. המשתמש מתבקש לאשר או לדחות את הפעולה הספציפית.
proceed-in-sandbox
במצב הזה, הסוכן יכול להריץ פקודות בטרמינל באופן אוטומטי, אבל בתוך קונטיינר מאובטח ומבודד. ה-Agent יכול להריץ פקודות בלי לבקש אישור, אבל הפקודות האלה מבוצעות בארגז חול וירטואלי (למשל, קונטיינר קל משקל). הם לא יכולים לשנות את מערכת הקבצים של המחשב המארח בפועל או לגשת לרשת המקומית.
always-proceed
זהו מצב אוטונומי מלא, שמאפשר לסוכן לפעול במהירות המקסימלית ולקבל את היכולות המקסימליות. הסוכן מקבל הרשאה מלאה להריץ פקודות ולכתוב קבצים ישירות במחשב המארח שלכם. הוא אף פעם לא יבקש מכם אישור.
strict
זהו מצב של אפס אמון ואבטחה גבוהה. היכולות של הסוכן מוגבלות להפעלת כלי קריאה. כל הכלים שאינם כלי קריאה ידרשו מהמשתמש לבצע פעולה.
6. Antigravity CLI – פרמטרים של פקודות
יש כמה פרמטרים של שורת פקודה שאפשר לספק כשמפעילים את Antigravity CLI. כדי לקבל רשימה מלאה של אפשרויות, אפשר להשתמש ב---help כמו בדוגמה שלמטה.
agy --help
אמורות להופיע כל האפשרויות הזמינות. דוגמה לכרטיס מוצר:
$ agy --help
Usage of agy:
--add-dir Add a directory to the workspace (repeatable) (default [])
-c Short alias for --continue
--continue Continue the most recent conversation
--conversation Resume a previous conversation by ID
--dangerously-skip-permissions Auto-approve all tool permission requests without prompting
-i Short alias for --prompt-interactive
--log-file Override CLI log file path
--model Model for the current CLI session
-p Short alias for --print
--print Run a single prompt non-interactively and print the response
--print-timeout Timeout for print mode wait (default 5m0s)
--prompt Alias for --print
--prompt-interactive Run an initial prompt interactively and continue the session
--sandbox Run in a sandbox with terminal restrictions enabled
Available subcommands:
changelog Show changelog and release notes
help Show help for subcommands
install Configure environment paths and shell settings
models List available models
plugin Manage plugins (install, uninstall, list, enable, disable)
plugins Alias for plugin
update Update CLI
בואו נראה כמה מהם.
מצב לא אינטראקטיבי (אוטונומי)
אפשרות מעניינת היא להריץ את 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
Gemini 3.5 Flash (Medium)
Gemini 3.5 Flash (High)
Gemini 3.5 Flash (Low)
Gemini 3.1 Pro (Low)
Gemini 3.1 Pro (High)
Claude Sonnet 4.6 (Thinking)
Claude Opus 4.6 (Thinking)
אתם יכולים להשתמש בכל אחד משמות המודלים האלה כדי לציין את המודל שבו רוצים להשתמש בסשן. אפשר לעשות את זה באמצעות הפקודה --model שמוצגת למטה:
$ agy --model "Claude Opus 4.6 (Thinking)"
אחרי שמפעילים את Antigravity CLI, אפשר לבדוק את המודל הספציפי שביקשתם להשתמש בו באמצעות הפקודה /model, או להסתכל בפינה השמאלית התחתונה שבה מוצג המודל שבו נעשה שימוש בסשן.
חיים מסוכנים
אם אתם רוצים לחיות על הקצה, אתם יכולים לחפש פרמטר עם שם מתאים במיוחד שנקרא --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.
המצב הזה יכול להיות שימושי בתרחישים שבהם הדברים הם מקומיים ונמצאים בשליטה שלכם, אבל עדיין כדאי להיות מוכנים להפתעות ולהשתמש בו בזהירות.
7. Antigravity CLI – מצב Shell
זה הזמן ללמוד איך לעבוד ישירות עם ה-Shell מתוך Antigravity CLI. כדי לעבור למצב Shell, לוחצים על ! בתיבת ההודעה. הפעולה הזו תעביר אתכם למצב Shell. כדי לחזור, לוחצים שוב על ! או על המקש ESC.
במצב Shell, התו ! יופיע בתחילת ההנחיה, כמו בדוגמה הבאה:
אפשר לבדוק ישירות באמצעות פקודות רגילות כמו pwd ו-ls, כמו שמוצג בהמשך. שימו לב שהפקודות מניחות שמדובר במערכת הפעלה מסוג Linux. אם אתם משתמשים במערכת הפעלה אחרת (Windows), עליכם להשתמש בפקודות מקבילות כמו (cd, dir ו-type).
8. תרחישים לדוגמה
אפשר להשתמש ב-Antigravity CLI במגוון רחב של תרחישי שימוש שרלוונטיים למפתחים ולמשתמשים אחרים. כאן מוצגים כמה תרחישים, ואתם יכולים לנסות כל אחד מהם או את כולם, בהתאם לתחום העניין שלכם.
בכל אחד מהמקרים האלה, ההנחיה מסופקת. אתם יכולים לנסות את זה במצב האינטראקטיבי של Antigravity CLI כדי להבין טוב יותר איך Antigravity CLI מבצע את המשימה שלו.
תכנות בשיטת Vibe coding עם 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
הגיע הזמן להבין מהם ארטיפקטים ב-Antigravity. הארטיפקטים הם הדרך שבה ה-CLI של Antigravity מעדכן אותנו לגבי תוכנית ההטמעה, רשימת המשימות שהוא מבצע, פלט שניתן לאימות ועוד. הקבצים האלה נוצרים כתיעוד של העבודה ש-Antigravity מבצע, התוכנית שלו, רשימת המשימות ועוד.
אחרי שהוא עושה את זה, הוא אומר "יצרתי את implementation_plan.md כדי לתאר את העיצוב והארכיטקטורה של אפליקציית האינטרנט של הערות הגרסה של BigQuery. כדאי לעיין בתוכנית, במיוחד בגישה לכרטיס התצוגה המקדימה ולכלי ליצירת פוסטים בטוויטר, ולהודיע לי אם היא מקובלת עליך או אם יש שינויים שתרצה לבצע בה".
אפשר לראות שגם בפינה הימנית התחתונה מצוין שיש 1 ארטיפקט לבדיקה, ובמקרה הזה זהו implementation_plan.md.
נותנים את הפקודה /artifact. התוצאה תהיה הצגת הארטיפקט שנוצר implementation_plan.md, ואפשר להשתמש במקשי החצים כדי לפתוח, לאשר, לדחות וכו'. פשוט לוחצים על Escape וחוזרים להנחיה , ואז אפשר לאשר את הארטיפקט אם רוצים.
במקרה שלנו, נשתמש בתוכן שנוצר ונאשר אותו. הפעולה הזו תתחיל את השלב הבא, שבו יתחיל תהליך ההטמעה, כלומר יצירת קבצים, הפעלת כמה פקודות וכו'. תתבקשו לאשר ולתת הרשאה לביצוע הפעולה, לפי הצורך.
במקרה שלנו, נתנו לו אישור ליצור את הסביבה הווירטואלית של Python, להתקין את התלות באמצעות requirements.txt וכן הלאה.
ברקע, הוא גם יצר קובץ task.md כחלק מהמשימות שהוא צריך לבצע על סמך תוכנית ההטמעה, והוא מסמן את המשימות האישיות כשהוא משלים אותן. כשהוא יסיים, הוא יודיע לכם ותוכלו לבדוק את האפליקציה בדפדפן. הנה מה שהוא יצר בשבילנו:
אפשר להפסיק את השיחה עכשיו. המטרה הייתה להדגים ולבדוק מה אפשר לעשות עם דרישות פשוטות.
(אופציונלי) העברת שינויים למאגר ב-GitHub
אם לא רוצים להעלות את אתר האירוע שיצרנו ל-GitHub, אפשר להתעלם מהקטע הזה ולעבור לקטע הבא.
קודם כל, ניצור קובץ .gitignore בעזרת Antigravity CLI.
Create a .gitignore file for this project.
השלב הבא הוא לתת הוראות ל-Antigravity CLI כדי לדחוף את המאגר הזה לחשבון GitHub שלנו. לשם כך צריך להשתמש בכלי העזר של GitHub (gh), שאמור להיות זמין ומוגדר במחשב שלכם. הכלים של שרת ה-MCP של GitHub ברקע.
נותנים הנחיה שדומה להנחיה הבאה:
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 remote ותבצע push
אם הכול ילך כשורה, אמור להיות לכם מאגר ב-GitHub. אפשר להיכנס לדף המאגר ב-Github. למטה מוצגת דוגמה לצילום מסך:
שימו לב שלא יצרתם README.md לפרויקט הזה, וזה תרגיל טוב לקטע הבא, שבו נעבוד עם המאגר שיצרתם.
שימוש ב-Antigravity CLI לעבודה עם מאגר המקורות של הקוד
בתרחיש שימוש זה, תשתמשו ב-Antigravity CLI כדי לעבוד עם מאגר המקורות של הקוד. תבצעו כמה משימות, כולל:
- הסבר על ה-codebase
- יצירת מסמכים
- הטמעה של תכונה חדשה
ההסבר הזה אמור לספק לכם בסיס טוב לעבודה עם המאגרים שלכם ולשימוש ב-Antigravity CLI כעוזר לביצוע משימות ספציפיות למפתחים.
דרישה מוקדמת
כדי לבצע את המשימות בקטע הזה, תצטרכו:
- Antigravity CLI
- חשוב להשלים את השלב הקודם ולוודא שיש לכם את הקוד שנוצר, שבו יצרנו קורא של הערות על גרסאות של BigQuery.
נמשיך להשתמש ב-Antigravity CLI מהתיקייה שבה השתמשתם כדי ליצור את האפליקציה BigQuery Release Notes.
אפשר לנסות את ההנחיות הבאות:
הסבר על ה-codebase
- אני רוצה להבין את הפרויקט הזה בפירוט. אני רוצה להבין את התכונות העיקריות, ואז לקבל הסבר על הצד של השרת ועל הצד של הלקוח. קח דוגמה לתהליך עבודה ותראה לי איך הבקשה והתשובה פועלות. שימו לב שייווצר קובץ חדש (ארטיפקט), ותוכלו לראות את כל הארטיפקטים או ארטיפקטים ספציפיים באמצעות הפקודה **
/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 ליצור קודם כמה תיקיות: Images, Documents, Videos, ואז תבקשו מ-Antigravity CLI לארגן את הקבצים בתיקיות.
ממשק שורת הפקודה של Antigravity יבקש מכם הרשאה לפני הפעלת פקודות, במיוחד פקודות שמשנות את מערכת הקבצים (כמו כתיבה, העברה או מחיקה של קבצים). חשוב לבדוק את ההנחיות האלה בקפידה לפני שנותנים הרשאה. זהו אמצעי הבטיחות שלכם.
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 .
עוד כמה תרחישים לארגון (ההנחיות מופיעות לצד כל תרחיש):
- סיכום: לכל מסמך בתיקייה Documents, צריך ליצור קובץ txt באותה תיקייה בשם summary_ORIGINAL_FILENAME.txt, שמכיל סיכום של 3 משפטים של הנקודות העיקריות במסמך.
- סיווג לפי סוג: סריקה של כל קובצי ה-PDF וה-DOCX בספרייה הזו. העברת כל הקבצים שכוללים את המילה invoice בשם או בתוכן שלהם לתיקייה Financial/Invoices. מעבירים קבצים עם המילה 'קבלה' לתיקייה 'פיננסי/קבלות'. כל קובץ אחר בפורמט .docx עובר לתיקייה 'דוחות'.
- שליפת מידע חשוב (ו'תיוג'): לכל קובץ PDF בתיקייה Financial/Invoices, קרא את התוכן שלו. אם נמצא תאריך, שנה את שם הקובץ כך שיכלול את התאריך בפורמט YYYY-MM-DD, לדוגמה, invoice_2025-07-26_original_name.pdf.
סיכום מאמרים (קבצים מקומיים או באינטרנט)
בכל אחד מהתרחישים שבהמשך, אתם יכולים לשנות את כתובת ה-URL, את נושא העניין ואת שמות הקבצים המקומיים לפי הצורך. שמות הקבצים שמופיעים כאן הם שמות קבצים לדוגמה, ואתם יכולים להחליף אותם בשמות של קבצים שיש לכם במערכת.
אפשר לנסות את אחד מהתרחישים הבאים (ההנחיות מופיעות לצד כל תרחיש):
- לסכם מאמר באינטרנט (כתובת URL אחת): עבור אל https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 וסכם את 3 התובנות העיקריות מהמאמר הזה.
- לסכם כמה מאמרים באינטרנט (למשל מחיפוש): תמצא את מאמרי החדשות האחרונים בנושא 'ממשק שורת פקודה (CLI) נגד כוח המשיכה' באמצעות חיפוש Google. תסכם כל אחד מ-5 המאמרים הרלוונטיים ביותר ב-2-3 משפטים ותציין את כתובות ה-URL שלהם.
- לסכם קובץ טקסט מקומי: תסכם את הנקודות העיקריות במאמר בקובץ my_research_paper.txt. חשוב להתמקד במתודולוגיה ובמסקנות.
- סיכום של קובץ PDF מקומי: תקרא את הקובץ financial_report_Q2_2025.pdf. תספק סיכום של הביצועים הפיננסיים והאתגרים העיקריים שצוינו.
חילוץ מידע ספציפי (קבצים מקומיים או אינטרנט)
בכל אחד מהתרחישים שבהמשך, אתם יכולים לשנות את כתובת ה-URL, את נושא העניין ואת שמות הקבצים המקומיים לפי הצורך. שמות הקבצים שמופיעים כאן הם שמות קבצים לדוגמה, ואתם יכולים להחליף אותם בשמות של קבצים שיש לכם במערכת.
אפשר לנסות את אחד מהתרחישים הבאים (ההנחיות מופיעות לצד כל תרחיש):
- חילוץ ישויות ממאמר מקומי: מתוך הקובץ '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)
בכל אחד מהתרחישים שבהמשך, אתם יכולים לשנות את כתובת ה-URL, את נושא העניין ואת שמות הקבצים המקומיים לפי הצורך. שמות הקבצים שמופיעים כאן הם שמות קבצים לדוגמה, ואתם יכולים להחליף אותם בשמות של קבצים שיש לכם במערכת.
אפשר לנסות את אחד מהתרחישים הבאים (ההנחיות מופיעות לצד כל תרחיש):
- שאלות ותשובות לגבי מסמך מקומי: אני מצרף את הקובץ 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
Antigraity CLI תומך במספר מודלים באמצעות Gemini, ואפשר לבקש ממנו לעבד קבצים בפורמטים שונים של תוכן בהתאם לדרישות שלכם.
אתם עומדים לעבד הרבה תמונות של חשבוניות באמצעות Antigraity 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).
יצירת תגובות מדומה של API (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).
9. מזל טוב
סיימתם בהצלחה את ההיכרות עם Antigravity CLI, עם היכולות שלו ועם כמה תרחישי שימוש.