Google AI Studio Playground, प्रोटोटाइप बनाने और यह जानने के लिए विज़ुअल इंटरफ़ेस उपलब्ध कराता है कि एपीआई कॉल बनाए और लिखे बिना मैनेज किए गए एजेंट कैसे बनाए जाते हैं.
इसे इस्तेमाल करने के लिए, Google AI Studio के नेविगेशन पैनल में मौजूद Playground टैब पर जाएं. इसके बाद, टॉगल को Agents पर स्विच करें.
पहले से बने टेंप्लेट
एजेंट टैब में टेंप्लेट की एक सीरीज़ होती है. ये टूल और एनवायरमेंट कॉन्फ़िगरेशन सेट करके, Antigravity एजेंट को पहले से कॉन्फ़िगर करते हैं. सभी टेंप्लेट ओपन-सोर्स हैं और इन्हें google-gemini/gemini-managed-agents-templates रिपॉज़िटरी में पब्लिश किया गया है. इन टेंप्लेट को एक्सप्लोर करके, मैनेज किए जाने वाले एजेंट को बनाने और उसे स्ट्रक्चर करने का तरीका आसानी से सीखा जा सकता है.
उदाहरण के लिए, एआई रेडियो टेंप्लेट चुनने पर, यह उन सभी टूल को चालू कर देता है जिनके इस्तेमाल की अनुमति है. साथ ही, यह रेडियो शो के प्रोडक्शन के लिए, खास AGENTS.md फ़ाइल और स्किल को लिंक करता है. सोर्स बटन पर क्लिक करके, एनवायरमेंट सेक्शन में जाकर, Playground के यूज़र इंटरफ़ेस (यूआई) पर इन सेटिंग को देखा जा सकता है.
टूल कॉन्फ़िगरेशन
Playground में एजेंट की सेटिंग में जाकर, इन बिल्ट-इन टूल के ऐक्सेस को टॉगल किया जा सकता है:
- Google Search: रीयल-टाइम में जानकारी पाने के लिए, ओपन वेब को ऐक्सेस करें.
- यूआरएल का कॉन्टेक्स्ट: किसी वेब पेज के यूआरएल के टेक्स्ट कॉन्टेंट को फ़ेच और पार्स करता है.
- कोड एक्ज़ीक्यूट करना: अलग किए गए सैंडबॉक्स एनवायरमेंट में, सीधे तौर पर बैश और Python कमांड चलाएं.
- फ़ाइल सिस्टम टूल: इससे वर्कस्पेस में मौजूद फ़ाइलों को पढ़ने, लिखने, सूची बनाने, और मिटाने का ऐक्सेस मिलता है.
परिवेश का कॉन्फ़िगरेशन
मैनेज किए गए एजेंट, सुरक्षित और कुछ समय के लिए उपलब्ध Linux सैंडबॉक्स (एनवायरमेंट) में काम करते हैं. यह सैंडबॉक्स, उन्हें काम करने के लिए ज़रूरी वर्कस्पेस और टूल उपलब्ध कराता है. ज़्यादा जानने के लिए, मैनेज किए गए एजेंट एनवायरमेंट गाइड देखें.
एजेंट के व्यवहार को कंट्रोल करना
एजेंट का व्यवहार, पर्सोना, और क्षमताएं मुख्य रूप से उसके एनवायरमेंट में मौजूद फ़ाइलों से तय होती हैं. एजेंट, .agents फ़ोल्डर से कॉन्फ़िगरेशन का अपने-आप पता लगाता है और उन्हें लोड करता है:
AGENTS.md: सिस्टम के निर्देशों और पर्सोना को तय करने के लिए, एजेंट के कॉन्टेक्स्ट में पहले से लोड किया गया.SKILL.md: ये अलग-अलग स्किल फ़ोल्डर (जैसे,.agents/skills/my-skill/SKILL.md) में मौजूद होते हैं. इनका इस्तेमाल, खास क्षमताओं और वर्कफ़्लो को तय करने के लिए किया जाता है.
एनवायरमेंट को चालू करना
सेशन शुरू करने से पहले, एनवायरमेंट में फ़ाइलें माउंट करके, एजेंट के इस्तेमाल के लिए एनवायरमेंट को कॉन्फ़िगर किया जा सकता है. सोर्स माउंट करके नया एनवायरमेंट बनाया जा सकता है या पिछले एनवायरमेंट को वापस लाया जा सकता है:
- नया एनवायरमेंट बनाने के लिए, एनवायरमेंट की सेटिंग वाले पैनल में जाकर सोर्स जोड़ें पर क्लिक करें. इसके बाद, इनमें से कोई सोर्स टाइप चुनें:
| स्रोत प्रकार | ब्यौरा | माउंट करने का पाथ |
|---|---|---|
| इनलाइन फ़ाइलें | कॉन्फ़िगरेशन फ़ाइलें, मॉक डेटासेट या यूटिलिटी स्क्रिप्ट (100 केबी तक) सीधे तौर पर Playground के यूज़र इंटरफ़ेस (यूआई) में लिखें या चिपकाएं. | उपयोगकर्ता के तय किए गए डेस्टिनेशन का पाथ (उदाहरण के लिए, /workspace/scripts/parser.py). |
| Google Cloud Storage | सार्वजनिक या निजी Cloud Storage बकेट को माउंट करें. निजी बकेट के लिए, स्टैंडर्ड OAuth 2.0 Bearer टोकन की ज़रूरत होती है. ज़्यादा जानकारी के लिए, निजी सोर्स देखें. |
यह GCS बकेट के पाथ (जैसे, gs://your-bucket-name/data/) को वर्कस्पेस डायरेक्ट्री (जैसे, /workspace/data/) से मैप करता है. |
| GitHub रिपॉज़िटरी | सार्वजनिक या निजी कोडबेस क्लोन करें. निजी रिपॉज़िटरी के लिए, GitHub Personal Access Token (PAT) के साथ बुनियादी पुष्टि की ज़रूरत होती है. ज़्यादा जानकारी के लिए, निजी सोर्स देखें. |
सीधे /workspace/ में क्लोन किया गया (आम तौर पर /workspace/<repo-name> से कम). |
- पिछले एनवायरमेंट को वापस लाने के लिए, किसी मौजूदा एनवायरमेंट आईडी का फिर से इस्तेमाल किया जा सकता है. इससे, एनवायरमेंट की मौजूदा स्थिति को क्लोन और फ़ोर्क किया जा सकता है.
किसी मौजूदा एनवायरमेंट आईडी का फिर से इस्तेमाल करना
अगर आपने सैंडबॉक्स एनवायरमेंट को सेट अप करने में पहले ही समय लगा दिया है, तो आपको इसे फिर से सेट अप करने की ज़रूरत नहीं है. किसी मौजूदा एनवायरमेंट का इस्तेमाल करने के लिए:
- AI Studio में एनवायरमेंट पैनल पर जाएं और टाइप को टॉगल करके मौजूदा पर सेट करें
- एनवायरमेंट आईडी डालें (जैसे,
env_abc123)
ज़्यादा जानकारी के लिए, एनवायरमेंट कॉन्फ़िगर करना लेख पढ़ें. यूज़र इंटरफ़ेस (यूआई) में मौजूद एनवायरमेंट टैब से, मौजूदा सेशन का एनवायरमेंट आईडी भी वापस पाया जा सकता है.
एजेंट को पहला मैसेज भेजने के बाद, उस सेशन के लिए एनवायरमेंट कॉन्फ़िगरेशन तय हो जाता है. इंटरैक्शन के चालू होने पर, नए सोर्स माउंट नहीं किए जा सकते. साथ ही, नेटवर्क की अनुमति वाली सूची में बदलाव नहीं किया जा सकता.
एनवायरमेंट डाउनलोड करना
एनवायरमेंट बनाने के बाद, AI Studio Playground की एनवायरमेंट सेटिंग में जाकर, डाउनलोड करें बटन का इस्तेमाल करके, एनवायरमेंट का स्नैपशॉट किसी भी समय डाउनलोड किया जा सकता है. इससे एनवायरमेंट की फ़ाइलों को टारबॉल के तौर पर वापस पाया जा सकता है.
सुरक्षा और लागत मैनेजमेंट
टोकन के इस्तेमाल को मैनेज करना
स्टैंडर्ड चैट के अनुरोध में सिर्फ़ एक आउटपुट मिलता है. हालांकि, Antigravity Agent में अपने-आप काम करने वाला वर्कफ़्लो होता है. यह प्लान बनाता है, कोड चलाता है, नतीजों को देखता है, और दोहराता है. इसका मतलब है कि एक प्रॉम्प्ट से, टोकन का इस्तेमाल असीमित तौर पर किया जा सकता है.
लागत को मैनेज करने के लिए, अपने प्रॉम्प्ट में टास्क खत्म करने की शर्तों के बारे में साफ़ तौर पर बताएं. साथ ही, एजेंट के लिए टास्क का दायरा सीमित रखें. एक अच्छा उदाहरण इस तरह के प्रॉम्प्ट का हो सकता है पुल के अनुरोध की समीक्षा करें और मार्कडाउन की खास जानकारी जनरेट करने के बाद रुक जाएं. खुद से ठीक करने की कोशिश न करें.
अतिरिक्त लागत
डिफ़ॉल्ट रूप से, Playground पर मौजूद सभी एजेंट टेंप्लेट के पास Gemini API सेवा का ऐक्सेस होता है. साथ ही, वे अनुरोधों को पूरा करने के लिए, एनवायरमेंट से एपीआई कॉल कर सकते हैं. इनसे अतिरिक्त लागत लग सकती है, जो टोकन के इस्तेमाल में नहीं दिखेगी.
इसी तरह, अगर आपने अन्य बाहरी सेवाएं जोड़ी हैं, तो एजेंट आपकी ओर से इन सेवाओं को कॉल करके अतिरिक्त शुल्क ले सकता है.
नेटवर्क की अनुमति वाली सूची
डिफ़ॉल्ट रूप से, AI Studio में आपके एजेंट के सैंडबॉक्स एनवायरमेंट से किए जाने वाले सभी आउटबाउंड नेटवर्क अनुरोधों को पूरी तरह से कंट्रोल किया जाता है. साथ ही, सुरक्षा को पक्का करने के लिए इन पर पाबंदी लगाई जाती है. अपने एजेंट को बाहरी एपीआई, वेब सेवाओं या पैकेज मैनेजर तक पहुंचने की अनुमति देने के लिए, आपको उन्हें साफ़ तौर पर यह जानकारी देनी होगी:
- AI Studio में, Environments पैनल पर जाएं.
- नेटवर्क के बगल में मौजूद, नियम बटन को चुनें.
- नेटवर्क कॉन्फ़िगरेशन पैनल में, अनुमति वाली सूची में जोड़ें पर क्लिक करें और ज़रूरी जानकारी भरें:
- डोमेन से जुड़ी पाबंदी: सूची में जोड़े गए सिर्फ़ कुछ डोमेन या वाइल्डकार्ड पैटर्न को एजेंट की वर्चुअल मशीन से ऐक्सेस किया जा सकता है. उदाहरण के लिए,
api.github.comजैसे सटीक डोमेन या*.googleapis.comजैसे ब्रॉड पैटर्न डाले जा सकते हैं. - एचटीटीपी हेडर और टोकन इंजेक्ट करना: किसी खास डोमेन के लिए ज़रूरी क्रेडेंशियल (जैसे, एपीआई टोकन) को सुरक्षित तरीके से इंजेक्ट करने के लिए, एचटीटीपी हेडर जोड़ें विकल्प का इस्तेमाल करें. ये क्रेडेंशियल, इग्रेस प्रॉक्सी के ज़रिए सुरक्षित तरीके से पास किए जाते हैं. साथ ही, इन्हें एजेंट सैंडबॉक्स में कभी भी सीधे तौर पर रॉ टेक्स्ट के तौर पर नहीं दिखाया जाता.
- डोमेन से जुड़ी पाबंदी: सूची में जोड़े गए सिर्फ़ कुछ डोमेन या वाइल्डकार्ड पैटर्न को एजेंट की वर्चुअल मशीन से ऐक्सेस किया जा सकता है. उदाहरण के लिए,
अनुमति वाली सूची में डोमेन जोड़ते समय, हमेशा सावधानी बरतें. एजेंट को पुष्टि की गई सेवाओं का ऐक्सेस देने का मतलब है कि वह आपकी ओर से कार्रवाई कर सकता है. अगर इस पर ध्यान नहीं दिया जाता है, तो इससे ऐसी कार्रवाइयां हो सकती हैं जो आपके हिसाब से न हों.
क्रेडेंशियल से जुड़े सबसे सही तरीके
अगर आपके वर्कफ़्लो में एजेंट को बाहरी सेवाओं के साथ पुष्टि करने की ज़रूरत होती है, तो उन क्रेडेंशियल को उपलब्ध कराने और उनका दायरा तय करने की ज़िम्मेदारी आपकी होती है. जोखिम कम करने के लिए, इन दिशा-निर्देशों का पालन करें:
- कम से कम विशेषाधिकार वाले क्रेडेंशियल का इस्तेमाल करें: ऐसे सेवा खाते या एपीआई कुंजियां बनाएं जिनमें सिर्फ़ वे अनुमतियां हों जिनकी आपके एजेंट को ज़रूरत है. ऐसे क्रेडेंशियल पास न करें जिनमें एडमिन या ब्रॉड ऐक्सेस हो.
- कम समय के लिए मान्य टोकन का इस्तेमाल करें: जहां भी मुमकिन हो, वहां समयसीमा वाले क्रेडेंशियल या ऐसे टोकन का इस्तेमाल करें जो लंबे समय तक मान्य रहने वाले एपीआई पासकोड के बजाय खत्म हो जाते हैं.
- पूरा ऐक्सेस मान लें: एजेंट, आपको दिए गए टास्क को पूरा करने के लिए, उन सभी क्रेडेंशियल का इस्तेमाल कर सकता है जिनका ऐक्सेस उसके पास है. सिर्फ़ उन क्रेडेंशियल को शेयर करें जिनका पूरा ऐक्सेस आपको देना है.
- क्रेडेंशियल को नियमित तौर पर बदलें: एजेंट के साथ शेयर किए गए क्रेडेंशियल को उसी तरह से मैनेज करें जिस तरह से प्रोग्राम के हिसाब से मैनेज किए जाने वाले क्रेडेंशियल को मैनेज किया जाता है. साथ ही, उन्हें नियमित तौर पर बदलें.
बाहरी टूल और एपीआई कनेक्ट करना
एजेंट की क्षमताओं को बढ़ाने के लिए, बाहरी टूल और एपीआई (जैसे, मॉडल कॉन्टेक्स्ट प्रोटोकॉल / एमसीपी सर्वर) कनेक्ट किए जा सकते हैं. ऐसा करते समय:
- सिर्फ़ भरोसेमंद सोर्स से मिलने वाले टूल कनेक्ट करें. बुरे मकसद से बनाया गया या खराब तरीके से लिखा गया टूल, डेटा को सार्वजनिक कर सकता है या अनचाहे काम कर सकता है.
- अपने इस्तेमाल के उदाहरण के हिसाब से, ज़रूरी अनुमतियों वाले टूल कॉन्फ़िगर करें. अगर कोई टूल सिर्फ़ पढ़ने के लिए मोड को सपोर्ट करता है, तो उसका इस्तेमाल करें. ऐसा तब तक करें, जब तक कि लिखना बहुत ज़रूरी न हो.
- किसी टूल को प्रोडक्शन डेटा सोर्स से कनेक्ट करने से पहले, उसे सैंपल या सिंथेटिक डेटा के साथ टेस्ट करें. इससे यह पुष्टि की जा सकेगी कि एजेंट इसका इस्तेमाल उम्मीद के मुताबिक कर रहा है.
इंसानों की निगरानी
एजेंट, कई चरणों वाले वर्कफ़्लो के बारे में सोच सकते हैं, प्लान बना सकते हैं, और उन्हें लागू कर सकते हैं. इसके लिए, उन्हें किसी और की मदद की ज़रूरत नहीं होती. यह सुविधा बहुत काम की है. हालांकि, इसका मतलब यह भी है कि आपको इस पर नज़र रखनी चाहिए. खास तौर पर, उन टास्क के लिए जो डेटा में बदलाव करते हैं या बाहरी सिस्टम के साथ इंटरैक्ट करते हैं.
जनरेट किए गए कोड, डेटा ट्रांसफ़ॉर्मेशन या कॉन्फ़िगरेशन में किए गए बदलाव जैसे अहम आउटपुट को डिप्लॉय करने से पहले, हमेशा उनकी पुष्टि करें.