Gemini API Managed Agents: 3.6 Flash, Hooks, और बहुत कुछ

Gemini API में प्रबंधित एजेंट अब डिफ़ॉल्ट रूप से Gemini 3.6 Flash का उपयोग करते हैं। नए एनवायरनमेंट हुक्स आपको सैंडबॉक्स के अंदर टूल कॉल को ब्लॉक, लिंट या ऑडिट करने देते हैं। साथ ही, हमने बजट नियंत्रण, शेड्यूल्ड ट्रिगर और फ्री टियर एक्सेस भी जोड़ा है।

Gemini API में प्रबंधित एजेंट को अब एनवायरनमेंट हुक्स, मॉडल चयन, और फ्री टियर एक्सेस मिल रहे हैं। ये क्षमताएं हमारे पिछले रिलीज़ पर आधारित हैं जिसमें बैकग्राउंड टास्क और रिमोट MCP सर्वर इंटीग्रेशन शामिल थे।

Gemini Interactions API में प्रबंधित एजेंटों के साथ, एक एकल API कॉल एक पृथक क्लाउड सैंडबॉक्स के अंदर रीज़निंग, कोड निष्पादन, पैकेज इंस्टॉलेशन, फ़ाइल प्रबंधन और वेब रिट्रीवल का समन्वय करती है।

यदि आप AI कोडिंग असिस्टेंट का उपयोग कर रहे हैं, तो इसे अपने टर्मिनल में डालें ताकि इसे Interactions API स्किल तक पहुंच मिल सके: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

नीचे @google/genai TypeScript/JavaScript SDK का उपयोग करने वाले उदाहरण दिए गए हैं। Python या cURL के लिए, Antigravity एजेंट दस्तावेज़ीकरण देखें।

1npm install @google/genai

Gemini 3.6 Flash अब डिफ़ॉल्ट है

antigravity-preview-05-2026 एजेंट अब डिफ़ॉल्ट रूप से Gemini 3.6 Flash चलाता है। कोई कोड बदलाव की आवश्यकता नहीं है। आपकी अगली इंटरैक्शन इसे स्वचालित रूप से अपना लेगी।

आप इंटरैक्शन या प्रबंधित एजेंट बनाते समय agent_config.model पास करके स्पष्ट रूप से मॉडल का चयन भी कर सकते हैं। कम लागत के लिए Gemini 3.5 Flash-Lite का उपयोग करें, या अपने पसंदीदा मॉडल पर पिन करें।

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const interaction = await client.interactions.create({
6  agent: "antigravity-preview-05-2026",
7  input: "Audit all dependencies in package.json, upgrade outdated packages, and verify the build by running npm test.",
8  environment: "remote",
9  agent_config: {
10    type: "antigravity",
11    model: "gemini-3.5-flash-lite",
12  },
13});
14
15console.log(interaction.output_text);

समर्थित मॉडलों में शामिल हैं:

• Gemini 3.6 Flash (gemini-3.6-flash, डिफ़ॉल्ट): रीज़निंग, कोडिंग और टूल उपयोग के लिए संतुलित मॉडल।
• Gemini 3.5 Flash (gemini-3.5-flash): सामान्य एजेंटिक वर्कफ़्लो के लिए पिछली पीढ़ी।
• Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite): Gemini 3.5 परिवार में सबसे कम विलंबता और लागत।

एनवायरनमेंट हुक्स: सैंडबॉक्स के अंदर टूल कॉल को ब्लॉक, लिंट और ऑडिट करें

एनवायरनमेंट हुक्स आपको अपने एनवायरनमेंट में अपनी कस्टम स्क्रिप्ट को एजेंट द्वारा अपने सैंडबॉक्स के अंदर किए जाने वाले प्रत्येक टूल कॉल से पहले या बाद में चलाने देते हैं। अपने एनवायरनमेंट में एक .agents/hooks.json फ़ाइल जोड़ें और रनटाइम pre_tool_execution या post_tool_execution ईवेंट पर आपके हैंडलर को निष्पादित करेगा।

1{
2  "security-gate": {
3    "pre_tool_execution": [
4      {
5        "matcher": "code_execution|write_file",
6        "hooks": [
7          {
8            "type": "command",
9            "command": "python3 /.agents/hooks-scripts/gate.py",
10            "timeout": 10
11          }
12        ]
13      }
14    ]
15  },
16  "auto-format": {
17    "post_tool_execution": [
18      {
19        "matcher": "*",
20        "hooks": [
21          {
22            "type": "command",
23            "command": "python3 /.agents/hooks-scripts/auto_lint.py",
24            "timeout": 15
25          }
26        ]
27      }
28    ]
29  }
30}

इस कॉन्फ़िगरेशन में:

• security-gate समूह प्रत्येक code_execution या write_file कॉल से पहले gate.py चलाता है। यदि स्क्रिप्ट {"decision": "deny", "reason": "..."} लौटाती है, तो टूल कॉल को छोड़ दिया जाता है और अस्वीकृति का कारण मॉडल के संदर्भ में पास कर दिया जाता है।
• auto-format समूह कोड स्टाइलिंग लागू करने के लिए प्रत्येक टूल के समाप्त होने के बाद auto_lint.py चलाता है।
• हुक्स http प्रकार के हैंडलर का भी समर्थन करते हैं जो सीधे किसी बाहरी एंडपॉइंट पर POST करते हैं।

पूर्ण HTTP हुक परिभाषाओं और विफलता हैंडलिंग सिमैंटिक्स के लिए, हुक्स दस्तावेज़ीकरण देखें।

