Dialogflow ES की मदद से Google Chat ऐड-ऑन बनाना

इस पेज पर, Google Workspace के ऐड-ऑन के तौर पर Google Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. यह ऐड-ऑन, Dialogflow ES का इस्तेमाल करके, सामान्य भाषा को समझता है और उसका जवाब देता है. Dialogflow CX का इस्तेमाल करके भी, Dialogflow CX Google Chat ऐप्लिकेशन बनाया जा सकता है. इसके लिए, Dialogflow CX Google Chat के लिए बने गाइडलाइन को फ़ॉलो करें. Dialogflow CX को Google Chat के साथ सीधे इंटिग्रेट किया जा सकता है.

मकसद

• अपना एनवायरमेंट सेट अप करना.
• Dialogflow ES एजेंट बनाना और उसे डिप्लॉय करना.
• Dialogflow ES एजेंट की मदद से Chat ऐप्लिकेशन बनाना और उसे डिप्लॉय करना.
• Chat ऐप्लिकेशन की जांच करना.

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

• Business या Enterprise Google Workspace खाता. साथ ही, Google Chat का ऐक्सेस.
• बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट में बिलिंग की सुविधा चालू है या नहीं, देखें अपने प्रोजेक्ट की बिलिंग की स्थिति की पुष्टि करना. कोई प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.

आर्किटेक्चर

यहां दिए गए डायग्राम में, Dialogflow की मदद से बनाए गए Chat ऐप्लिकेशन का आर्किटेक्चर दिखाया गया है:

ऊपर दिए गए डायग्राम में, Dialogflow Chat ऐप्लिकेशन के साथ इंटरैक्ट करने वाले उपयोगकर्ता के लिए, जानकारी का फ़्लो इस तरह होता है:

1. कोई उपयोगकर्ता, Chat ऐप्लिकेशन को Chat में मैसेज भेजता है. यह मैसेज, डायरेक्ट मैसेज या Chat स्पेस में भेजा जा सकता है.
2. Dialogflow वर्चुअल एजेंट, मैसेज को लेता है और उसका जवाब देने के लिए उसे प्रोसेस करता है. यह एजेंट, में मौजूद होता है , लेता है और जवाब देने के लिए मैसेज को प्रोसेस करता है.
3. Dialogflow वेबहुक का इस्तेमाल करके, Dialogflow एजेंट, तीसरे पक्ष की बाहरी सेवाओं के साथ इंटरैक्ट कर सकता है. जैसे, प्रोजेक्ट मैनेजमेंट सिस्टम या टिकट टूल.
4. Dialogflow एजेंट, Chat में Chat ऐप्लिकेशन सेवा को जवाब भेजता है.
5. जवाब, Chat स्पेस में डिलीवर किया जाता है.

एनवायरमेंट सेट अप करना

Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या एक से ज़्यादा एपीआई चालू किए जा सकते हैं.

1. Google API Console में, Google Chat API और Dialogflow API चालू करें.

   एपीआई चालू करें

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

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

Dialogflow ES एजेंट बनाना

अगर आपके पास पहले से कोई Dialogflow ES एजेंट नहीं है, तो:

1. Dialogflow ES Console पर जाएं.
2. एजेंट बनाएं पर क्लिक करें.
3. इसे कोई नाम दें. साथ ही, डिफ़ॉल्ट भाषा और टाइम ज़ोन चुनें.
4. इसे अपने क्लाउड प्रोजेक्ट से जोड़ें.
5. बनाएं पर क्लिक करें.
6. अपनी ज़रूरत के हिसाब से इंटेंट और इकाइयां बनाएं. ये इंटेंट और इकाइयां, आपके Chat ऐप्लिकेशन के बातचीत के फ़्लो के लिए ज़रूरी हैं. शुरुआत में, स्वागत करने वाला इंटेंट बनाया जा सकता है.
7. अपना प्रोजेक्ट आईडी नोट करें.

ज़्यादा जानकारी के लिए, एजेंट बनाना लेख पढ़ें.

Chat ऐप्लिकेशन बनाना और उसे Dialogflow एजेंट से कनेक्ट करना

Dialogflow ES एजेंट बनाने के बाद, उसे Chat ऐप्लिकेशन में बदलने के लिए यह तरीका अपनाएं:

1. Google API Console में, Google Chat API पर जाएं. "Google Chat API" खोजें और Google Chat API पर क्लिक करें. इसके बाद, मैनेज करें पर क्लिक करें.

   Chat API पर जाएं

2. कॉन्फ़िगरेशन पर क्लिक करें और Chat ऐप्लिकेशन सेट अप करें:

   1. ऐप्लिकेशन का नाम में, Dialogflow App डालें.
   2. अवतार यूआरएल में, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png डालें.
   3. **जानकारी** में, Responds to real human conversation डालें.
   4. सुविधा में, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
   5. कनेक्शन सेटिंग में, Dialogflow को चुनें.
   6. Dialogflow सेटिंग में, Dialogflow ES को चुनें.
   7. अपने डोमेन में इस Chat ऐप्लिकेशन को चुनिंदा लोगों और ग्रुप के लिए उपलब्ध कराएं को चुनें और अपना ईमेल पता डालें.
   8. लॉग में, लॉगिंग में गड़बड़ियों को लॉग करें को चुनें.

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

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

