अपना पहला एजेंट बनाएं

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

अपना एजेंट बनाना

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

इस क्विकस्टार्ट में, आपको ये काम करने होंगे:

  • पार्टनर के तौर पर रजिस्टर करना
  • कोई ब्रैंड और एजेंट बनाना
  • ज़रूरी नहीं: Business Messages हेल्पर बॉट के साथ बातचीत में, सुविधाओं को एक्सप्लोर करना
  • मैसेज भेजने और पाने के लिए, अपने एजेंट को सेट अप करना

सैंपल का इस्तेमाल किए बिना एजेंट बनाने के लिए, अपना एजेंट बनाना लेख पढ़ें.

पार्टनर के तौर पर रजिस्टर करना

  1. Business Communications डेवलपर कंसोल खोलें.
  2. Business Messages में जाकर, पार्टनर खाता बनाएं पर क्लिक करें.

  3. पार्टनर की जानकारी डालें:

    फ़ील्ड मान
    आपका नाम आपका पूरा नाम
    पार्टनर का नाम आपके संगठन का नाम
    पार्टनर वेबसाइट आपके संगठन की वेबसाइट
    क्षेत्र वह क्षेत्र जहां आपको Business Messages सेवा को होस्ट करना है

  4. Business Messages की सेवा की शर्तों की समीक्षा करें और उन्हें स्वीकार करें .

  5. बनाएं पर क्लिक करें.

अब आपने Business Messages के पार्टनर के तौर पर रजिस्टर कर लिया है. आपके लिए एक नया Google Cloud प्रोजेक्ट बनाया गया है. इसमें Business Messages और Business Communications API चालू हैं. आपके पास इस प्रोजेक्ट का ऐक्सेस नहीं है. साथ ही, इससे आपके मौजूदा Google Cloud प्रोजेक्ट पर कोई असर नहीं पड़ेगा.

अब आपके पास Business Messages और Business Communications API का ऐक्सेस है.

सेवा खाता बनाना

  1. Business Communications डेवलपर कंसोल के होम पेज पर, पार्टनर खाते की सेटिंग पर क्लिक करें.
  2. बाएं नेविगेशन में, सेवा खाता पर क्लिक करें.

  3. **कुंजी बनाएं** पर क्लिक करें. इसके बाद, **बनाएं** पर क्लिक करें.

    आपका ब्राउज़र, सेवा खाते की कुंजी डाउनलोड करता है. इसे सुरक्षित जगह पर सेव करें. वेब ऐप्लिकेशन को डिप्लॉय करने और आने वाले समय में Business Messages और Business Communications API को ऐक्सेस करने के लिए, आपको इस कुंजी की ज़रूरत होगी.

कोई ब्रैंड और एजेंट बनाना

एजेंट, ब्रैंड की तरफ़ से बातचीत करने के लिए तय किया गया प्रतिनिधि होता है. यह बातचीत करने वाली ऐसी इकाई है जिससे लोग इंटरैक्ट करते हैं. कारोबार को दिखाने के लिए, कोई ब्रैंड बनाया जाता है. वहीं, एजेंट इसलिए बनाया जाता है, ताकि ग्राहक उससे बातचीत कर सकें.

  1. Business Communications Developer Console खोलें और Business Messages के Google खाते से साइन इन करें.
  2. एजेंट बनाएं पर क्लिक करें.
  3. **एजेंट का टाइप** में, **Business Messages** को चुनें.
  4. ब्रैंड का नाम और एजेंट का नाम के लिए वैल्यू डालें.
  5. इनमें से कोई एक काम करें:
    • अपने एजेंट के साथ बातचीत करने और उपलब्ध सुविधाओं को एक्सप्लोर करने के लिए, Business Messages हेल्पर बॉट को चालू करें को चुनें.
    • अपने एजेंट को पसंद के मुताबिक बनाने और उसे मैसेज हैंडल करने के लिए तैयार करने के लिए, Business Messages हेल्पर बॉट को चालू करें से सही का निशान हटाएं.
  6. एजेंट बनाएं पर क्लिक करें.

अगर आपने Business Messages हेल्पर बॉट को चालू किया है, तो तुरंत बातचीत शुरू की जा सकती है. इसके अलावा, मैसेज हैंडल करने के लिए अपने एजेंट को सेट अप करें.

