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 ऐप्लिकेशन में एक ग्राफ़िकल यूज़र इंटरफ़ेस (GUI) जोड़ते हैं जिसे आपके उपयोगकर्ता सीधे Chat, Gmail, Calendar, Drive, Docs, Sheets, और Slides में एक्सेस कर सकते हैं.

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

मकसद

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

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

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

चैट और गैर-चैट (जीमेल, कैलेंडर, ड्राइव, डॉक्स, शीट्स, स्लाइड्स) अनुप्रयोगों के लिए GUI को अलग-अलग तरीके से डिज़ाइन किया गया है ताकि उनकी विशिष्ट विशेषताओं और सीमाओं को ध्यान में रखा जा सके.

सुविधाएं

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

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

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

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

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

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

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

अन्य अनुप्रयोगों में ये अतिरिक्त विशेषताएं हैं:

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

  • Gmail संदर्भ: उपयोगकर्ता ईमेल के ज़रिए संदेश भेज सकते हैं (इस नमूने में एक विषय और मुख्य भाग तक सीमित).

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

आर्किटेक्चर

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

निम्नलिखित आरेख मुख्य उपयोगकर्ता प्रवाह को दर्शाता है: AI एजेंट को संदेश भेजें.

HTTP

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

Apps Script

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

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

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

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

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

Google Cloud कंसोल

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

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

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

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

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

gcloud सीएलआई

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

  • क्लाउड शेल: पहले से सेट किए गए gcloud CLI वाले ऑनलाइन टर्मिनल का उपयोग करने के लिए, क्लाउड शेल सक्रिय करें.
    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 क्लाउड प्रोजेक्ट से लिंक किया जाना है.

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. पुष्टि करें कि आप सही क्लाउड प्रोजेक्ट में API सक्षम कर रहे हैं, फिर अगला पर क्लिक करें.

  3. पुष्टि करें कि आप सही API सक्षम कर रहे हैं, फिर सक्षम करें पर क्लिक करें.

Apps Script

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

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

  2. पुष्टि करें कि आप सही क्लाउड प्रोजेक्ट में API सक्षम कर रहे हैं, फिर अगला पर क्लिक करें.

  3. पुष्टि करें कि आप सही API सक्षम कर रहे हैं, फिर सक्षम करें पर क्लिक करें.

Google मानचित्र प्लेटफ़ॉर्म स्थान API कुंजी प्राप्त करें

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

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

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

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 क्लाउड प्रोजेक्ट के संसाधनों तक पहुंच प्रदान करने के लिए अपने सेवा खाते को भूमिकाएं असाइन करें. अधिक जानकारी के लिए, संसाधनों तक पहुंच प्रदान करना, बदलना और रद्द करना देखें.

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

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

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

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

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

  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 क्लाउड खाते से प्रमाणीकरण करें और अपने Google क्लाउड प्रोजेक्ट का उपयोग करने के लिए Google क्लाउड 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. 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 को कॉल करें. इसमें आपने जिस Cloud प्रोजेक्ट को बनाया है उसकी लोकेशन शामिल करें.

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

  6. ADK AI एजेंट स्थापित और तैनात करें.

    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. CPU फ़ील्ड में, 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 प्रोजेक्ट में, प्रोजेक्ट सेटिंग का आइकॉन एडिटर पर क्लिक करें. इसके बाद, फ़ाइल VertexAi.gs को तब तक ऊपर ले जाएं, जब तक वह फ़ाइल AgentHandler.gs के ऊपर न आ जाए. इसके लिए, फ़ाइल ऐक्शन फ़ाइल को ऊपर ले जाएं का इस्तेमाल करें.

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

  6. ENGINE_ID पिछले चरणों में तैनात ट्रैवल कंसीयज ADK AI एजेंट के इंजन आईडी के साथ, ENGINE_ID.

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

  8. PROJECT_NUMBER पिछले चरणों में तैनात ट्रैवल कंसीयज 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, कैलेंडर, ड्राइव, दस्तावेज़, शीट, स्लाइड पर लागू करें

Python

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

  1. अपने पसंदीदा स्थानीय डेवलपमेंट परिवेश में, प्रोजेक्ट के कोड स्रोत से deployment.json फ़ाइल खोलें और $BASE_URL की सभी आवृत्तियों को BASE_URL के मान से बदलें, जो कि वह एंडपॉइंट 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. अपने ऐप्स स्क्रिप्ट प्रोजेक्ट में, तैनात करें > परिनियोजनों का परीक्षण करें पर क्लिक करें, फिर इंस्टॉल करें पर क्लिक करें.

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

