शून्य से "Google पर कार्रवाई" नायक: शुरू

Google हैकाथॉन, और आपको एक सहायक के लिए अपने एप्लिकेशन विकसित करने शुरू करने की आवश्यकता है।

Google ने एक्शन ऑन गूगल तकनीक को समर्पित एक हैकथॉन का आयोजन किया है। यह अनुभव प्राप्त करने और हमारे अनुप्रयोगों के लिए वार्तालाप उपयोगकर्ता इंटरफ़ेस (CUI) बनाने के बारे में सोचने का एक अच्छा अवसर है। इसलिए, हमने दो एंड्रॉइड डेवलपर्स की एक टीम को इकट्ठा किया: शिपा_ओ , रेनार्डेव और डिजाइनर कॉमरेडगैस्ट, और भाग लेने के लिए चले गए।

Google पर कार्रवाई क्या है?

Google पर कार्रवाई (एओजी) आपकी कार्रवाई को सहायक में जोड़ने का एक तरीका है।
आप 4 टूल का उपयोग करके ऐसा कर सकते हैं:

• सामग्री क्रियाएँ
• स्लाइस ;
• ऐप क्रिया
• Google सहायक के लिए कौशल ।

हैकाथॉन में, हमने एक कौशल बनाया - एक ऐसा अनुप्रयोग जो एक सहायक की क्षमताओं का विस्तार करता है, इसलिए हम वहां रुकेंगे।

अपील के बाद, “ठीक है गूगल। मैं ${_} साथ बात करना चाहता हूं ”, सहायक उस कौशल को खोलता है जिसके साथ उपयोगकर्ता एक संवाद आयोजित करता है:

कौशल कैसे लिखें?

आपको दो कौशलों की आवश्यकता होगी:
- संवादी उपयोगकर्ता इंटरफ़ेस (CUI) की समझ, उन्हें डिजाइन करने की क्षमता;
- प्राकृतिक भाषा प्रसंस्करण (एनएलपी) के साथ काम करने की क्षमता, उदाहरण के लिए, डायलॉगफ़्लो।

स्टेज 1: डिजाइन

आपके कौशल के लिए एक प्रोटीन वार्ताकार होने के लिए, अब भविष्य के बारे में सोचना बेहतर है। मांग वह होगी जो उपयोग के संदर्भ को ध्यान में रखे। डायलॉग इंटरफेस का उपयोग तब किया जाएगा जब ज़ोर से बोलना संभव हो और हाथों, आंखों और शरीर के अन्य हिस्सों की तुलना में आवाज़ के साथ उपकरणों को अधिक आसानी से और जल्दी से बातचीत कर सके।

आवाज इंटरफ़ेस धारावाहिक है। यदि ग्राफिक पर एक आदेश रखने के पूरे रूप को दिखाना संभव है, और व्यक्ति खुद चुन लेगा कि पहले क्या देखना है और फिर क्या, तो आप केवल एक के बाद एक आवाज में सवाल पूछ सकते हैं। एक लोकप्रिय और सुविधाजनक एप्लिकेशन के साथ आने के लिए, उपयोगकर्ता की जरूरतों और वॉयस इंटरफेस का उपयोग करने की क्षमता (या दूसरों का उपयोग करने में असमर्थता) के बीच अंतर देखें।

पहली बात जो दिमाग में आती है वह अंधे के लिए एक आवाज सहायक है, जो रोजमर्रा की समस्याओं को हल करने में मदद करती है। उदाहरण के लिए, एक स्टोर में एक ऑर्डर रखें, टैक्सी बुलाएं, रिश्तेदारों को बुलाएं। दूसरा आटे में हाथ के साथ गृहिणियों के लिए एक बात कर नुस्खा किताब है। तीसरा, खेल जिसमें आपको कुछ समझाने की जरूरत है।

हमने एक साधारण से शुरुआत करने का फैसला किया और एक ऐसा रोबोट विकसित किया, जो अच्छी फिल्मों पर लोगों को सलाह देता है। हम ध्वनि सिंथेसाइज़र की अपूर्णता को हराते हैं: हमारे सहायक भी एक आदमी होने का दिखावा नहीं करते हैं और हर तरह से अपने ज्वलंत इलेक्ट्रॉनिक व्यक्तित्व पर जोर देते हैं।

