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

הוראות מערכת

אפשר להתאים אישית את ההתנהגות של הסוכן באמצעות 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);

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

הסוכן טוען באופן אוטומטי קובצי הוראות מהסביבה:

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

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

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

סביבה

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

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