ADK एआई एजेंट और Gemini मॉडल की मदद से, तथ्यों की जांच करना

कोडिंग स्तर: उन्नत
अवधि: 30 मिनट
प्रोजेक्ट प्रकार: कस्टम फ़ंक्शन

खास जानकारी

Google Sheets के लिए, तथ्यों की जांच करने वाला कस्टम फ़ंक्शन. इसका इस्तेमाल, Apps Script के बाउंड प्रोजेक्ट के तौर पर किया जा सकता है. यह Vertex AI एजेंट और Gemini मॉडल पर आधारित है.

इस सैंपल में दिखाया गया है कि Google Sheets की स्प्रेडशीट में, दो तरह के एआई संसाधनों का इस्तेमाल कैसे किया जा सकता है:

  1. Vertex AI Agent Engine में डिप्लॉय किए गए ADK एजेंट का इस्तेमाल करके, एआई एजेंट को कई टूल और कई चरणों में तर्क करने की बेहतर क्षमताएं मिलती हैं.
  2. Vertex AI के Gemini मॉडल का इस्तेमाल करके, बेहतर तरीके से समझने, जनरेटिव, और खास जानकारी देने की सुविधाएँ देने वाले एआई मॉडल.

तथ्य की जांच करने वाले Google Sheets कस्टम फ़ंक्शन के इस्तेमाल का सैंपल

मकसद

  • यह समझना कि समाधान क्या करता है.
  • जानें कि समाधान को कैसे लागू किया जाता है.
  • Vertex AI एजेंट को डिप्लॉय करें.
  • स्क्रिप्ट सेट अप करें.
  • स्क्रिप्ट चलाएं.

इस समाधान के बारे में जानकारी

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

  • इस्तेमाल:
    • =FACT_CHECK("Your statement here") का इस्तेमाल करके, कम शब्दों में जानकारी पाएं.
    • =FACT_CHECK("Your statement here", "Your output formatting instructions here") का इस्तेमाल करके, आउटपुट को किसी खास फ़ॉर्मैट में बदलें.
  • वजह: LLM Auditor ADK AI Agent (Python का सैंपल).
  • आउटपुट फ़ॉर्मैटिंग: Gemini मॉडल.

यह समाधान, UrlFetchApp का इस्तेमाल करके Vertex AI REST API का अनुरोध करता है.

आर्किटेक्चर

इस डायग्राम में, Google Workspace और Google Cloud के उन संसाधनों का आर्किटेक्चर दिखाया गया है जिनका इस्तेमाल कस्टम फ़ंक्शन करता है.

तथ्यों की जांच करने वाले Google Sheets के कस्टम फ़ंक्शन का आर्किटेक्चर डायग्राम

ज़रूरी शर्तें

इस सैंपल का इस्तेमाल करने के लिए, आपको इन ज़रूरी शर्तों को पूरा करना होगा:

वातावरण तैयार करें

इस सेक्शन में, Google Cloud प्रोजेक्ट बनाने और उसे कॉन्फ़िगर करने का तरीका बताया गया है.

Google क्लाउड प्रोजेक्ट बनाएँ

Google Cloud कंसोल

  1. Google क्लाउड कंसोल में, मेनू > IAM और एडमिन > प्रोजेक्ट बनाएं पर जाएं.

    प्रोजेक्ट बनाएं पर जाएं

  2. प्रोजेक्ट का नाम फ़ील्ड में, अपने प्रोजेक्ट के लिए जानकारी देने वाला नाम डालें.

    वैकल्पिक: प्रोजेक्ट आईडी संपादित करने के लिए, संपादित करें पर क्लिक करें. प्रोजेक्ट बनाने के बाद प्रोजेक्ट आईडी को बदला नहीं जा सकता, इसलिए ऐसी आईडी चुनें जो प्रोजेक्ट के जीवनकाल के लिए आपकी आवश्यकताओं को पूरा करे.

  3. जगह फ़ील्ड में, ब्राउज़ करें पर क्लिक करके, अपने प्रोजेक्ट के लिए संभावित जगहें दिखाएं. फिर, चुनें पर क्लिक करें.
  4. बनाएं पर क्लिक करें. गूगल क्लाउड कंसोल डैशबोर्ड पेज पर ले जाता है और आपका प्रोजेक्ट कुछ ही मिनटों में बन जाता है.

