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

1. Введение

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

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

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

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

• Установка и настройка Antigravity.
• Изучение ключевых концепций антигравитации, таких как менеджер агентов, редактор, браузер и многое другое.
• Настройка Antigravity с учетом ваших собственных правил и рабочего процесса, а также требований безопасности.

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

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

Программа Antigravity должна быть установлена ​​локально на вашем компьютере. Продукт доступен для Mac, Windows и некоторых дистрибутивов Linux. Помимо вашего компьютера, вам потребуется следующее:

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

Этот практический семинар предназначен для пользователей и разработчиков всех уровней (включая начинающих).

Для получения кредитов Google Cloud: Чтобы использовать Antigravity с проектами Google Cloud, активируйте свои бесплатные кредиты Google Cloud, перейдя по этой ссылке . Вы можете следовать инструкциям здесь , чтобы активировать кредиты и создать новый проект.

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

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

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

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

Вы также можете перейти в редактор, используя ссылку Report Issue под значком своего профиля:

2. Установка

Если у вас ещё не установлена ​​Antigravity, давайте начнём с её установки. В настоящее время продукт доступен для предварительного просмотра, и вы можете начать работу с ним, используя свою личную учётную запись Gmail.

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

Пожалуйста, каждый раз нажимайте кнопку Next . Основные шаги подробно описаны ниже:

• Выберите процесс настройки: это откроет возможность импорта из существующих настроек VS Code или курсора. Мы начнем с чистого листа.
• Выберите тип темы оформления редактора : Мы выберем темную тему, но это полностью на ваше усмотрение.
• Как вы хотите использовать антигравитационный агент?

Давайте разберемся в этом подробнее. Помните, что настройки можно изменить в любое время через пользовательские настройки Antigravity ( Cmd + , ).

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

Политика исполнения на терминале

Речь идёт о предоставлении агенту возможности выполнять команды (приложения/инструменты) в вашем терминале:

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

Политика пересмотра

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

• Всегда продолжайте: агент никогда не просит оставить отзыв.
• Решение принимает агент: агент сам решает, когда запросить проверку.
• Запрос на проверку: Агент всегда запрашивает проверку.

Политика выполнения JavaScript

При включении этой функции агент может использовать инструменты браузера для открытия URL-адресов, чтения веб-страниц и взаимодействия с содержимым браузера. Эта политика определяет, как выполняется JavaScript в браузере.

• Всегда продолжать: Агент не будет останавливаться, чтобы запросить разрешение на выполнение JavaScript в браузере. Это обеспечивает Агенту максимальную автономию для выполнения сложных действий и проверок в браузере, но также создает максимальную уязвимость для уязвимостей безопасности.
• Проверка запроса: Агент всегда будет останавливаться, чтобы запросить разрешение на выполнение кода JavaScript в браузере.
• Отключено: Агент никогда не будет выполнять код JavaScript в браузере.

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

Вот 4 варианта:

• Защищенный режим : Защищенный режим обеспечивает расширенные средства защиты агента, позволяя ограничить его доступ к внешним ресурсам и конфиденциальным операциям. При включении защищенного режима применяется ряд мер безопасности для защиты вашей среды.
• Разработка, основанная на отзывах (рекомендуется) : Агент будет часто запрашивать отзывы.
• Разработка, управляемая агентом : агент никогда не будет запрашивать проверку.
• Пользовательская конфигурация

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

Далее следует страница «Настройка параметров редактора» , где вы можете выбрать свои предпочтения по следующим параметрам:

• Назначение клавиш: Настройте назначение клавиш.
• Расширения: Установите популярные языковые и другие рекомендуемые расширения.
• Командная строка: Установите инструмент командной строки, чтобы открыть Antigravity с помощью agy .

Теперь вы готовы войти в Google. Как упоминалось ранее, Antigravity доступен в режиме предварительного просмотра и бесплатен, если у вас есть личная учетная запись Gmail. Войдите сейчас, используя свою учетную запись. Это откроет браузер, позволяющий войти в систему. После успешной аутентификации вы увидите сообщение, похожее на приведенное ниже, и оно вернет вас в приложение Antigravity. Действуйте!

Наконец, Условия использования . Вы можете решить, хотите ли вы принять участие или нет, а затем нажать Next .

Это приведет вас к моменту истины, где вас будет ждать Антигравитация, готовая к сотрудничеству.

3. Менеджер агентов

Мы готовы начать!

