Google Workspace के सभी ऐप्लिकेशन में उपलब्ध एआई एजेंट की मदद से यात्राओं की योजना बनाना

कोडिंग का लेवल: ऐडवांस
अवधि: 45 मिनट
प्रोजेक्ट का टाइप: Google Workspace ऐड-ऑन जो Chat, Gmail, Calendar, Drive, Docs, Sheets, और Slides के साथ काम करता है.

इस ट्यूटोरियल में, Apps Script या एचटीटीपी एंडपॉइंट का इस्तेमाल करके, एआई एजेंटों को Google Workspace में Google Workspace ऐड-ऑन के तौर पर पब्लिश करने का तरीका बताया गया है. ऐड-ऑन पब्लिश करने के बाद, उपयोगकर्ता अपने वर्कफ़्लो में एआई एजेंटों के साथ इंटरैक्ट कर सकते हैं.

खास जानकारी

इस ट्यूटोरियल में, एजेंट डेवलपमेंट किट (एडीके) से ट्रैवल कंसीयर्ज सैंपल को डिप्लॉय किया जाता है. Travel Concierge, बातचीत करने वाला मल्टी-एजेंट एआई है. यह Google Maps Platform Places API, Google Search Grounding, और मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर जैसे टूल का इस्तेमाल करता है.

ADK, डेवलपर के लिए डिफ़ॉल्ट रूप से चैट और टेक्स्ट इंटरफ़ेस उपलब्ध कराता है. इस ट्यूटोरियल में, Google Workspace ऐप्लिकेशन में एक ग्राफ़िकल यूज़र इंटरफ़ेस (जीयूआई) जोड़ा जाता है. इससे आपके उपयोगकर्ता, Chat, Gmail, Calendar, Drive, Docs, Sheets, और Slides में सीधे तौर पर ऐक्सेस कर सकते हैं.

  • यात्रा के आइडिया पर सोच-विचार करने के लिए, Chat के एआई एजेंट का इस्तेमाल करना.
    पहली इमेज. यात्रा के आइडिया पर सोच-विचार करने के लिए, Chat के एआई एजेंट का इस्तेमाल करना.
  • चुने गए ईमेल के कॉन्टेक्स्ट के आधार पर, यात्रा की योजना बनाने के लिए Gmail के एआई एजेंट का इस्तेमाल करना.
    दूसरी इमेज. चुने गए ईमेल के कॉन्टेक्स्ट के आधार पर, यात्रा की योजना बनाने के लिए Gmail के एआई एजेंट का इस्तेमाल करना.

मकसद

  • एनवायरमेंट सेट अप करें.
  • एआई एजेंट को डिप्लॉय करें.
  • प्रोजेक्ट सेट अप करें.
  • Gmail, Calendar, Drive, Docs, Sheets, और Slides में डिप्लॉय करें.
  • Chat में डिप्लॉय करें.
  • समस्या हल होने की पुष्टि करें.

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

यह समाधान, इन मुख्य टेक्नोलॉजी पर आधारित है: ADK, Google Cloud और Google Workspace API, Vertex AI Agent Engine, और कार्ड फ़्रेमवर्क.

Chat और Chat के अलावा अन्य ऐप्लिकेशन (Gmail, Calendar, Drive, Docs, Sheets, Slides) के लिए, जीयूआई अलग-अलग डिज़ाइन किए गए हैं. ऐसा इसलिए किया गया है, ताकि उनकी खास सुविधाओं और सीमाओं को ध्यान में रखा जा सके.

सुविधाएं

Travel Concierge ऐप्लिकेशन की ये सुविधाएं, Google Workspace के सभी ऐप्लिकेशन में उपलब्ध हैं:

  • उपयोगकर्ता के परसिस्टेंट सेशन: सेशन को Vertex AI मैनेज करता है, ताकि वे बने रहें. हर उपयोगकर्ता, सभी Workspace ऐप्लिकेशन के साथ एक सेशन शेयर करता है. उपयोगकर्ता, नई बातचीत शुरू करने के लिए अपने सेशन को मैन्युअल तरीके से रीसेट कर सकते हैं.

  • रिच मैसेजिंग: इसमें उपयोगकर्ता, टेक्स्ट मैसेज भेजते हैं और उन्हें रिस्पॉन्स में रिच टेक्स्ट और कार्ड विजेट मिलते हैं.

  • गड़बड़ी ठीक करना: अनचाही गड़बड़ियों को ठीक करने के लिए, कॉन्फ़िगर किए जा सकने वाले फिर से कोशिश करने के तरीके और जवाबों में स्टेटस का इस्तेमाल किया जाता है.

