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 ऐप्लिकेशन की जांच करना.

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

आर्किटेक्चर

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

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. पुष्टि करें कि आपने सही Cloud प्रोजेक्ट में एपीआई चालू किए हैं. इसके बाद, आगे बढ़ें पर क्लिक करें.

  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 ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.

  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: चैट मैसेज से, 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 एजेंट सिर्फ़ एक मैसेज के साथ जवाब देता है, तो मैसेज को Google Chat पर सिंक्रोनस तरीके से भेजा जाता है. अगर Dialogflow एजेंट एक से ज़्यादा मैसेज के साथ जवाब देता है, तो सभी मैसेज को Chat पर एसिंक्रोनस तरीके से भेजा जाता है. इसके लिए, हर मैसेज के लिए Chat API में create तरीके को spaces.messages संसाधन पर एक बार कॉल किया जाता है.
  • Chat के साथ Dialogflow ES इंटिग्रेशन का इस्तेमाल करते समय, Dialogflow एजेंट और Chat ऐप्लिकेशन को एक ही Google Cloud प्रोजेक्ट में सेट अप करना होगा.

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

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

स्टोरेज में जगह बनाएं

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

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

    Resource Manager पर जाएं

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