Business Messages हेल्पर बॉट की मदद से सुविधाएं एक्सप्लोर करना

Business Messages हेल्पर बॉट आपको अपने एजेंट के साथ आसानी से बातचीत शुरू करने में मदद करता है, ताकि आप यह जान सकें कि प्लैटफ़ॉर्म पर क्या-क्या उपलब्ध है. पहला एजेंट बनाते समय, हेल्पर बॉट को चालू करना ज़रूरी नहीं है. हालांकि, हमारा सुझाव है कि आप इसे चालू करें.

हेल्पर बॉट की मदद से, ये काम किए जा सकते हैं

  • ज़्यादा बेहतर सुविधाएं एक्सप्लोर करना
  • सुविधाओं को लागू करने का तरीका जानना
  • एजेंट को सेट अप करने के लिए संसाधन ढूंढना

जब हेल्पर बॉट को चालू किया जाता है, तो यह आपके एजेंट के लिए मैसेज भेजने और पाने का काम करता है. इसके लिए, किसी वेबहुक की ज़रूरत नहीं होती. उपयोगकर्ताओं के मैसेज हैंडल करने के लिए वेबहुक सेट करने या Dialogflow को चालू करने से पहले, आपको हेल्पर बॉट को बंद करना होगा .

हेल्पर बॉट के साथ बातचीत शुरू करना

Business Messages हेल्पर बॉट को चालू करने के बाद, बातचीत शुरू की जा सकती है. एजेंट बनाने के तुरंत बाद, एक डायलॉग खुलता है, ताकि आपको शुरुआत करने में मदद मिल सके.

हेल्पर बॉट से इंटरैक्ट करने के लिए, इस डायलॉग में यह तरीका अपनाएं:

  1. एजेंट के टेस्ट यूआरएल ऐक्सेस करें. इसके लिए, ये तरीके अपनाए जा सकते हैं:

    • Android बटन या iOS बटन पर क्लिक करें. इसके बाद, संबंधित फ़ोन या टैबलेट से क्यूआर कोड स्कैन करें और लॉन्च करें पर क्लिक करें. इसके अलावा, एजेंट का टेस्ट यूआरएल कॉपी करने के लिए, Android यूआरएल कॉपी करें या iOS यूआरएल कॉपी करें पर क्लिक करें.
    • यूआरएल को अपने ईमेल पते पर भेजने के लिए, भेजें पर क्लिक करें.

  2. अपने फ़ोन या टैबलेट में यूआरएल खोलें. (iOS डिवाइसों के लिए, Google Maps ऐप्लिकेशन की ज़रूरत होती है.)

हेल्पर बॉट को बंद करना

अपने एजेंट को पसंद के मुताबिक बनाने और उसे लॉन्च करने के लिए तैयार करने से पहले, आपको Business Messages हेल्पर बॉट को बंद करना होगा.

हेल्पर बॉट को बंद करने के लिए,

  1. Business Communications Developer कंसोल खोलें.
  2. अपना एजेंट चुनें.
  3. बाएं नेविगेशन में, इंटिग्रेशन पर क्लिक करें.
  4. हेल्पर बॉट के लिए, बंद करें पर क्लिक करें.

हेल्पर बॉट को बंद करने के बाद, यह आपके एजेंट के लिए मैसेज भेजने और पाने का काम नहीं करता. अब मैसेजिंग फ़्लो को हैंडल करने के लिए, अपने एजेंट को सेट अप किया जा सकता है.

मैसेज हैंडल करने के लिए, अपने एजेंट को सेट अप करना

इस गाइड में, आपको Google Cloud Platform (GCP) पर Echo Bot को डिप्लॉय करने का तरीका बताया जाएगा. इसमें, उपयोगकर्ताओं के मैसेज प्रोसेस करने के लिए डिज़ाइन किया गया वेबहुक शामिल है.

Echo Bot, सैंपल ऐप्लिकेशन है. यह उपयोगकर्ताओं को उनके मैसेज वापस भेजता है. इसकी मदद से, अपने एजेंट के साथ बातचीत में, सुझाई गई कार्रवाइयां और रिच कार्ड जैसी ज़्यादा बेहतर सुविधाओं को आज़माया जा सकता है. अपने एजेंट को डेवलप करने के लिए, Echo Bot का इस्तेमाल शुरुआती तौर पर भी किया जा सकता है.

