Антигравитационный агент

Агент 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\"
}"

Системные инструкции

Настройте поведение агента с помощью system_instruction для ввода подсказок непосредственно в код, или путем монтирования файлов инструкций в среду выполнения:

Python 

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Analyze the uploaded CSV and create a report.",
    environment="remote",
    system_instruction="You are a data analyst. Always include visualizations and export results as PDF.",
)

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: "Analyze the uploaded CSV and create a report.",
    environment: "remote",
    system_instruction: "You are a data analyst. Always include visualizations and export results as PDF.",
}, { 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": "Analyze the uploaded CSV and create a report.",
    "environment": "remote",
    "system_instruction": "You are a data analyst. Always include visualizations and export results as PDF."
}'

Агент автоматически загружает файлы инструкций из среды выполнения:

  • AGENTS.md : Добавляется в качестве системных инструкций, если находится в папке .agents/ или в корневом каталоге рабочей области.
  • SKILL.md : Загружается из .agents/skills/ и регистрируется как возможности, которые может вызывать агент.

Например:

Python 

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Analyze the Q1 revenue data and create a slide deck.",
    environment={
        "type": "remote",
        "sources": [
            {
                "type": "inline",
                "target": ".agents/AGENTS.md",
                "content": "You are a data analyst. Always use matplotlib for charts.",
            },
            {
                "type": "inline",
                "target": ".agents/skills/slide-maker/SKILL.md",
                "content": "---\nname: slide-maker\n---\n# Slide Maker\nCreate HTML slide decks...",
            },
        ],
    },
)

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: "Analyze the Q1 revenue data and create a slide deck.",
    environment: {
        type: "remote",
        sources: [
            {
                type: "inline",
                target: ".agents/AGENTS.md",
                content: "You are a data analyst. Always use matplotlib for charts.",
            },
            {
                type: "inline",
                target: ".agents/skills/slide-maker/SKILL.md",
                content: "---\nname: slide-maker\n---\n# Slide Maker\nCreate HTML slide decks...",
            },
        ],
    },
}, { 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: $API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Analyze the Q1 revenue data and create a slide deck.",
    "environment": {
        "type": "remote",
        "sources": [
            {
                "type": "inline",
                "target": ".agents/AGENTS.md",
                "content": "You are a data analyst. Always use matplotlib for charts."
            },
            {
                "type": "inline",
                "target": ".agents/skills/slide-maker/SKILL.md",
                "content": "---\nname: slide-maker\n---\n# Slide Maker\nCreate HTML slide decks..."
            }
        ]
    }
}'

Полный формат определения агентов и список многократно используемых именованных агентов см. в разделе «Создание пользовательских агентов» .

Окружающая среда

Каждый вызов создает или повторно использует песочницу 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 .
  • Структурированный вывод: Агент «Антигравитация» не поддерживает структурированный вывод.
  • Недоступные инструменты: file_search , computer_use , google_maps , function_calling и mcp пока не поддерживаются.
  • Инструмент для работы с файловой системой: В настоящий момент такого инструмента нет. Он является частью environment .
  • Предыстория: Агент не поддерживает использование background=True и требует store=True .
  • Неподдерживаемые типы мультимодальных данных. В настоящее время не поддерживаются аудио-, видео- и документные входные данные. Допускаются только текст и изображения.

Что дальше?