Antigravity является ответвлением от открытого программного обеспечения Visual Studio Code (VS Code), но радикально меняет пользовательский интерфейс, отдавая приоритет управлению агентами, а не редактированию текста. Интерфейс разделен на два отдельных основных окна: Editor и Agent Manager . Такое разделение задач отражает различие между индивидуальным вкладом и управлением проектами.

Менеджер агентов: Центр управления полетами

При запуске Antigravity пользователь обычно видит не древовидную структуру файлов, а Менеджер агентов, как показано ниже:

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

В этом контексте разработчик выступает в роли архитектора. Он определяет основные цели, например:

• Проведите рефакторинг модуля аутентификации.
• Обновите дерево зависимостей
• Сгенерируйте набор тестов для API выставления счетов.

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

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

Если вы нажмете кнопку Next выше, у вас появится возможность открыть рабочее пространство.

Представьте себе рабочее пространство таким, каким вы его знали по VS Code, и всё готово. Итак, мы можем открыть локальную папку, нажав на кнопку, а затем выбрав папку для начала. В моём случае у меня была папка в домашней папке с названием my-agy-projects , и я выбрал её. Вы можете использовать совершенно другую папку. Обратите внимание, что вы можете полностью пропустить этот шаг, если хотите, и открыть рабочее пространство можно в любое время позже.

После выполнения этого шага вы окажетесь в окне «Менеджер агентов», которое показано ниже:

Вы заметите, что приложение сразу же настраивается на начало нового диалога в выбранной папке рабочей области ( my-agy-projects ). Вы можете использовать свои знания работы с другими приложениями ИИ (Cursor, Gemini CLI) и использовать @ и другие способы для добавления дополнительного контекста при вводе вопросов.

Обратите внимание на выпадающие списки Planning и « Model Selection . В выпадающем списке «Выбор модели» вы можете выбрать одну из доступных на данный момент моделей для использования вашим агентом. Список представлен ниже:

Аналогично, мы обнаруживаем, что агент будет находиться в режиме Planning по умолчанию. Но мы также можем выбрать Fast режим.

Давайте посмотрим, что об этом говорится в документации :

• Planning : Агент может планировать свою работу до начала выполнения задач. Используйте этот режим для глубоких исследований, сложных задач или совместной работы. В этом режиме Агент организует свою работу в группы задач, создает артефакты и предпринимает другие шаги для тщательного исследования, обдумывания и планирования своей работы с целью достижения оптимального качества. Здесь вы увидите гораздо больше результатов.
• Fast : Агент будет выполнять задачи напрямую. Используйте его для простых задач, которые можно выполнить быстрее, например, переименование переменных, запуск нескольких команд bash или другие небольшие локализованные задачи. Это полезно, когда скорость является важным фактором, а задача достаточно проста, чтобы не было опасений по поводу ухудшения качества.

Если вам знакомы понятия «бюджет мышления» и аналогичные термины в контексте агентов, представьте это как возможность контролировать мышление агента, тем самым напрямую влияя на бюджет мышления. Пока мы будем использовать настройки по умолчанию, но помните, что на момент запуска модель Gemini 3 Pro была доступна в рамках ограниченных квот для всех пользователей, поэтому ожидайте соответствующих сообщений о том, что вы исчерпали эти бесплатные квоты для использования Gemini 3.

Давайте теперь немного поговорим о окне «Менеджер агентов» и разберемся в некоторых моментах, чтобы стало понятно, как работают основные компоненты, как перемещаться в Antigravity и многое другое. Окно «Менеджер агентов» отображается ниже:

Пожалуйста, обратитесь к приведенной выше схеме с указанием цифр:

