Gemini API Managed Agents: फ्री टियर, ट्रिगर्स और बहुत कुछ

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

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

यदि आप एक 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 API पर फ्री टियर उपलब्धता

हम प्रबंधित एजेंट्स की पूर्वावलोकन उपलब्धता को फ्री टियर प्रोजेक्ट्स तक बढ़ा रहे हैं, जो Gemini API के माध्यम से है।

फ्री टियर का उपयोग करने के लिए, बस एक फ्री प्रोजेक्ट से लिंक API कुंजी (एक प्रोजेक्ट जिसमें सक्रिय बिलिंग सक्षम नहीं है) का उपयोग करके अपने अनुरोध करें। फ्री टियर API कुंजी का उपयोग करते समय, आपकी बातचीत पर शुल्क नहीं लगाया जाएगा और इसके बजाय वे हमारी फ्री दर सीमाओं और उपयोग कोटा के तहत चलेंगी।

बजट नियंत्रण गार्डरेल्स

क्योंकि एक Antigravity एजेंट कई चरणों में रीज़निंग, टूल निष्पादन और कोड चलाने का एक स्वायत्त लूप चलाता है, एक ही इंटरैक्शन में महत्वपूर्ण टोकन जमा हो सकते हैं। यह सुनिश्चित करने के लिए कि आप भगोड़े कार्यों या अप्रत्याशित रूप से उच्च टोकन गणनाओं पर अंतहीन पैसा खर्च न करें, हम वित्तीय गार्डरेल्स के रूप में बजट नियंत्रण शुरू कर रहे हैं।

agent_config के अंदर max_total_tokens पास करें ताकि एक इंटरैक्शन द्वारा उपभोग किए जा सकने वाले कुल टोकन (इनपुट + आउटपुट + थिंकिंग) को नियंत्रित किया जा सके। जब एजेंट सीमा तक पहुँचता है, तो इंटरैक्शन सुरक्षित रूप से रुक जाता है और status: "incomplete" लौटाता है। आपके एजेंट का कार्य और वातावरण फ़ाइल सिस्टम की स्थिति संरक्षित रहती है, जिससे आप SSE स्ट्रीमिंग के माध्यम से निष्पादन की निगरानी कर सकते हैं और एक अधूरे इंटरैक्शन को जारी रख सकते हैं ठीक वहीं से जहाँ यह छूटा था, previous_interaction_id और environment को एक नए बजट के साथ पास करके।

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5// 1. 10,000 टोकन तक सीमित सख्त बजट नियंत्रण के साथ एक बहु-चरणीय ऑडिट शुरू करें
6const interaction = await client.interactions.create({
7  agent: "antigravity-preview-05-2026",
8  input: "https://github.com/google/guava को क्लोन करें, guava/src में सभी मॉड्यूल का डिप्रेकेटेड क्लासेस और आंतरिक उपयोगिताओं के लिए ऑडिट करें, और /workspace/migration_audit.md में कोड उदाहरणों के साथ एक व्यापक माइग्रेशन ऑडिट रिपोर्ट तैयार करें।",
9  agent_config: {
10    type: "antigravity",
11    max_total_tokens: 10000,
12  },
13  environment: "remote",
14});
15
16console.log(`स्थिति: ${interaction.status}`);
17console.log(`उपयोग किए गए टोकन: ${interaction.usage?.total_tokens}`);
18
19// 2. 'continue' भेजने पर जारी रख सकते हैं
20if (interaction.status === "incomplete") {
21  const continuation = await client.interactions.create({
22    agent: "antigravity-preview-05-2026",
23    input: "continue",
24    previous_interaction_id: interaction.id,
25    environment: interaction.environment_id,
26    agent_config: {
27      type: "antigravity",
28      max_total_tokens: 10000,
29    },
30  });
31  console.log(`निरंतरता स्थिति: ${continuation.status}`);
32}

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

बाहरी शेड्यूलिंग स्क्रिप्ट चलाने या क्रॉन जॉब्स के लिए समर्पित इंफ्रास्ट्रक्चर बनाए रखने के बजाय, अब आप शेड्यूल्ड ट्रिगर्स का उपयोग करके आवर्ती एजेंट कार्यों को स्वचालित कर सकते हैं।

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

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const trigger = await client.triggers.create({
6  schedule: "0 9 * * *", // प्रति सुबह 9:00 बजे
7  time_zone: "America/Los_Angeles",
8  display_name: "daily-issue-solver",
9  interaction: {
10    agent: "antigravity-preview-05-2026",
11    input: [
12      {
13        type: "text",
14        text: "हमारे रिपॉजिटरी में ओपन PRs की समीक्षा करें, नई टिप्पणियों के लिए जाँच करें और फीडबैक का जवाब दें। 'accepted' लेबल वाले नए इश्यू की जाँच करें, /workspace/solved-issues/ में ट्रैक किए गए किसी भी इश्यू को छोड़ें, बाकी को ठीक करें, और PRs खोलें। रिपोर्ट को /workspace/solved-issues/ में सहेजें।",
15      },
16    ],
17    environment: {
18      type: "remote",
19      network: {
20        allowlist: [
21          {
22            domain: "api.github.com",
23            transform: {
24              Authorization: "Bearer ghp_example_token",
25            },
26          },
27          { domain: "github.com" },
28        ],
29      },
30    },
31  },
32});
33
34console.log(`ट्रिगर बनाया गया: ${trigger.id}`);
35console.log(`अगला शेड्यूल्ड रन: ${trigger.next_run_time}`);
36
37const executions = await client.triggers.listExecutions(trigger.id);
38for (const ex of executions.trigger_executions) {
39  console.log(`${ex.id}: ${ex.status} (${ex.start_time} - ${ex.end_time})`);
40}

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

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

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