Agen Antigravity adalah agen terkelola serbaguna di Gemini API. Satu panggilan API memberi Anda agen yang dapat melakukan penalaran, mengeksekusi 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. Tersedia 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\"
}"
Menyesuaikan agen
Anda dapat memperluas agen Antigravity dengan menyesuaikan petunjuk, alat, dan lingkungannya. Agen mendukung pendekatan native sistem file untuk penyesuaian: Anda dapat memasang file seperti AGENTS.md untuk petunjuk dan keterampilan di bawah .agents/skills/ langsung ke sandbox, atau meneruskan konfigurasi inline pada waktu interaksi. Anda dapat melakukan iterasi pada konfigurasi inline, lalu menyimpannya sebagai agen terkelola saat Anda siap.
Untuk mengetahui detail lengkap tentang cara membuat agen kustom, lihat Membuat Agen Terkelola.
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 kustom dan aturan jaringan. |
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 penalaran, eksekusi alat, menjalankan kode, dan pengelolaan file.
Perkiraan biaya
Biaya bervariasi berdasarkan kompleksitas tugas. Agen secara otonom menentukan jumlah panggilan alat, eksekusi kode, dan operasi file yang diperlukan. Perkiraan berikut didasarkan pada proses.
| Kategori tugas | Token input | Token output | Biaya standar |
|---|---|---|---|
| Sintesis riset &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, danmcpbelum didukung. - Alat sistem file: Saat ini tidak ada alat sistem file. Alat ini merupakan bagian dari
environment. - Latar belakang: Agen tidak mendukung penggunaan
background=Truedan memerlukanstore=True. - Jenis multimodal yang tidak didukung. Input audio, video, dan dokumen saat ini tidak didukung. Hanya teks dan gambar yang diizinkan.
Langkah berikutnya
- Panduan memulai: percakapan multi-turn dan streaming.
- Membuat Agen Kustom: petunjuk, keterampilan kustom, dan menyimpan agen.
- Lingkungan: konfigurasi sandbox, sumber, jaringan.
- Agen Deep Research: tugas riset bentuk panjang.
- Interactions API: API yang mendasarinya.