चैट पर तैनात करें

Python

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

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

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

  2. चैट ऐप सेट अप करें:

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

Apps Script

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

  1. अपने ऐप्स स्क्रिप्ट प्रोजेक्ट में, डिप्लॉय करें > टेस्ट डिप्लॉयमेंट पर क्लिक करें, फिर हेड डिप्लॉयमेंट आईडी के अंतर्गत हेड डिप्लॉयमेंट आईडी कॉपी के लिए आइकन कॉपी करें पर क्लिक करें.

  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. कनेक्शन सेटिंग में, ऐप्स स्क्रिप्ट चुनें.
    5. डिप्लॉयमेंट आईडी फ़ील्ड में, वह हेड डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने पहले कॉपी किया था.
    6. एक त्वरित आदेश पंजीकृत करें जिसका उपयोग पूरी तरह से क्रियान्वित चैट ऐप्लिकेशन करता है:
      1. निर्देश में जाकर, कोई निर्देश जोड़ें पर क्लिक करें.
      2. कमांड आईडी में, 1 टाइप करें.
      3. जानकारी में जाकर, Reset session टाइप करें.
      4. कमांड टाइप में जाकर, क्विक कमांड चुनें.
      5. नाम में, Reset session टाइप करें.
      6. हो गया पर क्लिक करें. त्वरित आदेश पंजीकृत और सूचीबद्ध है.
    7. दृश्यता में, इस चैट ऐप्लिकेशन को अपने Workspace डोमेन के खास लोगों और ग्रुप के लिए उपलब्ध कराएं चुनें और अपना ईमेल पता डालें.
    8. लॉग में जाकर, लॉगिंग में लॉग की गई गड़बड़ियां चुनें.
    9. सेव करें पर क्लिक करें.

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

  1. Google Chat खोलें.

    Google Chat पर जाएं

  2. चैट DM स्थान बनाएँ:

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

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

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

  1. Gmail खोलें.

    Gmail पर जाएं

  2. अपने आप को निम्नलिखित ईमेल भेजें:

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

  3. साइडबार से ट्रैवल ADK AI एजेंट ऐड-ऑन खोलें.

  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 के अन्य ऐप्लिकेशन में एआई एजेंट की ये सीमाएं हैं:

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

  • समय समाप्त हो सकता है: साइडबार समय समाप्त होने की सूचना तब देता है जब कार्य पूरा होने में कुछ मिनट से अधिक समय लगता है.

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

Apps Script

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

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

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

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

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

Python

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

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

  • agent_handler.py: चैट और गैर-चैट ऐप्लिकेशन के विशिष्ट मामलों में vertex_ai.py में परिभाषित Vertex AI-विशिष्ट इंटरफ़ेस को लागू करता है. एक सामान्य विस्तार यह होगा कि उपयोगकर्ताओं को AI एजेंट प्रतिक्रियाओं के बारे में फीडबैक भेजने के लिए बटन जोड़े जाएं.

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

  • travel_agent_ui_render.gs: उप-एजेंटों और Workspace ऐप्लिकेशन के लिए ट्रैवल कंसीयज-विशिष्ट प्रतिक्रिया रेंडरिंग लागू करता है. विशिष्ट विस्तार में उड़ान विकल्पों और अन्य AI एजेंटों को ग्राफिक रूप से प्रदर्शित करने के लिए नई प्रतिक्रिया रेंडरिंग के लिए समर्थन जोड़ना शामिल होगा.

Apps Script

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

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

  • AgentHandler.gs: चैट और गैर-चैट ऐप्लिकेशन के विशिष्ट मामलों में VertexAi.gs में परिभाषित Vertex AI-विशिष्ट इंटरफ़ेस लागू करता है. एक सामान्य विस्तार यह होगा कि उपयोगकर्ताओं को AI एजेंट प्रतिक्रियाओं के बारे में फीडबैक भेजने के लिए बटन जोड़े जाएं.

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

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

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

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

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

    Resource Manager पर जाएं

  2. प्रोजेक्ट सूची में, वह प्रोजेक्ट चुनें जिसे आप हटाना चाहते हैं और फिर हटाएँ पर क्लिक करें.
  3. संवाद में, प्रोजेक्ट आईडी लिखें और फिर प्रोजेक्ट को हटाने के लिए शट डाउन करें पर क्लिक करें.