نمای کلی عامل‌ها

عامل‌های مدیریت‌شده در Gemini API به شما یک عامل پیکربندی‌پذیر ارائه می‌دهند. با یک فراخوانی API، جعبه شنی Linux تأمین می‌شود که در آن کارگزار استدلال می‌کند، کد اجرا می‌کند، فایل‌ها را مدیریت می‌کند، و به‌طور خودکار در وب مرور می‌کند.

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

  • عامل Antigravity: عامل مدیریت‌شده همه‌منظوره که با Gemini 3.8 Flash ساخته شده است. کد را اجرا می‌کند، فایل‌ها را مدیریت می‌کند، و در جعبه امن Linux میزبانی‌شده توسط Google در وب جستجو می‌کند. می‌توانید مدل زیربنایی (مثل Gemini 3.6 Flash یا Gemini 3.5 Flash-Lite) را بااستفاده از agent_config پیکربندی کنید و آن را با دستورالعمل‌ها، مهارت‌ها، و داده‌های خودتان گسترش دهید تا عامل سفارشی بسازید.
  • Deep Research (پژوهش عمیق): عامل پژوهش خودگردان که تکالیف پژوهشی چندمرحله‌ای را برای موارد استفاده‌ای مثل تحلیل بازار، بررسی دقیق، و مرور ادبیات برنامه‌ریزی، اجرا، و ترکیب می‌کند.

امنیت و روال‌های مطلوب

هر عامل در محیطی با جعبه ایمنی اجرا می‌شود که در سطح سیستم‌عامل ایزوله شده است. جعبه شنی به‌طور پیش‌فرض دسترسی نامحدود به شبکه خروجی دارد. می‌توانید بااستفاده از فهرست مجاز، دسترسی به شبکه را محدود یا غیرفعال کنید.

دسترسی به شبکه

به‌طور پیش‌فرض، محیط‌ها دسترسی نامحدود به شبکه خروجی دارند. از network فهرست مجاز برای محدود کردن ترافیک خروجی به دامنه‌های خاص یا الگوهای کارت عام استفاده کنید. برای جزئیات پیکربندی، به فهرست مجاز شبکه (AI Studio) یا قوانین شبکه (API) مراجعه کنید.

ابزارها و میاناهای برنامه‌سازی کاربردی خارجی

می‌توانید ابزارها و میاناهای برنامه‌سازی کاربردی خارجی را برای توسعه دادن کارگزار متصل کنید. فقط از ابزارهای منابع مورداعتماد استفاده کنید و اجازه‌ها را به حداقل موردنیاز محدود کنید. رمزهای را به‌عنوان اطلاعات اعتباری مدیریت‌شده ذخیره کنید و آن‌ها را براساس شناسه ارجاع دهید، بنابراین کارگزار خروجی آن‌ها را در زمان درخواست تزریق می‌کند و هرگز در sandbox فاش نمی‌شوند. کارگزار می‌تواند از هر اعتبارنامه‌ای که به آن دسترسی دارد استفاده کند، بنابراین فقط اعتبارنامه‌هایی را ارائه دهید که مایلید دامنه کامل آن‌ها را اعطا کنید.

  • از حساب‌های سرویس با کمترین امتیاز یا کلیدهای API استفاده کنید.
  • به‌جای کلیدهای بلندمدت، از نشان‌های کوتاه مدت استفاده کنید.
  • فقط اعتبارنامه‌هایی را ارائه دهید که مایلید محدوده کامل آن‌ها را اعطا کنید.
  • اعتبارنامه‌ها را به‌طور منظم تغییر دهید.

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

نظارت انسانی

همیشه بروندادها (کد تولیدشده، تبدیل داده‌ها، تغییرات پیکربندی) را قبل‌از استقرار آن‌ها درستی‌سنجی کنید، به‌ویژه برای وظایفی که داده‌ها را اصلاح می‌کنند یا با سیستم‌های خارجی تعامل دارند.

قیمت‌گذاری

عامل‌های مدیریت‌شده از مدل پرداخت براساس مصرف براساس نشان‌های مدل Gemini و استفاده از ابزار استفاده می‌کنند. یک تعامل واحد می‌تواند چندین حلقه استدلال را راه‌اندازی کند که معمولاً ۱۰۰ هزار تا ۳ میلیون کد مصرف می‌کنند. درطول دوره پیش‌نمایش، هزینه محیط محاسبه کسر نمی‌شود. برای تفکیک هزینه‌ها براساس هر تکلیف، هزینه‌های تخمینی را ببینید. کارگزاران مدیریت‌شده نیز در سطح رایگان با حد نرخ رایگان و سهمیه استفاده دردسترس هستند.

محدودیت‌ها

حد شرح
کل دوره محیط محیط‌ها پس‌از ۷ روز غیرفعال بودن برای همیشه حذف می‌شوند.
VM Spin-down ماشین‌های مجازی پس‌از مدت کوتاهی غیرفعال بودن خاموش می‌شوند تا منابع را حفظ کنند. درخواست بعدی وضعیت را (با شروع سرد) بازیابی می‌کند.
نرم‌افزار ازپیش نصب‌شده محیط مبتنی بر Ubuntu با Python 3.12 و Node.js 22. برای کسب اطلاعات بیشتر درباره تصویر پایه محیط، به نرم‌افزار ازپیش نصب‌شده مراجعه کنید.
حداکثر نمایندگان می‌توانید حداکثر ۱٬۰۰۰ عامل مدیریت‌شده داشته باشید.

چارچوب‌های عامل

همچنین می‌توانید بااستفاده از این چارچوب‌ها و کیت‌های توسعه نرم‌افزار، با Gemini کارگزار بسازید:

  • LangChain / LangGraph: بااستفاده از ساختارهای گراف، جریان‌های برنامه پیچیده و حالت‌دار و سیستم‌های چندعاملی بسازید.
  • LlamaIndex: عامل‌های Gemini را برای گردش‌های کار بهبودیافته با RAG به داده‌های خصوصی‌تان متصل کنید.
  • CrewAI: نمایندگان هوش مصنوعی خودکار و نقش‌آفرین را به‌صورت مشارکتی هماهنگ کنید.
  • کیت توسعه نرم‌افزار هوش مصنوعی Vercel: در JavaScript/TypeScript، رابط‌های کاربری و عامل‌های مجهز به هوش مصنوعی بسازید.
  • Google ADK: چارچوب منبع‌باز برای ساختن و هماهنگ کردن عامل‌های هوش مصنوعی با قابلیت تعامل‌پذیری.
  • کیت توسعه نرم‌افزار Antigravity: بااستفاده از همان ابزارها، حلقه عامل، و مدیریت زمینه‌ای که Google Antigravity را توانمند می‌کند، عامل‌های هوش مصنوعی خودگردان بسازید. این کیت توسعه نرم‌افزار در Python قابل برنامه‌ریزی است.