Google ने इंटरेक्टिव इंटरफेस विकसित करने के बारे में उत्कृष्ट दिशानिर्देश लिखे हैं। और हम इस बारे में बात करेंगे कि हमने अपनी बातचीत को पहली बार कैसे तैयार किया।

1. आह्वान

सबसे पहले, आपको एक सहायक को कॉल करने की आवश्यकता है। कॉल स्पष्ट (स्पष्ट आमंत्रण) और अप्रत्यक्ष (इंप्लिमेंट इनवोकेशन) हो सकता है। जब वे पहले से ही आवेदन जानते हैं तो लोग स्पष्ट उपचार का उपयोग करेंगे। अप्रत्यक्ष रूप से, Google सहायक एक विशिष्ट स्थिति में एक उपयुक्त आवेदन की सिफारिश कर सकता है। अप्रत्यक्ष अपील के लिए सही तरीके से चुने गए विकल्प - प्रासंगिक विज्ञापन में सही कीवर्ड की तरह, केवल "मानव" हैं।

यह महत्वपूर्ण है कि अप्रत्यक्ष कॉल बहुत सामान्य नहीं हैं। प्रासंगिक विज्ञापन में सामान्य कीवर्ड की तरह, वे केवल आपको सही एप्लिकेशन ढूंढने से रोकते हैं और सहायक के जारी होने में आवेदन की रेटिंग को कम करते हैं।

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

2. पहला अभिवादन

पहला ग्रीटिंग वह है जो एप्लिकेशन कॉल के तुरंत बाद व्यक्ति को बताता है।
पहले आपको उपयोगकर्ता को यह बताना होगा कि सहायक पहले से ही यहां है:

हाय, जीवन का एक प्रोटीन रूप। मैं एक रेड पैशन मूवी-रोबोट हूं। मेरे अस्तित्व का उद्देश्य अच्छी फिल्मों पर जैविक फिल्मों की सलाह देना है।

और फिर - सुझाव है कि आगे क्या करना है। हमारा रोबोट शैली द्वारा फिल्मों की तलाश कर रहा है, इसलिए हम सुझाव देते हैं कि कोई व्यक्ति किस अनुरोध पर आगे बढ़ सकता है:
आप क्या देखना चाहते हैं: शायद कॉमेडी, एक्शन या हॉरर?

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

3. मानवीय वार्तालाप

अपने सहायक को प्राकृतिक भाषण समझने और बातचीत जारी रखने के लिए सिखाएं। ऐसा करने का सबसे आसान तरीका विकास शुरू होने से पहले ही लक्षित दर्शकों के लोगों से संवाद करना है। इसके अलावा, यह मौखिक रूप से वांछनीय है, और लिखित रूप में नहीं, क्योंकि लिखित बोलचाल की भाषा मौखिक की तुलना में अधिक दुर्लभ है। रोबोट की भूमिका निभाएं, और वार्ताकार से यह कल्पना करने के लिए कहें कि वह आपके भविष्य के एप्लिकेशन का उपयोग कर रहा है। रिकॉर्डर पर सभी संवाद रिकॉर्ड करें, और फिर डिक्रिप्ट करें। यह आपको एक विशिष्ट वार्तालाप आरेख डिजाइन करने और यह पता लगाने में मदद करेगा कि शाखाएं कहां दिखाई दे सकती हैं।

स्टेज 2: विकास

सहायक के लिए अपनी कार्रवाई विकसित करने के कई तरीके हैं:

• संवाद के साथ।
• Google एसडीके पर कार्रवाई के साथ।
• पाठ को स्वतंत्र रूप से संसाधित किया जा सकता है - उदाहरण के लिए, यदि आपके पास प्राकृतिक भाषा (एनएलपी - प्राकृतिक भाषा प्रसंस्करण) के प्रसंस्करण के लिए अपना समाधान है।

निम्नलिखित आपके कौशल के साथ एक सहायक की बातचीत है।
संवाद कुछ इस तरह दिखता है:

1. सहायक भाषण को पाठ में अनुवादित करता है और इसे आपकी कार्रवाई में भेजता है।

   
   

2. पाठ उपरोक्त तरीकों में से एक में संसाधित होता है। इस आरेख में, डायलॉगफ़्लो के माध्यम से।

   
   

3. Dialogflow इरादे (उपयोगकर्ता के विशिष्ट इरादे) को परिभाषित करता है और प्राप्त करता है
   इसे संस्थाओं (मापदंडों) से।

   
   