Chat ऐप्लिकेशन में ये अतिरिक्त सुविधाएं उपलब्ध हैं:

  • मल्टीमॉडल मैसेजिंग: उपयोगकर्ता अटैचमेंट के साथ मैसेज भेज सकते हैं. इनमें सीधे तौर पर Chat स्पेस से रिकॉर्ड किया गया ऑडियो और वीडियो शामिल है.

  • ज़्यादा बेहतर विज़ुअल वाले जवाब: जवाबों को ज़्यादा बेहतर विजेट की मदद से जनरेट किया जा सकता है. जैसे, इमेज वाले कैरसेल. इसके लिए, Card फ़्रेमवर्क की सिर्फ़ चैट वाली सुविधाओं और ज़्यादा रेंडरिंग स्पेस का इस्तेमाल किया जाता है.

अन्य ऐप्लिकेशन में ये अतिरिक्त सुविधाएं उपलब्ध हैं:

  • Google प्रोफ़ाइल का कॉन्टेक्स्ट: उपयोगकर्ता अपनी प्रोफ़ाइल की जानकारी के साथ मैसेज भेज सकते हैं. इस सैंपल में, यह जानकारी सिर्फ़ जन्मदिन तक सीमित है.

  • Gmail के हिसाब से कॉन्टेक्स्ट: उपयोगकर्ता, ईमेल के साथ मैसेज भेज सकते हैं. इस सैंपल में, सिर्फ़ एक विषय और मुख्य हिस्से का इस्तेमाल किया गया है.

  • एजेंट के Chat स्पेस का ऐक्सेस: उपयोगकर्ता, एक बटन पर क्लिक करके Chat ऐप्लिकेशन के डायरेक्ट मैसेज (डीएम) स्पेस को नए टैब में खोल सकते हैं.

आर्किटेक्चर

Travel Concierge ऐप्लिकेशन, Google Workspace ऐप्लिकेशन से Google Workspace ऐड-ऑन इंटरैक्शन इवेंट पाता है और उन्हें प्रोसेस करता है. यह ADK के एआई एजेंट को प्रॉम्प्ट करने और उपयोगकर्ता के सेशन मैनेज करने के लिए, Vertex AI का इस्तेमाल करता है. साथ ही, कॉन्टेक्स्ट इकट्ठा करने और जवाब दिखाने के लिए, Google Cloud और Google Workspace API पर निर्भर रहता है.

नीचे दिए गए डायग्राम में, उपयोगकर्ता के मुख्य फ़्लो को दिखाया गया है: एआई एजेंट को मैसेज भेजना.

HTTP

  • Chat ऐप्लिकेशन के आर्किटेक्चर का डायग्राम.
    तीसरी इमेज. Chat ऐप्लिकेशन, उपयोगकर्ता के मैसेज से मिले अटैचमेंट के साथ कॉन्टेक्स्ट को पूरा करता है. इसके बाद, यह सब-एजेंट के साथ हुई बातचीत के इतिहास और क्रम के हिसाब से जवाबों का सेट भेजता है.
  • Chat के अलावा अन्य ऐप्लिकेशन के लिए आर्किटेक्चर डायग्राम.
    चौथी इमेज. चैट के अलावा अन्य ऐप्लिकेशन, उपयोगकर्ता की Google प्रोफ़ाइल और आइटम के चुने जाने की जानकारी के साथ कॉन्टेक्स्ट पूरा करते हैं. साथ ही, सब-एजेंट के इंटरैक्शन का इतिहास और आखिरी जवाब, उल्टे कालानुक्रम में सेक्शन के सेट के साथ दिखाते हैं.

Apps Script

  • Chat ऐप्लिकेशन के आर्किटेक्चर का डायग्राम.
    तीसरी इमेज. Chat ऐप्लिकेशन, उपयोगकर्ता के मैसेज से मिले अटैचमेंट के साथ कॉन्टेक्स्ट को पूरा करता है. इसके बाद, यह सब-एजेंट के साथ हुई बातचीत के इतिहास और क्रम के हिसाब से जवाबों का सेट भेजता है.
  • Chat के अलावा अन्य ऐप्लिकेशन के लिए आर्किटेक्चर डायग्राम.
    चौथी इमेज. चैट के अलावा अन्य ऐप्लिकेशन, उपयोगकर्ता की Google प्रोफ़ाइल और आइटम के चुने जाने की जानकारी के साथ कॉन्टेक्स्ट पूरा करते हैं. साथ ही, सब-एजेंट के इंटरैक्शन का इतिहास और आखिरी जवाब, उल्टे कालानुक्रम में सेक्शन के सेट के साथ दिखाते हैं.

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

एनवायरमेंट तैयार करना

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