आपको ये चरण पूरे करने होंगे:

  • Echo Bot के सैंपल को GCP पर डिप्लॉय करना
  • Business Messages के पार्टनर खाते के लिए, वेबहुक यूआरएल को कॉन्फ़िगर करना
  • अपने एजेंट के बारे में बुनियादी जानकारी देना

इस गाइड के आखिर तक, आपका एजेंट मैसेज भेजने और पाने के लिए तैयार हो जाएगा.

वेब ऐप्लिकेशन को GCP पर डिप्लॉय करना

Business Messages, उपयोगकर्ताओं के मैसेज को आपके इन्फ़्रास्ट्रक्चर में मौजूद वेबहुक पर फ़ॉरवर्ड करता है. इस गाइड में, आपको पहले से कॉन्फ़िगर किए गए वेबहुक पर, Echo Bot के सैंपल सोर्स कोड को डिप्लॉय करने का तरीका बताया जाएगा. अगर आपके पास मैसेज पाने के लिए पहले से ही वेब इन्फ़्रास्ट्रक्चर है, तो उस वेब सेवा पर नया वेबहुक बनाया जा सकता है. हालांकि, आपको लॉजिक को खुद ही कॉन्फ़िगर करना होगा. ज़्यादा जानकारी के लिए, पार्टनर-लेवल वेबहुक सेट करना लेख पढ़ें.

Cloud एनवायरमेंट बनाना

Echo Bot के सैंपल को डिप्लॉय करने के लिए, Cloud एनवायरमेंट की ज़रूरत होती है.

GCP प्रोजेक्ट को Cloud एनवायरमेंट के तौर पर बनाने के लिए, यह तरीका अपनाएं:

  1. Google Cloud Console का प्रोजेक्ट सिलेक्टर खोलें.

    अगर आपने पहले कभी Google Cloud प्रोजेक्ट नहीं बनाया है, तो आपको सेवा की शर्तें स्वीकार करें पर क्लिक करना होगा.

  2. प्रोजेक्ट बनाएं पर क्लिक करें.

  3. अपने नए प्रोजेक्ट के लिए कोई नाम और जगह डालें

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

  4. बनाएं पर क्लिक करें.

  5. मेन्यू पर क्लिक करें.

  6. बिलिंग पर क्लिक करें.

  7. बिलिंग खाता लिंक करें पर क्लिक करें.

  8. कोई नया बिलिंग खाता बनाएं या प्रोजेक्ट में कोई मौजूदा बिलिंग खाता जोड़ें. पेमेंट के विकल्पों को समझने के लिए, Google Cloud के मुफ़्त प्रोग्राम की सुविधाएं लेख पढ़ें.

Echo Bot के सैंपल को डिप्लॉय करना

  1. gcloud सीएलआई इंस्टॉल करें. इसका इस्तेमाल, सैंपल कोड को Google Cloud पर डिप्लॉय करने के लिए किया जाएगा.

  2. Echo Bot के सैंपल (Node.js, Java, Python) को डाउनलोड करें और एक्सट्रैक्ट करें.

  3. सेवा खाता बनाना में डाउनलोड की गई JSON क्रेडेंशियल फ़ाइल को, सैंपल के रिसॉर्स फ़ोल्डर में कॉपी करें. इसके बाद, क्रेडेंशियल का नाम बदलकर "bm-agent-service-account-credentials.json" करें. इस क्रेडेंशियल फ़ाइल का पाथ, डाउनलोड किए गए सैंपल पर निर्भर करता है.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. टर्मिनल में, सैंपल की full_sample डायरेक्ट्री पर जाएं.

  5. सैंपल को डिप्लॉय करने के लिए, टर्मिनल में ये कमांड चलाएं:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID Cloud एनवायरमेंट बनाना में बनाए गए प्रोजेक्ट का आईडी है. प्रोजेक्ट आईडी, Google Cloud में प्रोजेक्ट डैशबोर्ड पर दिखता है.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID Cloud एनवायरमेंट बनाना में बनाए गए प्रोजेक्ट का आईडी है. प्रोजेक्ट आईडी, Google Cloud में प्रोजेक्ट डैशबोर्ड पर दिखता है.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID Cloud एनवायरमेंट बनाना में बनाए गए प्रोजेक्ट का आईडी है. प्रोजेक्ट आईडी, Google Cloud में प्रोजेक्ट डैशबोर्ड पर दिखता है.

  6. आखिरी कमांड के आउटपुट में, डिप्लॉय किए गए ऐप्लिकेशन का यूआरएल नोट करें. यह आपके वेबहुक यूआरएल का बेस है:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