4. (वैकल्पिक) डायलॉगफ़्लो इसी वेबहुक को कॉल कर सकता है, बैकएंड पर डेटा को संसाधित कर सकता है और प्रतिक्रिया प्राप्त कर सकता है।

   
   

5. डायलॉगफ्लो उत्तर बनाता है।

   
   

6. सहायक उत्तर को आवाज देता है, माइक्रोफोन को चालू करता है और सुनता है कि उपयोगकर्ता क्या कहेगा।

   
   

सहायक क्रिया आरेख

Dialogflow

हम डायलॉगफ़्लो की मूल बातों का विस्तार नहीं करेंगे - Google ने अच्छे ट्यूटोरियल वीडियो जारी किए।

1. इरादे - इरादे को पहचानने के बारे में, कैसे डायलॉगफ़्लो यह समझता है कि उपयोगकर्ता क्या पूछता है या वह क्या कार्रवाई करना चाहता है।
2. संस्थाओं - एक वाक्यांश के अंदर मापदंडों की मान्यता के बारे में। उदाहरण के लिए, फिल्मों की सिफारिश करने के मामले में, यह एक विशिष्ट शैली है।
3. संवाद नियंत्रण - संदर्भ तंत्र के बारे में (इसके बारे में नीचे) और पूर्ति: अपने बैकएंड पर पहुंचकर उपयोगकर्ता के अनुरोध को कैसे संसाधित करें, और पाठ प्रतिक्रिया की तुलना में कुछ अधिक दिलचस्प कैसे वापस करें।

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

याद रखें कि जब आप कार्यान्वयन के लिए आगे बढ़ते हैं, तो एक अच्छा संवाद बनाने के नियम - यह इंटेंट्स के गुच्छा, संस्थाओं के सेट और उत्तरों में उनके उपयोग, संदर्भों के उपयोग और अन्य सभी चीजों को प्रभावित करेगा।

इंटेंट

सिफारिशें हैं - नए उपयोगकर्ता के लिए अधिक विस्तृत ग्रीटिंग बनाने के लिए, और बाकी के लिए इसे और अधिक संक्षिप्त बनाने के लिए। इसे कैसे लागू किया जाए?

डायलॉगफ़्लो कंसोल में, यह तर्क निर्धारित नहीं किया जा सकता है। यह स्वागत इरादे के लिए पूर्ति के अंदर किया जा सकता है। दूसरे शब्दों में, आपको अपने हाथों से ऐसा करने की आवश्यकता होगी।

यह एरर हैंडलिंग पर भी लागू होता है। उदाहरण के लिए, पहली बार आप बस फिर से पूछ सकते हैं, और दूसरी बार आप बता सकते हैं कि आप उपयोगकर्ता से किस तरह की प्रतिक्रिया की उम्मीद करते हैं।

आपने प्रतिक्रियाओं के माध्यम से ऐसा नहीं किया - एक यादृच्छिक उत्तर का चयन किया जाएगा। आप इसे पूर्णता के माध्यम से कर सकते हैं या इसे संदर्भ में बांधकर थोड़ा पेचीदा मामला (नीचे उस पर और अधिक)।

संस्थाओं

"स्वचालित विस्तार की अनुमति दें" और sys.Any

यदि वाक्यांश संरचना में समान है, तो जब "अनुमति दें स्वचालित विस्तार" को एक मान्यता प्राप्त इकाई के रूप में चालू किया जाता है, तो कुछ ऐसा हो सकता है जिसे अभी भी लाभ के साथ संसाधित नहीं किया जा सकता है।

उदाहरण के लिए, आपका एप्लिकेशन मूवी टिप्स के लिए वाक्यांश "मुझे <शैली> से कुछ सुझाव दें" को पहचानता है। यदि आप कहते हैं "मुझे भोजन से कुछ सलाह दें", तो एक पैरामीटर "शैली" के रूप में आपको वह नहीं मिलेगा जो आप उम्मीद करेंगे। यह समझ में आता है कि अगर आप लगातार बैकेंड पर गतिशील रूप से अपडेट किए गए शैलियों के सेट और उपयोगकर्ता की प्रतिक्रिया को वहां संसाधित करते हैं, लेकिन आपके पास इकाई को अपडेट करने का समय नहीं है।