Google Cloud प्रोजेक्ट बनाना

Google Cloud कंसोल

  1. Google Cloud console में, मेन्यू &gt IAM और एडमिन &gt प्रोजेक्ट बनाएं पर जाएं.

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

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

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

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

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 प्रोजेक्ट से लिंक करना है.

Google Cloud API चालू करना

HTTP

  1. Google Cloud Console में, Vertex AI, Places, People, Google Chat, Gmail, Cloud Build, Cloud Functions, Cloud Pub/Sub, Cloud Logging, Artifact Registry, Cloud Run, और Google Workspace ऐड-ऑन API चालू करें.

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

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

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

Apps Script

  1. Google Cloud Console में, Vertex AI, Places, People, और Google Chat API चालू करें.

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

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

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

Google Maps Platform Places API का पासकोड पाना

  1. Google Cloud Console में, Google Maps Platform > पासकोड और क्रेडेंशियल पेज पर जाएं.

    कुंजियां और क्रेडेंशियल पर जाएं

  2. Google Maps Platform का इस्तेमाल शुरू करें डायलॉग बॉक्स में, नया एपीआई पासकोड दिखता है. यह एक अल्फ़ान्यूमेरिक स्ट्रिंग होती है. आपको इस स्ट्रिंग की ज़रूरत अगले सेक्शन में पड़ेगी.

Google Cloud Console में सेवा खाता बनाना

Vertex AI User की भूमिका वाला नया सेवा खाता बनाने के लिए, यह तरीका अपनाएं:

Google Cloud कंसोल

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

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

  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 के दस्तावेज़ में सेवा खाते लेख पढ़ें.

Google Workspace ऐड-ऑन के लिए, सहमति वाली स्क्रीन को कॉन्फ़िगर करना ज़रूरी है. अपने ऐड-ऑन के लिए, OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करने से यह तय होता है कि Google, उपयोगकर्ताओं को क्या दिखाएगा.

  1. Google Cloud Console में, मेन्यू > Google Auth platform > ब्रैंडिंग पर जाएं.

    ब्रैंडिंग पर जाएं

  2. अगर आपने पहले ही Google Auth platformको कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth platform अभी तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
    1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में ऐप्लिकेशन का नाम डालें.
    2. उपयोगकर्ता सहायता के लिए ईमेल पता में, सहायता के लिए वह ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
    3. आगे बढ़ें पर क्लिक करें.
    4. दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें.
    5. आगे बढ़ें पर क्लिक करें.
    6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना मिल सके.
    7. आगे बढ़ें पर क्लिक करें.
    8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
    9. जारी रखें पर क्लिक करें.
    10. बनाएं पर क्लिक करें.
  3. फ़िलहाल, स्कोप जोड़ने की प्रोसेस को स्किप किया जा सकता है. अगर आपको आने वाले समय में, अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाना है, तो आपको उपयोगकर्ता का टाइप बदलकर बाहरी करना होगा. इसके बाद, अपने ऐप्लिकेशन के लिए ज़रूरी अनुमति के स्कोप जोड़ें. ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करना गाइड पढ़ें.

यात्रा कंसीयज के लिए, ADK एआई एजेंट को डिप्लॉय करना

  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/travel-concierge डायरेक्ट्री खोलें.

    unzip adk-samples-main.zip
cd adk-samples-main/python/agents/travel-concierge

  4. एडीके एआई एजेंट के लिए, एक नया 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 को उस Cloud प्रोजेक्ट के आईडी से बदलें जिसे आपने बनाया है.
    3. PROJECT_LOCATION को कॉल करें. इसमें आपने जिस क्लाउड प्रोजेक्ट को बनाया है उसकी लोकेशन शामिल करें.

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

    export GOOGLE_GENAI_USE_VERTEXAI=1
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
export GOOGLE_PLACES_API_KEY=PLACES_API_KEY
export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME
export TRAVEL_CONCIERGE_SCENARIO=travel_concierge/profiles/itinerary_empty_default.json

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

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

  6. ADK के एआई एजेंट को इंस्टॉल और डिप्लॉय करें.

    uv sync --group deployment
uv run python deployment/deploy.py --create

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

    Created remote agent: projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/ENGINE_ID

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

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

Python

GitHub पर देखें

Apps Script

GitHub पर देखें

प्रोजेक्ट बनाना और उसे कॉन्फ़िगर करना

Python

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

    डाउनलोड करें

  2. अपने पसंदीदा लोकल डेवलपमेंट एनवायरमेंट में, डाउनलोड की गई संग्रह फ़ाइल को निकालें और add-ons-samples/python/travel-adk-ai-agent डायरेक्ट्री खोलें.

    unzip add-ons-samples-main.zip
