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

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

1. Введение

В этой практической работе вы узнаете о Google Antigravity – агентной платформе для разработки, которая поможет вам создавать агентов в эпоху агентов. Antigravity 2.0 – это централизованная платформа для запуска, мониторинга и координации действий ИИ-агентов.

После запуска версии 2.0 Antigravity – это не просто менеджер агентов, интегрированный с IDE. Теперь это целая экосистема продуктов, разработанных для эпохи агентов:

Antigravity – основное отдельное приложение для macOS, Linux и Windows. Это центр управления, в котором можно одновременно управлять несколькими локальными агентами, запускать запланированные задачи и выполнять другие действия. В отличие от предыдущей версии, Agent Manager, Antigravity 2.0 – это отдельное приложение, которое работает независимо от интегрированной среды разработки.
Antigravity IDE. Изначальная полнофункциональная IDE с агентами по-прежнему доступна и рекомендуется разработчикам. Он поставляется с менеджером агентов, артефактами и глубоким пониманием вашей базы кода.
Antigravity CLI – интерфейс командной строки для взаимодействия с агентами через терминал. В этом руководстве мы не будем рассматривать этот вариант.
Antigravity SDK – инструменты для разработчиков, позволяющие интегрировать Antigravity в собственные системы. В этом руководстве мы не будем рассматривать этот вариант.
Antigravity для IDE. Эта функция была выпущена недавно. Это позволяет использовать возможности автономного агента Antigravity прямо в вашем любимом редакторе с помощью официальных расширений для Visual Studio Code, Jetbrains, Zed и других. Если вы не хотите использовать ни одно из этих расширений, вы можете использовать упомянутую выше отдельную IDE Antigravity.

В этой практической работе мы уделим основное внимание Antigravity и кратко рассмотрим Antigravity IDE. Остальные два компонента – Antigravity CLI и Antigravity SDK – не рассматриваются.

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

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

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

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

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

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

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

Проблемы с отчетами

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

Если вы обнаружили ошибку в коде или инструкции, нажмите на кнопку Report a mistake в левом нижнем углу страницы.

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

2. Установка

Установка Antigravity

Перейдите на страницу скачивания Google Antigravity. Скачайте приложение Antigravity для своей операционной системы (macOS, Linux или Windows).

Запустите установщик. На экране появится следующее сообщение:

Доступны два варианта:

Войти через Google. Вы можете использовать личный аккаунт Google. Antigravity поддерживает стартовый пакет с личным адресом Gmail. Если вы приобрели пакеты Google AI Pro или Ultra в своем аккаунте Google, будут применены соответствующие лимиты квоты Antigravity.
Использовать корпоративный аккаунт. Этот вариант подходит, если вы используете проект Enterprise, в котором есть проект Google Cloud и ваша организация приобрела лицензии. Вы также можете использовать проект Google Cloud вместе с платформой агентов с оплатой по мере использования. Мы не будем использовать этот вариант.

Нажмите "Продолжить с Google" и войдите в аккаунт Google. После аутентификации вы увидите следующее:

Нажмите Открыть Antigravity, чтобы продолжить процесс.

Вы можете выбрать тему, один или несколько плагинов Google, которые можно добавить в Antigravity (пока можно пропустить этот шаг), и экран Условия использования. Примите его, нажмите Готово, и вы увидите интерфейс Antigravity, который выглядит следующим образом:

Мы вернемся к интерфейсу позже, а пока все готово.

Как установить Antigravity IDE

В правом верхнем углу экрана должна быть кнопка Install Antigravity IDE (Установить Antigravity IDE). Вы будете перенаправлены на страницу скачивания Google Antigravity IDE. Вы также можете перейти на нее напрямую.

Нажмите кнопку Скачать. Вы перейдете на страницу, где можно скачать расширение Antigravity для вашей любимой интегрированной среды разработки (Visual Studio Code, Zed, Jetbrains и т. д.) или отдельный установщик Antigravity IDE, как показано ниже.

Скачайте подходящий установщик. Запустите установщик, войдите в тот же аккаунт Google и следуйте инструкциям. На каждом шаге выбирайте значения по умолчанию, начиная с IDE, действий по умолчанию, плагинов и т. д.

В доке появятся два значка: Antigravity 2.0 (белый фон) и Antigravity IDE (черный фон с сеткой).

3. Интерфейс Antigravity 2.0

Запустите Antigravity, если вы ещё этого не сделали. В идеале вы должны увидеть экран, как на изображении ниже. Если вы установили отдельную IDE Antigravity, кнопка в правом верхнем углу будет называться Открыть IDE Antigravity, а не Установить IDE.

Мы вернемся к настройкам в левом нижнем углу экрана, когда они нам понадобятся.

Проекты

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

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

Давайте создадим наш первый проект. В домашней папке на локальном компьютере создайте папку с названием $HOME/agy2-projects/my-first-project . Обратите внимание, что папка не обязательно должна быть пустой.