Chat ऐप्लिकेशन की जांच करना

Google Chat में, Dialogflow ES Chat ऐप्लिकेशन को मैसेज भेजकर उसकी जांच करें.

1. Google Workspace खाते का इस्तेमाल करके, Google Chat खोलें. आपने इस खाते की जानकारी, भरोसेमंद टेस्टर के तौर पर खुद को जोड़ने के दौरान दी थी.

   Google Chat पर जाएं

2. नई चैट पर क्लिक करें.
3. एक या उससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.

4. नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.

   ध्यान दें: अगर आपको नतीजों की सूची में अपना Chat ऐप्लिकेशन नहीं दिखता है, तो पक्का करें कि आपने Google API Console में Chat API कॉन्फ़िगरेशन पेज की विज़िबिलिटी सेटिंग में, अपना Google Workspace खाता शामिल किया हो.

5. ऐप्लिकेशन के साथ नए डायरेक्ट मैसेज में, Hello लिखें और enter दबाएं.

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

मैसेज वाले जवाब

मैसेज वाले जवाब Google Chat को मैसेज के तौर पर भेजे जाते हैं. इस फ़ॉर्मैटिंग की मदद से, टेक्स्ट को बोल्ड या इटैलिक किया जा सकता है. इसके लिए, टेक्स्ट को कुछ (मार्कडाउन लाइट) सिंबल में रैप करें.

मैसेज वाले जवाब, Dialogflow Console में डिफ़ॉल्ट के तौर पर सेट किए गए मैसेज वाले जवाब की तरह दिखते हैं. हालांकि, एपीआई का रॉ रिस्पॉन्स थोड़ा अलग दिखेगा. यह प्लैटफ़ॉर्म कॉन्फ़िगरेशन को GOOGLE_HANGOUTS पर भी सेट करता है. यह कई इंटिग्रेशन के लिए एजेंट बनाते समय काम आ सकता है.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

कार्ड

कार्ड वाले जवाब Google Chat को कार्ड मैसेज के तौर पर भेजे जाते हैं.

इमेज

इमेज वाले जवाब Google Chat को Google Chat इमेज विजेटके तौर पर भेजे जाते हैं.

कस्टम पेलोड

Google Chat के अन्य तरह के मैसेज भेजने के लिए, कस्टम पेलोड का इस्तेमाल किया जा सकता है.

Google Chat के कस्टम पेलोड की मदद से, ज़्यादा बेहतर कार्ड बनाए जा सकते हैं. एक कार्ड में एक या एक से ज़्यादा सेक्शन हो सकते हैं. हर सेक्शन में हेडर हो सकता है. Google Workspace ऐड-ऑन, Chat कार्ड रेफ़रंस गाइड को बढ़ाकर, कुछ ऐसे कॉम्बिनेशन देखे जा सकते हैं जिन्हें इससे बनाया जा सकता है. हालांकि, कस्टम पेलोड का इस्तेमाल करने का मतलब है कि आपको JSON फ़ॉर्मैट देना होगा.

ध्यान दें: रेफ़रंस गाइड से उदाहरणों को कॉपी करके, Dialogflow में कस्टम पेलोड बॉक्स में चिपकाते समय, पक्का करें कि एडिटर में कोई लिंटिंग गड़बड़ी न हो. Dialogflow सिम्युलेटर में नतीजों की जांच नहीं की जा सकती. हालांकि, Google Chat में सीधे तौर पर जांच की जा सकती है.

यहां कार्ड वाला मैसेज बनाने के लिए, कस्टम पेलोड का एक उदाहरण दिया गया है:

{ "hangouts": { "hostAppDataAction": { "chatDataAction": {
  "createMessageAction": { "message": { "cardsV2": [{
    "cardId": "pizza",
    "card": {
      "header": {
        "title": "Pizza Delivery Customer Support",
        "subtitle": "[e-mail]",
        "imageUrl": "https://goo.gl/aeDtrS"
      },
      "sections": [{ "widgets": [{ "textParagraph": {
        "text": " Your pizza is here!"
      }}]}]
    }
  }]}}
}}}}

सीमाएं और ध्यान रखने वाली बातें