अपना वेबहुक सेट करना

Echo Bot को डिप्लॉय करने के बाद, आपको मैसेज पाने के लिए, वेबहुक यूआरएल (जिसे आप मैनेज करते हैं) तय करना होगा मैसेज पाने के लिए.

  1. Business Communications डेवलपर कंसोल में, खाते की सेटिंग खोलें.
  2. पक्का करें कि सही पार्टनर खाता चुना गया हो.
  3. Business Messages वेबहुक यूआरएल के लिए, कॉन्फ़िगर करें पर क्लिक करें.

  4. वेबहुक एंडपॉइंट यूआरएल के लिए, अपने ऐप्लिकेशन का यूआरएल + "/callback" डालें.

    आपका एंडपॉइंट इस फ़ॉर्मैट में होगा: "https://PROJECT_ID.appspot.com/callback".

    यह एंडपॉइंट, GCP पर डिप्लॉय किए गए सैंपल के ऐप्लिकेशन लॉजिक में पहले से तय है.

  5. डेवलपर कंसोल में, पुष्टि करें पर क्लिक करें.

    Business Messages से आपके वेबहुक की पुष्टि हो जाने पर, डायलॉग बंद हो जाता है.

Business Communications API की मदद से, अपने वेबहुक को कॉन्फ़िगर करने के लिए, उदाहरण: वेबहुक यूआरएल अपडेट करना लेख पढ़ें.

Business Messages के टेस्ट फ़्रेमवर्क का इस्तेमाल करके, यह टेस्ट किया जा सकता है कि आपका वेबहुक, Business Messages के पेलोड का जवाब सही तरीके से देता है या नहीं.

एजेंट की जानकारी डालना

अपने एजेंट को सेट अप करने के लिए, कुछ बुनियादी जानकारी दें.

  1. Business Communications Developer कंसोल खोलें.
  2. बाएं नेविगेशन में, एजेंट की जानकारी पर क्लिक करें.

  3. वैल्यू को अपनी पसंद के मुताबिक अपडेट करें या ये सुझाव इस्तेमाल करें:

    फ़ील्ड मान
    वेलकम मैसेज Echo Bot के साथ बातचीत शुरू करें!
    निजता नीति https://policies.google.com/privacy

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

बातचीत शुरू करना

Echo Bot से इंटरैक्ट करने के लिए, यह तरीका अपनाएं:

  1. Business Communications Developer कंसोल खोलें.
  2. बाएं नेविगेशन में, एजेंट की जानकारी पर क्लिक करें.
  3. एजेंट के टेस्ट यूआरएल में जाकर, Android बटन या iOS बटन पर क्लिक करें.

  4. संबंधित फ़ोन या टैबलेट से क्यूआर कोड स्कैन करें. इसके अलावा, एजेंट का टेस्ट यूआरएल कॉपी करने के लिए, Android यूआरएल कॉपी करें या iOS यूआरएल कॉपी करें पर क्लिक करें.

    यूआरएल को अपने ईमेल पते पर भेजने के लिए, भेजें पर भी क्लिक किया जा सकता है.

  5. अपने फ़ोन या टैबलेट में यूआरएल खोलें. (iOS डिवाइसों के लिए, Google Maps ऐप्लिकेशन की ज़रूरत होती है.)

आपके एजेंट का वेलकम मैसेज दिखता है. अब Echo Bot से इंटरैक्ट किया जा सकता है. यह आपके भेजे गए मैसेज को वापस भेजता है. इसके अलावा, खास स्ट्रिंग भेजकर, ज़्यादा बेहतर सुविधाओं को ऐक्सेस किया जा सकता है. जैसे: “carousel”, “card”, “chips”.

अगले चरण

पहला एजेंट बनाने के बाद, Business Messages के बारे में ज़्यादा जानें. साथ ही, यह भी जानें कि इस प्लैटफ़ॉर्म पर और क्या-क्या किया जा सकता है.