Начало работы с Antigravity IDE

1. Введение

Antigravity — это платформа для разработки агентных приложений, созданная для того, чтобы помочь любому пользователю создавать приложения в эпоху, когда агенты играют первостепенную роль. Она состоит из четырех основных продуктов: Antigravity, Antigravity IDE, Antigravity CLI и Antigravity SDK.

В этом практическом занятии мы сосредоточимся исключительно на среде разработки Antigravity IDE для разработчиков.

Что вы узнаете

• Разберитесь в работе антигравитационной платформы.
• Установите Antigravity IDE.
• Изучите редактор Antigravity и панель агентов.
• Команды со слэшем.
• Настройки, серверы MCP и навыки.

Что вам понадобится

Для работы Antigravity IDE необходимо установить её локально на вашем компьютере (Mac, Windows и некоторые дистрибутивы Linux). Кроме того, вам потребуется следующее:

• Веб-браузер Chrome.
• Аккаунт Gmail (личный аккаунт Gmail).

Сообщение о проблемах

В процессе работы над лабораторной работой и с программой Antigravity вы можете столкнуться с проблемами.

По вопросам, связанным с выполнением заданий (опечатки, неверные инструкции), пожалуйста, сообщите об ошибке, используя кнопку Report a mistake в левом нижнем углу этого задания:

Сообщения об ошибках или пожелания по улучшению функций Antigravity следует отправлять непосредственно в Antigravity. Вы также можете оставить отзыв о продукте, перейдя в «Настройки», расположенные в левом нижнем углу страницы Antigravity, а затем выбрав опцию Provide Feedback .

2. Антигравитационная платформа

Прежде чем мы перейдем к рассмотрению Antigravity IDE, давайте сначала разберемся в платформе Antigravity.

Антигравитация состоит из 4 отдельных продуктов:

• Antigravity : флагманское автономное приложение и ваш командный центр для параллельного управления несколькими локальными агентами.
• Antigravity IDE : Полнофункциональная, управляемая агентами среда разработки для разработчиков.
• Antigravity CLI : Интерфейс командной строки для взаимодействия с агентами через терминал.
• Antigravity SDK : Инструменты для разработчиков, позволяющие программно интегрировать Antigravity в свои системы.

Хотя все продукты обеспечивают доступ к одним и тем же базовым антигравитационным агентам, уровень взаимодействия различен.

В Antigravity вы работаете на более высоком уровне с агентами. В диалогах с агентом вы объясняете, что хотите, чтобы он создал, и позволяете ему работать с кодом. Вы видите сгенерированный код, но не обязательно сами в него заглядываете.

В Antigravity IDE вы находитесь на более низком уровне программирования. Вы по-прежнему можете общаться с агентом через панель агента, но также получаете полный обзор кода и помощь от агента при генерации и редактировании кода.

В Antigravity CLI вы используете агенты из командной строки. Вы по-прежнему можете взаимодействовать с агентом, заставляя его генерировать и редактировать код, но всё происходит в терминале.

Выбор уровня — за вами. Как правило, разработку в Antigravity начинают на более высоком уровне, а по мере увеличения сложности переключаются на Antigravity IDE для кодирования или Antigravity CLI для задач, более удобных для работы в терминале.

3. Установка

Если у вас уже установлено приложение Antigravity, но Antigravity IDE еще не установлена, в правом верхнем углу вы увидите кнопку «Установить IDE»:

Вы можете либо нажать на эту кнопку, либо перейти непосредственно на страницу загрузки Antigravity IDE , чтобы скачать и установить Antigravity IDE для вашей операционной системы (macOS, Windows, Linux).

После завершения установки вы увидите приветственный экран:

Войдите в систему с помощью своей учетной записи Google и продолжите установку, выбрав тему оформления.

На каком-то этапе вас спросят, как вы хотите использовать агент Antigravity IDE. На этом экране вы можете настроить политику выполнения в терминале, политику проверки и политику выполнения JavaScript для агента. Пока выберите разработку, основанную на проверке .

На следующем экране вы сможете настроить расширения и инструмент командной строки agy-ide . Мы рекомендуем устанавливать только необходимые расширения.

В состав Antigravity IDE также входят плагины, готовые наборы навыков и MCP, помогающие агентам работать с продуктами Google для разработчиков. Выберите те, которые, по вашему мнению, могут быть полезны для вашей работы:

Теперь вы готовы использовать Antigravity IDE.

4. Антигравитационный IDE-интерфейс

При первом запуске Antigravity IDE вы должны увидеть основной интерфейс Antigravity IDE.

Для начала можно открыть локальную папку. Также рекомендуется открыть новый терминал через меню Terminal , а затем выбрав пункт New Terminal .

Теперь у вас готовы редактор, терминал и агент:

В редакторе вы получаете помощь ИИ от Antigravity по мере ввода кода. Панель агента — это место, где вы общаетесь с агентом, выбираете различные модели и обращаетесь к файлам и командам. Терминал по умолчанию не поддерживает помощь ИИ, но если вы установите Antigravity CLI, вы сможете запустить его с помощью команды agy и получить помощь ИИ и в терминале.

Настройки антигравитации

Стоит взглянуть на настройки антигравитации в правом верхнем углу. Там находятся основные настройки агента:

Расширенные настройки предоставляют доступ к дополнительным параметрам, таким как режим безопасности агента:

Это позволяет указать, насколько агент свободен в отношении команд терминала, доступа к файловой системе и так далее. Обязательно ознакомьтесь с ними и выберите настройки, которые вас устраивают для вашего проекта.

5. Редактор

Давайте изучим редактор. Создайте файл Python, hello.py , чтобы изучить возможности редактора.

Когда вы набираете код в файле hello.py в редакторе, включается интеллектуальная функция автозаполнения, которую вы можете подтвердить, нажав клавишу Tab .

Вам будет предложена вкладка для перехода по подсказкам, позволяющим переместить курсор в следующее логическое место в коде. Например, после того, как вы закончите набирать main(), редактор предложит вам перейти к методу main:

Также появляется вкладка для импорта предложений по добавлению недостающих зависимостей:

6. Панель агента

Справа находится боковая панель агента. Если она не видна, вы можете переключить её с помощью сочетания клавиш Cmd + L

Вы можете выбрать различные типы моделей, использовать символ @ для указания дополнительного контекста, например, файлов, каталогов, терминала, серверов MCP или / для команд (это будет рассмотрено на следующем шаге).

Самый простой способ взаимодействовать с агентом — начать задавать вопросы в ходе беседы, но существует множество других способов общения с агентом.

Если у вас установлен статический линтер (например, Pylint), вы увидите синтаксические ошибки в коде, если допустите ошибку. Наведите курсор на проблему в редакторе и выберите Explain and fix . Это откроет панель агента, где вы сможете получить объяснение и возможное решение от агента.

Вы также можете перейти на вкладку Problems в IDE и выбрать Send to Agent , чтобы агент попытался исправить эти проблемы:

Вы также можете выделить часть вывода терминала с помощью команды Cmd + L и отправить её в диалог с агентом.

Во время общения с оператором в верхней части окна ввода вы увидите несколько значков:

Это разделы «Обзор изменений» (для просмотра изменений в коде), «Терминал» (фоновые процессы), «Артефакты» и «Браузер».

7. Артефакты

В основе Antigravity лежит способность без труда собирать ваши отзывы на каждом этапе разработки. В процессе работы над задачей агент создает различные артефакты:

• Перед началом кодирования: план реализации и список задач.
• В процессе генерации кода: сравнение кода.
• После написания кода: пошаговое объяснение того, что было сделано, и проверка результатов.

Эти артефакты позволяют «Антигравитации» сообщать о своих планах и ходе работ. Что еще важнее, они также дают вам возможность оставлять отзывы агенту в комментариях в стиле Google Docs. Это очень полезно для эффективного управления агентом в нужном вам направлении.

Давайте попробуем создать простое приложение и посмотрим, как мы сможем предоставлять обратную связь Antigravity в процессе его разработки.

В панели управления агента попробуйте выполнить следующую команду:

Build a TODO list application with Python Flask, SQlite DB, and a CRUD frontend. Keep the application simple

Это даст агенту толчок к началу планирования и составлению плана реализации.

План реализации

План реализации представляет собой общий обзор того, что Antigravity намеревается сделать, какой технологический стек будет использоваться, а также общее описание предлагаемых изменений.

Через несколько секунд в диалоге должен появиться план реализации:

Если вас всё устраивает, можете нажать кнопку Proceed . Если хотите оставить отзыв, можете открыть план реализации и добавить комментарии в стиле документа Google Docs перед отправкой.

Список задач

После обновления плана внедрения компания Antigravity создает список задач. Это конкретный перечень шагов, которые Antigravity будет выполнять для создания и проверки приложения. Это способ сообщить о ходе работы:

Несколько советов при работе с отзывами:

1. При добавлении комментария к чертежам обязательно отправьте его. Именно это запускает процесс обновления чертежей в Antigravity.
2. Иногда Antigravity переходит непосредственно к кодированию после создания плана реализации, не дожидаясь вашего подтверждения. В таких случаях вы все еще можете оставить комментарии к плану и отправить его снова. Это обновит код и пошаговое руководство. Вы также можете остановить процесс кодирования, добавить комментарии к плану и попробовать снова.

Изменения в коде

