סוכן Antigravity הוא סוכן מנוהל לשימוש כללי ב-Gemini API. קריאה אחת ל-API מספקת לכם סוכן שמבצע ניתוח, מריץ קוד, מנהל קבצים ומחפש באינטרנט בתוך ארגז חול מאובטח של Linux, שמתארח ב-Google.
הוא מבוסס על Gemini 3.6 Flash ומשתמש באותו מנגנון כמו Antigravity IDE. אתם יכולים להגדיר את מודל Gemini הבסיסי באמצעות agent_config. זמין דרך 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" \
-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. אפשר גם להגדיר פונקציות מותאמות אישית כדי לחבר את הסוכן לממשקי ה-API ולכלים שלכם. צריך לציין את הפרמטר tools רק כשמתאימים אישית את קבוצת ברירת המחדל או מגבילים אותה, או כשמוסיפים פונקציות מותאמות אישית.
| כלי | הקלדת ערך | תיאור |
|---|---|---|
| הרצת קוד | code_execution |
הרצת פקודות של מעטפת (bash, Python, Node) עם לכידה של stdout/stderr. |
| חיפוש Google | google_search |
חיפוש באינטרנט הציבורי. |
| URL Context | url_context |
אחזור וקריאה של דפי אינטרנט. |
| מערכת קבצים | (הופעל באמצעות environment) |
קריאה, כתיבה, עריכה, חיפוש ורישום של קבצים בארגז החול. המערכת מפעילה את הכלים האלה באופן אוטומטי כשמגדירים את environment. |
| פונקציות מותאמות אישית | function |
הגדרת פונקציות בהתאמה אישית שהסוכן יכול לבקש להפעיל. מידע נוסף מופיע במאמר בנושא בקשה להפעלת פונקציה. |
| שרת MCP מרוחק | mcp_server |
רישום שרתים חיצוניים של Model Context Protocol (MCP) ככלים. מידע נוסף מופיע בקטע שרתי MCP. |
אתם יכולים ליירט ולאמת את ההרצה של כלי code_execution ו-filesystem ישירות בארגז החול המרוחק באמצעות Hooks סינכרוניים.
כדי להגביל את הסוכן לכלים ספציפיים, מעבירים רק את הכלים שצריך:
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"