Actions on Google वेबहुक फ़ॉर्मैट (Dialogflow)

इस दस्तावेज़ में Actions on Google और कस्टम बातचीत वाले यूज़र इंटरफ़ेस के बारे में बताने वाली सेवा के बीच बातचीत करने के लिए, वेबहुक फ़ॉर्मैट के बारे में बताया गया है.

यह समझना ज़रूरी है कि Actions on Google और आपका ऑर्डर, Actions on Google वेबहुक फ़ॉर्मैट के ज़रिए किस तरह से बातचीत करते हैं:

  • Actions on Google से होने वाली बातचीत में हिस्सा लेने के लिए, आपके फ़ुलफ़िलमेंट में एक वेबहुक लागू किया जाता है. यह Actions on Google से मिले एचटीटीपी अनुरोधों का जवाब दे सकता है.
  • जब उपयोगकर्ता आपकी सेट की गई कार्रवाई को शुरू करते हैं, तो आपके फ़ुलफ़िलमेंट को एक HTTP POST मिलता है. इसमें JSON पेलोड होता है, जो उपयोगकर्ता के अनुरोध की जानकारी देता है.
  • इससे, अनुरोध पेलोड से पैरामीटर को पढ़ने, JSON फ़ॉर्मैट में सही रिस्पॉन्स जनरेट करने, और इस रिस्पॉन्स के साथ Assistant को जवाब भेजने की ज़िम्मेदारी आपके फ़ुलफ़िलमेंट की होती है.

अनुरोध के टाइप

इस टेबल में उन अनुरोधों की खास जानकारी दी गई है जो आपके वेबहुक को Assistant से मिल सकते हैं:

Type ब्यौरा JSON के उदाहरण
शुरू करने के अनुरोध उपयोगकर्ता के ऐसे उच्चारण जो आपके ऑर्डर को पूरा करने के लिए बातचीत शुरू करते हों या डीप-लिंक वाली कार्रवाइयों को ट्रिगर करते हों (उदाहरण के लिए, "डिनर की रेसिपी ढूंढने के लिए निजी शेफ़ से बात करें").
  • अगर Dialogflow का इस्तेमाल किया जा रहा है, तो ये अनुरोध, Google Assistant की इंटिग्रेशन सेटिंग के डिस्कवरी सेक्शन में दिए गए इंटेंट के मुताबिक होते हैं.
  • अगर Actions SDK टूल का इस्तेमाल किया जा रहा है, तो ये अनुरोध आपके Action पैकेज में बताए गए इंटेंट के मुताबिक होते हैं.
बातचीत के अनुरोध आपके फ़ुलफ़िलमेंट के साथ बातचीत शुरू होने के बाद, एक ही सेशन में शामिल उपयोगकर्ताओं के स्टेटमेंट. बातचीत के वेबहुक फ़ॉर्मैट में, ये actions.intent.TEXT इंटेंट से जुड़े ऐसे रॉ टेक्स्ट वाले जवाब होते हैं जो उपयोगकर्ता ने पिछली बार भेजे थे.
हेल्पर नतीजे ये वे अनुरोध हैं जो Assistant से आपके ऑर्डर को पूरा करने के लिए तब भेजे जाते हैं, जब वेबहुक ने बातचीत के पिछले मोड़ में, बातचीत के कुछ हिस्सों (उदाहरण के लिए, actions.intent.OPTION और actions.intent.PERMISSION) को मैनेज करने के लिए हेल्पर इंटेंट का अनुरोध किया हो.

बातचीत के अनुरोध और जवाब

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

जब Actions on Google को यह पता चलता है कि आपका फ़ुलफ़िलमेंट, उपयोगकर्ता की बातचीत के हिसाब से सही है, तब वह एक एचटीटीपी अनुरोध भेजकर बातचीत का सेशन शुरू करता है. इस अनुरोध में, आपके फ़ुलफ़िलमेंट एंडपॉइंट पर उपयोगकर्ता के अनुरोध की जानकारी के साथ JSON पेलोड शामिल होता है. आपका फ़ुलफ़िलमेंट, अनुरोध को पार्स करता है और JSON पेलोड वाला रिस्पॉन्स दिखाता है. इसके बाद Actions on Google, उपयोगकर्ताओं के लिए पेलोड को रेंडर किए गए स्पीच और मल्टीमीडिया आउटपुट में बदल देता है.

पहली इमेज. Actions on Google की मदद से, आपके ऑर्डर को पूरा करने के लिए, Actions SDK टूल की मदद ली जाती है.

जब Actions on Google, Actions SDK टूल की मदद से आपका फ़ुलफ़िलमेंट शुरू करता है, तब JSON पेलोड के फ़ॉर्मैट के बारे में ज़्यादा जानने के लिए, बातचीत का वेबहुक फ़ॉर्मैट देखें.

Dialogflow के अनुरोध और जवाब

कार्रवाइयां बनाते समय, बातचीत वाले इंटरफ़ेस बनाने के काम को आसान बनाने के लिए, Dialogflow का इस्तेमाल किया जा सकता है. इस स्थिति में, Dialogflow, Actions on Google और आपके ऑर्डर को पूरा करने के लिए, प्रॉक्सी के तौर पर काम करता है. एचटीटीपी/JSON अनुरोध को सीधे तौर पर आपके फ़ुलफ़िलमेंट एंडपॉइंट पर भेजने के बजाय, Actions on Google इसे Dialogflow को भेजता है.

Dialogflow, मूल अनुरोध में शामिल JSON पेलोड को Dialogflow वेबहुक फ़ॉर्मैट में रैप करता है और उससे मिलने वाले अनुरोध को Dialogflow पर फ़ॉरवर्ड करता है.

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

दूसरी इमेज. Actions on Google, Dialogflow की मदद से आपके ऑर्डर को पूरा करने के लिए न्योता देता है.

जब Actions on Google, Dialogflow के ज़रिए आपके फ़ुलफ़िलमेंट को शुरू करता है, तो JSON पेलोड के फ़ॉर्मैट के बारे में ज़्यादा जानने के लिए, Dialogflow वेबहुक फ़ॉर्मैट देखें.