1. Inbox : Воспринимайте это как способ отслеживать все ваши разговоры в одном месте. Когда вы отправляете агентов на выполнение заданий, они появляются во входящих, и вы можете щелкнуть по входящим, чтобы получить список всех текущих разговоров. Нажатие на любой из разговоров приведет вас ко всем обмененным сообщениям, статусу задач, тому, что агент уже сделал, или даже к тому, ожидает ли он подтверждения с вашей стороны. Это отличный способ вернуться позже к предыдущей задаче, над которой вы работали. Очень удобная функция.
2. Start Conversation : Нажмите на эту кнопку, чтобы начать новый разговор. Это переведет вас непосредственно к полю ввода, где написано Ask anything .
3. Workspaces : Мы уже упоминали о рабочих пространствах и о том, что вы можете работать в любом рабочем пространстве по своему усмотрению. Вы можете добавлять новые рабочие пространства в любое время и выбирать любое рабочее пространство при начале разговора.
4. Playground : Это отличный способ начать разговор с агентом, а затем, при желании, преобразовать его в рабочее пространство, где вы будете иметь более строгий контроль над файлами и т.д. Представьте это как рабочую область для черновиков.
5. Editor View : Пока что мы находимся в режиме менеджера агентов. При желании вы можете в любой момент переключиться в режим редактора. В этом режиме отобразится папка рабочей области и все созданные файлы. Вы можете редактировать файлы непосредственно в редакторе или даже добавлять подсказки и команды прямо в редакторе, чтобы агент мог внести изменения в соответствии с вашими рекомендациями/инструкциями. Режим редактора мы подробно рассмотрим в следующем разделе.
6. Browser : Наконец, мы подошли к одному из очевидных отличий, которое делает Antigravity очень мощным инструментом, а именно к его тесной интеграции с браузером Chrome. Давайте перейдем к настройке браузера в следующем разделе.

4. Антигравитационный браузер

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

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

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

Выберите Playground и назначьте агенту следующую задачу go to antigravity.google , как показано ниже:

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

После этого откроется браузер и отобразится сообщение с предложением установить расширение, как показано ниже:

Продолжайте, и вы перейдете к расширению для Chrome, которое затем сможете установить.

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

Вернитесь в режим просмотра «Диспетчер агентов», и вы увидите следующее:

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

5. Артефакты

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

Артефакты решают проблему «пробела в доверии». Когда агент заявляет: «Я исправил ошибку», разработчику раньше приходилось читать код, чтобы это проверить. В Antigravity агент создает артефакт, чтобы это доказать.

Вот основные артефакты, созданные с помощью антигравитации:

• Task Lists : Перед написанием кода агент генерирует структурированный план. Обычно редактировать этот план не требуется, но вы можете просмотреть его и в некоторых случаях добавить комментарий для внесения изменений, если это необходимо.
• Implementation Plan : Он используется для планирования изменений в кодовой базе для выполнения задачи. Эти планы содержат технические подробности о необходимых изменениях и предназначены для ознакомления пользователем, если только в вашей политике проверки артефактов не установлен параметр «Всегда продолжать».
• Walkthrough : Оно создается после завершения агентом выполнения задачи и представляет собой краткое описание изменений и способов их тестирования.
• Code diffs : Хотя технически это не артефакт, Antigravity также создает сравнение кода, которое вы можете просмотреть и прокомментировать.
• Screenshots : Агент фиксирует состояние пользовательского интерфейса до и после изменения.
• Browser Recordings : Для динамических взаимодействий (например, «Нажмите кнопку входа, дождитесь появления индикатора загрузки, убедитесь, что загрузилась панель управления») агент записывает видео своей сессии. Разработчик может просмотреть это видео, чтобы убедиться в выполнении функциональных требований, не запуская приложение самостоятельно.

Артефакты создаются и отображаются как в окне «Менеджер агентов», так и в окне «Редактор».

В режиме редактора в правом нижнем углу можно нажать на Artifacts :

В окне «Менеджер агентов» в правом верхнем углу, рядом с кнопкой Review changes , вы увидите кнопку для переключения отображения артефактов, или, если она включена, вы увидите список сгенерированных артефактов:

Вы должны увидеть представление «Артефакты», как показано ниже. В нашем случае мы дали указание Агенту посетить страницу antigravity.google , и поэтому он сделал скриншот и записал видео:

Различия в коде можно увидеть в разделе Review Changes в редакторе:

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

6. Вернитесь к папке «Входящие».

Если вы уже начали несколько диалогов с агентами, теперь вам следует посмотреть свою Inbox в окне Agent Manager . Там отобразятся все диалоги. Щелкните любой из диалогов, чтобы просмотреть историю этого диалога, созданные артефакты и многое другое. В нашем случае, после запуска первого диалога, в папке «Входящие» отображается список диалогов, как показано ниже:

Нажав на ссылку, вы получите подробную информацию:

Вы можете продолжить разговор и отсюда.

7. Редактор

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

Чтобы перейти в редактор, вы можете нажать кнопку Open Editor в правом верхнем углу окна Agent Manager.

Настройка и расширения

В типичной конфигурации у вас будут видны редактор, терминал и агент:

Если это не так, вы можете переключать панели терминала и агента следующим образом:

• Для переключения панели терминала используйте сочетание клавиш Ctrl + ` .
• Для переключения панели агента используйте сочетание клавиш Cmd + L

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

Редактор

Автозаполнение

По мере ввода кода в редакторе включается интеллектуальная функция автозаполнения, которую можно просто перевести с помощью клавиши Tab:

Вкладка для импорта

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

Нажмите Tab для перехода

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

Команды

В редакторе или терминале можно запускать команды с помощью сочетания Cmd + I для автодополнения на естественном языке.

В редакторе вы можете запросить метод для вычисления чисел Фибоначчи, а затем принять или отклонить его:

В терминале можно получить подсказки по командам:

Боковая панель агента

В редакторе можно переключать боковую панель агента несколькими способами.

Ручное открытие

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

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

Вы также можете выбрать один из двух режимов разговора: Fast или Planning .

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

Вы также можете выбрать различные модели для диалога:

Объясните и исправьте

Ещё один способ запустить агента — навести курсор на проблему и выбрать Explain and fix :

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

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

Отправьте вывод терминала агенту.

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

Переключение между редактором и менеджером агентов.

В любой момент вы можете переключаться между режимом редактора и полнофункциональным режимом управления агентами, нажав кнопку Open Agent Manager в правом верхнем углу, когда находитесь в режиме редактора, и обратно, нажав кнопку Open Editor в правом верхнем углу, когда находитесь в режиме управления агентами.

В качестве альтернативы, для переключения между двумя режимами можно использовать сочетание клавиш Cmd + E

8. Предоставьте обратную связь.

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

• План внедрения и список задач (до начала кодирования)
• Сравнение кода (по мере генерации кода)
• Пошаговое руководство для проверки результатов (после написания кода)

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

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

Режим планирования

Во-первых, необходимо убедиться, что Antigravity находится в режиме Planning (вместо Fast режима). Вы можете выбрать этот режим в чате на боковой панели агента. Это гарантирует, что Antigravity создаст план реализации и список задач, прежде чем приступить к написанию кода. Затем попробуйте ввести запрос, например, такой: Create a todo list web app using Python . Это запустит процесс планирования и создания плана реализации для агента.

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

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

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

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

Это также первое место, где вы можете оставить отзыв. В нашем случае агент хочет использовать Flask в качестве веб-фреймворка на Python. Мы можем добавить комментарий к плану реализации, чтобы вместо него использовать FastAPI. После добавления комментария либо отправьте его, либо попросите Antigravity Proceed с обновленным планом.

Список задач

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

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

Это второе место, где вы можете оставить отзыв.

Например, в нашем случае вы можете добавить более подробные инструкции по проверке, добавив следующий комментарий: Verify application by adding, editing, and deleting a todo item and taking a screenshot.

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

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

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

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

Вы также можете нажать Review changes , чтобы увидеть подробности изменений и добавить подробные комментарии к коду. Например, мы можем добавить следующий комментарий в main.py : Add basic comments to all methods

Это отличный способ итеративной доработки кода с помощью Antigravity.

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

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

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

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

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

9. Правила и рабочие процессы

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

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

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

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

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

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

• Глобальное правило: ~/.gemini/GEMINI.md
• Глобальный рабочий процесс: ~/.gemini/antigravity/global_workflows/global-workflow.md
• Правила рабочей области: your-workspace/.agent/rules/
• Рабочие процессы рабочей области: your-workspace/.agent/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. Навыки

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

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

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

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

• Глобальная область действия ( ~/.gemini/antigravity/skills/ ): Доступно для всех ваших проектов (например, "Форматирование JSON", "Общий анализ кода") .
• Область действия рабочей области ( <workspace-root>/.agent/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 ~/.gemini/antigravity/skills/code-review

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

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

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

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

## How to provide feedback

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

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

Попробуйте!

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

import time

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

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

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

if __name__ == "__main__":
   run_batch()

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

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

Навык создания шаблонов заголовков кода

Иногда навыку необходимо использовать большой блок статического текста (например, заголовок лицензии). Вставлять этот текст непосредственно в подсказку нецелесообразно. Вместо этого мы помещаем его в папку resources/ и даем агенту указание читать его только при необходимости.

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

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

Создайте .agent/skills/license-header-adder/resources/HEADER.txt в который вставьте текст вашей лицензии:

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

Создайте файл .agent/skills/license-header-adder/SKILL.md со следующим содержимым:

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

# License Header Adder

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

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

Попробуйте!

Попросите агента сделать следующее: Create a new Python script named data_processor.py that prints 'Hello World'.

Агент прочтёт шаблон, преобразует комментарии в стиле C в стиль Python и автоматически добавит их в начало вашего нового файла.

Развив эти навыки, вы фактически превратили универсальную модель Gemini в специалиста по вашему проекту. Вы систематизировали лучшие практики, будь то следование рекомендациям по проверке кода или заголовкам лицензий. Вместо того чтобы постоянно напоминать ИИ «не забудьте добавить лицензию» или «исправьте формат коммита», агент теперь инстинктивно знает, как работать в вашей команде.

11. Обеспечение безопасности агента

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

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

При первой настройке Antigravity или через меню настроек необходимо выбрать политику Terminal Command Auto Execution . Этот параметр определяет автономность агента в отношении команд оболочки.

Текущие настройки можно посмотреть в разделе Antigravity — Settings , затем Advanced Settings . Там вы увидите раздел Terminal с настройками агента. Запомните эту таблицу, если захотите изменить этот параметр на другой:

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

Настройка списка разрешенных пользователей

Список разрешенных объектов используется преимущественно в сочетании с политикой «Выкл.» . Он представляет собой позитивную модель безопасности, означающую, что все запрещено, если это прямо не разрешено. Это наиболее безопасная конфигурация.

Пошаговая настройка

1. Установите параметр « Автоматическое выполнение команд терминала» в положение «Выкл.» .
2. Добавьте следующую команду в список разрешенных команд терминала, нажав кнопку «Добавить» рядом с ней: ls -al . При желании вы можете добавить и другие команды терминала.

Проверка списка разрешенных объектов.

• Попросите агента: List the files in this directory .
• Агент автоматически запускает ls .
• Попросите агента: Delete the <some file>
• Агент попытается выполнить rm <filepath> , но Antigravity заблокирует её и принудительно запросит проверку у пользователя, поскольку rm отсутствует в списке разрешенных. Перед выполнением команды Antigravity должен запросить у вас разрешение.

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

Настройка списка запрещенных сайтов

Список запрещенных действий — это мера безопасности для режима Turbo (а иногда и Auto ). Он представляет собой негативную модель безопасности, означающую, что разрешено все, если это прямо не запрещено. Это основано на предположении разработчика о каждой возможной опасности, что является рискованным подходом, но обеспечивает максимальную скорость.

Пошаговая настройка

1. Установите параметр « Автоматическое выполнение команд терминала» в режим «Турбо» .
2. Добавьте следующие команды в список запрещенных команд терминала, нажав кнопку «Добавить» рядом с ним.
3. рм
4. судо
5. локон
6. wget

Проверка списка запрещенных сайтов

• Спросите у агента: Check the version of python .
• Агент автоматически запускает команду python --version .
• Спросите у агента: Download home page www.google.com .
• Агент пытается выполнить команду curl . Antigravity обнаруживает curl в списке запрещенных команд и блокирует выполнение, запрашивая у вас ручное подтверждение.

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

Безопасность браузера

Способность Antigravity просматривать веб-страницы — это сверхспособность, но и уязвимость. Агент, посетивший скомпрометированный сайт с документацией, может столкнуться с мгновенной инъекционной атакой.

Чтобы предотвратить это, вы можете добавить список разрешенных URL-адресов браузера для агента браузера.

Текущие настройки можно посмотреть в разделе Antigravity — Settings , а затем Advanced Settings . В настройках браузера вы увидите раздел «Разрешенные URL-адреса браузера», как показано ниже:

Нажмите на кнопку «Открыть файл списка разрешенных доменов», и откроется файл в папке HOME/.gemini/antigravity/browserAllowlist.txt. Здесь вы можете убедиться, что в список разрешенных доменов внесены только доверенные домены.

12. Заключение и дальнейшие шаги

Поздравляем! Вы успешно установили Antigravity, настроили среду и научились управлять своими агентами.

Что дальше? Чтобы увидеть Antigravity в действии при создании реальных приложений, вы можете ознакомиться со следующими примерами кода:

• Разработка приложений с помощью Google Antigravity : В этом практическом занятии показано, как создать несколько приложений, включая динамический веб-сайт для конференций и приложение для повышения производительности.
• Создание и развертывание бессерверного приложения в Google Cloud с помощью Antigravity : В этом практическом занятии показано, как спроектировать, создать и развернуть бессерверное приложение в Google Cloud.

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

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