1. Введение
В этом практическом занятии вы познакомитесь с Antigravity CLI, облегченным интерфейсом пользовательского терминала (TUI) Antigravity. Он предоставляет те же основные возможности агентного управления, что и Antigravity 2.0 (такие как многошаговое рассуждение, редактирование нескольких файлов, вызов инструментов и история диалогов), непосредственно на вашем терминале.
Что вы узнаете
- Установка и настройка Antigrabity CLI
- Понимание основных принципов использования интерфейса командной строки Antigravity.
- Рассмотрим несколько вариантов использования Antigravity CLI.
Что вам понадобится
Вам потребуется следующее:
- Веб-браузер Chrome
- Аккаунт Gmail
Этот практический курс предназначен для пользователей и разработчиков всех уровней (включая начинающих). Примеры использования в курсе разделены на задачи для разработчиков и задачи для неразработчиков. Примеры для разработчиков демонстрируют, как работать с Antigravity CLI и репозиторием GitHub для выполнения распространенных задач разработки, таких как объяснение/понимание кода, создание документации, исправление ошибок и многое другое. Рекомендуется выполнить эти примеры в курсе. В конце есть дополнительный раздел, посвященный нескольким повседневным задачам, не ориентированным на разработчиков.
2. Прежде чем начать
Создать проект
- В консоли Google Cloud на странице выбора проекта выберите или создайте проект Google 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 ) в вашей системе и в Path.
В некоторых случаях, если установщик не может добавить исполняемый файл ( 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.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. Мы подробнее рассмотрим это позже в этой серии, а пока можете смело сказать: «Да, я доверяю этой папке» .
Поздравляем! Теперь все готово, и Antigravity CLI ждет вашего запроса.
4. Наше первое взаимодействие с интерфейсом командной строки Antigravity.
Давайте начнём работу с 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 в интерактивном терминале Antigravity CLI.
5. Интерфейс командной строки Antigravity — несколько команд для управления процессом.
Убедитесь, что Antigravity CLI запущен и ожидает вашей команды.
Обратите внимание на используемую модель, название которой будет отображаться в правом нижнем углу. Прежде всего, желательно понимать, что большинство необходимых настроек и параметров доступны через команды /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 в Antigravity CLI для работы с этим файлом.
Разрешение на использование инструмента
Важная настройка, которую необходимо понимать, — это права доступа к инструментам. Она определяет, требуется ли ваше разрешение для выполнения команд терминала. Доступ к ней можно получить с помощью команды /config .
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
По умолчанию установлено значение request-review . Давайте разберемся в этом подробнее. В Antigravity настройки разрешений инструментов контролируют баланс между безопасностью (защита вашей хост-системы от непреднамеренных изменений) и скоростью (насколько автономно агент может работать, не прерывая выполнение запроса). Давайте рассмотрим доступные параметры:
Запрос на проверку (текущее значение по умолчанию)
В этом режиме агент рассматривается как партнер по сотрудничеству, который проверяет свою работоспособность перед выполнением любых действий, которые могут повлиять на вашу систему или файлы проекта за пределами предварительно согласованных границ. Всякий раз, когда агент пытается выполнить команду терминала, выполнить операцию с файлами (например, запись/удаление) или обратиться к внешней службе без предварительного согласования разрешения, выполнение приостанавливается. Пользователю предлагается подтвердить или отклонить конкретное действие.
продолжить в песочнице
Этот режим позволяет агенту автоматически выполнять команды терминала, но в защищенном, изолированном контейнере. Агент может выполнять команды без вашего запроса, но эти команды выполняются в виртуализированной песочнице (например, в легковесном контейнере). Он не может изменять файловую систему вашей хост-машины или получать доступ к вашей локальной сети.
всегда продолжать
Это полностью автономный режим, обеспечивающий агенту максимальную скорость и возможности. Агенту предоставляются полные права на выполнение команд и запись файлов непосредственно на вашем хост-компьютере. Он никогда не будет запрашивать у вас подтверждение.
строгий
Это режим нулевого доверия с высоким уровнем безопасности. Возможности агента ограничены выполнением инструментов чтения. Для всех инструментов, не связанных с чтением, потребуется запрос подтверждения действий от пользователя.
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 — режим оболочки
Сейчас самое время научиться работать непосредственно с оболочкой из командной строки Antigravity. Вы можете перейти в режим оболочки, нажав восклицательный знак ! в окне сообщения. Это переключит вас в режим оболочки. Вернуться в этот режим можно, снова нажав восклицательный знак ! или клавишу ESC .
В режиме командной оболочки вы увидите восклицательный знак ! в начале приглашения командной строки, как показано ниже:
Вы можете проверить это напрямую, используя стандартные команды, такие как pwd и ls как показано ниже. Обратите внимание, что команды предполагают операционную систему типа Linux. Если вы используете другую операционную систему (Windows), используйте эквивалентные команды, такие как ( cd , dir и type ).
8. Варианты использования для тестирования
Интерфейс командной строки Antigravity CLI может применяться в самых разных областях, актуальных как для разработчиков, так и для тех, кто не занимается разработкой. Здесь представлены несколько сценариев, и в зависимости от ваших интересов вы можете попробовать любой из них или все сразу.
В каждом из этих случаев предоставляется соответствующая подсказка. Вы можете попробовать это в интерактивном режиме Antigravity CLI, чтобы лучше понять, как Antigravity CLI выполняет свою задачу.
Программирование Vibe с помощью Antigravity CLI
Давайте воспользуемся Antigravity CLI для создания приложения с помощью Vibe Code. В этом задании вы попросите Antigravity CLI сгенерировать приложение, а затем загрузить его начальную версию в репозиторий GitHub.
Предварительное условие
Для выполнения заданий в этом разделе необходимо выполнить несколько предварительных условий:
- Гит
- Антигравитационный CLI
- среда Python 3
- Настройте
gh( инструмент командной строки GitHub ). - Знание основ 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 Release Notes. Пожалуйста, ознакомьтесь с планом, особенно с подходом к Twitter Composer и Preview Card, и сообщите мне, одобряете ли вы его или хотите внести какие-либо корректировки!»
Как видите, в правом нижнем углу также указано, что необходимо проверить 1 артефакт , и в данном случае это файл 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 Helper (gh), который должен быть доступен и настроен на вашем компьютере, а также инструменты GitHub MCP Server, работающие в фоновом режиме.
Предложите вариант ответа, аналогичный приведенному ниже:
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 будут использоваться несколько команд Git: init, add, commit.
- Затем будет настроен удалённый репозиторий Git и выполнена операция push.
Если всё пойдёт хорошо, у вас должен быть создан репозиторий GitHub. Вы можете перейти на страницу репозитория GitHub. Пример скриншота показан ниже:
Обратите внимание, что вы не создали файл README.md для этого проекта, и это хорошее упражнение для следующего раздела, где мы теперь будем работать с только что созданным вами репозиторием.
Использование Antigravity CLI для работы с репозиторием кода.
В данном сценарии вам предстоит использовать Antigravity CLI для работы с репозиторием кода. Вы будете выполнять ряд задач, в том числе:
- Понимание кодовой базы
- Создание документации
- Внедрение новой функции
Это должно заложить хорошую основу для дальнейшей работы с вашими репозиториями и использования Antigravity CLI в качестве помощника при выполнении этих задач, специфичных для разработчиков.
Предварительное условие
Для выполнения заданий в этом разделе вам потребуется следующее:
- Антигравитационный CLI
- Вы должны были завершить предыдущий раздел и иметь под рукой сгенерированный код, где мы создали средство чтения примечаний к выпуску BigQuery.
Давайте продолжим использовать Antigravity CLI из папки/каталога, который вы использовали для генерации приложения BigQuery Release Notes.
Попробуйте выполнить следующие задания, указанные ниже:
Понимание кодовой базы
- Мне хотелось бы подробно разобраться в этом проекте. Помогите мне понять основные функции, а затем разбейте его на серверную и клиентскую части. Приведите примерный сценарий и покажите, как работают запросы и ответы. Обратите внимание, что будет создан новый файл (артефакт), и вы сможете просмотреть все артефакты или отдельные артефакты с помощью команды **
/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 часто запрашивает разрешение перед выполнением команд, особенно тех, которые изменяют файловую систему (например, записывают, перемещают или удаляют файлы). Всегда внимательно проверяйте эти запросы, прежде чем предоставлять разрешение. Это ваша гарантия безопасности.
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 .
Несколько других вариантов организации (подсказки приведены рядом с каждым вариантом):
- Краткое изложение: Для каждого документа в папке «Документы» создайте в той же папке текстовый файл с именем «summary_ORIGINAL_FILENAME.txt», содержащий краткое изложение основных положений документа в трех предложениях.
- Классификация по типу: Отсканируйте все файлы PDF и DOCX в этой директории. Переместите все файлы, содержащие слово «invoice» в названии или содержимом, в папку «Financial/Invoices». Переместите файлы, содержащие слово «receipt», в папку «Financial/Receipts». Все остальные файлы .docx поместите в папку «Reports».
- Извлечение ключевой информации (и «тегирование»): Для каждого PDF-файла в папке «Финансы/Счета-фактуры» прочтите его содержимое. Если вы обнаружите дату, переименуйте файл, указав эту дату в формате ГГГГ-ММ-ДД, например, «invoice_2025-07-26_original_name.pdf».
Краткое изложение статей (в локальных файлах или в интернете)
Для каждого из описанных ниже сценариев вы можете изменить URL-адрес, интересующую вас тему и имена локальных файлов по своему усмотрению. Приведенные имена файлов являются примерами, вы можете заменить их именами файлов, которые есть в вашей системе.
Попробуйте выполнить любой из следующих сценариев (подсказки приведены рядом с каждым сценарием):
- Кратко изложите содержание веб-статьи (по одной ссылке): Перейдите по ссылке https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 и кратко изложите 3 главных вывода из этой новостной статьи.
- Кратко изложите содержание нескольких веб-статей (например, найденных в поиске): Найдите последние новостные статьи о "Antigravity 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.
- Запустите Antigraity 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 для генерации данных
Вы можете настроить 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, его возможности и применили их в нескольких сценариях использования.