1. Введение
В этом практическом занятии вы познакомитесь с Google Antigravity — платформой для разработки агентных систем, созданной для того, чтобы помочь вам в разработке в эпоху агентов. Antigravity 2.0 служит центральным командным центром для ваших ИИ-агентов, предоставляя единую платформу для запуска, мониторинга и координации их действий.
С запуском версии 2.0 Antigravity перестала быть просто менеджером агентов, интегрированным с IDE. Теперь это полноценная экосистема продуктов, разработанная для эпохи, ориентированной на агентов:
- Antigravity: флагманское автономное приложение для macOS, Linux и Windows. Это ваш командный центр для управления несколькими локальными агентами параллельно, выполнения запланированных задач и многого другого. В отличие от своего предшественника, Agent Manager, Antigravity 2.0 — это автономное приложение, работающее независимо от IDE.
- Antigravity IDE: Оригинальная полнофункциональная IDE с поддержкой агентов по-прежнему доступна (и рекомендуется разработчикам!). Она включает в себя менеджер агентов, артефакты и глубокое понимание вашей кодовой базы.
- Antigravity CLI: Интерфейс командной строки для взаимодействия с агентами через терминал. В данном руководстве он рассматриваться не будет.
- Antigravity SDK: Инструменты для разработчиков, позволяющие программно интегрировать Antigravity в свои системы. В данном руководстве это рассматриваться не будет.
В этом практическом занятии мы сосредоточимся на Antigravity и кратко рассмотрим IDE Antigravity. Два других компонента, Antigravity CLI и Antigravity SDK, рассматриваться не будут.
Если вас интересует практическое занятие по Antigravity CLI, приложению, работающему в терминале, обратитесь к практическому занятию: Начало работы с Antigravity CLI .
Что вы узнаете
- Установка и настройка Antigravity.
- Изучение ключевых концепций антигравитации, таких как работа с агентами, рабочие пространства и многое другое.
- Настройка антигравитации с помощью различных параметров в соответствии с вашими предпочтениями.
Что вам понадобится
Программа Antigravity должна быть установлена локально на вашем компьютере. Продукт доступен для Mac, Windows и некоторых дистрибутивов Linux. Помимо вашего компьютера, вам потребуется следующее:
- Веб-браузер Chrome.
- Аккаунт Gmail (личный аккаунт Gmail).
Данный практический семинар предназначен для пользователей и разработчиков всех уровней.
Сообщение о проблемах
В процессе работы над лабораторной работой и с программой Antigravity вы можете столкнуться с проблемами.
По вопросам, связанным с выполнением заданий (опечатки, неверные инструкции), пожалуйста, сообщите об ошибке, используя кнопку Report a mistake в левом нижнем углу этого задания:
Сообщения об ошибках или пожелания по улучшению функций Antigravity следует отправлять непосредственно в Antigravity. Вы также можете оставить отзыв о продукте, перейдя в «Настройки», расположенные в левом нижнем углу страницы Antigravity, а затем выбрав опцию Provide Feedback .
2. Установка
Установка антигравитации
Перейдите на страницу загрузки Google Antigravity . Загрузите приложение Antigravity для вашей операционной системы (macOS, Linux или Windows).
Запустите установщик. Отобразится следующий экран:
Войдите в систему, используя свой аккаунт Google. Пройдите аутентификацию, и должно отобразиться следующее:
Нажмите «Открыть Antigravity» . Отобразится политика безопасности и использования данных. Нажмите «Далее» .
Выберите понравившуюся тему оформления:
Antigravity поставляется с набором плагинов, работающих с различными инструментами разработчика Google. Эти плагины устанавливают набор навыков, которые помогают Antigravity взаимодействовать с различными инструментами разработчика Google. Вот список плагинов, которые вы можете установить по желанию. Мы не будем рассматривать эти плагины в практическом занятии. Нажмите « Готово» .
Вы должны увидеть следующий интерфейс антигравитации:
Установите Antigravity IDE
При желании вы можете установить Antigravity IDE. Перейдите на страницу загрузки Google Antigravity . Затем перейдите в раздел загрузок Antigravity IDE.
После успешной установки Antigravity и Antigravity IDE в доке появятся два значка: Antigravity (белый фон) и Antigravity IDE (черный сетчатый фон).
3. Антигравитационный интерфейс
Мы готовы начать! Давайте сначала сосредоточимся на использовании антигравитации. Начальный экран антигравитации выглядит примерно так:
По ходу этого урока мы будем обращаться к опции «Настройки» в левом нижнем углу по мере необходимости.
Проекты
Давайте сначала разберемся с концепцией проектов в Antigravity. Это очень важно, потому что, если вы посмотрите на интерфейс в правой панели, там четко написано «Выберите проект» , и Antigravity использует проектно-ориентированный подход, чтобы гарантировать, что агенты имеют доступ к нужным файлам, инструментам, разрешениям и многому другому.
Проект представляет собой комбинацию папок, определяющих среду и область действия вашего агента. Вместо того чтобы заставлять агента работать в рамках одной папки, проект может работать с одной или несколькими папками (например, репозитории фронтенда и бэкенда), предоставляя вашим агентам весь необходимый контекст для вашей кодовой базы. Все проекты имеют свои собственные изолированные настройки агента, что позволяет независимо настраивать параметры безопасности различных проектов.
Давайте создадим наш первый проект. В домашней папке на вашем локальном компьютере создайте папку с именем $HOME/agy2-projects/my-first-project . Обратите внимание, что это не обязательно должна быть пустая папка.
Теперь мы создадим наш первый проект в Antigravity, определив, какие папки будут составлять проект. В нашем первоначальном случае это будет одна папка.
Нажмите «Выбрать проект» → «Новый проект» , как показано ниже:
Как и ожидалось, программа предлагает выбрать папку (папки), как показано ниже:
Нажмите «Добавить папку» и выберите нужную папку, например, $HOME/agy2-projects/my-first-project
Как вы можете заметить (через кнопку «Добавить папку» ), вы все еще можете добавить в проект новые папки, но пока что мы можем нажать кнопку «Далее» .
При этом открывается диалоговое окно, как показано ниже. Все проекты имеют собственные изолированные настройки агента, что позволяет независимо настраивать параметры безопасности различных проектов.
Каждый проект наследует права доступа к артефактам для проверки, разрешенным инструментам и конфигурации сервера протокола контекста модели (MCP) из глобальной конфигурации, доступной в разделе «Настройки» в главном интерфейсе. Однако вы можете индивидуально настроить эти и другие права доступа для каждого проекта, что обеспечит гораздо большую гибкость и позволит оптимизировать контекст и инструменты для вашего конкретного проекта.
На данный момент выберите вариант «По умолчанию» .
В следующем диалоговом окне вы также можете дать название своему проекту и нажать кнопку «Создать» .
Теперь вы увидите следующий экран. Проект отображается в списке проектов, а также в интерфейсе чата, как показано на рисунке. Обратите внимание, что вы можете выбрать модель, передать дополнительный контекст с помощью знака «+», «@» или «/» и многое другое.
После того, как вы отправите оператору сообщение, он ответит соответствующим образом.
У нас есть еще один запрос на получение новостей, и он хорошо справляется со своей задачей.
Беседы
В нашем проекте ( my-first-project ) мы запустили цепочку сообщений, и в настоящее время в ней присутствует ряд сообщений (сообщения пользователей и ответы агентов).
Вы увидите, что эта ветка обсуждения слева сгруппирована под проектом.
А теперь давайте сделаем что-нибудь интересное и дадим название этой ветке обсуждения. Назовём её conv-introduction .
Для этого нажмите на три вертикальные точки рядом с диалогом. Откроются 3 варианта. Выберите действие «Переименовать» .
Присвойте значению conv-introduction или любое другое подходящее вам имя.
Теперь, если вы хотите начать совершенно новую беседу в проекте, нажмите знак + (Новая беседа в проекте) рядом с проектом, как показано ниже.
Вы перешли к совершенно новому разговору.
Давайте спросим о спортивных новостях со всего мира. Заметьте, что мы всё ещё находимся в рамках моего первого проекта.
Это дало мне некоторые новости из мира спорта, и вы можете заметить, что теперь у нас две ветки обсуждения в рамках одного проекта.
Давайте переименуем эту беседу в conv-sportsnews . Если вы хотите увидеть все состоявшиеся на данный момент беседы, вы можете перейти в Историю бесед в верхнем левом углу, как показано ниже:
В любой момент времени у вас есть возможность начать новую беседу либо в текущем проекте, либо в новом проекте, используя опцию « Новая беседа» вверху страницы.
Настройки проекта
Теперь вернемся к настройкам проекта , о которых мы говорили ранее. При создании проекта в Antigravity он наследует разрешения по умолчанию, которые при желании можно изменить.
Чтобы перейти к настройкам конкретного проекта, нажмите на значок шестеренки настроек рядом с каждым проектом в левой панели навигации.
Это приведет вас к настройкам конкретного проекта (например , my-first-project ), как показано ниже:
Обратите внимание, что слева в разделе «Проекты» выбран мой первый проект . Если бы проектов было больше, они бы отображались в этом списке, и вы могли бы легко выбрать любой из них и изменить его настройки по своему усмотрению.
Теперь давайте обратим внимание на правую часть, где отображаются настройки проекта my-first-project. Вы заметите, что здесь находится единственная папка, которую мы добавили в этот проект. Вы также можете добавить сюда другие папки.
Я предлагаю вам сначала ознакомиться со всем списком и оценить гибкость, которая теперь позволяет изменять множество настроек в соответствии с требованиями вашего проекта.
К ним относятся:
- Настройки безопасности : Определяет, должны ли все команды терминала и обращения к файлам проверяться вами, прежде чем агент сможет выполнять какие-либо действия.
- Поведение агента : определяет, будет ли агент выполнять план реализации с вашим контролем или без него.
- Различные локальные разрешения: пути к файлам, URL-адреса и т. д., разрешенные или заблокированные для агента.
- Вы даже можете настроить, какие именно инструменты MCP разрешены для этого проекта. Это очень полезно, чтобы предотвратить предоставление агенту в этом проекте доступа ко всем глобально настроенным серверам MCP.
Примечание : В любой момент вы можете перейти к настройкам Antigravity или даже к настройкам проектов через главный раздел настроек в интерфейсе Antigravity.
4. Команды с косой чертой
В Antigravity доступны некоторые интересные команды со слэшем / . В интерфейсе чата, если вы наберете / , вы увидите команды, как показано ниже:
Рассмотрим команду /browser . Это явная команда для запуска браузера и запроса на выполнение определённых действий. Для её выполнения требуется Google Chrome и разрешение Google Chrome на запуск сеанса отладки.
Это запускает подпрограмму браузера, которая пытается запустить сеанс отладки в Chrome и сначала запрашивает ваше разрешение:
После вашего разрешения система запросит необходимые разрешения и получит подробную информацию.
Команда /schedule полезна, если вы хотите настроить повторяющиеся или разовые задачи для агента, которые будут выполняться через фиксированные интервалы или по расписанию (например, в 9:00 утра в понедельник или среду).
В то же время, вам предоставляется возможность сделать это через пользовательский интерфейс, и это рассматривается в разделе «Планирование команд» на следующем шаге.
5. Планирование команд
В главном интерфейсе вы можете использовать опцию «Планирование» , чтобы автоматизировать повторяющиеся задачи или установить разовые напоминания для конкретных проектов.
Давайте создадим ежедневное задание, которое будет напоминать нам о нашей встрече в 18:00. Нажмите «Создать» и заполните данные, как показано ниже:
Нажмите кнопку «Добавить запланированную задачу» , и задача будет добавлена в список запланированных задач, как показано ниже:
Добавим еще один совет, который напоминает нам о необходимости делать перерыв каждые 20 минут:
У нас сейчас запланированы две задачи, как показано ниже:
Вы можете отключить или удалить любую из задач. Помните, что мы использовали базовые подсказки, но ваши подсказки могут быть более подробными, могут запускать инструменты (взаимодействовать с внешними системами) и выполнять гораздо больше работы в фоновом режиме с регулярными интервалами, в зависимости от ваших требований.
6. Серверы протокола контекста модели (MCP)
Протокол контекста модели (MCP) стал стандартом, помогающим подключать агентов к внешним системам. Он играет ключевую роль в обеспечении того, чтобы агент оставался в курсе ваших данных и интеграции.
Antigravity поддерживает серверы MCP, как локальные, так и удаленные. В комплект также входит интеграция с несколькими серверами MCP, работающими с сервисами Google Cloud, установка которых осуществляется простым щелчком мыши с минимальными настройками.
Для начала давайте посмотрим список предварительно настроенных параметров сервера MCP. Перейдите в «Настройки» → «Настройки» , а затем нажмите кнопку «Добавить MCP+» , чтобы добавить новый сервер. Откроется диалоговое окно, где вы увидите полный список серверов:
Нажмите кнопку «+Добавить» , чтобы добавить любой сервер MCP. В зависимости от сервера MCP вам потребуется указать некоторую информацию, такую как идентификатор проекта и данные базы данных.
Добавление существующих серверов MCP
В фоновом режиме серверы MCP настраиваются в файле $HOME/.gemini/config/mcp_config.json . Если вы уже работали с существующими удаленными серверами MCP, вы можете просто добавить данные в этот файл. Подробнее о настройке пользовательских серверов MCP можно узнать здесь .
После добавления удалённых MCP-серверов и сохранения файла вы можете перейти в раздел MCP-серверов в Antigravity следующим образом:
- В главном интерфейсе Antigravity нажмите «Настройки» .
- Перейдите в раздел «Настройки» . Если серверы MCP по-прежнему не отображаются, нажмите « Обновить» .
- При желании вы можете отключить любой из серверов MCP с помощью кнопки «Переключить» . Также вы можете щелкнуть по любому из серверов MCP и увидеть инструменты, предоставляемые этим сервером.
Чтобы использовать настроенные MCP-серверы, вы можете запросить у Antigravity выполнение действия, требующего наличия MCP-сервера. Например, вы можете включить сервер cloudrun-mcp и запросить у Antigravity следующее: Build and deploy a Cloud Run service . Это должно побудить Antigravity найти и использовать сервер cloudrun-mcp для настройки и развертывания службы Cloud Run.
7. Артефакты
В процессе планирования и выполнения своей работы Antigravity создает артефакты , чтобы доносить результаты своей деятельности и получать обратную связь от пользователей. К ним относятся файлы в формате Markdown, архитектурные схемы, изображения, записи браузера, сравнения кода и так далее.
Артефакты решают проблему недостатка доверия. Когда агент заявляет об исправлении ошибки, разработчику раньше приходилось читать код, чтобы убедиться в этом. В Antigravity агент создает артефакт, чтобы это доказать.
Вот основные артефакты, созданные с помощью антигравитации:
-
Task Lists: Перед написанием кода агент генерирует структурированный план. Обычно редактировать этот план не требуется, но вы можете просмотреть его и в некоторых случаях добавить комментарий для внесения изменений, если это необходимо. -
Implementation Plan: Он используется для планирования изменений в кодовой базе для выполнения задачи. Эти планы содержат технические подробности о необходимых изменениях и предназначены для ознакомления пользователем, если только в вашей политике проверки артефактов не установлен параметр «Всегда продолжать» . -
Walkthrough: Оно создается после завершения агентом выполнения задачи и представляет собой краткое описание изменений и способов их тестирования. -
Code diffs: Хотя технически это не артефакт, Antigravity также создает сравнение кода, которое вы можете просмотреть и прокомментировать. -
Screenshots: Агент фиксирует состояние пользовательского интерфейса до и после изменения.
Чтобы лучше понять, что такое артефакты, создайте диалог с новым или существующим проектом, используя следующую подсказку:
Write a node application that I can run from the command line to get me the latest news from Google.
Агент улетает и возвращается с нашим первым артефактом: Планом реализации.
Вы можете просмотреть любые артефакты, созданные с помощью антигравитации, переключив вспомогательную панель, расположенную в правом верхнем углу.
Если вы переключите вспомогательную панель , вы увидите следующий вывод, в котором указано, что был сгенерирован 1 артефакт (план реализации).
Для просмотра подробностей нажмите на « План реализации» , как показано ниже:
На данный момент нас устраивает этот план, и мы просто нажимаем кнопку «Продолжить» , чтобы двигаться дальше.
В процессе работы создается еще один артефакт — план задачи, а также другие файлы. Все это можно увидеть во вспомогательной панели, как показано ниже:
Если вы щелкнете по артефакту «Задача» , вы увидите пошаговый список задач для достижения поставленной вами цели, а также информацию о том, какие шаги уже выполнены, а какие еще предстоит выполнить.
Наконец, когда все будет завершено, протестировано и проверено агентом, вы получите сообщение о завершении задачи. Еще один артефакт, называемый «Пошаговое руководство» , теперь готов. Итоговый список представлен ниже:
Следует отметить несколько моментов: помимо артефактов (задача, пошаговое руководство и план реализации), существуют также исходные файлы (package.json , index.js ) .
Для просмотра сгенерированных файлов вам может не понадобиться полноценный редактор/IDE. Вы можете щелкнуть по файлам package.json или index.js , и вы сможете увидеть их содержимое и оставить комментарии.
8. Антигравитационная ИДЕ
При желании вы можете использовать интегрированную среду разработки Antigravity IDE, которую мы установили ранее в этом практическом занятии. Обратите внимание, что при переключении вспомогательной панели в главном интерфейсе Antigravity есть опция «Открыть IDE» .
Нажмите на это, чтобы открыть Antigravity IDE. При запуске Antigravity IDE вы можете увидеть предупреждение, которое выглядит примерно так:
Это нормально. Нажмите «Да» . Откроется среда разработки Antigravity IDE, которая должна быть знакома всем, кто раньше пользовался 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 в выбранном вами проекте и введите следующий запрос.
Это должно демонстрировать навык проверки кода .
Попробуйте!
Создайте новый файл с именем demo_bad_code.py в папке $HOME/agy2-projects/my-skills-project со следующим содержимым:
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, настроили среду и научились управлять своими агентами.
Получите значок Kaggle "5-дневный курс по ИИ-агентам"
Вы выполнили эту лабораторную работу в рамках 5-дневного интенсивного курса программирования Vibe от Google на Kaggle? Получите значок за завершение курса: Получить значок 5-дневного курса по ИИ-агентам .
Что дальше? Чтобы увидеть Antigravity в действии при создании реальных приложений, вы можете ознакомиться со следующим практическим заданием:
- Создание и развертывание бессерверного приложения в Google Cloud с помощью Antigravity : В этом практическом занятии показано, как спроектировать, создать и развернуть бессерверное приложение в Google Cloud.
Справочная документация
- Официальный сайт: 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