• Dialogflow के साथ Google Workspace ऐड-ऑन का इस्तेमाल करते समय, Chat इवेंट ऑब्जेक्ट पर ये सीमाएं लागू होती हैं और इन बातों का ध्यान रखना होता है:
  • ऐप्लिकेशन होम पेज के इवेंट: फ़िलहाल, APP_HOME इवेंट के लिए सहायता उपलब्ध नहीं है.
  • Dialogflow क्वेरी इनपुट: Dialogflow एजेंट को क्वेरी इनपुट के तौर पर भेजा गया टेक्स्ट, इवेंट के टाइप पर निर्भर करता है:
    • MESSAGE: Chat मैसेज से argumentText फ़ील्ड की वैल्यू.
    • APP_COMMAND: स्ट्रिंग "APP_COMMAND_PAYLOAD".
    • ADDED_TO_SPACE: डिफ़ॉल्ट के तौर पर, स्वागत करने वाला इवेंट भेजा जाता है.
    • REMOVED_FROM_SPACE: स्ट्रिंग "REMOVED_FROM_SPACE_PAYLOAD".
    • CARD_CLICKED: स्ट्रिंग "BUTTON_CLICKED_PAYLOAD".
    • WIDGET_UPDATED: स्ट्रिंग "WIDGET_UPDATED_PAYLOAD" (ऑटोमैटिक तरीके से पूरा करने के लिए इस्तेमाल की जाती है).
  • पूरा इवेंट पेलोड: Chat इंटरैक्शन इवेंट का पूरा JSON पेलोड, WebhookRequest.payload फ़ील्ड में Dialogflow को भेजा जाता है. इसे अपने Dialogflow वेबहुक में ऐक्सेस किया जा सकता है. ज़्यादा जानकारी के लिए, Dialogflow ES वेबहुक के अनुरोध से जुड़ा दस्तावेज़ देखें.
• कमांड का जवाब देने और कार्ड या डायलॉग से डेटा पाने के लिए, इन बातों का ध्यान रखें:
  • अगर Dialogflow एजेंट को Chat इंटरैक्शन इवेंट के JSON पेलोडको प्रोसेस करना है, तो वह क्वेरी पैरामीटर में कस्टम पेलोड की जांच करने के लिए, Dialogflow वेबहुक का इस्तेमाल करके ऐसा कर सकता है.
  • Dialogflow एजेंट से कोई डायलॉग दिखाने के लिए, एक कस्टम JSON पेलोड के साथ जवाब दें. इसमें नेविगेशन pushCard के साथ RenderActions ऑब्जेक्ट शामिल हो.
  • कार्ड से डाले गए डेटा को प्रोसेस करने के लिए, Dialogflow वेबहुक का इस्तेमाल किया जा सकता है. साथ ही, सही कार्रवाई वाले एक कस्टम JSON पेलोड के साथ जवाब दिया जा सकता है.
• लिंक की झलक दिखाने की सुविधा उपलब्ध नहीं है.
• अगर Dialogflow एजेंट सिर्फ़ एक मैसेज के साथ जवाब देता है, तो मैसेज को Google Chat पर सिंक्रोनस तरीके से भेजा जाता है. अगर Dialogflow एजेंट एक से ज़्यादा मैसेज के साथ जवाब देता है, तो सभी मैसेज को Chat पर एसिंक्रोनस तरीके से भेजा जाता है. इसके लिए, हर मैसेज के लिए Chat API में create तरीके को spaces.messages संसाधन पर एक बार कॉल किया जाता है.
• Chat के साथ Dialogflow ES इंटिग्रेशन का इस्तेमाल करते समय, Dialogflow एजेंट और Chat ऐप्लिकेशन को एक ही Google Cloud प्रोजेक्ट में सेट अप करना होगा.

समस्या हल करें

अपने Chat ऐप्लिकेशन को डीबग करने के लिए, सबसे पहले गड़बड़ी के लॉग देखें. यह ऐप्लिकेशन, Dialogflow का इस्तेमाल करता है. इसलिए, आपके पास लॉगिंग और समस्या हल करने के कई संसाधन उपलब्ध हैं:

• Google Workspace ऐड-ऑन के लॉग: ऐड-ऑन के व्यवहार के बारे में ज़्यादा जानकारी के लिए, क्वेरी लॉग देखें. इनमें Chat के साथ इसके इंटरैक्शन की जानकारी भी शामिल होती है. Google Workspace ऐड-ऑन के लिए क्वेरी लॉग देखें.

• Google Chat ऐप्लिकेशन की गड़बड़ियां: Chat ऐप्लिकेशन की गड़बड़ी के सामान्य मैसेज और उन्हें ठीक करने के तरीके जानने के लिए, Chat ऐप्लिकेशन की गड़बड़ियां हल करना लेख पढ़ें.

• Dialogflow ES की बातचीत का इतिहास: इतिहास | Dialogflow ES

• Dialogflow की सामान्य समस्याएं हल करना: समस्या हल करना | Dialogflow

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

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

चेतावनी: किसी प्रोजेक्ट को मिटाने पर, यह असर होता है:

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

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

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

   Resource Manager पर जाएं

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

मिलते-जुलते विषय

• Dialogflow CX Chat ऐप्लिकेशन के साथ Dialogflow का इस्तेमाल करने का एक और तरीका है.