عامل Antigravity یک عامل مدیریتشدهی همهمنظوره در رابط برنامهنویسی Gemini است. یک فراخوانی API به شما عاملی میدهد که در داخل جعبهی شنی امن لینوکس شما که توسط گوگل میزبانی میشود، استدلال میکند، کد را اجرا میکند، فایلها را مدیریت میکند و وب را مرور میکند.
این برنامه توسط Gemini 3.5 Flash پشتیبانی میشود و از همان سیستم Antigravity IDE استفاده میکند. میتوانید از طریق 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" \
-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"
}'
قابلیتها
هر تماس میتواند یک سندباکس لینوکس را فراهم کند و یک حلقه استفاده از ابزار را آغاز کند. عامل برنامهریزی میکند، عمل میکند، نتایج را مشاهده میکند و تا زمانی که کار انجام شود، تکرار میکند.
- اجرای کد: اجرای دستورات Bash، Python و Node.js. نصب بستهها، اجرای تستها، ساخت برنامهها.
- مدیریت فایل: خواندن، نوشتن، ویرایش، جستجو و فهرست کردن فایلها در محیط سندباکس. فایلها در تعاملات مختلف باقی میمانند.
- دسترسی به وب: جستجوی گوگل و دریافت دادهها از طریق URL.
- فشردهسازی متن: فشردهسازی خودکار متن (در حدود ۱۳۵ هزار توکن فعال میشود) برای پشتیبانی از جلسات طولانی مدت و چند نوبتی بدون از دست دادن متن یا رسیدن به محدودیتهای توکن.
برای استفاده چند نوبتی و پخش جریانی، به شروع سریع مراجعه کنید.
ابزارهای پشتیبانی شده
به طور پیشفرض، عامل به code_execution ، google_search و url_context دسترسی دارد. ابزارهای سیستم فایل به طور خودکار هنگام تعیین پارامتر environment فعال میشوند. شما فقط باید هنگام سفارشیسازی یا محدود کردن مجموعه پیشفرض، پارامتر tools را مشخص کنید:
| ابزار | مقدار نوع | توضیحات |
|---|---|---|
| اجرای کد | code_execution | اجرای دستورات پوسته (bash، Python، Node) با ضبط stdout/stderr. |
| جستجوی گوگل | google_search | در وب عمومی جستجو کنید. |
| متن URL | url_context | صفحات وب را دریافت و مطالعه کنید. |
| سیستم فایل | (از طریق environment فعال میشود) | خواندن، نوشتن، ویرایش، جستجو و فهرست کردن فایلها در محیط سندباکس. بدون نوع ابزار جداگانه - به طور خودکار با تنظیم environment فعال میشود. |
برای محدود کردن عامل به ابزارهای خاص، فقط ابزارهای مورد نیاز خود را ارسال کنید:
پایتون
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" \
-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 پشتیبانی میشوند. تصاویر باید به صورت رشتههای ( 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",
},
],
environment="remote",
)
جاوا اسکریپت
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 });
استراحت
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 برای اعلانهای درونخطی یا با نصب فایلهای دستورالعمل در محیط، سفارشی کنید:
پایتون
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)
جاوا اسکریپت
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);
استراحت
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/بارگذاری شده و به عنوان قابلیتهایی که عامل میتواند فراخوانی کند، ثبت شده است.
برای مثال:
پایتون
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)
جاوا اسکریپت
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);
استراحت
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..."
}
]
}
}'
برای قالب کامل تعریف عامل و عاملهای نامگذاریشدهی قابل استفادهی مجدد، به بخش «ساخت عاملهای سفارشی» مراجعه کنید.
محیطها
هر فراخوانی یک سندباکس لینوکس ایجاد یا دوباره استفاده میکند. پارامتر environment سه شکل دارد:
| فرم | توضیحات |
|---|---|
"remote" | یک سندباکس جدید با تنظیمات پیشفرض فراهم کنید. |
"env_abc123" | استفاده مجدد از یک محیط موجود بر اساس شناسه، با حفظ تمام فایلها و وضعیت. |
{...} | پیکربندی کامل EnvironmentConfig با منابع سفارشی و قوانین شبکه. |
برای جزئیات بیشتر در مورد منابع (Git، GCS، درونخطی)، شبکهسازی، چرخه حیات و محدودیتهای منابع، به بخش محیطها مراجعه کنید.
موجودی و قیمتگذاری
عامل ضد جاذبه از طریق Interactions API در Google AI Studio و Gemini API به صورت پیشنمایش در دسترس است.
قیمتگذاری از یک مدل پرداخت به ازای استفاده پیروی میکند که بر اساس توکنهای مدل Gemini و ابزارهایی که عامل استفاده میکند، میباشد. برخلاف یک درخواست چت استاندارد که یک خروجی واحد تولید میکند، تعامل Antigravity یک گردش کار عاملمحور است. یک درخواست واحد، یک حلقه مستقل از استدلال، اجرای ابزار، اجرای کد و مدیریت فایل را فعال میکند.
هزینههای تخمینی
هزینهها بر اساس پیچیدگی وظیفه متفاوت است. عامل به طور خودکار تعداد فراخوانیهای ابزار، اجرای کد و عملیات فایل مورد نیاز را تعیین میکند. تخمینهای زیر بر اساس اجراها هستند.
| دسته بندی وظایف | توکنهای ورودی | توکنهای خروجی | هزینه معمول |
|---|---|---|---|
| تحقیق و ترکیب اطلاعات | ۱۰۰ هزار تا ۵۰۰ هزار | ۱۰ هزار تا ۴۰ هزار | ۰.۳۰ تا ۱.۰۰ دلار |
| تولید سند و محتوا | ۱۰۰ هزار تا ۵۰۰ هزار | ۱۵ هزار تا ۵۰ هزار | ۰.۳۰ تا ۱.۳۰ دلار |
| طراحی فرآیند و سیستم | ۱۰۰ هزار تا ۴۰۰ هزار | ۱۰ هزار تا ۳۰ هزار | ۰.۲۵ تا ۰.۸۰ دلار |
| پردازش و تحلیل دادهها | ۳۰۰ هزار تا ۳ میلیون | ۳۰ هزار تا ۱۵۰ هزار | ۰.۷۰ تا ۳.۲۵ دلار |
۵۰ تا ۷۰ درصد از توکنهای ورودی معمولاً ذخیره میشوند. گردشهای کاری پیچیده با فراخوانیهای ابزار زیاد میتوانند ۳ تا ۵ میلیون توکن را در یک تعامل واحد جمعآوری کنند که هزینهای تا حدود ۵ دلار دارد.
محاسبات محیطی (پردازنده، حافظه، اجرای سندباکس) در طول دوره پیشنمایش هزینهای دریافت نمیکند .
محدودیتها
- وضعیت پیشنمایش: عامل ضد جاذبه و API تعاملات در پیشنمایش هستند. ویژگیها و طرحوارهها ممکن است تغییر کنند.
- پیکربندی نسل پشتیبانی نشده: پارامترهای زیر پشتیبانی نمیشوند و خطای ۴۰۰ را برمیگردانند:
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نیاز دارد. - انواع چندوجهی پشتیبانی نمیشوند. ورودیهای صدا، ویدئو و سند در حال حاضر پشتیبانی نمیشوند. فقط متن و تصویر مجاز هستند.
قدم بعدی چیست؟
- مرور کلی عاملها : با مفاهیم اصلی عاملهای مدیریتشده آشنا شوید.
- شروع سریع : شروع به ساختن با مکالمات و پخش جریانی چند نوبته کنید.
- محیطهای عامل : پیکربندی جعبههای شنی، منابع و شبکه.
- ساخت عاملهای سفارشی : عاملهای خودتان را با استفاده از
AGENTS.mdوSKILL.mdتعریف کنید.