Google Cloud Platform (GCP) टूलकिट आपके एजेंट को BigQuery, Cloud Run (सर्विसेज़ और HTTP-ट्रिगर्ड फंक्शंस) और Cloud SQL के साथ इंटरैक्ट करने में सक्षम बनाता है। प्रमाणीकरण एक सर्विस-अकाउंट JSON कुंजी के माध्यम से किया जाता है जो कनेक्शन के रूप में संग्रहीत होता है — एजेंट सर्विस अकाउंट के रूप में कार्य करता है और इसकी IAM भूमिकाएं विरासत में प्राप्त करता है।
पूर्वावश्यकताएं
GCP टूलकिट कॉन्फ़िगर करने से पहले, आपको एक सक्रिय Google Cloud कनेक्शन चाहिए। यदि आपने अभी तक सेटअप नहीं किया है, तो बनाने के लिए Settings → Connections पर जाएं।
कनेक्शन Settings → Connections में केंद्रीय रूप से प्रबंधित होते हैं। सर्विस-अकाउंट JSON एन्क्रिप्टेड रूप से संग्रहीत होता है; केवल client_email और प्रोजेक्ट एजेंट्स को दिखाई देते हैं।
एजेंट में टूलकिट जोड़ना
- अपना एजेंट खोलें और Toolkits पर जाएं।
- Google Cloud Platform खोजें और Add to Agent पर क्लिक करें।
- कॉन्फ़िगरेशन पैनल खोलने के लिए Configure पर क्लिक करें।
कॉन्फ़िगरेशन
कनेक्शन
एजेंट जिस सर्विस अकाउंट कनेक्शन का उपयोग करेगा उसे चुनने के लिए Select GCP Connection ड्रॉपडाउन का उपयोग करें। कनेक्शन प्रबंधित या बनाने के लिए, ऊपरी दाएं में Manage Connections पर क्लिक करें।
Google Cloud एकीकरण के बारे में
टूलकिट कॉन्फ़िगर करते समय निम्नलिखित ध्यान में रखें:
- एजेंट सर्विस अकाउंट की IAM भूमिकाएं विरासत में प्राप्त करता है — केवल आवश्यक भूमिकाएं प्रदान करें (जैसे
BigQuery Data Viewer, Cloud Run Invoker, Cloud SQL Client)।
- Cloud Run / Cloud Functions इन्वोकेशन सर्विस अकाउंट द्वारा हस्ताक्षरित OIDC ID-टोकन का उपयोग करता है; जब सर्विसेज़ प्राइवेट हों तो
roles/run.Invoker को सर्विस अकाउंट तक सीमित करें।
- केवल वे टूल्स उपलब्ध होंगे जो आप नीचे सक्षम करते हैं।
टूल्स चुनें
टूल्स को थोक में प्रबंधित करने के लिए Select All या Deselect All का उपयोग करें, या उन्हें व्यक्तिगत रूप से सक्षम करें। आप प्रत्येक टूल के लिए Require Confirmation भी टॉगल कर सकते हैं ताकि एजेंट द्वारा उस कार्य को निष्पादित करने से पहले उपयोगकर्ता से पुष्टि मांगी जा सके।
चार श्रेणियों में 13 टूल्स उपलब्ध हैं।
BigQuery
| टूल | विवरण |
|---|
| डेटासेट सूचीबद्ध करें | कनेक्टेड सर्विस अकाउंट द्वारा एक्सेस किए जा सकने वाले BigQuery डेटासेट सूचीबद्ध करता है। |
| टेबल सूचीबद्ध करें | BigQuery डेटासेट में टेबल सूचीबद्ध करता है। |
| टेबल स्कीमा प्राप्त करें | कॉलम नाम, प्रकार, विवरण और टेबल मेटाडेटा का निरीक्षण करता है। |
| क्वेरी चलाएं | वैकल्पिक ड्राई-रन, पैरामीटर और पंक्ति सीमा के साथ BigQuery पर SQL क्वेरी चलाता है। |
| पंक्तियाँ डालें | स्ट्रीमिंग इंसर्ट API का उपयोग करके BigQuery टेबल में पंक्तियाँ स्ट्रीम-इंसर्ट करता है। |
Cloud Run
| टूल | विवरण |
|---|
| सर्विसेज़ सूचीबद्ध करें | किसी क्षेत्र में Cloud Run सर्विसेज़ (Gen 2) सूचीबद्ध करता है। |
| सर्विस प्राप्त करें | Cloud Run सर्विस परिभाषा प्राप्त करता है जिसमें इसका URL और इमेज शामिल है। |
| सर्विस इन्वोक करें | सर्विस अकाउंट द्वारा हस्ताक्षरित OIDC ID-टोकन के साथ Cloud Run सर्विस के HTTP एंडपॉइंट को इन्वोक करता है। |
| फंक्शन इन्वोक करें | OIDC ID-टोकन के साथ HTTP-ट्रिगर्ड Cloud Run / Cloud Functions Gen 2 फंक्शन को इन्वोक करता है। |
Cloud SQL
| टूल | विवरण |
|---|
| इंस्टेंस सूचीबद्ध करें | प्रोजेक्ट में Cloud SQL इंस्टेंस (Postgres, MySQL, SQL Server) सूचीबद्ध करता है। |
| इंस्टेंस प्राप्त करें | विशिष्ट Cloud SQL इंस्टेंस का मेटाडेटा प्राप्त करता है (इंजन, IPs, संस्करण)। |
| क्वेरी निष्पादित करें | Python कनेक्टर के माध्यम से Cloud SQL इंस्टेंस पर SQL क्वेरी चलाता है। |
जेनेरिक
| टूल | विवरण |
|---|
| कस्टम API कॉल | किसी भी Google Cloud REST API के लिए प्रमाणित अनुरोध करता है। जब आपके आवश्यक ऑपरेशन के लिए कोई समर्पित टूल न हो तो इसका उपयोग करें। |
अपनी कॉन्फ़िगरेशन सहेजें
अपनी कॉन्फ़िगरेशन लागू करने के लिए Save पर क्लिक करें, या नए एजेंट्स के लिए यह कॉन्फ़िगरेशन डिफ़ॉल्ट बनाने के लिए Set as Default पर क्लिक करें। एजेंट से पूरी तरह से टूलकिट हटाने के लिए Remove Toolkit पर क्लिक करें। 