cd add-ons-samples-main/python/travel-adk-ai-agent

  3. पिछले चरणों में डाउनलोड की गई सेवा खाते की JSON कुंजी वाली फ़ाइल credentials.json को प्रोजेक्ट डायरेक्ट्री में ले जाएं.

  4. Google Cloud Console में, Cloud Run पर जाएं:

    Cloud Run पर जाएं

  5. फ़ंक्शन लिखें पर क्लिक करें.

  6. सेवा बनाएं पेज पर, अपना फ़ंक्शन सेट अप करें:

    1. सेवा का नाम फ़ील्ड में, travel-concierge-app डालें.
    2. रीजन सूची में, बनाए गए Cloud प्रोजेक्ट की जगह चुनें PROJECT_LOCATION.
    3. एंडपॉइंट यूआरएल में जाकर, कॉपी बनाने का आइकॉन पर क्लिक करें.
    4. रनटाइम सूची में, Python का सबसे नया वर्शन चुनें.
    5. पुष्टि करें सेक्शन में जाकर, सार्वजनिक ऐक्सेस की अनुमति दें को चुनें.
    6. कंटेनर, वॉल्यूम, नेटवर्किंग, सुरक्षा सेक्शन में, संसाधन में जाकर:
      1. मेमोरी फ़ील्ड में, 1 GiB चुनें.
      2. सीपीयू फ़ील्ड में, 2 चुनें.
    7. बनाएं पर क्लिक करें. इसके बाद, Cloud Run को सेवा बनाने दें. कंसोल आपको सोर्स टैब पर रीडायरेक्ट करता है.

  7. अपने पसंदीदा लोकल डेवलपमेंट एनवायरमेंट में, प्रोजेक्ट का सोर्स डिप्लॉय करें:

    gcloud run deploy travel-concierge-app --quiet --source . \
    --region PROJECT_LOCATION  \
    --function adk_ai_agent  \
    --set-env-vars LOCATION=LOCATION,PROJECT_NUMBER=PROJECT_NUMBER,ENGINE_ID=ENGINE_ID,BASE_URL=BASE_URL

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

    1. PROJECT_LOCATION में, Cloud Run फ़ंक्शन की जगह की जानकारी शामिल हो, जिसे आपने पहले बनाया था.
    2. LOCATION में, पिछले चरणों में बनाए गए Google Cloud प्रोजेक्ट की जगह की जानकारी शामिल है, PROJECT_LOCATION.
    3. PROJECT_NUMBER में, पिछले चरणों में डिप्लॉय किए गए Travel Concierge ADK एआई एजेंट का प्रोजेक्ट नंबर डालें.
    4. ENGINE_ID में, पिछले चरणों में डिप्लॉय किए गए Travel Concierge ADK AI एजेंट का इंजन आईडी डालें.
    5. BASE_URL में, वह एंडपॉइंट यूआरएल डालें जिसे आपने पहले कॉपी किया था.

Apps Script

Apps Script प्रोजेक्ट बनाने और उसे डिप्लॉय किए गए Travel Concierge ADK AI एजेंट का इस्तेमाल करने के लिए कॉन्फ़िगर करने का तरीका:

  1. Travel Concierge ADK AI Agent Apps Script प्रोजेक्ट खोलने के लिए, यहां दिए गए बटन पर क्लिक करें.
    प्रोजेक्ट खोलें

  2. खास जानकारी पर क्लिक करें. इसके बाद, कॉपी बनाने का आइकॉन कॉपी बनाएं पर क्लिक करें.

  3. Apps Script प्रोजेक्ट की कॉपी का नाम डालें:

    1. Copy of Travel Concierge ADK AI Agent पर क्लिक करें.
    2. प्रोजेक्ट का टाइटल में, Travel Concierge ADK AI Agent टाइप करें.
    3. नाम बदलें पर क्लिक करें.

  4. अपने Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग का आइकॉन एडिटर पर क्लिक करें. इसके बाद, फ़ाइल को तब तक ऊपर ले जाएं, जब तक वह फ़ाइल AgentHandler.gs के ऊपर न आ जाए. इसके लिए, फ़ाइल ऐक्शन फ़ाइल को ऊपर ले जाएं का इस्तेमाल करें.VertexAi.gs

  5. अपने Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग का आइकॉन प्रोजेक्ट की सेटिंग पर क्लिक करें. इसके बाद, स्क्रिप्ट की प्रॉपर्टी में बदलाव करें पर क्लिक करें. इसके बाद, स्क्रिप्ट की प्रॉपर्टी जोड़ें पर क्लिक करके, स्क्रिप्ट की ये प्रॉपर्टी जोड़ें:

  6. ENGINE_ID को पिछले चरणों में डिप्लॉय किए गए, Travel Concierge ADK के एआई एजेंट के इंजन आईडी ENGINE_ID से बदलें.

  7. LOCATION में, पिछले चरणों में बनाए गए Google Cloud प्रोजेक्ट की जगह की जानकारी PROJECT_LOCATION.

  8. PROJECT_NUMBER में, पिछले चरणों में डिप्लॉय किए गए Travel Concierge ADK AI एजेंट का प्रोजेक्ट नंबर डालें PROJECT_NUMBER.

  9. SERVICE_ACCOUNT_KEY में, सेवा खाते से डाउनलोड की गई JSON कुंजी डालें. जैसे, { ... }.

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

  11. अपने Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग का आइकॉन प्रोजेक्ट की सेटिंग पर क्लिक करें.

  12. Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.

  13. GCP प्रोजेक्ट नंबर में, पिछले चरणों में डिप्लॉय किए गए Travel Concierge ADK AI एजेंट का प्रोजेक्ट नंबर चिपकाएं, PROJECT_NUMBER.

  14. प्रोजेक्ट सेट करें पर क्लिक करें. अब Cloud प्रोजेक्ट और Apps Script प्रोजेक्ट कनेक्ट हो गए हैं.