एक और उपाय sys.Any का उपयोग करना है। इस मामले में, वह सब कुछ बताएगा जो अपेक्षित डिजाइन के बाद था, जो कि पूरा प्रस्ताव हो सकता है। यह स्वचालित विस्तार की तुलना में अधिक अवसर देता है, लेकिन इसके साथ ही अधिक नुकसान भी हैं।

एकवचन और बहुवचन, मामले, लिंग

चलो एक सरल उदाहरण के साथ आते हैं। हम आपके पसंदीदा फलों के बारे में बात करेंगे, और एप्लिकेशन जवाब देगा कि वे कितने शांत हैं। नीचे दिए गए उदाहरणों में, पी उपयोगकर्ता है, ए हमारी कार्रवाई है।

P: अनानास सबसे स्वादिष्ट हैं।
एक: हाँ, अनानास सबसे अच्छे फल हैं!

इस उदाहरण में, हमारे पास इकाई है: अनानास
लेकिन क्या होगा अगर उपयोगकर्ता "अनानास" कहता है? हम एक पर्यायवाची जोड़ सकते हैं।

P: मैं अनानास पसंद आया।
एक: हाँ, अनानास सबसे अच्छे फल हैं!

डिफ़ॉल्ट संदर्भ प्रपत्र है - अर्थात यह मूल रूप है, इसके पर्यायवाची नहीं। यही कारण है कि आवेदन "हाँ, अनानास सबसे अच्छे फल है!"

उत्तर लिखते समय यह भी ध्यान देने योग्य है। अगर हमारे पास जवाब था "हाँ, $ फल सबसे ठंडा है!", तो हमें निम्नलिखित मिलेगा:

P: मैं अनानास पसंद आया।
A: हाँ, अनानास सबसे अच्छे हैं!

और मामलों के बारे में मत भूलना:

P: मुझे नाटक चाहिए
A: यहाँ एक शांत नाटक है ...

इसलिए, आपको इकाई के प्रारंभिक मूल्यों और उत्तर दोनों को एक सुसंगत रूप में लिखना चाहिए। उदाहरण के लिए, हम बहुवचन में फल के लिए सभी मूल इकाई रूपों को कर सकते हैं, और किसी में समानार्थक शब्द।

हम रूसी में नाममात्र के मामले में शैलियों को करेंगे, लेकिन किसी भी संख्या (नाटक, भयावहता) में।

जब हम उत्तर प्राप्त करते हैं, तो हम नहीं लिखते हैं "हाँ, $ फल सबसे अच्छा फल है!" और "हाँ, $ फल सबसे अच्छे हैं!" - फल हमेशा बहुवचन में होते हैं।

रूसी भाषा के मामले में, यह और भी आगे बढ़ने के लायक है और एक सहमत उत्तर लिखने के तरीके के बारे में - हमारे पास न केवल मामले (नाटक / नाटक) हैं, बल्कि लिंग (नाटक / पश्चिमी) भी हैं।

P: मैं एक पश्चिमी चाहते हैं
एक: यहाँ एक शांत पश्चिमी है ...

P: मैं एक पश्चिमी चाहते हैं
A: पश्चिमी? ठीक है, यहाँ एक शांत फिल्म ...

लेकिन उपयोगकर्ता द्वारा कहा गया है कि वास्तव में इकाई के रूप में वापस कैसे करें?

शैलियों के मामले में, "विज्ञान कथा" का पर्याय "एलियंस" हो सकता है। फिर, यदि उपयोगकर्ता ने कहा कि "एलियंस", "विज्ञान कथा" एक पैरामीटर के रूप में वापस आ जाएगी।
यदि हम उस इकाई को उस रूप में प्राप्त करना चाहते हैं जिसमें उपयोगकर्ता ने कहा है, तो यह $ एंटिटी का मूल्य चुनने के लायक है।

लेकिन फिर संख्या की असंगति और (विशेषकर) मामलों की असंगति के साथ समस्याएं हो सकती हैं। क्या यह वास्तव में आवश्यक है? यदि हां, तो एकवचन, बहुवचन और मामले के लिए एक इकाई बनाएं। प्रतिक्रियाएं उस इकाई रूप के अनुरूप भी होनी चाहिए जिसका वे उपयोग करते हैं।

संदर्भों

शायद इसके साथ सबसे अधिक समस्याएं हैं।

इनपुट संदर्भ

