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 . Это явная команда для запуска браузера и запроса на выполнение определённых действий.
Попробуйте перейти на веб-сайт, как показано ниже:
Это запускает подпрограмму браузера, которая пытается запустить сеанс отладки в 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: Агент фиксирует состояние пользовательского интерфейса до и после изменения.
Чтобы лучше понять, что такое артефакты, создайте диалог с новым или существующим проектом, используя следующую подсказку:
Design a Node application that I can run from the command line to get me the latest news from Google.
Агент улетает и возвращается с нашим первым артефактом: Планом реализации.