टीमें पहले से ही प्रोडक्शन-ग्रेड वैलिडेशन पाइपलाइन बनाने के लिए हुक्स का उपयोग कर रही हैं। उदाहरण के लिए, AI-नेटिव इन्वेस्टमेंट बैंक Offdeal रिमोट सैंडबॉक्स के अंदर स्वचालित इमेज वेरिफिकेशन चलाने के लिए post_tool_execution हुक्स का उपयोग करता है।

OffDeal एक AI-नेटिव इन्वेस्टमेंट बैंक है, और Archie वह AI विश्लेषक है जिसका हमारे बैंकर हर दिन उपयोग करते हैं। बैंकर-रेडी डेक के लिए एक आवश्यकता कंपनी के लोगो हैं: खरीदार तालिकाएं, प्रायोजक कॉलम, टॉम्बस्टोन ग्रिड, अक्सर एक ही डेक में 30+ लोगो, जिनमें से प्रत्येक सही कंपनी का होना चाहिए, उचित आकार और पहलू अनुपात होना चाहिए, जिसमें नाम हो, एक पारदर्शी पृष्ठभूमि हो, और जब एक सफेद स्लाइड पर रखा जाए तो उच्च कंट्रास्ट हो।

एजेंट हुक्स से पहले, हम Gemini के प्रबंधित एजेंटों पर ऐसा नहीं कर सकते थे: सैंडबॉक्स रिमोट है, इसलिए हमारे वैलिडेशन कोड को चलने के लिए कोई जगह नहीं थी। हुक्स के साथ, एक post_tool_execution हुक हमारी पाइपलाइन को सैंडबॉक्स के अंदर ट्रिगर करता है जैसे ही Archie अपनी कंपनी की सूची लिखता है, उम्मीदवारों को लाता है, पिक्सेल-स्तरीय गुणवत्ता जांच लागू करता है, Gemini विज़न के साथ प्रत्येक लोगो को सत्यापित करता है, और स्वीकृत फ़ाइलों का एक मेनिफेस्ट प्रकाशित करता है जो डेक में अनुमति प्राप्त एकमात्र चित्र हैं।

— Alston Lin, OffDeal के संस्थापक और CTO

लागत नियंत्रण और ऑटोमेशन सुविधाएँ

फ्री टियर उपलब्धता

प्रबंधित एजेंट अब फ्री टियर प्रोजेक्ट्स पर उपलब्ध हैं। डेवलपर्स सक्रिय बिलिंग के बिना प्रोजेक्ट से API कुंजी का उपयोग करके एजेंटिक वर्कफ़्लो के साथ प्रयोग कर सकते हैं।

बजट नियंत्रण

क्योंकि प्रबंधित एजेंट मल्टी-टर्न ऑटोनॉमस लूप निष्पादित करते हैं, जटिल कार्य महत्वपूर्ण टोकन बजट का उपभोग कर सकते हैं। अनियंत्रित कार्यों को रोकने के लिए, आप कुल खपत (इनपुट + आउटपुट + थिंकिंग) को सीमित करने के लिए agent_config के अंदर max_total_tokens पास कर सकते हैं।

जब एजेंट सीमा तक पहुंचता है, तो निष्पादन सुरक्षित रूप से रुक जाता है और इंटरैक्शन status: "incomplete" लौटाता है। एनवायरनमेंट स्थिति संरक्षित रहती है, जिससे आप एक नए बजट के साथ previous_interaction_id पास करके जहां यह रुका था वहां से जारी रख सकते हैं।

1const interaction = await client.interactions.create({
2  agent: "antigravity-preview-05-2026",
3  input: "इस रिपॉजिटरी के सभी मॉड्यूल का ऑडिट करें और एक माइग्रेशन रिपोर्ट तैयार करें।",
4  agent_config: {
5    type: "antigravity",
6    max_total_tokens: 10000,
7  },
8  environment: "remote",
9});

ट्रिगर्स के साथ शेड्यूल्ड निष्पादन

शेड्यूल्ड ट्रिगर्स के साथ आवर्ती एजेंट कार्यों को स्वचालित करें। एक ट्रिगर एक एजेंट, एनवायरनमेंट, प्रॉम्प्ट और क्रॉन शेड्यूल को एक स्थायी संसाधन में बांधता है जो मैन्युअल हस्तक्षेप के बिना सक्रिय होता है। प्रत्येक रन उसी सैंडबॉक्स का पुन: उपयोग करता है, इसलिए फ़ाइलें निष्पादन के दौरान बनी रहती हैं।

Environments API

Environments API आपको कोड से सैंडबॉक्स सत्रों को सूचीबद्ध करने, निरीक्षण करने और हटाने देता है। डिस्कनेक्ट के बाद एनवायरनमेंट ID पुनर्प्राप्त करें, या 7-दिवसीय TTL की प्रतीक्षा करने के बजाय आपकी पाइपलाइन समाप्त होने पर सैंडबॉक्स साफ़ करें।

प्रबंधित एजेंटों के साथ शुरुआत करें

ये अपडेट प्रबंधित एजेंटों को लागत-नियंत्रित, शेड्यूल्ड वर्कर में बदल देते हैं जो वास्तविक डेवलपमेंट एनवायरनमेंट के अंदर स्वायत्त रूप से काम करते हैं, बिना आपके बजट को तोड़े या बाहरी ऑर्केस्ट्रेशन की आवश्यकता के।

कस्टम एजेंट परिभाषाओं, एनवायरनमेंट कॉन्फ़िगरेशन, नेटवर्क नियमों और उन्नत स्ट्रीमिंग पैटर्न का पता लगाने के लिए Gemini Interactions API अवलोकन और प्रबंधित एजेंट क्विकस्टार्ट देखें।