عامل Antigravity یک عامل مدیریتشدهی همهمنظوره در رابط برنامهنویسی Gemini است. یک فراخوانی API به شما عاملی میدهد که در داخل جعبهی شنی امن لینوکس شما که توسط گوگل میزبانی میشود، استدلال میکند، کد را اجرا میکند، فایلها را مدیریت میکند و وب را مرور میکند.
این برنامه توسط Gemini 3.7 Flash پشتیبانی میشود و از همان سیستم Antigravity IDE استفاده میکند. میتوانید مدل Gemini را با استفاده agent_config پیکربندی کنید. این سیستم از طریق Interactions API و Google AI Studio در دسترس است.
پایتون
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)
جاوا اسکریپت
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);
استراحت
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"
}'
قابلیتها
هر تماس میتواند یک سندباکس لینوکس را فراهم کند و یک حلقه استفاده از ابزار را آغاز کند. عامل برنامهریزی میکند، عمل میکند، نتایج را مشاهده میکند و تا زمانی که کار انجام شود، تکرار میکند.
- اجرای کد: اجرای دستورات Bash، Python و Node.js. نصب بستهها، اجرای تستها، ساخت برنامهها.
- مدیریت فایل: خواندن، نوشتن، ویرایش، جستجو و فهرست کردن فایلها در محیط سندباکس. فایلها در تعاملات مختلف باقی میمانند.
- دسترسی به وب: جستجوی گوگل و دریافت دادهها از طریق URL.
- فشردهسازی متن: فشردهسازی خودکار متن (در حدود ۱۳۵ هزار توکن فعال میشود) برای پشتیبانی از جلسات طولانی مدت و چند نوبتی بدون از دست دادن متن یا رسیدن به محدودیتهای توکن.
برای استفاده چند نوبتی و پخش جریانی، به شروع سریع مراجعه کنید.
ابزارهای پشتیبانی شده
به طور پیشفرض، عامل به code_execution ، google_search و url_context دسترسی دارد. ابزارهای سیستم فایل به طور خودکار هنگام تعیین پارامتر environment فعال میشوند. همچنین میتوانید توابع سفارشی را برای اتصال عامل به APIها و ابزارهای خود تعریف کنید. فقط هنگام سفارشیسازی یا محدود کردن مجموعه پیشفرض یا هنگام اضافه کردن توابع سفارشی، باید پارامتر tools را مشخص کنید.
| ابزار | مقدار نوع | توضیحات |
|---|---|---|
| اجرای کد | code_execution | اجرای دستورات پوسته (bash، Python، Node) با ضبط stdout/stderr. |
| جستجوی گوگل | google_search | در وب عمومی جستجو کنید. |
| متن URL | url_context | صفحات وب را دریافت و مطالعه کنید. |
| سیستم فایل | (از طریق environment فعال میشود) | خواندن، نوشتن، ویرایش، جستجو و فهرست کردن فایلها در محیط سندباکس. سیستم این ابزارها را به طور خودکار هنگام تنظیم environment فعال میکند. |
| توابع سفارشی | function | توابع سفارشی را تعریف کنید که عامل میتواند درخواست اجرای آنها را داشته باشد. به فراخوانی تابع مراجعه کنید. |
| سرور MCP از راه دور | mcp_server | سرورهای پروتکل زمینه مدل (MCP) خارجی را به عنوان ابزار ثبت کنید. به سرورهای MCP مراجعه کنید. |
شما میتوانید اجرای code_execution و ابزار filesystem را مستقیماً درون sandbox از راه دور با استفاده از Hookهای همگام رهگیری و اعتبارسنجی کنید.
برای محدود کردن عامل به ابزارهای خاص، فقط ابزارهای مورد نیاز خود را ارسال کنید:
پایتون
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)
جاوا اسکریپت
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);
استراحت
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": "Search for the latest AI research papers on reasoning and summarize them.",
"environment": "remote",
"tools": [
{"type": "google_search"},
{"type": "url_context"}
]
}'
ورودی چندوجهی
عامل Antigravity از ورودیهای چندوجهی پشتیبانی میکند. در حال حاضر، فقط ورودیهای text و image پشتیبانی میشوند. تصاویر باید به صورت رشتههای ( data ) کدگذاری شده با base64 درونخطی ارائه شوند.
پایتون
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",
},