Antigravity Agent

‫Antigravity agent هو وكيل مُدار للأغراض العامة على Gemini API. يمنحك طلب بيانات من واجهة برمجة التطبيقات وكيلاً يمكنه الاستدلال وتنفيذ الرموز البرمجية وإدارة الملفات وتصفُّح الويب داخل وضع الحماية الآمن الخاص بك على Linux الذي تستضيفه Google.

يستند هذا الوكيل إلى 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"
}'

الإمكانات

يمكن لكل طلب توفير وضع حماية على Linux وبدء حلقة استخدام الأدوات. يخطّط الوكيل ويتخذ إجراءات ويراقب النتائج ويكرّر العملية إلى أن تكتمل المهمة.

• تنفيذ الرموز البرمجية: يمكنك تشغيل أوامر Bash وPython وNode.js. وتثبيت الحِزم وتشغيل الاختبارات وإنشاء التطبيقات.
• إدارة الملفات: يمكنك قراءة الملفات وكتابتها وتعديلها والبحث عنها وإدراجها في وضع الحماية. وتظل الملفات محفوظة خلال التفاعلات.
• الوصول إلى الويب: يمكنك استخدام "بحث Google" وجلب عناوين URL للبيانات.
• ضغط السياق: يتم ضغط السياق تلقائيًا (عند بلوغ عدد الرموز 135 ألفًا تقريبًا) لدعم الجلسات الطويلة المتعددة بدون فقدان السياق أو بلوغ الحدود القصوى للرموز.

يمكنك الاطّلاع على دليل البدء السريع هنا لمعرفة كيفية استخدام المحادثات المتعددة والبيانات المتدفقة.

الأدوات المتوافقة

يتمكّن الوكيل تلقائيًا من الوصول إلى 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 agent مع الإدخالات المتعددة الوسائط. لا تتوافق هذه الميزة حاليًا إلا مع إدخالات text وimage. يجب تقديم الصور كسلاسل مضمّنة مشفّرة بترميز base64 (data).

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 agent من خلال تخصيص التعليمات والأدوات والبيئة. يتوافق الوكيل مع طريقة تخصيص نظام الملفات: يمكنك ربط ملفات مثل AGENTS.md للتعليمات والمهارات ضمن .agents/skills/ مباشرةً في وضع الحماية، أو تمرير الإعدادات المضمّنة في وقت التفاعل. يمكنك تكرار الإعدادات المضمّنة ثم حفظها كوكيل مُدار عندما تكون جاهزًا.

لمعرفة التفاصيل الكاملة حول كيفية إنشاء وكلاء مخصّصين، يُرجى الاطّلاع على مقالة إنشاء وكلاء مُدارين.

البيئات

ينشئ كل طلب وضع حماية على Linux أو يعيد استخدامه. تتخذ المَعلمة environment ثلاثة أشكال:

يمكنك الاطّلاع على البيئات لمعرفة التفاصيل حول المصادر (Git وGCS والمضمّنة) والشبكات ودورة الحياة والحدود القصوى للموارد.

التوفّر والأسعار

يتوفّر Antigravity agent في المعاينة من خلال Interactions API في Google AI Studio وGemini API.

تستند الأسعار إلى نموذج الدفع حسب الاستخدام استنادًا إلى رموز نموذج Gemini الأساسي والأدوات التي يستخدمها الوكيل. على عكس طلب المحادثة العادي الذي ينتج عنه ناتج واحد، يكون تفاعل Antigravity عبارة عن سير عمل للوكيل. ويؤدي طلب واحد إلى تشغيل حلقة مستقلة من الاستنتاج وتنفيذ الأدوات وتشغيل الرموز البرمجية وإدارة الملفات.

التكاليف المقدَّرة

تختلف التكاليف حسب مدى تعقيد المهمة. يحدّد الوكيل بشكل مستقل عدد طلبات الأدوات وعمليات تنفيذ الرموز البرمجية وعمليات الملفات المطلوبة. تستند التقديرات التالية إلى عمليات التشغيل.

عادةً ما يتم تخزين 50 إلى 70% من رموز الإدخال مؤقتًا. يمكن أن تؤدي عمليات سير عمل الوكيل المعقدة التي تتضمّن العديد من طلبات الأدوات إلى تجميع 3 إلى 5 ملايين رمز في تفاعل واحد، بتكاليف تصل إلى 5 دولارات أمريكية تقريبًا.

لا يتم تحصيل رسوم عن حوسبة البيئة (وحدة المعالجة المركزية والذاكرة وتنفيذ وضع الحماية) خلال فترة المعاينة.

القيود

• حالة المعاينة: يتوفّر Antigravity agent وInteractions API في المعاينة. وقد تتغيّر الميزات والمخططات.
• إعدادات الإنشاء غير المتوافقة: لا تتوافق هذه الميزة مع المَعلمات التالية وتعرض خطأ 400: temperature وtop_p وtop_k وstop_sequences وmax_output_tokens.
• ناتج منظَّم: لا يتوافق Antigravity agent مع النواتج المنظَّمة.
• الأدوات غير المتاحة: لا تتوافق هذه الميزة بعد مع file_search وcomputer_use وgoogle_maps وfunction_calling وmcp.
• أداة نظام الملفات: لا تتوفّر حاليًا أداة نظام الملفات. وهي جزء من environment.
• الخلفية: لا يتيح الوكيل استخدام background=True ويتطلب store=True.
• الأنواع المتعددة الوسائط غير المتوافقة لا تتوافق هذه الميزة حاليًا مع إدخالات الصوت والفيديو والمستندات. ويُسمح فقط بالنص والصورة.

الخطوات التالية

• دليل البدء السريع: المحادثات المتعددة والبيانات المتدفقة
• إنشاء وكلاء مخصّصين: التعليمات والمهارات المخصّصة وحفظ الوكلاء
• البيئات: إعداد وضع الحماية والمصادر والشبكات
• ‫Deep Research Agent: مهام البحث الطويلة
• ‫Interactions API: واجهة برمجة التطبيقات الأساسية