Agen Antigravitasi

Agen Antigravity adalah agen terkelola serbaguna di Gemini API. Dengan satu panggilan API, Anda akan mendapatkan agen yang dapat memberikan alasan, menjalankan kode, mengelola file, dan menjelajahi web di dalam sandbox Linux aman Anda sendiri, yang dihosting oleh Google.

Agen ini didukung oleh Gemini 3.5 Flash dan menggunakan harness yang sama dengan Antigravity IDE. Anda dapat menggunakannya melalui Interactions API dan 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);

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

Kemampuan

Setiap panggilan dapat menyediakan sandbox Linux dan memulai loop penggunaan alat. Agen merencanakan, bertindak, mengamati hasil, dan mengulanginya hingga tugas selesai.

  • Eksekusi kode: Menjalankan perintah Bash, Python, dan Node.js. Menginstal paket, menjalankan pengujian, membuat aplikasi.
  • Pengelolaan file: Membaca, menulis, mengedit, menelusuri, dan mencantumkan file di sandbox. File tetap ada di seluruh interaksi.
  • Akses web: Google Penelusuran dan pengambilan URL untuk data.
  • Pemadatan konteks: Pemadatan konteks otomatis (dipicu pada ~135 ribu token) untuk mendukung sesi multi-turn yang berjalan lama tanpa kehilangan konteks atau mencapai batas token.

Lihat Panduan Memulai untuk penggunaan multi-turn dan streaming.

Alat yang didukung

Secara default, agen memiliki akses ke code_execution, google_search, dan url_context. Alat sistem file diaktifkan secara otomatis saat Anda menentukan parameter environment. Anda hanya perlu menentukan parameter tools saat menyesuaikan atau membatasi setelan default:

Alat Nilai jenis Deskripsi
Mengeksekusi kode code_execution Menjalankan perintah shell (bash, Python, Node) dengan pengambilan stdout/stderr.
Google Penelusuran google_search Menelusuri web publik.
Konteks URL url_context Mengambil dan membaca halaman web.
Filesystem (diaktifkan melalui environment) Membaca, menulis, mengedit, menelusuri, dan mencantumkan file di sandbox. Tidak ada jenis alat terpisah — diaktifkan secara otomatis saat environment ditetapkan.

Untuk membatasi agen ke alat tertentu, teruskan hanya alat yang Anda butuhkan:

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

Input Multimodal

Agen Antigravity mendukung input multimodal. Saat ini, hanya input text dan image yang didukung. Gambar harus diberikan sebagai string berenkode base64 inline (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 });

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

Petunjuk sistem

Sesuaikan perilaku agen dengan system_instruction untuk perintah inline, atau dengan memasang file petunjuk ke dalam lingkungan:

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

Agen akan otomatis memuat file petunjuk dari lingkungan:

  • AGENTS.md: Ditambahkan sebagai petunjuk sistem saat ditemukan di .agents/ atau root ruang kerja.
  • SKILL.md: Dimuat dari .agents/skills/ dan didaftarkan sebagai kemampuan yang dapat dipanggil oleh agen.

Contoh:

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

Lihat Membangun Agen Kustom untuk mengetahui format definisi agen lengkap dan agen bernama yang dapat digunakan kembali.

Lingkungan

Setiap panggilan membuat atau menggunakan kembali sandbox Linux. Parameter environment memiliki tiga bentuk:

Bentuk Deskripsi
"remote" Menyediakan sandbox baru dengan setelan default.
"env_abc123" Menggunakan kembali lingkungan yang ada berdasarkan ID, dengan mempertahankan semua file dan status.
{...} EnvironmentConfig lengkap dengan sumber dan aturan jaringan kustom.

Lihat Lingkungan untuk mengetahui detail tentang sumber (Git, GCS, inline), jaringan, siklus proses, dan batas resource.

Ketersediaan dan harga

Agen Antigravity tersedia dalam pratinjau melalui Interactions API di Google AI Studio dan Gemini API.

Harga mengikuti model bayar sesuai penggunaan berdasarkan token model Gemini yang mendasarinya dan alat yang digunakan agen. Tidak seperti permintaan chat standar yang menghasilkan satu output, interaksi Antigravity adalah alur kerja agen. Satu permintaan memicu loop otonom dari penalaran, eksekusi alat, menjalankan kode, dan pengelolaan file.

Perkiraan biaya

Biaya bervariasi berdasarkan kompleksitas tugas. Agen secara otonom menentukan berapa banyak panggilan alat, eksekusi kode, dan operasi file yang diperlukan. Estimasi berikut didasarkan pada proses.

Kategori tugas Token input Token output Biaya standar
Penelitian &sintesis informasi 100 ribu–500 ribu 10 ribu–40 ribu $0,30–$1,00
Pembuatan dokumen &konten 100 ribu–500 ribu 15 ribu–50 ribu $0,30–$1,30
Desain proses &sistem 100 ribu–400 ribu 10 ribu–30 ribu $0,25–$0,80
Pemrosesan &analisis data 300 ribu–3 juta 30 ribu–150 ribu $0,70–$3,25

50–70% token input biasanya di-cache. Alur kerja agen yang kompleks dengan banyak panggilan alat dapat mengakumulasikan 3–5 juta token dalam satu interaksi, dengan biaya hingga ~$5.

Komputasi lingkungan (CPU, memori, eksekusi sandbox) tidak ditagih selama periode pratinjau.

Batasan

  • Status pratinjau: Agen Antigravity dan Interactions API berada dalam pratinjau. Fitur dan skema dapat berubah.
  • Konfigurasi pembuatan yang tidak didukung: Parameter berikut tidak didukung dan menampilkan error 400: temperature, top_p, top_k, stop_sequences, max_output_tokens.
  • Output terstruktur: Agen Antigravity tidak mendukung output terstruktur.
  • Alat yang tidak tersedia: file_search, computer_use, google_maps, function_calling, dan mcp belum didukung.
  • Alat sistem file: Saat ini tidak ada alat sistem file. Alat ini adalah bagian dari environment.
  • Latar belakang: Agen tidak mendukung penggunaan background=True dan memerlukan store=True.
  • Jenis multimodal yang tidak didukung. Input audio, video, dan dokumen saat ini tidak didukung. Hanya teks dan gambar yang diizinkan.

Langkah berikutnya