Gmail, Calendar, Drive, Docs, Sheets, Slides में डिप्लॉय करें

Python

Google Workspace ऐड-ऑन डिप्लॉयमेंट का इस्तेमाल करके, सभी Google Workspace ऐप्लिकेशन (Google Chat को छोड़कर) में सैंपल प्रोजेक्ट इंस्टॉल करें, ताकि टेस्टिंग की जा सके.

  1. अपने पसंदीदा लोकल डेवलपमेंट एनवायरमेंट में, प्रोजेक्ट के कोड सोर्स से deployment.json फ़ाइल खोलें. इसके बाद, $BASE_URL की सभी जगहों पर BASE_URL की वैल्यू डालें. यह एंडपॉइंट यूआरएल है, जिसे आपने पिछले चरणों में कॉपी किया था.

  2. travel-concierge-addon नाम का Google Workspace ऐड-ऑन डिप्लॉयमेंट बनाएं:

    gcloud workspace-add-ons deployments create travel-concierge-addon \
    --deployment-file=deployment.json

  3. Google Workspace ऐड-ऑन डिप्लॉयमेंट इंस्टॉल करें:

    gcloud workspace-add-ons deployments install travel-concierge-addon

Apps Script

जांच करने के लिए, Apps Script प्रोजेक्ट को Google Workspace के सभी ऐप्लिकेशन (Google Chat को छोड़कर) में इंस्टॉल करें.

  1. अपने Apps Script प्रोजेक्ट में, डिप्लॉय करें > डिप्लॉयमेंट की जांच करें पर क्लिक करें. इसके बाद, इंस्टॉल करें पर क्लिक करें.

अब इस ऐड-ऑन को Google Workspace ऐप्लिकेशन के साइडबार से ऐक्सेस किया जा सकता है.

Chat में डिप्लॉय करना

Python

जांच करने के लिए, एंडपॉइंट यूआरएल का इस्तेमाल करके, Chat में सैंपल प्रोजेक्ट इंस्टॉल करें.

  1. कंसोल में, Google Chat API खोजें. इसके बाद, Google Chat API पर क्लिक करें. फिर, मैनेज करें और कॉन्फ़िगरेशन पर क्लिक करें.

    Google Chat API कॉन्फ़िगरेशन पेज पर जाएं

  2. Chat ऐप्लिकेशन सेट अप करें:

    1. ऐप्लिकेशन का नाम फ़ील्ड में, Travel ADK AI Agent डालें.
    2. अवतार का यूआरएल फ़ील्ड में, https://goo.gle/3SfMkjb डालें.
    3. ब्यौरा फ़ील्ड में, Travel ADK AI Agent डालें.
    4. कनेक्शन सेटिंग में जाकर, एचटीटीपी एंडपॉइंट यूआरएल चुनें.
    5. ट्रिगर में जाकर, सभी ट्रिगर के लिए, एक ही एचटीटीपी एंडपॉइंट यूआरएल का इस्तेमाल करें को चुनें.
    6. एचटीटीपी एंडपॉइंट यूआरएल फ़ील्ड में, वह एंडपॉइंट यूआरएल चिपकाएं जिसे आपने पहले कॉपी किया था BASE_URL.
    7. क्विक कमांड रजिस्टर करें, जिसका इस्तेमाल पूरी तरह से लागू किया गया Chat ऐप्लिकेशन करता है:
      1. निर्देश में जाकर, कोई निर्देश जोड़ें पर क्लिक करें.
      2. कमांड आईडी में, 1 टाइप करें.
      3. जानकारी में जाकर, Reset session टाइप करें.
      4. कमांड टाइप में जाकर, क्विक कमांड चुनें.
      5. नाम में, Reset session टाइप करें.
      6. हो गया पर क्लिक करें. क्विक कमांड रजिस्टर हो जाती है और सूची में दिखती है.
    8. दिखने की सेटिंग में जाकर, इस Chat ऐप्लिकेशन को अपने Workspace डोमेन के कुछ लोगों और ग्रुप के लिए उपलब्ध कराएं को चुनें. इसके बाद, अपना ईमेल पता डालें.
    9. लॉग में जाकर, लॉगिंग में गड़बड़ियों को लॉग करें चुनें.
    10. सेव करें पर क्लिक करें.