На этом этапе Antigravity сгенерирует некоторый код в новых файлах. Вы можете Accept all или Reject all эти изменения в боковой панели чата агента, не вдаваясь в подробности. Вы также можете нажать Review changes , чтобы увидеть подробности изменений и добавить подробные комментарии в код.

Пошаговое руководство

После завершения кодирования Antigravity запускает сервер, который может открыть браузер для проверки приложения. Он также проводит ручное тестирование, например, добавление и обновление задач и т.д. В конце создаётся файл с пошаговым описанием процесса проверки приложения. Это может включать скриншот или запись процесса проверки в браузере.

Вы также можете оставлять комментарии к скриншоту или записи браузера в пошаговом руководстве. Например, можно добавить комментарий Change the blue theme to orange theme и отправить его. После отправки комментария Antigravity внесет изменения, проверит результаты и обновит пошаговое руководство.

Отменить изменения

И наконец, после каждого шага, если вас не устраивает изменение, у вас есть возможность отменить его в чате. Просто выберите кнопку ↩️ Undo changes up to this point в чате.

8. Команды с косой чертой

В Antigravity IDE есть встроенные команды со слэшем / . На боковой панели агента, если вы введете / , вы увидите список команд:

/goal указывает агенту выполнять задачу до ее завершения, /schedule позволяет планировать задачи как повторяющиеся или разовые. /grill-me полезен для согласования плана с агентом, а /learn — для извлечения многократно используемых навыков или правил из диалогов.

Поэкспериментируйте с этими командами, чтобы увидеть, насколько они могут быть вам полезны.

9. Индивидуальные настройки

Antigravity IDE предлагает несколько вариантов настройки: Правила и Рабочие процессы .

Нажмите на значок ... в правом верхнем углу и выберите Customizations . Вы увидите Rules и Workflows :

Правила помогают направлять поведение агента. Это рекомендации, которые вы можете предоставить, чтобы убедиться, что агент следует им при генерации кода и тестов. Например, вы можете захотеть, чтобы агент придерживался определенного стиля кодирования или всегда документировал методы. Вы можете добавить их в качестве правил, и агент будет их учитывать.

Рабочие процессы — это сохраненные подсказки, которые можно запускать по запросу с помощью / , во время взаимодействия с агентом. Они также определяют поведение агента, но запускаются пользователем по запросу.

Хорошая аналогия: правила больше похожи на системные инструкции, а рабочие процессы — на сохраненные подсказки, которые можно выбрать по запросу.

Правила и рабочие процессы могут применяться глобально или для каждой рабочей области и сохраняться в следующих местах:

• Глобальное правило: ~/.gemini/GEMINI.md
• Глобальный рабочий процесс: ~/.gemini/config/global_workflows/<YOUR_WORKFLOW_NAME>.md
• Правила рабочего пространства: your-workspace/.agents/rules/
• Рабочие процессы в рабочей области: your-workspace/.agents/workflows/

Давайте добавим несколько правил и рабочих процессов в рабочее пространство.

Добавить правило

Для начала добавим правило стиля кода. Перейдите в Rules и выберите кнопку +Workspace . Дайте ему имя, например, code-style-guide и добавьте следующие правила стиля кода:

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

Во-вторых, давайте добавим еще одно правило, чтобы убедиться, что код генерируется модульным способом с примерами в правиле code-generation-guide :

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

Оба правила сохранены и готовы к использованию.

Добавить рабочий процесс

Давайте также определим рабочий процесс для генерации модульных тестов. Это позволит нам запускать модульные тесты только тогда, когда мы будем удовлетворены кодом (вместо того, чтобы агент постоянно генерировал модульные тесты).

Перейдите в Workflows и выберите кнопку +Workspace . Присвойте ей имя, например, generate-unit-tests со следующим содержимым:

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

Рабочий процесс также готов к запуску.

Попробуйте!

Теперь давайте посмотрим, как работают правила и рабочие процессы. Создайте шаблон файла main.py в вашей рабочей области:

def main():
    pass

if __name__ == "__main__":
    main()

Теперь перейдите на боковую панель агента и попросите его выполнить следующие действия: Implement binary search and bubble sort.

Через минуту-две в рабочей области должны появиться три файла: main.py , bubble_sort.py и binary_search.py . Вы также заметите, что все правила реализованы: основной файл не перегружен и содержит примеры кода, каждая функция реализована в отдельном файле, весь код документирован и написан в хорошем стиле.

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


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

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

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


if __name__ == "__main__":
    main()

Теперь, когда нас устраивает код, давайте посмотрим, сможем ли мы запустить процесс генерации модульных тестов.

Зайдите в чат и начните вводить /generate , и Antigravity уже будет знать о нашем рабочем процессе:

Выберите generate-unit-tests и нажмите Enter. Через несколько секунд в вашей рабочей области появятся новые файлы: test_binary_search.py ​​и test_bubble_sort.py с уже реализованным рядом тестов!

