عامل ضد جاذبه

عامل 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 را مشخص کنید.

برای محدود کردن عامل به ابزارهای خاص، فقط ابزارهای مورد نیاز خود را ارسال کنید:

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

سفارشی‌سازی عامل

شما می‌توانید عامل Antigravity را با سفارشی‌سازی دستورالعمل‌ها، ابزارها و محیط آن گسترش دهید. این عامل از رویکرد بومی سیستم فایل برای سفارشی‌سازی پشتیبانی می‌کند: می‌توانید فایل‌هایی مانند AGENTS.md را برای دستورالعمل‌ها و مهارت‌ها تحت .agents/skills/ مستقیماً در sandbox مانت کنید، یا پیکربندی را به صورت درون‌خطی در زمان تعامل منتقل کنید. می‌توانید پیکربندی خود را به صورت درون‌خطی تکرار کنید و سپس وقتی آماده شدید، آن را به عنوان یک عامل مدیریت‌شده ذخیره کنید.

برای جزئیات کامل در مورد نحوه ساخت عامل‌های سفارشی، به بخش «ساخت عامل‌های مدیریت‌شده» مراجعه کنید.

محیط‌ها

هر فراخوانی یک سندباکس لینوکس ایجاد یا دوباره استفاده می‌کند. پارامتر environment سه شکل دارد:

برای جزئیات بیشتر در مورد منابع (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 نیاز دارد.
• انواع چندوجهی پشتیبانی نمی‌شوند. ورودی‌های صدا، ویدئو و سند در حال حاضر پشتیبانی نمی‌شوند. فقط متن و تصویر مجاز هستند.

قدم بعدی چیست؟

• شروع سریع : مکالمات و پخش چند مرحله‌ای.
• ساخت عوامل سفارشی : دستورالعمل‌ها، مهارت‌ها و عوامل صرفه‌جویی سفارشی
• محیط‌ها : پیکربندی سندباکس، منابع، شبکه.
• عامل تحقیقات عمیق : وظایف تحقیقاتی طولانی مدت.
• API تعاملات : API زیربنایی.