Apps Script

टेस्टिंग की सुविधा चालू करने के लिए, हेड डिप्लॉयमेंट आईडी का इस्तेमाल करके, Apps Script प्रोजेक्ट को Chat में इंस्टॉल करें.

  1. अपने Apps Script प्रोजेक्ट में, डिप्लॉय करें > डिप्लॉयमेंट की जांच करें पर क्लिक करें. इसके बाद, हेड डिप्लॉयमेंट आईडी में जाकर, हेड डिप्लॉयमेंट आईडी कॉपी करने का आइकॉन कॉपी करें पर क्लिक करें.

  2. कंसोल में, Google Chat API खोजें. इसके बाद, Google Chat API पर क्लिक करें. फिर, मैनेज करें और कॉन्फ़िगरेशन पर क्लिक करें.

    Google Chat API कॉन्फ़िगरेशन पेज पर जाएं

  3. Chat ऐप्लिकेशन सेट अप करें:

    1. ऐप्लिकेशन का नाम फ़ील्ड में, Travel ADK AI Agent डालें.
    2. अवतार का यूआरएल फ़ील्ड में, https://goo.gle/3SfMkjb डालें.
    3. ब्यौरा फ़ील्ड में, Travel ADK AI Agent डालें.
    4. कनेक्शन की सेटिंग में जाकर, Apps Script को चुनें.
    5. डिप्लॉयमेंट आईडी फ़ील्ड में, वह हेड डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने पहले कॉपी किया था.
    6. ऐसी क्विक कमांड रजिस्टर करें जिसका इस्तेमाल, Chat की सभी सुविधाओं को लागू करने वाला ऐप्लिकेशन करता है:
      1. निर्देश में जाकर, कोई निर्देश जोड़ें पर क्लिक करें.
      2. कमांड आईडी में, 1 टाइप करें.
      3. जानकारी में जाकर, Reset session टाइप करें.
      4. कमांड टाइप में जाकर, क्विक कमांड चुनें.
      5. नाम में, Reset session टाइप करें.
      6. हो गया पर क्लिक करें. क्विक कमांड रजिस्टर हो जाती है और सूची में दिखती है.
    7. दिखने की सेटिंग में जाकर, इस Chat ऐप्लिकेशन को अपने Workspace डोमेन के कुछ लोगों और ग्रुप के लिए उपलब्ध कराएं को चुनें. इसके बाद, अपना ईमेल पता डालें.
    8. लॉग में जाकर, लॉगिंग में गड़बड़ियों को लॉग करें चुनें.
    9. सेव करें पर क्लिक करें.

अब इस ऐप्लिकेशन को Google Chat से ऐक्सेस किया जा सकता है.

  1. Google Chat खोलें.

    Google Chat पर जाएं

  2. Chat डीएम स्पेस बनाएं:

    1. नई चैट पर क्लिक करें.
    2. खोज बार में, ऐप्लिकेशन Travel ADK AI Agent टाइप करें और उसे चुनें.
    3. Install app डायलॉग बॉक्स में, ऐप्लिकेशन इंस्टॉल करें पर क्लिक करें.
    4. Install app डायलॉग बॉक्स बंद हो जाता है और नया बनाया गया Chat डीएम स्पेस चुना जाता है.

Chat ऐप्लिकेशन, मैसेज का जवाब देने के लिए तैयार है.