यह वह संदर्भ है जिसके लिए एक विशेष इरादा बाध्य है। कई इरादे एक ही वाक्यांश का जवाब दे सकते हैं, और सक्रिय इनपुट संदर्भ के साथ सबसे अधिक संभावना काम होगी।
इस प्रकार, उदाहरण के लिए, आप एक विशिष्ट प्रश्न के लिए हाँ / नहीं में उत्तर दे सकते हैं, जो डायलॉगफ़्लो में अनुवर्ती इरादे का उपयोग करके किया जाता है

आउटपुट संदर्भ

यह वह संदर्भ है जो आशय ट्रिगर होने पर सक्रिय होता है। डायलॉगफ़्लो कंसोल में यह कैसे संदर्भ सक्रिय होता है (इसे भी पूरा किया जा सकता है)। हम उस संवाद की संख्या को इंगित करते हैं जिसके दौरान वह सक्रिय होगा, और काउंटर को रीसेट करने के बाद या 20 मिनट के बाद इसे निष्क्रिय कर दिया जाता है। इसका मतलब है कि इस संदर्भ के अंदर डेटा अब उपलब्ध नहीं होगा और इरादे जिसके लिए यह इनपुट है वह काम नहीं करेगा।

एक और चाल इसी के साथ जुड़ी हुई है: आप एक इरादे के साथ एक संदर्भ को सक्रिय कर सकते हैं और इसे मैन्युअल रूप से दूसरे के साथ निष्क्रिय कर सकते हैं, बस इसे दूसरे संदर्भ के लिए आउटपुट संदर्भ के रूप में उत्तर 0 की संख्या के साथ डाल सकते हैं।

यदि आप पूर्ति में कोड नहीं लिखना चाहते हैं, तो इस तरह से आप दिलचस्प तर्क को लागू कर सकते हैं, उदाहरण के लिए, एक काउंटर के रूप में संदर्भ का उपयोग करते हुए, त्रुटि से निपटने को लागू करें जब सहायक उपयोगकर्ता को नहीं समझता है।

डायलॉगफ्लो टिप्स

• पृष्ठ को सहायक पूर्वावलोकन के साथ पुनरारंभ करने की कोई आवश्यकता नहीं है - जब आपने संवादप्रवाह एजेंट में परिवर्तन किए हैं, तो आप तब तक इंतजार कर सकते हैं जब तक कि इसका प्रशिक्षण पूरा नहीं हो जाता है और सिम्युलेटर में अपरिचित वाक्यांश को तुरंत दोहराते हैं। डायलॉगफ़्लो को एक बैकेंड के रूप में माना जा सकता है जिसके लिए एक सहायक संदर्भित करता है।

  
  

• प्रीबिल्ट एजेंटों का उपयोग करें - वहां आप देख सकते हैं कि एक सामान्य परिदृश्य को कैसे लागू किया जाए।

  
  

• स्माल टॉक सेक्शन से सावधान रहें। इसका उपयोग बातचीत के अंत में माइक्रोफ़ोन को बंद नहीं करता है, और ऐसे उत्तरों में आमतौर पर कॉल-टू-एक्शन नहीं होता है। आप उपयोगकर्ता को संवाद के अगले दौर में निर्देशित नहीं करते हैं, और यह उसके लिए पूरी तरह से स्पष्ट नहीं है कि आगे क्या कहा जाना चाहिए। उच्च संभावना के साथ, इस वजह से, आप समीक्षा पास नहीं कर सकते हैं। यदि आप उन्हें संवाद में दर्ज कर सकते हैं, तो इसके लिए अलग-अलग उद्देश्य बनाना बेहतर है।

  
  

• एक ही समय में एक ही इरादे को एक साथ संपादित न करें। अब एक साथ कई लोगों के काम का समर्थन नहीं किया जाता है - यह ज्ञात नहीं है कि किसके परिवर्तन ओवरराइट किए जाएंगे।

  
  

• यदि इरादे के साथ काम को समानांतर करना आवश्यक है, तो इसे अलग-अलग परियोजनाओं में किया जा सकता है, और फिर बस आवश्यक लोगों का चयन करें और उन्हें स्थानांतरित करें। इसके अलावा json / xml में आयात और निर्यात इकाइयाँ और इरादे के लिए आयात / निर्यात।

  
  

