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

इस पेज पर, Google Chat ऐप्लिकेशन को Google Workspace ऐड-ऑन के तौर पर बनाने का तरीका बताया गया है. यह ऐड-ऑन, सामान्य भाषा को समझने और उसका जवाब देने के लिए Dialogflow ES का इस्तेमाल करता है. 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 स्पेस में मैसेज भेजता है.
2. Dialogflow का वर्चुअल एजेंट, मैसेज को पाने और प्रोसेस करने के बाद जवाब देता है. यह एजेंट, में मौजूद होता है .
3. Dialogflow वेबहुक का इस्तेमाल करके, Dialogflow एजेंट, तीसरे पक्ष की बाहरी सेवाओं के साथ इंटरैक्ट कर सकता है. जैसे, प्रोजेक्ट मैनेजमेंट सिस्टम या टिकट टूल.
4. Dialogflow एजेंट, Chat में Chat ऐप्लिकेशन सेवा को जवाब भेजता है.
5. जवाब, Chat स्पेस में डिलीवर किया जाता है.

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

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

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

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

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

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

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

1. Dialogflow ES Console पर जाएं.
2. एजेंट बनाएं पर क्लिक करें.
3. इसे कोई नाम दें. साथ ही, डिफ़ॉल्ट भाषा और टाइम ज़ोन चुनें.
4. इसे अपने Cloud प्रोजेक्ट से जोड़ें.
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. add नई चैट पर क्लिक करें.
3. एक या उससे ज़्यादा लोग जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.

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

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 फ़ॉर्मैट देना होगा.

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

{ "hangouts": { "hostAppDataAction": { "chatDataAction": {
  "createMessageAction": { "message": { "cardsV2": [{
    "cardId": "pizza",
    "card": {
      "header": {
        "title": "Pizza Delivery Customer Support",
        "subtitle": "pizzadelivery@example.com",
        "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 Google Chat ऐप्लिकेशन की गड़बड़ियां: Chat ऐप्लिकेशन की गड़बड़ी के सामान्य मैसेज और उन्हें ठीक करने के तरीके जानने के लिए, Chat ऐप्लिकेशन की गड़बड़ियां हल करना और उन्हें ठीक करना लेख पढ़ें.

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

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

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

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

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

   Resource Manager पर जाएं

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

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

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