Antigravity Agent

Antigravity ajanı, Gemini API'de genel amaçlı olarak yönetilen bir ajandır. Tek bir API çağrısı, Google tarafından barındırılan kendi güvenli Linux sanal alanınızda akıl yürüten, kod yürüten, dosyaları yöneten ve web'de gezinmenizi sağlayan bir aracı sunar.

Gemini 3.5 Flash tarafından desteklenir ve Antigravity IDE ile aynı koşum takımını kullanır. Bu API'yi Interactions API ve Google AI Studio üzerinden kullanabilirsiniz.

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);

REST

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"
}'

Özellikler

Her çağrı, bir Linux sanal alanı sağlayabilir ve araç kullanma döngüsünü başlatabilir. Aracı, görev tamamlanana kadar plan yapar, harekete geçer, sonuçları gözlemler ve tekrarlar.

  • Kod yürütme: Bash, Python ve Node.js komutlarını çalıştırın. Paketleri yükleyin, testleri çalıştırın ve uygulamalar oluşturun.
  • Dosya yönetimi: Korumalı alandaki dosyaları okuma, yazma, düzenleme, arama ve listeleme. Dosyalar, etkileşimler arasında korunur.
  • Web erişimi: Veriler için Google Arama ve URL getirme.
  • Bağlam sıkıştırma: Bağlamı kaybetmeden veya jeton sınırlarına ulaşmadan uzun süren, çok turlu oturumları desteklemek için otomatik bağlam sıkıştırma (~135 bin jetonda tetiklenir).

Çok turlu kullanım ve yayın için Hızlı Başlangıç bölümüne bakın.

Desteklenen araçlar

Varsayılan olarak, temsilci code_execution, google_search ve url_context uygulamalarına erişebilir. environment parametresini belirttiğinizde dosya sistemi araçları otomatik olarak etkinleştirilir. Varsayılan grubu özelleştirirken veya kısıtlarken yalnızca tools parametresini belirtmeniz gerekir:

Araç Değer türü Açıklama
Kod Yürütme code_execution stdout/stderr yakalama ile kabuk komutlarını (bash, Python, Node) çalıştırın.
Google Arama google_search Herkese açık web'de arama yapın.
URL Bağlamı url_context Web sayfalarını getirme ve okuma
Dosya sistemi (environment üzerinden etkinleştirilir) Korumalı alanda dosyaları okuma, yazma, düzenleme, arama ve listeleme Ayrı bir araç türü yoktur. environment ayarlandığında otomatik olarak etkinleştirilir.

Aracı belirli araçlarla sınırlamak için yalnızca ihtiyacınız olanları iletin:

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);

REST

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"}
    ]
}'

Çok formatlı giriş

Antigravity aracısı, çok formatlı girişleri destekler. Şu anda yalnızca text ve image girişleri desteklenmektedir. Resimler satır içi Base64 kodlu dizeler (data) olarak sağlanmalıdır.

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 });

REST

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\"
}"

Sistem talimatları

Satır içi istemler için system_instruction ile veya talimat dosyalarını ortama yerleştirerek aracının davranışını özelleştirin:

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);

REST

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."
}'

Aracı, talimat dosyalarını ortamdan otomatik olarak yükler:

  • AGENTS.md: .agents/ veya çalışma alanının kök dizininde bulunduğunda sistem talimatları olarak eklenir.
  • SKILL.md: .agents/skills/ kaynağından yüklenir ve temsilcinin çağırabileceği özellikler olarak kaydedilir.

Örneğin:

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);

REST

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..."
            }
        ]
    }
}'

Tam temsilci tanımı biçimi ve yeniden kullanılabilir adlandırılmış temsilciler için Özel Temsilciler Oluşturma bölümüne bakın.

Ortam

Her çağrı, bir Linux sanal alanı oluşturur veya yeniden kullanır. environment parametresi üç biçimde olabilir:

Form Açıklama
"remote" Varsayılan ayarlarla yeni bir korumalı alan sağlayın.
"env_abc123" Tüm dosyaları ve durumu koruyarak mevcut bir ortamı kimliğe göre yeniden kullanın.
{...} Özel kaynaklar ve ağ kurallarıyla tam EnvironmentConfig

Kaynaklar (Git, GCS, satır içi), ağ, yaşam döngüsü ve kaynak sınırları hakkında ayrıntılı bilgi için Ortamlar başlıklı makaleyi inceleyin.

Kullanılabilirlik ve fiyatlandırma

Antigravity aracısı, Google AI Studio'daki Interactions API ve Gemini API üzerinden önizleme olarak kullanılabilir.

Fiyatlandırma, temel Gemini model jetonlarına ve aracının kullandığı araçlara dayalı kullandıkça öde modeline göre belirlenir. Tek bir çıktı üreten standart bir sohbet isteğinin aksine, Antigravity etkileşimi, aracı tabanlı bir iş akışıdır. Tek bir istek, muhakeme, araç yürütme, kod çalıştırma ve dosya yönetimi gibi işlemleri içeren bağımsız bir döngüyü tetikler.

Tahmini maliyetler

Maliyetler, görevin karmaşıklığına göre değişir. Aracı, kaç araç çağrısı, kod yürütme ve dosya işlemi gerektiğini bağımsız olarak belirler. Aşağıdaki tahminler, çalıştırmalara dayanmaktadır.

Görev kategorisi Giriş jetonları Çıkış jetonları Normal maliyet
Araştırma ve bilgi sentezi 100 bin - 500 bin 10 bin-40 bin 0,30-1,00 ABD doları
Doküman ve içerik oluşturma 100 bin - 500 bin 15.000-50.000 0,30-1,30 ABD doları
Süreç ve sistem tasarımı 100 bin - 400 bin 10.000-30.000 0,25-0,80 ABD doları
Veri işleme ve analiz 300.000-3.000.000 30 bin - 150 bin 0,70-3,25 ABD doları

Giriş jetonlarının% 50-70'i genellikle önbelleğe alınır. Çok sayıda araç çağrısı içeren karmaşık aracı iş akışları, tek bir etkileşimde 3-5 milyon jeton biriktirebilir ve maliyeti yaklaşık 5 ABD dolarına kadar çıkabilir.

Önizleme döneminde ortam işlem (CPU, bellek, korumalı alan yürütme) için ücret alınmaz.

Sınırlamalar

  • Önizleme durumu: Antigravity aracısı ve Etkileşimler API'si önizleme aşamasındadır. Özellikler ve şemalar değişebilir.
  • Desteklenmeyen oluşturma yapılandırması: Aşağıdaki parametreler desteklenmez ve 400 hatası döndürür: temperature, top_p, top_k, stop_sequences, max_output_tokens.
  • Yapılandırılmış çıkış: Antigravity aracısı, yapılandırılmış çıkışları desteklemez.
  • Kullanılamayan araçlar: file_search, computer_use, google_maps, function_calling ve mcp henüz desteklenmemektedir.
  • Dosya sistemi aracı: Şu anda dosya sistemi aracı yok. Bu, environment'nın bir parçasıdır.
  • Arka plan: Temsilci, background=True kullanımını desteklemiyor ve store=True gerektiriyor.
  • Desteklenmeyen çok formatlı türler. Ses, video ve doküman girişleri şu anda desteklenmemektedir. Yalnızca metin ve resimlere izin verilir.

Sırada ne var?