• तुरंत यह विचार करने के लायक है कि आप किसी विशेष भाषा के लिए कार्रवाई लिखते हैं। रूसी में उत्तर लिखने से अतिरिक्त बारीकियां होती हैं। इसलिए कार्रवाई को स्थानीय करना मोबाइल एप्लिकेशन GUI की तुलना में अधिक चुनौतीपूर्ण लगता है।

  
  

• वॉयस इंटरफेस के डिजाइन नियमों पर विचार करें - वे न केवल प्रतिकृतियों के सेट को प्रभावित करते हैं, बल्कि एक पूरे के रूप में संरचना को भी प्रभावित करते हैं। आप एक संवाद का निर्माण कर रहे हैं, इसलिए प्रत्येक उत्तर को कार्रवाई करने के लिए कॉल छोड़ देना चाहिए ताकि उपयोगकर्ता समझता है कि क्या कहना है।

  
  

• सब कुछ तैयार होने के बाद, और आप परीक्षण करना शुरू करते हैं, संवाद या प्रश्न रूपों की अलग-अलग शाखाओं को छोड़ने से डरो मत। शायद परीक्षण के स्तर पर आप समझेंगे कि इंटेंट को कैसे जोड़ा जाए और उपयोग में आसानी के लिए क्या गायब है।

  
  

सर्वर कनेक्शन

सर्वर से जुड़ने के लिए आपको पूर्ति का उपयोग करना होगा। इसके लिए दो विकल्प हैं:

• Webhook ग्राहक । कई भाषाओं ने समर्थन किया।
• फायरबेस (नोड.जेएस) के लिए क्लाउड फ़ंक्शंस पर इनलाइन संपादक ।

आइए सबसे सरल एक पर विचार करें - इनलाइन संपादक।

हम नोड.जेएस में विशेषज्ञ होने का दिखावा नहीं करते हैं, टिप्पणियों में त्रुटियों को ठीक करना स्वागत योग्य है।

डायलॉगफ़्लो एपीआई के संस्करण पर ध्यान देना महत्वपूर्ण है।
नवीनतम संस्करण v2। संस्करण v1 के लिए लिखा गया सब कुछ इसके साथ काम नहीं करता है।
माइग्रेशन के बारे में और अधिक पढ़ें।

उपयोगी लिंक:

• संवाद और पूर्ति के साथ काम करने के लिए प्रलेखन और पुस्तकालय स्रोत कोड
• डायलॉगफ़्लो पूर्ति के साथ शुरुआत करना
• उदाहरण
• लॉग को यहां देखा जा सकता है: डिप्लॉय बटन के बगल में फायरबेस कंसोल पर जाएं

मानक टेम्पलेट को पार्स करें

 'use strict'; const functions = require('firebase-functions'); const {WebhookClient} = require('dialogflow-fulfillment'); const {Card, Suggestion} = require('dialogflow-fulfillment'); process.env.DEBUG = 'dialogflow:debug'; // enables lib debugging statements exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => { const agent = new WebhookClient({ request, response }); console.log('Dialogflow Request headers: ' + JSON.stringify(request.headers)); console.log('Dialogflow Request body: ' + JSON.stringify(request.body)); function welcome(agent) { agent.add(`Welcome to my agent!`); } function fallback(agent) { agent.add(`I didn't understand`); agent.add(`I'm sorry, can you try again?`); } // // Uncomment and edit to make your own intent handler // // uncomment `intentMap.set('your intent name here', yourFunctionHandler);` // // below to get this function to be run when a Dialogflow intent is matched // function yourFunctionHandler(agent) { // agent.add(`This message is from Dialogflow's Cloud Functions for Firebase editor!`); // agent.add(new Card({ // title: `Title: this is a card title`, // imageUrl: 'https://developers.google.com/actions/images/badges/XPM_BADGING_GoogleAssistant_VER.png', // text: `This is the body text of a card. You can even use line\n breaks and emoji! `, // buttonText: 'This is a button', // buttonUrl: 'https://assistant.google.com/' // }) // ); // agent.add(new Suggestion(`Quick Reply`)); // agent.add(new Suggestion(`Suggestion`)); // agent.setContext({ name: 'weather', lifespan: 2, parameters: { city: 'Rome' }}); // } // // Uncomment and edit to make your own Google Assistant intent handler // // uncomment `intentMap.set('your intent name here', googleAssistantHandler);` // // below to get this function to be run when a Dialogflow intent is matched // function googleAssistantHandler(agent) { // let conv = agent.conv(); // Get Actions on Google library conv instance // conv.ask('Hello from the Actions on Google client library!') // Use Actions on Google library // agent.add(conv); // Add Actions on Google library responses to your agent's response // } // // See https://github.com/dialogflow/dialogflow-fulfillment-nodejs/tree/master/samples/actions-on-google // // for a complete Dialogflow fulfillment library Actions on Google client library v2 integration sample // Run the proper function handler based on the matched Dialogflow intent name let intentMap = new Map(); intentMap.set('Default Welcome Intent', welcome); intentMap.set('Default Fallback Intent', fallback); // intentMap.set('your intent name here', yourFunctionHandler); // intentMap.set('your intent name here', googleAssistantHandler); agent.handleRequest(intentMap); }); 

 { "name": "dialogflowFirebaseFulfillment", "description": "This is the default fulfillment for a Dialogflow agents using Cloud Functions for Firebase", "version": "0.0.1", "private": true, "license": "Apache Version 2.0", "author": "Google Inc.", "engines": { "node": "~6.0" }, "scripts": { "start": "firebase serve --only functions:dialogflowFirebaseFulfillment", "deploy": "firebase deploy --only functions:dialogflowFirebaseFulfillment" }, "dependencies": { "actions-on-google": "2.0.0-alpha.4", "firebase-admin": "^4.2.1", "firebase-functions": "^0.5.7", "dialogflow": "^0.1.0", "dialogflow-fulfillment": "0.3.0-beta.3" } } 