10. Серверы MCP

Протокол контекста модели (MCP) стал стандартом, помогающим подключать агентов к внешним системам. Он играет ключевую роль в обеспечении того, чтобы агент оставался в курсе ваших данных и интеграции.

Antigravity IDE поддерживает серверы MCP, как локальные, так и удаленные. В комплект также входит интеграция с несколькими серверами MCP, работающими с сервисами Google Cloud, установка которых осуществляется простым щелчком мыши с минимальными настройками.

Нажмите на значок ... в правом верхнем углу и выберите MCP Servers . Откроется диалоговое окно со списком серверов MCP:

Например, вы можете нажать на Cloud Run , чтобы установить его MCP-сервер.

Если вы нажмете на кнопку Manage MCP Servers в правом верхнем углу, вы также сможете увидеть исходную конфигурацию серверов MCP в файле ~/.gemini/config/mcp_config.json . Вы также можете добавить в этот файл другие пользовательские серверы MCP и нажать кнопку обновления, чтобы увидеть их распознавание в Antigravity IDE.

Чтобы использовать настроенные MCP-серверы, вы можете запросить у Antigravity выполнение действия, требующего наличия MCP-сервера. Например, вы можете включить сервер cloudrun-mcp и запросить у Antigravity следующее: Build and deploy a Cloud Run service . Это должно побудить Antigravity найти и использовать сервер cloudrun-mcp для настройки и развертывания службы Cloud Run.

11. Навыки

Хотя базовые модели Antigravity являются мощными универсальными инструментами, они не учитывают специфический контекст вашего проекта или стандарты вашей команды. Загрузка каждого правила или инструмента в контекстное окно агента приводит к избыточности инструментов, увеличению затрат, задержкам и путанице.

Навыки решают эту проблему за счет постепенного раскрытия информации. Навык — это специализированный набор знаний, который находится в неактивном состоянии до тех пор, пока не понадобится. Он загружается в контекст агента только тогда, когда ваш конкретный запрос соответствует описанию навыка.

Структура и сфера применения

Навыки представляют собой пакеты, расположенные в каталогах. В зависимости от ваших потребностей вы можете определить их в двух областях видимости:

• Глобальная область действия ( ~/.gemini/config/skills/ ): Доступно для всех продуктов Antigravity (Antigravity, Antigravity IDE, Antigravity CLI) и проектов.
• Область действия проекта/рабочей области ( <project-root>/.agents/skills/ ): Это сделает навык доступным только в рамках конкретного проекта.

Типичный каталог навыков выглядит следующим образом:

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

Давайте добавим навык.

Навык проверки кода

Это навык, содержащий только инструкции, то есть нам нужно только создать файл SKILL.md , который будет содержать метаданные и инструкции к навыку. Давайте создадим навык, который будет предоставлять агенту подробную информацию для проверки изменений кода на наличие ошибок, проблем со стилем и передовых методов.

Создайте в папке проекта каталог, который будет содержать навык:

mkdir -p .agents/skills/code-review

Создайте файл SKILL.md в папке проекта, например, .agents/skills/code-review , со следующим содержимым:

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

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

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

## How to provide feedback

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

Обратите внимание, что файл SKILL.md указанный выше, содержит метаданные (имя и описание) вверху, а затем инструкции. При загрузке агент будет считывать только метаданные навыков и загружать полные инструкции к навыкам только при необходимости.

Давайте проверим навык. Начните новый разговор с Antigravity и спросите, какие навыки установлены. Вы должны увидеть навык проверки кода :

Попробуйте!

Создайте новый файл с именем demo_bad_code.py в папке со следующим содержимым:

import time

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

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

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

if __name__ == "__main__":
   run_batch()

Откройте новую беседу в конкретном проекте в Antigravity и введите следующее сообщение: review the @demo_bad_code.py file .

Агент должен определить навык code-review , загрузить его подробные сведения, а затем выполнить действие в соответствии с инструкциями, указанными в файле code-review/SKILL.md .

Пример выходных данных показан ниже:

12. Заключение

Поздравляем! Вы успешно установили, настроили и изучили основные функции Antigravity IDE!

Чтобы узнать больше о платформе Antigravity, ознакомьтесь со следующими практическими заданиями и справочной документацией.

Другие семинары по кодированию

• Начало работы с Google Antigravity
• Строительство с использованием Google Antigravity
• Практическое знакомство с интерфейсом командной строки Antigravity.
• Создание и развертывание приложений в облаке Google с помощью Antigravity.

Справочная документация

• Официальный сайт: https://antigravity.google/
• Документация: https://antigravity.google/docs/home
• Примеры использования: https://antigravity.google/use-cases
• Скачать: https://antigravity.google/download
• YouTube-канал Google Antigravity: https://www.youtube.com/@googleantigravity