Агент Antigravity — это универсальный управляемый агент, работающий через API Gemini. Один вызов API предоставляет вам агента, который выполняет логические рассуждения, код, управляет файлами и просматривает веб-страницы внутри вашей собственной защищенной песочницы Linux, размещенной Google.
Она работает на флэш-памяти Gemini 3.5 и использует ту же инфраструктуру, что и Antigravity IDE. Доступна через Interactions API и Google AI Studio .
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
environment="remote",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
environment: "remote",
}, { timeout: 300000 });
console.log(interaction.output_text);
ОТДЫХ
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"agent": "antigravity-preview-05-2026",
"input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
"environment": "remote"
}'
Возможности
Каждый вызов позволяет развернуть песочницу Linux и запустить цикл использования инструмента. Агент планирует действия, наблюдает за результатами и повторяет процесс до тех пор, пока задача не будет выполнена.
- Выполнение кода: запуск команд Bash, Python и Node.js. Установка пакетов, запуск тестов, сборка приложений.
- Управление файлами: чтение, запись, редактирование, поиск и отображение файлов в изолированной среде. Файлы сохраняются при последующих взаимодействиях.
- Доступ к интернету: поиск в Google и получение данных по URL-адресам.
- Сжатие контекста: Автоматическое сжатие контекста (запускается при объеме ~135 тыс. токенов) для поддержки длительных многоходовых сессий без потери контекста или превышения лимита токенов.
Инструкции по использованию в несколько ходов и потоковой передаче см. в разделе «Быстрый старт» .
Поддерживаемые инструменты
По умолчанию агент имеет доступ к code_execution , google_search и url_context . Инструменты файловой системы включаются автоматически при указании параметра environment . Параметр tools необходимо указывать только при настройке или ограничении набора инструментов по умолчанию.
| Инструмент | Тип значения | Описание |
|---|---|---|
| Выполнение кода | code_execution | Выполнение команд оболочки (bash, Python, Node) с захватом стандартного вывода/ошибок. |
| Поиск Google | google_search | Поищите в открытом доступе в интернете. |
| Контекст URL | url_context | Загружать и читать веб-страницы. |
| Файловая система | (включается через environment ) | Чтение, запись, редактирование, поиск и отображение файлов в песочнице. Отдельный тип инструмента отсутствует; включается автоматически при настройке environment . |
Чтобы ограничить использование агентом определенных инструментов, передавайте только те, которые вам необходимы:
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Search for the latest AI research papers on reasoning and summarize them.",
environment="remote",
tools=[
{"type": "google_search"},
{"type": "url_context"},
],
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Search for the latest AI research papers on reasoning and summarize them.",
environment: "remote",
tools: [
{ type: "google_search" },
{ type: "url_context" },
],
}, { timeout: 300000 });
console.log(interaction.output_text);
ОТДЫХ
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"agent": "antigravity-preview-05-2026",
"input": "Search for the latest AI research papers on reasoning and summarize them.",
"environment": "remote",
"tools": [
{"type": "google_search"},
{"type": "url_context"}
]
}'
Мультимодальный ввод
Агент Antigravity поддерживает многомодальный ввод данных. В настоящее время поддерживаются только text и image входные данные. Изображения должны предоставляться в виде встроенных строк, закодированных в base64 ( data ).
Python
import base64
from google import genai
client = genai.Client()
with open("path/to/chart.png", "rb") as f:
image_bytes = f.read()
interaction_inline = client.interactions.create(
agent="antigravity-preview-05-2026",
input=[
{"type": "text", "text": "Analyze this chart and summarize the trends."},
{
"type": "image",
"data": base64.b64encode(image_bytes).decode("utf-8"),
"mime_type": "image/png",
},
],
environment="remote",
)
JavaScript
import { GoogleGenAI } from "@google/genai";
import * as fs from "node:fs";
const client = new GoogleGenAI({});
const base64Image = fs.readFileSync("path/to/chart.png", { encoding: "base64" });
const interactionInline = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: [
{ type: "text", text: "Analyze this chart and summarize the trends." },
{
type: "image",
data: base64Image,
mime_type: "image/png",
},
],
environment: "remote",
}, { timeout: 300000 });
ОТДЫХ
BASE64_IMAGE=$(base64 -w0 /path/to/chart.png)
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d "{
\"agent\": \"antigravity-preview-05-2026\",
\"input\": [
{\"type\": \"text\", \"text\": \"Analyze this chart and summarize the trends.\"},
{
\"type\": \"image\",
\"mime_type\": \"image/png\",
\"data\": \"$BASE64_IMAGE\"
}
],
\"environment\": \"remote\"
}"
Настройка агента
Вы можете расширить возможности агента Antigravity, настроив его инструкции, инструменты и окружение. Агент поддерживает подход к настройке, основанный на файловой системе: вы можете монтировать файлы, такие как AGENTS.md с инструкциями и навыками, в папку .agents/skills/ непосредственно в песочницу или передавать конфигурацию непосредственно во время взаимодействия. Вы можете изменять конфигурацию непосредственно в процессе работы, а затем сохранять ее как управляемый агент, когда будете готовы.
Подробную информацию о создании пользовательских агентов см. в разделе «Создание управляемых агентов» .
Окружающая среда
Каждый вызов создает или повторно использует песочницу Linux. Параметр environment может принимать три формы:
| Форма | Описание |
|---|---|
"remote" | Создайте новую песочницу с настройками по умолчанию. |
"env_abc123" | Используйте существующую среду по идентификатору, сохранив все файлы и состояние. |
{...} | Полный файл EnvironmentConfig с пользовательскими источниками и сетевыми правилами. |
Подробную информацию об источниках (Git, GCS, встроенные системы), сети, жизненном цикле и ограничениях ресурсов см. в разделе «Окружения» .
Наличие и цены
Функция Antigravity Agent доступна в режиме предварительного просмотра через API Interactions в Google AI Studio и API Gemini.
Ценообразование основано на модели оплаты по мере использования, зависящей от базовых токенов модели Gemini и инструментов, используемых агентом. В отличие от стандартного запроса в чате, который выдает один результат, взаимодействие в Antigravity представляет собой агентский рабочий процесс. Один запрос запускает автономный цикл рассуждений, выполнения инструментов, запуска кода и управления файлами.
Ориентировочные затраты
Затраты варьируются в зависимости от сложности задачи. Агент самостоятельно определяет необходимое количество вызовов инструментов, выполнений кода и операций с файлами. Приведенные ниже оценки основаны на результатах выполнения.
| Категория задач | Входные токены | Выходные токены | Типичная стоимость |
|---|---|---|---|
| Исследования и обобщение информации | 100 тыс.–500 тыс. | 10k–40k | 0,30–1,00 долл. США |
| Создание документов и контента | 100 тыс.–500 тыс. | 15–50 тыс. | 0,30–1,30 долл. |
| Проектирование процессов и систем | 100 тыс.–400 тыс. | 10–30 тыс. | 0,25–0,80 долл. США |
| Обработка и анализ данных | 300к–3М | 30 тыс.–150 тыс. | 0,70–3,25 долл. США |
Как правило, 50–70% входных токенов кэшируются. Сложные агентные рабочие процессы с множеством вызовов инструментов могут накапливать 3–5 миллионов токенов за одно взаимодействие, что обходится примерно в 5 долларов.
В течение периода предварительного просмотра плата за вычислительные ресурсы среды (процессор, память, выполнение в песочнице) не взимается .
Ограничения
- Статус предварительного просмотра: Агент Antigravity и API Interactions находятся в режиме предварительного просмотра. Функции и схемы могут изменяться.
- Неподдерживаемая конфигурация генерации: следующие параметры не поддерживаются и возвращают ошибку 400:
temperature,top_p,top_k,stop_sequences,max_output_tokens. - Структурированный вывод: Агент Antigravity не поддерживает структурированный вывод.
- Недоступные инструменты:
file_search,computer_use,google_maps,function_callingиmcpпока не поддерживаются. - Инструмент для работы с файловой системой: В настоящий момент такого инструмента нет. Он является частью
environment. - Предыстория: Агент не поддерживает использование
background=Trueи требуетstore=True. - Неподдерживаемые типы мультимодальных данных. В настоящее время не поддерживаются аудио-, видео- и документные входные данные. Допускаются только текст и изображения.
Что дальше?
- Быстрый старт : многоэтапные диалоги и потоковая передача данных.
- Создание пользовательских агентов : пользовательские инструкции, навыки и сохранение агентов.
- Среда : конфигурация песочницы, источники, сеть.
- Deep Research Agent : выполнение длительных исследовательских задач.
- API для взаимодействия : базовый API.