Сейчас мы создадим первый проект в Antigravity, указав, какие папки будут в него входить. В нашем примере это будет одна папка: $HOME/agy2-projects/my-first-project.

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

Вы увидите варианты, как показано ниже. Нажмите Новый проект:

Вам будет предложено выбрать папку для проекта в Проводнике. Выберите папку. В нашем случае это $HOME/agy2-projects/my-first-project.

Сейчас у нас определен проект my-first-project, который указывает на папку $HOME/agy2-projects/my-first-project.

Возможно, вы зададитесь вопросом, может ли у проекта быть только одна папка. Что делать, если мне нужен проект с папками для клиентского и серверного кода? Вы можете добавить больше папок, чтобы у Antigravity был полный контекст при работе с вашими проектами. Нажмите Настройки проекта для нужного проекта (my-first-project), как показано ниже.

Откроется диалоговое окно Настройки проекта, в котором можно добавить папки, нажав Добавить папку.

Вы можете добавить в проект больше папок, нажав Добавить папку, но пока нам достаточно и этого. Нажмите кнопку "Создать".

Теперь страницу настроек можно закрыть.

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

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

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

Давайте поздороваемся с агентом, и он ответит нам.

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

Разговоры

В проекте (my-first-project) мы начали цепочку сообщений, в которой сейчас есть несколько сообщений (сообщение пользователя и ответы агента).

Вы увидите, что цепочка чата осталась одна и она сгруппирована по проекту на левой стороне.

Теперь давайте сделаем что-нибудь интересное и дадим название этой цепочке сообщений. Назовем его conv-introduction.

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

Укажите значение conv-introduction или любое другое название, которое вам подходит.

Если вы хотите начать новый чат в проекте, нажмите на значок + (Новый чат в проекте) рядом с проектом, как показано ниже.

Вы перешли в новый чат.

Давай посмотрим спортивные новости со всего мира. Обратите внимание, что мы по-прежнему находимся в проекте my-first-project, то есть "Расскажи мне спортивные новости со всего мира".

Это позволяет мне получать новости из мира спорта. Как видите, в одном проекте теперь две цепочки сообщений.

Давай переименуем этот чат в conv-sportsnews. Чтобы посмотреть все чаты, нажмите История чатов в левом верхнем углу.

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

Настройки проекта

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

Чтобы перейти к настройкам определенного проекта, нажмите на значок шестеренки рядом с ним на панели навигации слева и выберите Настройки проекта.

Вы перейдете к настройкам определенного проекта (например, my-first-project), как показано ниже.

Обратите внимание, что слева в разделе проектов выбран вариант my-first-project. Если бы проектов было больше, они бы отображались под этим списком. Вы можете выбрать любой из них и изменить его настройки.

Теперь давайте посмотрим на правую сторону, где показаны настройки проекта my-first-project. Вы увидите, что в нем есть одна папка, которую мы добавили в этот проект. Здесь же можно добавить другие папки.

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

Вот некоторые из них:

Набор параметров безопасности. Вы можете настроить так, чтобы все команды терминала и обращения к файлам сначала проверялись вами, прежде чем агент сможет выполнить действия.
Поведение агента. В случае сгенерированных артефактов, например implementation_plan.md, которые вы хотите проверить, прежде чем попросить агента выполнить план.
Различные локальные разрешения, например разрешенные пути к файлам, разрешенные или заблокированные URL для агента и т. д.
Вы даже можете указать, какие именно инструменты MCP разрешены для этого проекта. Это позволяет запретить агенту в этом проекте использовать все глобально настроенные серверы MCP.

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

4. Слеш-команды

В Antigravity есть интересные команды, которые начинаются со слеша /. Если в интерфейсе чата ввести /, вы увидите команды , как показано ниже.

Команда /plan важна, если вы хотите, чтобы модель создала план реализации до выполнения.

Команда /browser запускает браузер и просит его что-то сделать.

Попробуйте перейти на сайт, как показано ниже.

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

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

Команда /schedule позволяет задавать повторяющиеся или однократные задачи для агента, которые будут выполняться через определенные интервалы или по расписанию (например, в 9:00 в понедельник и среду).

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

5. Команды для планирования

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

Давайте создадим ежедневную задачу, которая будет напоминать нам о встрече в 18:00. Нажмите New (Создать) и заполните поля, как показано ниже.

Нажмите Добавить запланированную задачу. Задача будет добавлена в список запланированных задач, как показано ниже.

Давайте добавим ещё одно напоминание, которое будет появляться каждые 20 минут:

Теперь у нас две запланированные задачи, как показано ниже:

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

6. Серверы Model Context Protocol (MCP)

Model Context Protocol (MCP) – это стандарт, который помогает подключать агентов к внешним системам. Они играют ключевую роль в том, чтобы агент оставался в рамках ваших данных и интеграции.

