Antigravity Agent

סוכן Antigravity הוא סוכן מנוהל לשימוש כללי ב-Gemini API. קריאה אחת ל-API מספקת לכם סוכן שמנמק, מבצע קוד, מנהל קבצים ומבצע חיפוש באינטרנט בתוך ארגז חול מאובטח של Linux, שמארחת Google.

הוא מבוסס על Gemini 3.5 Flash ומשתמש באותו מנגנון כמו 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);

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

יכולות

כל שיחה יכולה להקצות ארגז חול של Linux ולהתחיל לולאה של שימוש בכלי. הסוכן מתכנן, פועל, בודק את התוצאות וחוזר על הפעולות עד שהמשימה מסתיימת.

  • הרצת קוד: הרצת פקודות Bash,‏ Python ו-Node.js. להתקין חבילות, להריץ בדיקות ולפתח אפליקציות.
  • ניהול קבצים: קריאה, כתיבה, עריכה, חיפוש ורישום של קבצים בארגז החול. הקבצים נשמרים בין אינטראקציות.
  • גישה לאינטרנט: חיפוש ב-Google ואחזור כתובות URL של נתונים.
  • דחיסת הקשר: דחיסת הקשר אוטומטית (מופעלת בערך ב-135, 000 טוקנים) כדי לתמוך בסשנים ארוכים עם כמה תורות בלי לאבד את ההקשר או להגיע למגבלות הטוקנים.

במדריך למתחילים מוסבר איך להשתמש בסטרימינג ובשיחות מרובות תגובות.

כלים נתמכים

כברירת מחדל, לסוכן יש גישה אל code_execution, אל google_search ואל url_context. הכלים של מערכת הקבצים מופעלים באופן אוטומטי כשמציינים את הפרמטר environment. צריך לציין את הפרמטר tools רק כשמבצעים התאמה אישית או הגבלה של קבוצת ברירת המחדל.

כלי הקלדת ערך תיאור
הרצת קוד code_execution הרצת פקודות של מעטפת (bash, ‏ Python, ‏ Node) עם לכידה של stdout/stderr.
חיפוש 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);

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

קלט מרובה מצבים

הסוכן 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 });

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

התאמה אישית של הסוכן

אפשר להרחיב את סוכן Antigravity על ידי התאמה אישית של ההוראות, הכלים והסביבה שלו. הסוכן תומך בגישה מקורית למערכת הקבצים להתאמה אישית: אפשר לטעון קבצים כמו AGENTS.md להוראות ולמיומנויות ב-.agents/skills/ ישירות לארגז החול, או להעביר את ההגדרות בתוך שורה במועד האינטראקציה. אפשר לשנות את ההגדרה ישירות בטקסט ואז לשמור אותה כסוכן מנוהל כשמוכנים.

לפרטים מלאים על בניית סוכנים בהתאמה אישית, אפשר לעיין במאמר בנושא בניית סוכנים מנוהלים.

סביבה

כל קריאה יוצרת ארגז חול של Linux או משתמשת בארגז חול קיים. הפרמטר environment מופיע בשלוש צורות:

טופס תיאור
"remote" הקצאת ארגז חול חדש עם הגדרות ברירת מחדל.
"env_abc123" אפשר לעשות שימוש חוזר בסביבה קיימת לפי מזהה, ולשמור את כל הקבצים והמצב.
{...} מלא EnvironmentConfig עם מקורות מותאמים אישית וכללי רשת.

פרטים על מקורות (Git,‏ GCS,‏ inline), רשתות, מחזור חיים ומגבלות משאבים זמינים במאמר סביבות.

זמינות ומחירים

סוכן Antigravity זמין בגרסת טרום-השקה דרך Interactions API ב-Google AI Studio וב-Gemini API.

התמחור מבוסס על מודל של תשלום לפי שימוש, על סמך הטוקנים של מודל Gemini הבסיסי והכלים שבהם הסוכן משתמש. בניגוד לבקשה רגילה לצ'אט שמניבה פלט יחיד, אינטראקציה עם Antigravity היא תהליך עבודה מבוסס-סוכן. בקשה אחת מפעילה לולאה אוטונומית של ניתוח, הפעלת כלי, הרצת קוד וניהול קבצים.

עלויות משוערות

העלויות משתנות בהתאם למורכבות המשימה. הסוכן קובע באופן אוטונומי כמה קריאות לכלים, הפעלות קוד ופעולות על קבצים נדרשות. האומדנים הבאים מבוססים על הרצות.

קטגוריית משימה טוקנים של קלט טוקנים של פלט עלות רגילה
מחקר וסינתזת מידע ‫100,000–500,000 ‫10,000 עד 40,000 ‫0.30$ – 1.00$
יצירת מסמכים ותוכן ‫100,000–500,000 ‫15,000–50,000 ‫0.30$ – 1.30$
עיצוב תהליכים ומערכות ‫100,000–400,000 ‫10,000 עד 30,000 ‫0.25$-0.80$
עיבוד וניתוח נתונים ‫300,000 עד 3 מיליון ‫30,000–150,000 ‫0.70$ – 3.25$

בדרך כלל, 50-70% מאסימוני הקלט נשמרים במטמון. בתהליכי עבודה מורכבים שמבוססים על סוכנים וכוללים הרבה קריאות לכלים, יכולים להצטבר 3-5 מיליון טוקנים באינטראקציה אחת, והעלויות יכולות להגיע ל-5$.

החישוב של הסביבה (CPU, זיכרון, הרצה בארגז חול) לא מחויב במהלך תקופת התצוגה המקדימה.

מגבלות

  • סטטוס גרסת הבטא: נציג Antigravity ו-Interactions API נמצאים בגרסת בטא. יכול להיות שיהיו שינויים בתכונות ובסכימות.
  • הגדרת יצירה לא נתמכת: הפרמטרים הבאים לא נתמכים ומחזירים שגיאה 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.
  • סוגים לא נתמכים של נתונים מרובי-אופנים. בשלב הזה אין תמיכה בקלט של אודיו, וידאו ומסמכים. מותר להשתמש רק בטקסט ובתמונה.

המאמרים הבאים