‏هوک‌ها به ایجنت‌های مدیریت‌شدهٔ Gemini API رسیدن

تو اعلان تازهٔ تیم Gemini اومده که Managed Agents چند قابلیت تازه گرفته: هوک‌های محیطی، انتخاب مدل و دسترسی روی پلن رایگان. ایدهٔ اصلی این سرویس همونیه که قبلاً هم بود — با یه فراخوانی API واحد، استدلال، اجرای کد، نصب پکیج، مدیریت فایل و جست‌وجوی وب همه داخل یه سندباکس ابری ایزوله هماهنگ می‌شن.

ایجنت antigravity-preview-05-2026 حالا به‌صورت پیش‌فرض روی Gemini 3.6 Flash می‌چرخه و برای این تغییر لازم نیست کدت رو دست بزنی؛ همون تعامل بعدی خودش برمی‌داره. اگه مدل دیگه‌ای بخوای، کافیه agent_config.model رو موقع ساختن interaction ست کنی — مثلاً Gemini 3.5 Flash-Lite برای وقتی که تأخیر و هزینهٔ کمتر برات مهم‌تره.

جذاب‌ترین بخش، هوک‌های محیطیه. یه فایل .agents/hooks.json تو محیط می‌ذاری و رانتایم، هندلرهای تو رو روی رویدادهای pre_tool_execution و post_tool_execution اجرا می‌کنه. فیلد matcher عبارت باقاعده قبول می‌کنه، پس می‌شه چند ابزار رو با هم هدف گرفت یا همه رو گرفت. اگه اسکریپتِ مرحلهٔ pre تصمیم deny برگردونه، اون فراخوانی ابزار اجرا نمی‌شه و دلیل ردش به کانتکست مدل می‌ره. هندلر نوع http هم پشتیبانی می‌شه.

برای خرج بی‌حساب هم راه‌حل گذاشتن: با max_total_tokens داخل agent_config سقف کل مصرف (ورودی، خروجی و thinking) رو مشخص می‌کنی. وقتی ایجنت به سقف می‌رسه، اجرا امن متوقف می‌شه و وضعیت incomplete برمی‌گرده، ولی حالت محیط نگه داشته می‌شه تا با previous_interaction_id و بودجهٔ تازه ادامه بدی.

const interaction = await client.interactions.create({
  agent: "antigravity-preview-05-2026",
  input: "Audit all modules in this repo and generate a migration report.",
  agent_config: {
    type: "antigravity",
    max_total_tokens: 10000,
  },
  environment: "remote",
});

کنار اینا، Managed Agents روی پروژه‌های بدون بیلینگ فعال هم در دسترسه، تریگرهای زمان‌بندی‌شده با کرون اجازه می‌دن یه ایجنت و محیط و پرامپت رو به یه ریسورس دائمی گره بزنی که هر بار همون سندباکس رو دوباره استفاده می‌کنه، و Environments API هم برای لیست کردن، بررسی و پاک کردن سشن‌های سندباکس اضافه شده. به گفتهٔ نویسنده‌ها، جمع این‌ها ایجنت‌ها رو به کارگرهای زمان‌بندی‌شده و کنترل‌شده از نظر هزینه تبدیل می‌کنه.

نکات کلیدی:

• مدل پیش‌فرض ایجنت‌های مدیریت‌شده حالا Gemini 3.6 Flash ـه، بدون نیاز به تغییر کد
• با agent_config.model می‌تونی مدل رو پین کنی؛ 3.5 Flash-Lite گزینهٔ کم‌هزینه‌تره
• هوک‌های pre_tool_execution و post_tool_execution اجازهٔ بلاک، لینت و ممیزی فراخوانی ابزارها رو می‌دن
• max_total_tokens جلوی تسک‌های فراری رو می‌گیره و اجرا با previous_interaction_id ادامه‌پذیره
• تریگرهای کرونی، Environments API و دسترسی رایگان هم اضافه شدن