> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cloud Platform टूलकिट

> सर्विस-अकाउंट कनेक्शन का उपयोग करके अपने एजेंट को BigQuery, Cloud Run और Cloud SQL से कनेक्ट करें।

**Google Cloud Platform (GCP) टूलकिट** आपके एजेंट को BigQuery, Cloud Run (सर्विसेज़ और HTTP-ट्रिगर्ड फंक्शंस) और Cloud SQL के साथ इंटरैक्ट करने में सक्षम बनाता है। प्रमाणीकरण एक सर्विस-अकाउंट JSON कुंजी के माध्यम से किया जाता है जो कनेक्शन के रूप में संग्रहीत होता है — एजेंट सर्विस अकाउंट के रूप में कार्य करता है और इसकी IAM भूमिकाएं विरासत में प्राप्त करता है।

## पूर्वावश्यकताएं

GCP टूलकिट कॉन्फ़िगर करने से पहले, आपको एक सक्रिय Google Cloud कनेक्शन चाहिए। यदि आपने अभी तक सेटअप नहीं किया है, तो बनाने के लिए **Settings → Connections** पर जाएं।

<Info>
  कनेक्शन Settings → Connections में केंद्रीय रूप से प्रबंधित होते हैं। सर्विस-अकाउंट JSON एन्क्रिप्टेड रूप से संग्रहीत होता है; केवल `client_email` और प्रोजेक्ट एजेंट्स को दिखाई देते हैं।
</Info>

## एजेंट में टूलकिट जोड़ना

1. अपना एजेंट खोलें और **Toolkits** पर जाएं।
2. **Google Cloud Platform** खोजें और **Add to Agent** पर क्लिक करें।
3. कॉन्फ़िगरेशन पैनल खोलने के लिए **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** पर क्लिक करें।