gcloud सीएलआई

नीचे दिए गए डेवलपमेंट एनवायरमेंट में से किसी एक में, Google Cloud CLI (gcloud) को ऐक्सेस करें:

  • Cloud Shell: gcloud CLI के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell चालू करें.
    Cloud Shell चालू करें
  • लोकल शेल: लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, gcloud सीएलआई को इंस्टॉल करें और शुरू करें.
    Cloud प्रोजेक्ट बनाने के लिए, gcloud projects create कमांड का इस्तेमाल करें: 
    gcloud projects create PROJECT_ID
     आपको जिस प्रोजेक्ट को बनाना है उसके लिए आईडी सेट करके, PROJECT_ID को बदलें.

Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करना

Google Cloud कंसोल

  1. Google Cloud Console में, बिलिंग पर जाएं. मेन्यू > बिलिंग > मेरे प्रोजेक्ट पर क्लिक करें.

    'मेरे प्रोजेक्ट के लिए बिलिंग' पर जाएं

  2. कोई संगठन चुनें में जाकर, वह संगठन चुनें जो आपके Google Cloud प्रोजेक्ट से जुड़ा है.
  3. प्रोजेक्ट की लाइन में, कार्रवाइयां मेन्यू () खोलें. इसके बाद, बिलिंग बदलें पर क्लिक करें और Cloud Billing खाता चुनें.
  4. खाता सेट करें पर क्लिक करें.

gcloud सीएलआई

  1. उपलब्ध बिलिंग खातों की सूची देखने के लिए, यह कमांड चलाएं: 
    gcloud billing accounts list
  2. किसी बिलिंग खाते को Google Cloud प्रोजेक्ट से लिंक करने के लिए: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    इनकी जगह ये डालें:

    • PROJECT_ID उस Cloud प्रोजेक्ट का प्रोजेक्ट आईडी है जिसके लिए आपको बिलिंग की सुविधा चालू करनी है.
    • BILLING_ACCOUNT_ID वह बिलिंग खाता आईडी है जिसे Google Cloud प्रोजेक्ट से लिंक करना है.

वर्टेक्स AI API सक्षम करें

Google Cloud कंसोल

  1. Google क्लाउड कंसोल में, Vertex AI API सक्षम करें.

    एपीआई चालू करना

  2. पुष्टि करें कि आपने सही Cloud प्रोजेक्ट में Vertex AI API चालू किया है. इसके बाद, आगे बढ़ें पर क्लिक करें.

  3. पुष्टि करें कि आपने सही एपीआई चालू किया है. इसके बाद, चालू करें पर क्लिक करें.

gcloud सीएलआई

  1. यदि आवश्यक हो, तो वर्तमान क्लाउड प्रोजेक्ट को उस प्रोजेक्ट पर सेट करें जिसे आपने gcloud config set project कमांड से बनाया था:

    gcloud config set project PROJECT_ID

    PROJECT_ID को आपके द्वारा बनाए गए क्लाउड प्रोजेक्ट की प्रोजेक्ट आईडी से बदलें.

  2. gcloud services enable कमांड का इस्तेमाल करके, Vertex AI API चालू करें:

    gcloud services enable aiplatform.googleapis.com

Google क्लाउड कंसोल में एक सेवा खाता बनाएँ

इन चरणों का पालन करके Vertex AI User भूमिका वाला एक नया सेवा खाता बनाएँ:

Google Cloud कंसोल

  1. Google क्लाउड कंसोल में, मेनू > IAM और एडमिन > सेवा खाते पर जाएं.

    सेवा खातों पर जाएं

  2. सेवा खाता बनाएं पर क्लिक करें.
  3. सेवा खाते का विवरण भरें, फिर बनाएँ और जारी रखें पर क्लिक करें.
  4. ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि उसे आपके Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस मिल सके. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, उसमें बदलाव करना, और उसे रद्द करना लेख पढ़ें.
  5. जारी रखें पर क्लिक करें.
  6. उन उपयोगकर्ताओं या ग्रुप के नाम डालें जिनके पास इस सेवा खाते को मैनेज करने और इससे जुड़ी कार्रवाइयां करने का ऐक्सेस है. हालांकि, यह ज़रूरी नहीं है. ज़्यादा जानकारी के लिए, सेवा खाते के डुप्लीकेट को मैनेज करना लेख पढ़ें.
  7. हो गया पर क्लिक करें. सेवा खाते के लिए ईमेल पता नोट कर लें.

gcloud सीएलआई

  1. सेवा खाता बनाएं: 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. ज़रूरी नहीं: अपने सेवा खाते को भूमिकाएं असाइन करें, ताकि उसे आपके Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस मिल सके. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, उसमें बदलाव करना, और उसे रद्द करना लेख पढ़ें.

सेवा खाता, सेवा खाते वाले पेज पर दिखता है. इसके बाद, सेवा खाते के लिए निजी कुंजी बनाएं.

निजी कुंजी बनाना

सेवा खाते के लिए निजी कुंजी बनाने और डाउनलोड करने के लिए, इन चरणों का पालन करें:

  1. Google Cloud console में, मेन्यू &gt आईएएम और एडमिन &gt सेवा खाते पर जाएं.

    सेवा खातों पर जाएं

  2. अपना सेवा खाता चुनें.
  3. कुंजी > कुंजी जोड़ें > नई कुंजी बनाएं पर क्लिक करें.
  4. JSON को चुनें. इसके बाद, बनाएं पर क्लिक करें.

    आपके नए सार्वजनिक/निजी पासकोड को कंप्यूटर में बनाया और डाउनलोड किया जाता है. यह पासकोड की इकलौती कॉपी होती है. डाउनलोड की गई JSON फ़ाइल को अपनी वर्किंग डायरेक्ट्री में credentials.json के तौर पर सेव करें. यह फ़ाइल, इस कुंजी की एकमात्र कॉपी है. अपनी कुंजी को सुरक्षित तरीके से सेव करने के बारे में जानकारी के लिए, सेवा खाते की कुंजियां मैनेज करना लेख पढ़ें.

  5. बंद करें पर क्लिक करें.

सेवा खातों के बारे में ज़्यादा जानने के लिए, Google Cloud IAM के दस्तावेज़ में सेवा खाते लेख पढ़ें.

एलएलएम ऑडिटर एडीके एआई एजेंट तैनात करें

  1. अगर आपने अब तक ऐसा नहीं किया है, तो अपने Google Cloud खाते से पुष्टि करें. साथ ही, Google Cloud प्रोजेक्ट का इस्तेमाल करने के लिए, Google Cloud CLI को कॉन्फ़िगर करें.

    gcloud auth application-default login
gcloud config set project PROJECT_ID
gcloud auth application-default set-quota-project PROJECT_ID

    PROJECT_ID की जगह, बनाए गए Cloud प्रोजेक्ट का आईडी डालें.

  2. GitHub की इस रिपॉज़िटरी को डाउनलोड करें

    डाउनलोड करें

  3. अपने पसंदीदा स्थानीय विकास परिवेश में, डाउनलोड की गई संग्रह फ़ाइल निकालें और adk-samples/python/agents/llm-auditor निर्देशिका खोलें.

    unzip adk-samples-main.zip