Antigravity поддерживает локальные и удаленные MCP-серверы. Кроме того, в нем есть интеграции с несколькими серверами MCP, которые работают с сервисами Google Cloud. Их можно установить в один клик, указав несколько параметров конфигурации.

В последней версии Antigravity 2.0 добавить MCP-сервер в Antigravity стало проще.

Перейдите в раздел Настройки → Специальные настройки. Вы увидите конфигурацию сервера MCP, как показано ниже.

Перейдите к разделу "Установленные MCP-серверы" в конфигурации, как показано ниже:

Если нажать кнопку "Открыть конфигурацию MCP", вы перейдете к файлу, расположенному в $HOME/.gemini/config/mcp_config.json, где хранятся все ваши настройки. Если вы знакомы с файлом конфигурации серверов MCP, вы можете напрямую редактировать и сохранять его содержимое.

Как видите, сейчас он пуст.

Чтобы настроить MCP-сервер, нажмите кнопку Добавить MCP.

Откроется большой список предварительных конфигураций для разных MCP-серверов, особенно сервисов Google Cloud, которые были упакованы как MCP-серверы. Ниже показан экран:

Вы можете добавить любой из них. Например, я нажал Добавить рядом с сервером Google Cloud Run MCP, и он установился.

Он будет добавлен в список MCP-серверов, как показано ниже, вместе с инструментами, которые предоставляет MCP-сервер. Вы можете включить или отключить инструмент, нажав на подсказку с его названием ниже, или отключить весь MCP-сервер, переведя переключатель в положение "Выкл.".

Если нажать кнопку Open MCP Config (Открыть конфигурацию MCP), вы увидите, что запись добавлена в файл mcp_config.json, как показано ниже.

{
 "mcpServers": {
   "cloudrun": {
     "command": "npx",
     "args": [
       "-y",
       "@google-cloud/cloud-run-mcp"
     ]
   }
 }
}

Если вы уже работали с удаленными серверами MCP, просто добавьте их данные в файл $HOME/.gemini/config/mcp_config.json.

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

7. Объекты

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

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

Вот основные артефакты, которые могут быть созданы Antigravity:

Task Lists: перед написанием кода агент может создать структурированный план. Обычно этот план не нужно редактировать, но вы можете проверить его и при необходимости добавить комментарий, чтобы изменить его.
Implementation Plan – план реализации создается до начала выполнения задачи при использовании команды /plan. Эти планы содержат технические сведения о том, какие изменения необходимо внести. Они предназначены для проверки пользователем, если только в правилах проверки артефактов не задано значение Всегда выполнять.
Walkthrough: может быть создан после того, как агент выполнит задачу, в качестве краткого описания изменений и инструкций по их тестированию.
Code diffs: Antigravity также создает различия в коде, которые можно просматривать и комментировать.
Screenshots: агент может зафиксировать состояние интерфейса до и после изменения.

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

/plan Design a Node application that I can run from the command line to get me the latest news from Google.

Агент отправляется в путь и возвращается с первым артефактом – планом реализации.

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

Если вы переключите Дополнительную панель, то увидите следующие выходные данные, в которых указано, что был создан один артефакт (план реализации).

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

Нас устраивает предложенный план, поэтому мы нажимаем кнопку Продолжить.

Вам может потребоваться предоставить разрешения, чтобы продолжить.

Когда все будет готово, протестировано и проверено агентом, вы получите сообщение о том, что задача выполнена.

Ещё один артефакт, который вы можете увидеть, – это Пошаговое руководство вместе с различиями в файлах, как показано ниже.

Для просмотра сгенерированных файлов может не понадобиться полнофункциональный редактор или интегрированная среда разработки. Вы можете нажать на файлы package.json или index.js, чтобы посмотреть их содержимое и добавить комментарии.

8. Antigravity IDE

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

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

Это нормально. Нажмите Да. Откроется IDE Antigravity, которая должна быть знакома всем, кто раньше пользовался IDE. В нем есть все сгенерированные папки и файлы, редактор и панель агента, где можно общаться с агентом о коде (просить объяснить, сгенерировать, исправить и т. д.).

9. Навыки

Базовые модели 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, в котором будут метаданные и инструкции для навыка. Давайте создадим навык, который будет предоставлять агенту информацию для проверки изменений в коде на наличие ошибок, проблем со стилем и соответствия рекомендациям.

Предположим, что вы находитесь в папке проекта (например, $HOME/agy2-projects/my-skills-project)). Первый шаг – создать в ней каталог, в котором будет храниться навык.

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 в нужном проекте и введите следующий запрос:

На экране должен появиться навык code-review.

Попробовать

Создайте в каталоге $HOME/agy2-projects/my-skills-project файл 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.

Ниже приведен пример выходных данных:

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

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

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

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

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

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