Antigravity Agent

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

تستند هذه الأداة إلى Gemini 3.5 Flash وتستخدم الإطار نفسه الذي تستخدمه بيئة التطوير المتكاملة Antigravity. يمكنك استخدامها من خلال واجهة 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" \
-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 عند تخصيص المجموعة التلقائية أو حصرها:

الأداة نوع القيمة الوصف
تنفيذ الرموز البرمجية code_execution تنفيذ أوامر shell (مثل bash وPython وNode) مع إمكانية تسجيل stdout/stderr
بحث Google google_search البحث في شبكة الويب المتاحة للجميع
سياق عنوان URL url_context جلب صفحات الويب وقراءتها
نظام الملفات (يتم تفعيلها من خلال environment) قراءة الملفات وكتابتها وتعديلها والبحث فيها وإدراجها في وضع الحماية لا يوجد نوع أداة منفصل، ويتم تفعيلها تلقائيًا عند ضبط environment.

لحصر وصول الوكيل إلى أدوات معيّنة، مرِّر الأدوات التي تحتاج إليها فقط:

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" \
-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. يجب تقديم الصور كسلاسل مضمّنة بترميز base64 (data).

Python

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",
)

JavaScript


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 });

REST

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 للطلبات المضمّنة، أو من خلال تحميل ملفات التعليمات إلى البيئة:

Python

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)

JavaScript

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);

REST

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/ وتسجيلها كإمكانات يمكن للوكيل استدعاؤها.

على سبيل المثال:

Python

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)

JavaScript

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);

REST

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..."
            }
        ]
    }
}'

راجِع إنشاء وكلاء مخصّصين لمعرفة تنسيق تعريف الوكيل الكامل والوكلاء المسمّين القابلين لإعادة الاستخدام.

البيئات

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

النموذج الوصف
"remote" توفير بيئة اختبار جديدة مع الإعدادات التلقائية
"env_abc123" إعادة استخدام بيئة حالية حسب رقم التعريف، مع الاحتفاظ بجميع الملفات والحالة
{...} EnvironmentConfig كاملة مع مصادر وقواعد شبكة مخصّصة

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

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

يتوفّر وكيل Antigravity في إصدار تجريبي من خلال واجهة Interactions API في Google AI Studio وGemini API.

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

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

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

فئة المهمة رموز الإدخال المميزة رموز الناتج المميّزة التكلفة العادية
البحث وتجميع المعلومات ‫100 ألف إلى 500 ألف من 10 آلاف إلى 40 ألف ‫0.30–1.00 دولار أمريكي
إنشاء المستندات والمحتوى ‫100 ألف إلى 500 ألف ‫15,000 إلى 50,000 ‫0.30–1.30 دولار أمريكي
تصميم العمليات والأنظمة ‫100 ألف إلى 400 ألف ‫10 آلاف إلى 30 ألف ‫0.25–0.80 دولار أمريكي
معالجة البيانات وتحليلها ‫300 ألف - 3 ملايين ‫30 ألفًا إلى 150 ألفًا ‫$0.70–$3.25

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

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

القيود

  • حالة المعاينة: يتوفّر كلّ من وكيل Antigravity وواجهة برمجة التطبيقات Interactions API في إصدار المعاينة. قد تتغيّر الميزات والمخططات.
  • إعدادات إنشاء غير صالحة: لا تتوافق المَعلمات التالية مع هذه الطريقة، وتؤدي إلى ظهور الخطأ 400: 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.
  • أنواع الوسائط المتعددة غير المتوافقة لا تتوافق هذه الميزة مع ملفات الصوت والفيديو والمستندات في الوقت الحالي. يُسمح فقط بالنصوص والصور.

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