एजेंट को टेस्ट करना

  1. Gmail खोलें.

    Gmail पर जाएं

  2. खुद को यह ईमेल भेजें:

    • विषय: You need to travel to Paris
    • मुख्य हिस्सा: Please be there between 11/25/2025 and 11/30/2025!

  3. साइडबार से, Travel ADK AI Agent ऐड-ऑन खोलें.

  4. ऐड-ऑन का सेट अप पूरा करने के लिए, अनुमतियां दें पर क्लिक करें.

  5. एजेंट को यह अनुरोध भेजने के लिए, भेजें पर क्लिक करें:

    • मैसेज: Please help me plan this travel!
    • कॉन्टेक्स्ट: मौजूदा ईमेल को चुनें

    साइडबार में, एजेंट के जवाब को अपडेट किया जाता है.

    Gmail से यात्रा की योजना बनाना

  6. Chat के डीएम स्पेस पर रीडायरेक्ट होने के लिए, Chat खोलें पर क्लिक करें.

  7. + > रीसेट सेशन पर क्लिक करें.

    आपको एक नया मैसेज मिलता है, जिसमें पुष्टि की जाती है कि यह काम पूरा हो गया है: OK, let's start from the beginning, what can I help you with?

  8. मैसेज भेजें Give me ideas.

    आपको एजेंट के जवाब वाले नए मैसेज मिलते हैं.

    Chat से आइडिया पाना

  9. एफ़िल टावर जैसी किसी जगह की फ़ोटो अपलोड करने के बाद, I want to go there! मैसेज भेजें.

    आपको एजेंट के जवाब वाले नए मैसेज मिलते हैं.

    Chat में मौजूद अटैचमेंट से जगह की जानकारी पाना

सीमाएं

HTTP

Chat के अलावा, Google Workspace के अन्य ऐप्लिकेशन में एआई एजेंट की ये सीमाएं हैं:

  • यह सिंक्रोनस है: साइडबार को सिर्फ़ उपयोगकर्ता के इंटरैक्शन के जवाब में अपडेट किया जा सकता है. इसलिए, एआई एजेंट के जवाब सिर्फ़ पूरा होने के बाद दिखाए जाते हैं (स्ट्रीमिंग नहीं).

  • यह टाइम आउट हो सकता है: अगर साइडबार अपडेट होने में कुछ मिनट से ज़्यादा समय लगता है, तो यह टाइम आउट हो जाता है.

ये सीमाएं Chat में लागू नहीं होती हैं.

Apps Script

Google Workspace के सभी ऐप्लिकेशन में, एआई एजेंट UrlFetchApp का इस्तेमाल करके Vertex AI REST API को कॉल करता है. इससे ये सीमाएं लागू होती हैं:

  • यह सिंक्रोनस है: एआई एजेंट के जवाब, पूरा जवाब तैयार होने के बाद ही मिलते हैं. जवाब रीयल टाइम में नहीं मिलते.

  • यह टाइम आउट हो सकता है: एआई एजेंट के अनुरोध तब टाइम आउट हो जाते हैं, जब उन्हें पूरा होने में करीब एक मिनट से ज़्यादा समय लगता है.

कस्टमाइज़ेशन

यह समाधान, Vertex AI Agent Engine में होस्ट किए गए ADK एआई एजेंट के साथ काम करता है. यह Google Workspace ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) का सबसेट है. साथ ही, इसमें Travel Concierge के सैंपल के जवाबों के हिसाब से रेंडर किए गए जवाब शामिल हैं. इस समाधान में एक्सटेंसिबल फ़्रेमवर्क का इस्तेमाल किया जाता है. इसलिए, इन फ़ाइलों में बदलाव करके इसे अपनी पसंद के मुताबिक बनाया जा सकता है:

Python

  • main.py: यह मुख्य यूज़र इंटरफ़ेस (यूआई) और उपयोगकर्ता के इंटरैक्शन के लॉजिक (Google Workspace इवेंट हैंडलर) को तय करता है. एक सामान्य एक्सटेंशन, Drive ऐप्लिकेशन के लिए कॉन्टेक्स्ट फ़ीचर के तौर पर Drive दस्तावेज़ों को चालू करना होगा. यह Gmail ऐप्लिकेशन के लिए Gmail मैसेज के साथ किए गए काम जैसा ही होगा.

  • vertex_ai.py: यह एआई एजेंट के सेशन, जवाबों, और गड़बड़ियों को मैनेज करता है. साथ ही, एजेंट के साथ इंटरैक्शन और जवाबों को रेंडर करने के लिए, Vertex AI के खास इंटरफ़ेस तय करता है. आम तौर पर, एक्सटेंशन का इस्तेमाल अलग-अलग उपयोगकर्ताओं की बातचीत के लिए, एक से ज़्यादा सेशन की सुविधा जोड़ने और एआई एजेंट को मैनेज करने वाले अन्य प्लैटफ़ॉर्म के लिए किया जाता है.

  • agent_handler.py: यह Chat और Chat के अलावा अन्य ऐप्लिकेशन के खास मामलों में, vertex_ai.py में तय किए गए Vertex AI के इंटरफ़ेस लागू करता है. एक्सटेंशन का इस्तेमाल करके, उपयोगकर्ताओं के लिए ऐसे बटन जोड़े जा सकते हैं जिनसे वे एआई एजेंट के जवाबों के बारे में सुझाव/राय दे सकें या शिकायत कर सकें.

  • google_workspace.py: यह फ़ाइल, एपीआई कॉल का इस्तेमाल करके, एआई एजेंट के अलावा अन्य एजेंट को मैनेज करने वाले प्लैटफ़ॉर्म के साथ इंटरैक्शन लागू करती है. इस सैंपल में, कॉन्टेक्स्ट की जानकारी इकट्ठा करने और कार्रवाइयां करने के लिए, सिर्फ़ Google Workspace API का इस्तेमाल किया जाता है. किसी एक्सटेंशन का इस्तेमाल, Google Calendar या कस्टमर रिलेशनशिप मैनेजमेंट (सीआरएम) से कारोबार का डेटा पाने के लिए किया जा सकता है.

  • travel_agent_ui_render.gs: यह फ़ाइल, Travel Concierge के लिए खास तौर पर तैयार किए गए जवाबों को रेंडर करती है. ऐसा सब-एजेंट और Workspace ऐप्लिकेशन के लिए किया जाता है. आम तौर पर, एक्सटेंशन का इस्तेमाल नए रिस्पॉन्स रेंडरिंग के लिए किया जाता है. इससे फ़्लाइट के विकल्पों और अन्य एआई एजेंट को ग्राफ़िक के तौर पर दिखाया जा सकता है.

Apps Script

  • Code.gs: यह मुख्य यूज़र इंटरफ़ेस (यूआई) और उपयोगकर्ता के इंटरैक्शन के लॉजिक (Google Workspace इवेंट हैंडलर) को तय करता है. एक सामान्य एक्सटेंशन, Drive ऐप्लिकेशन के लिए कॉन्टेक्स्ट फ़ीचर के तौर पर Drive दस्तावेज़ों को चालू करना होगा. यह Gmail ऐप्लिकेशन के लिए Gmail मैसेज के साथ किए गए काम जैसा ही होगा.

  • VertexAi.gs: यह एआई एजेंट के सेशन, जवाबों, और गड़बड़ियों को मैनेज करता है. साथ ही, Vertex AI के लिए खास इंटरफ़ेस तय करता है, ताकि एजेंट के इंटरैक्शन और जवाबों को रेंडर करने में मदद मिल सके. आम तौर पर, एक्सटेंशन का इस्तेमाल अलग-अलग उपयोगकर्ताओं की बातचीत के लिए, एक से ज़्यादा सेशन की सुविधा जोड़ने और एआई एजेंट को मैनेज करने वाले अन्य प्लैटफ़ॉर्म के लिए किया जाता है.

  • AgentHandler.gs: यह VertexAi.gs में तय किए गए, Vertex AI के लिए खास इंटरफ़ेस लागू करता है. ऐसा Chat और non-Chat ऐप्लिकेशन के खास मामलों में किया जाता है. एक्सटेंशन का इस्तेमाल करके, उपयोगकर्ताओं के लिए ऐसे बटन जोड़े जा सकते हैं जिनसे वे एआई एजेंट के जवाबों के बारे में सुझाव/राय दे सकें या शिकायत कर सकें.

  • GoogleWorkspace.gs: यह एपीआई कॉल का इस्तेमाल करके, एआई एजेंट के अलावा अन्य एजेंट को मैनेज करने वाले प्लैटफ़ॉर्म के साथ इंटरैक्शन लागू करता है. इस सैंपल में, कॉन्टेक्स्ट की जानकारी इकट्ठा करने और कार्रवाइयां करने के लिए, सिर्फ़ Google Workspace API का इस्तेमाल किया जाता है. किसी एक्सटेंशन का इस्तेमाल, Google Calendar या कस्टमर रिलेशनशिप मैनेजमेंट (सीआरएम) से कारोबार का डेटा पाने के लिए किया जा सकता है.

  • TravelAgentUiRender.gs: यह फ़ाइल, Travel Concierge के लिए खास तौर पर तैयार किए गए जवाबों को रेंडर करती है. ऐसा सब-एजेंट और Workspace ऐप्लिकेशन के लिए किया जाता है. आम तौर पर, एक्सटेंशन का इस्तेमाल नए रिस्पॉन्स रेंडरिंग के लिए किया जाता है. इससे फ़्लाइट के विकल्पों और अन्य एआई एजेंट को ग्राफ़िक के तौर पर दिखाया जा सकता है.

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

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

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

    Resource Manager पर जाएं

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