सबसे पहले, नवीनतम स्थिर वाले अल्फा और बीटा निर्भरता को अपडेट करें।

 { "dependencies": { "actions-on-google": "^2.2.0", "firebase-admin": "^5.2.1", "firebase-functions": "^0.6.2", "dialogflow": "^0.6.0", "dialogflow-fulfillment": "^0.5.0" } } 

और अब कोड पर करीब से नज़र डालते हैं।

 // Cloud Functions  Firebase library const functions = require('firebase-functions'); //       const {WebhookClient} = require('dialogflow-fulfillment'); //       const {Card, Suggestion} = require('dialogflow-fulfillment'); 

 exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => { console.log('Dialogflow Request headers: ' + JSON.stringify(request.headers)); console.log('Dialogflow Request body: ' + JSON.stringify(request.body)); //   . const agent = new WebhookClient({ request, response }); //   let result = request.body.queryResult; //  action  entities https://dialogflow.com/docs/actions-and-parameters let action = result.action; let parameters = result.parameters; //    https://dialogflow.com/docs/contexts let outputContexts = result.outputContexts; //       let intentRequest = request.body.originalDetectIntentRequest; }); 

यह कॉलबैक उन इरादों के लिए कहा जाएगा, जिनके लिए आप फुलफिलमेंट को सक्रिय करते हैं।

 exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => { const agent = new WebhookClient({ request, response }); function welcome(agent) { //   agent.add(`Welcome to my agent!`); } function fallback(agent) { agent.add(`I didn't understand`); agent.add(`I'm sorry, can you try again?`); } //   ,  : // key -   intent-. // value -   ,   . let intentMap = new Map(); intentMap.set('Default Welcome Intent', welcome); intentMap.set('Default Fallback Intent', fallback); agent.handleRequest(intentMap); }); 

इसी समय, कोड पूरी तरह से प्रतिक्रिया अनुभाग से इरादे की प्रतिक्रिया को बदल देता है।
कॉलबैक विफल होने पर ही प्रतिक्रियाएं कॉल की जाएंगी, इसलिए आप वहां से निपटने में त्रुटि कर सकते हैं।

हम कॉलबैक से इरादे प्रसंस्करण कार्यों को हटा देते हैं।
स्वागत और वापसी कार्य बंद होने की स्थिति में हैं ।

 exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => { const agent = new WebhookClient({ request, response }); let intentMap = new Map(); //  set  Map.      intentMap .set('Default Welcome Intent', welcome.bind(this, agent)) .set('Default Fallback Intent', fallback.bind(this, agent)); agent.handleRequest(intentMap); }); function welcome(agent) { agent.add(`Welcome to my agent!`); } function fallback(agent) { //   2   add    agent.add([ `I didn't understand`, `I'm sorry, can you try again?` ]); } 

, , Google Assistant. , .