عامل‌های مدیریت‌شده در API جمنای

عامل Antigravity را در یک سندباکس ابری (Cloud sandbox) امن اجرا کنید، عامل‌های سفارشی را با دستورالعمل‌ها، مهارت‌ها و داده‌های خود بسازید و آن‌ها را به‌عنوان فایل‌های دارای قابلیت نسخه‌بندی با استفاده از فایل‌های AGENTS.md و SKILL.md تعریف کنید.

عامل مدیریت‌شده چیست؟

به کمک Managed Agents در Gemini API اکنون با یک فراخوانی ساده می‌توانید عاملی را راه‌اندازی کنید که استدلال می‌کند، از ابزارها استفاده می‌کند و کدها را در یک محیط لینوکس ایزوله و موقت (Ephemeral) اجرا می‌کند. این تجربه مبتنی بر عامل جدید Antigravity که بر پایه مدل Gemini 3.5 Flash ساخته شده و از طریق API تعاملات (Interactions API) و در استودیوی هوش مصنوعی گوگل (Google AI Studio) در دسترس است.

ساخت یک عامل در سطح تولید (Production-grade) تا پیش‌ازاین به معنای مدیریت زیرساخت‌های پیچیده، قالب‌بندی (Scaffolding) و مدیریت سندباکس‌های ایزوله برای ارائه خدمت به مشتریان در زمان آماده‌سازی برای مقیاس‌پذیری بود. با عامل‌های مدیریت‌شده جمنای، گوگل این پیچیدگی را از میان برمی‌دارد تا بتوانید صرفاً بر تجربه محصول و رفتار عامل خود تمرکز کنید.

دسترسی به زیرساخت گوگل

در ماه دسامبر، گوگل قابلیت Deep Research را به‌عنوان اولین عامل مدیریت‌شده خود برای وظایف تحقیقاتی پیچیده راه‌اندازی کرد. اکنون نیز گوگل در حال باز کردن چارچوب کنترلی و زیرساخت عامل خود است تا کاربران بتوانند عامل‌های مدیریت‌شده سفارشی خود را بسازد.

یک فراخوانی ساده API به عامل Antigravity، یک محیط لینوکس ریموت را فراهم می‌کند که در آن عامل می‌تواند کارهای زیر را انجام دهد:

• با استفاده از چارچوب کنترلی، استدلال و برنامه‌ریزی کند و ابزارها را فراخوانی کند.
• کدها را اجرا کرده و فایل‌ها را در یک سندباکس لینوکس ایزوله مدیریت کند.
• وب را مرور کند تا داده‌های زنده را واکشی (Fetch) و پردازش کند.

هر تعامل، یک محیط را ایجاد یا دریافت می‌کند که می‌توانید از آن در فراخوانی‌های بعدی برای از سرگیری جلسه (Session) با حفظ تمامی فایل‌ها و وضعیت (State) دست‌نخورده استفاده کنید.

from google import genai

client = genai.Client()

interaction = client.interactions.create(

    agent="antigravity-preview-05-2026",

    input="Plot the growth of solar energy generation globally and make some slides in HTML.",

    environment="remote", # Remote linux environment hosted by Google

)

print(interaction.output_text)

عامل‌های خود را تعریف کنید

شما می‌توانید عامل Antigravity را با دستورالعمل‌ها و مهارت‌های خاص خود گسترش دهید. به‌جای نوشتن کدهای هماهنگ‌سازی پیچیده، می‌توانید همه چیز را در فایل‌های مارک‌داون مانند AGENTS.md و SKILL.md تعریف کرده و آن‌ها را به‌عنوان یک عامل مدیریت‌شده ثبت کنید.

# Define your agent and register as managed agent

agent = client.agents.create(

    id="data-analyst",

    base_agent="antigravity-preview-05-2026",

    base_environment={

        "type": "remote",

        "sources": [

            {"type": "inline", "target": ".agents/AGENTS.md", "content": "You are a data analyst agent..."},

            {"type": "inline", "target": ".agents/slide-maker/SKILL.md", "content": "---name: slide-maker ...--- # Slide Maker ..."}

        ]

    }

)

# Call your agent using Interactions API

result = client.interactions.create(

    agent="data-analyst",

    input="Analyze the Q1 revenue data and create a slide deck",

)

print(result.output_text)

شروع به کار

عامل‌های مدیریت‌شده در API جمنای، به‌صورت پیش‌نمایش در Gemini API عرضه می‌شود. شما همچنین قادر خواهید بود با قالب‌های سفارشی جدید گوگل در Google AI Studio Playground کار خود را شروع کنید. مستندات توسعه‌دهندگان در مورد نحوه ساخت بررسی کنید؛ از جمله یک مهارت جدید عامل در API جمنای که برای کمک به عامل‌های کدنویسی در قالب‌بندی و مدیریت عامل‌های سفارشی طراحی شده است.

برای سازمان‌ها، همچنین پشتیبانی از عامل‌های مدیریت‌شده در API جمنای را در پلتفرم عامل سازمانی جمنای (Gemini Enterprise Agent Platform) به‌صورت پیش‌نمایش خصوصی (Private preview) اضافه شده است.