cd adk-samples-main/python/agents/llm-auditor

  4. ADK एजेंट के लिए, नया Cloud Storage बकेट बनाएं.

    gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

    इनकी जगह ये डालें:

    1. CLOUD_STORAGE_BUCKET_NAME को अपनी पसंद के किसी यूनीक बकेट नाम से बदलें.
    2. PROJECT_ID आपके द्वारा बनाए गए क्लाउड प्रोजेक्ट की आईडी के साथ.
    3. PROJECT_LOCATION को कॉल करें. इसमें आपने जिस क्लाउड प्रोजेक्ट को बनाया है उसकी लोकेशन शामिल करें.

  5. इन एनवायरमेंट वैरिएबल को सेट करें:

    export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME

    इनकी जगह ये डालें:

    1. CLOUD_STORAGE_BUCKET_NAME में, बनाए गए बकेट का नाम डालें.
    2. PROJECT_ID आपके द्वारा बनाए गए क्लाउड प्रोजेक्ट की आईडी के साथ.
    3. PROJECT_LOCATION को कॉल करें. इसमें आपने जिस क्लाउड प्रोजेक्ट को बनाया है उसकी लोकेशन शामिल करें.

  6. वर्चुअल एनवायरमेंट से ADK एजेंट को इंस्टॉल और डिप्लॉय करें.

    python3 -m venv myenv
source myenv/bin/activate
poetry install --with deployment
python3 deployment/deploy.py --create

  7. एजेंट आईडी पाएं. आपको कस्टम फ़ंक्शन कॉन्फ़िगर करने के लिए, इसकी ज़रूरत बाद में पड़ेगी.

    python3 deployment/deploy.py --list

सैंपल कोड की समीक्षा करें

ज़रूरी नहीं: नई स्प्रेडशीट बनाने से पहले, GitHub पर होस्ट किए गए सैंपल कोड को एक बार देख लें और उसके बारे में जान लें.

GitHub पर देखें

नई स्प्रेडशीट में बनाना और कॉन्फ़िगर करना

  1. नीचे दिए गए बटन पर क्लिक करें और Google Sheets की सैंपल स्प्रेडशीट की पूरी कॉपी बनाएं. इसमें कंटेनर से जुड़ा Apps Script प्रोजेक्ट भी शामिल है.

    Google शीट स्प्रेडशीट कॉपी करें

  2. नई बनाई गई स्प्रेडशीट में, एक्सटेंशन > Apps Script पर जाएं.

  3. ऐप्स स्क्रिप्ट प्रोजेक्ट में, प्रोजेक्ट सेटिंग पर जाएं, स्क्रिप्ट प्रॉपर्टी संपादित करें पर क्लिक करें, फिर निम्न स्क्रिप्ट प्रॉपर्टी जोड़ने के लिए स्क्रिप्ट प्रॉपर्टी जोड़ें पर क्लिक करें:

    1. LOCATION, जिसमें पिछले चरणों में बनाए गए Google Cloud प्रोजेक्ट की जगह की जानकारी हो. जैसे, us-central1.
    2. GEMINI_MODEL_ID को उस जेमिनी मॉडल के साथ जोड़ें जिसका आप उपयोग करना चाहते हैं, जैसे कि gemini-2.5-flash-lite.
    3. REASONING_ENGINE_ID में, पिछले चरणों में डिप्लॉय किए गए एलएलएम ऑडिटर एडीके एजेंट का आईडी डालें. जैसे, 1234567890.
    4. SERVICE_ACCOUNT_KEY को पिछले चरणों में डाउनलोड किए गए सेवा खाते से JSON कुंजी के साथ, जैसे कि { ... }.

  4. स्क्रिप्ट प्रॉपर्टी सेव करें पर क्लिक करें

कस्टम फ़ंक्शन की जांच करना

  1. नई बनाई गई स्प्रेडशीट पर जाएं.
  2. कॉलम A में दिए गए स्टेटमेंट बदलें.
  3. कॉलम B में सूत्र निष्पादित होते हैं और फिर तथ्य-जांच परिणाम प्रदर्शित करते हैं.

व्यवस्थित करें

इस ट्यूटोरियल में उपयोग किए गए संसाधनों के लिए आपके Google क्लाउड खाते पर लगने वाले शुल्क से बचने के लिए, हम अनुशंसा करते हैं कि आप क्लाउड प्रोजेक्ट को हटा दें.

  1. Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.

    Resource Manager पर जाएं

  2. प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
  3. डायलॉग बॉक्स में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट मिटाने के लिए बंद करें पर क्लिक करें.

अगले चरण