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

पहले भाग में, हमने Google सहायक के लिए अनुप्रयोगों के डिजाइन और विकास के बुनियादी सिद्धांतों का पता लगाया। अब अपने स्वयं के सहायक लिखने का समय है ताकि उपयोगकर्ता शाम के लिए एक फिल्म चुन सकें। Shipa_o , raenardev और ComradeGuest डिज़ाइनर से बात करना जारी है।

अपना कोड लिखें

आइए कुछ और अधिक जटिल लिखने की कोशिश करें।
मान लीजिए कि हमारा एजेंट शैली द्वारा फिल्मों की सिफारिश करता है।
हम उसे "हॉरर दिखाने" के लिए कहते हैं, और एजेंट शैली को पार्स करेगा, शैली द्वारा संग्रह में एक फिल्म की तलाश करेगा और इसे स्क्रीन पर प्रदर्शित करेगा।

var json = { "filmsList": [ { "id": "1", "title": " :  ", "description": "   ", "genres": ["", "", ""], "imageUrl": "http://t3.gstatic.com/images?q=tbn:ANd9GcQEA5a7K9k9ajHIu4Z5AqZr7Y8P7Fgvd4txmQpDrlQY2047coRk", "trailer": "https://www.youtube.com/watch?v=RNksw9VU2BQ" }, { "id": "2", "title": " :  2 –  ", "description": "   ", "genres": ["", "", "", ""], "imageUrl": "http://t3.gstatic.com/images?q=tbn:ANd9GcTPPAiysdP0Sra8XcIhska4MOq86IaDS_MnEmm6H7vQCaSRwahQ", "trailer": "https://www.youtube.com/watch?v=vX_2QRHEl34" }, { "id": "3", "title": "", "description": "  ", "genres": ["", "", ""], "imageUrl": "https://www.kinopoisk.ru/images/film_big/386.jpg", "trailer": "https://www.youtube.com/watch?v=xIe98nyo3xI" } ] }; 

 exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => { const agent = new WebhookClient({ request, response }); let result = request.body.queryResult; let parameters = result.parameters; let outputContexts = result.outputContexts; let intentMap = new Map(); //    agent  parameters,       intentMap.set('search-by-genre', searchByGenre.bind(this, agent, parameters)); agent.handleRequest(intentMap); }); function searchByGenre(agent, parameters) { let filmsList = json.filmsList; //     let filteredFilms = filmsList.filter((film) => { // ,             return film.genres.some((genre) => genre == parameters.genre); }); //       let firstFlim = filteredFilms[0]; //    agent.add(firstFlim.title); //       agent.add(new Card({ title: firstFlim.title, imageUrl: firstFlim.imageUrl, text: firstFlim.description, buttonText: ' ', buttonUrl: firstFlim.trailer })); //      agent.add([ "    ?", new Suggestion("  ?"), new Suggestion(""), new Suggestion("") ]); } 

अब उत्तर अधिक जानकारीपूर्ण हो गया है।
हम पाठ प्रदर्शित करते हैं, सूचना और युक्तियों के साथ एक कार्ड:

डायलॉगफ़्लो की एक अच्छी विशेषता यह है कि यह विभिन्न उपकरणों के लिए अनुकूलित बॉक्स से बाहर है।
यदि डिवाइस में स्पीकर हैं, तो हम सभी वाक्यांशों को जोड़ते हैं, जिन्हें हम जोड़ते हैं, और यदि कोई स्क्रीन नहीं है, तो Card और Suggestion ऑब्जेक्ट केवल प्रदर्शित नहीं होंगे।

हम डेटाबेस कनेक्ट करते हैं

आइए कार्य को जटिल करें और डेटाबेस (DB) से डेटा प्राप्त करें।
सबसे आसान तरीका फायरबेस रियलटाइम डेटाबेस का उपयोग करना है।
उदाहरण के लिए, हम एडमिन डाटाबेस एपीआई का उपयोग करेंगे ।

सबसे पहले आपको एक डेटाबेस बनाने और उसे आबाद करने की आवश्यकता है।
आप इसे उसी प्रोजेक्ट में कर सकते हैं जो क्लाउड फ़ंक्शंस के लिए बनाया गया था:

 //   firebase-admin const firebaseAdmin = require('firebase-admin'); //  firebaseAdmin firebaseAdmin.initializeApp({ credential: firebaseAdmin.credential.applicationDefault(), databaseURL: 'https://<ID->.firebaseio.com' }); //  ,      function getFilmsList() { return firebaseAdmin .database() .ref() .child('filmsList') .once('value') .then(snapshot => { const filmsList = snapshot.val(); console.log('filmsList: ' + JSON.stringify(filmsList)); return filmsList; }) .catch(error => { console.log('getFilmsList error: ' + error); return error; }); } 

डेटाबेस तक पहुँचने के लिए मल्टीथ्रेडिंग की आवश्यकता होती है। फायरबेस डेटाबेस एपीआई को प्रॉमिस का उपयोग करने के लिए डिज़ाइन किया गया है। .once('value') पद्धति हमें एक वादा देता है। तब हम अपने डेटा को then() ब्लॉक में प्राप्त करते हैं और फ़ंक्शन निष्पादन के परिणाम के रूप में उनके साथ वादा करते हैं।
इस प्रॉमिस को handleRequest() विधि से वापस करना महत्वपूर्ण है, अन्यथा एजेंट प्रतिक्रिया के लिए प्रतीक्षा किए बिना और परिणाम को संसाधित करने के बिना हमारे कॉलबैक से बाहर निकल जाएगा।

 'use strict'; const functions = require('firebase-functions'); const firebaseAdmin = require('firebase-admin'); const { WebhookClient } = require('dialogflow-fulfillment'); const { Card, Suggestion } = require('dialogflow-fulfillment'); firebaseAdmin.initializeApp({ credential: firebaseAdmin.credential.applicationDefault(), databaseURL: 'https://<ID->.firebaseio.com' }); exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => { const agent = new WebhookClient({ request, response }); let result = request.body.queryResult; let parameters = result.parameters; let outputContexts = result.outputContexts; let intentMap = new Map(); intentMap.set('search-by-genre', searchByGenre.bind(this, agent, parameters)); agent.handleRequest(intentMap); }); function getFilmsList() { return firebaseAdmin .database() .ref() .child('filmsList') .once('value') .then(snapshot => { const filmsList = snapshot.val(); console.log('filmsList: ' + JSON.stringify(filmsList)); return filmsList; }) .catch(error => { console.log('getFilmsList error: ' + error); return error; }); } function searchByGenre(agent, parameters) { return getFilmsList() .then(filmsList => { let filteredFilms = filmsList.filter((film) => { return film.genres.some((genre) => genre == parameters.genre); }); let firstFlim = filteredFilms[0]; agent.add(firstFlim.title); agent.add(new Card({ title: firstFlim.title, imageUrl: firstFlim.imageUrl, text: firstFlim.description, buttonText: ' ', buttonUrl: firstFlim.trailer })); agent.add([ "    ?", new Suggestion("  ?"), new Suggestion(""), new Suggestion("") ]); }) .catch(error => { console.log('getFilmsList error' + error); }); } 

अप्रत्याशितता जोड़ें

हमारा कौशल हर बार एक क्रम में फिल्मों का निर्माण करेगा। वही उत्तर पहले उपयोगकर्ता को परेशान करेंगे, और फिर वह हमारे रोबोट से बात करना बंद कर देगा।

लाइब्रेरी को फेरबदल करने वाले सरणी के साथ इसे ठीक करें ।

निर्भरता को package.json फ़ाइल में जोड़ें:

 "dependencies": { // ... "shuffle-array": "^1.0.1" // ... } 

 //   const shuffle = require('shuffle-array'); function searchByGenre(agent, parameters) { return getFilmsList() .then(filmsList => { let filteredFilms = filmsList.filter((film) => { return film.genres.some((genre) => genre == parameters.genre); }); //    shuffle(filteredFilms); let firstFlim = filteredFilms[0]; agent.add(firstFlim.title); agent.add(new Card({ title: firstFlim.title, imageUrl: firstFlim.imageUrl, text: firstFlim.description, buttonText: ' ', buttonUrl: firstFlim.trailer })); agent.add([ "    ?", new Suggestion("  ?"), new Suggestion(""), new Suggestion("") ]); }) .catch(error => { console.log('getFilmsList error' + error); }); } 

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

संदर्भ के साथ काम करना

हम एजेंट से पूछते हैं:

फैंटेसी दिखाओ

एजेंट हमें फिल्म "लॉर्ड ऑफ द रिंग्स" दिखाता है।
फिर हम पूछते हैं:

वह किस बारे में बात कर रहा है?

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

 //    ,       agent.setContext({ name: 'current-film', lifespan: 5, parameters: { id: firstFlim.id } }); 

 function genreSearchDescription(agent) { //   current-film const context = agent.getContext('current-film'); console.log('context current-film: ' + JSON.stringify(context)); //  id    const currentFilmId = context.parameters.id; //    return getFilmsList() .then(filmsList => { //    id const currentFilm = filmsList.filter(film => film.id === currentFilmId); agent.add(currentFilm[0].description); agent.add([ ' ?', new Suggestion(''), new Suggestion(' ') ]); }) .catch(error => { console.log('getFilmsList error:' + error); }); } 

उसी तरह, हम पहले से प्रदर्शित फिल्मों की सूची को फ़िल्टर कर सकते हैं।

टेलीग्राम एकीकरण

प्रलेखन और उपयोगी लिंक:

• वनस्पति का निर्माण
• कार्यात्मक संदेश

टेलीग्राम के साथ एकीकृत करने के लिए, लगभग कुछ भी आवश्यक नहीं है, लेकिन कई विशेषताएं हैं जिन पर विचार करने की आवश्यकता है।

1) अगर कार्ड या सुझाव प्रदर्शित करने की पूरी तैयारी है, तो टेलीग्राम में भी वे काम करेंगे।
लेकिन एक बग है : त्वरित उत्तरों के लिए, आपको एक शीर्षक निर्दिष्ट करना होगा, अन्यथा टेलीग्राम में "एक आइटम चुनें" प्रदर्शित किया जाएगा।
अभी तक हम फुलफिलमेंट में शीर्षक को इंगित करने की समस्या को हल करने में सफल नहीं हुए हैं।

2) यदि आशय Google सहायक के लिए सुझाव चिप्स का उपयोग करता है

फिर टेलीग्राम के लिए एक ही कार्यक्षमता को दो तरीकों से लागू किया जा सकता है:

त्वरित जवाब

कस्टम पेलोड
यहां आप मुख्य कीबोर्ड का उपयोग करके त्वरित उत्तर लागू कर सकते हैं:

  { "telegram": { "text": "      :", "reply_markup": { "keyboard": [ [ "", "", "", "", "" ] ], "one_time_keyboard": true, "resize_keyboard": true } } } 

और बिल्ट-इन कीबोर्ड:

  { "telegram": { "text": "      :", "reply_markup": { "inline_keyboard": [ [{ "text": "", "callback_data": "" }], [{ "text": "", "callback_data": "" }], [{ "text": "", "callback_data": "" }], [{ "text": "", "callback_data": "" }], [{ "text": "", "callback_data": "" }] ] } } } 

मुख्य कीबोर्ड एक संदेश भेजेगा जो इतिहास में संग्रहीत किया जाएगा, जबकि अंतर्निहित कीबोर्ड नहीं करता है।

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

3) अगर आपको टेलीग्राम और गूगल असिस्टेंट के लिए अलग-अलग तर्क चाहिए, तो आप इसे इस तरह कर सकते हैं:

 let intentRequest = request.body.originalDetectIntentRequest; if(intentRequest.source == 'google'){ let conv = agent.conv(); conv.ask('    ?'); agent.add(conv); } else { agent.add('    ?'); } 

4) एक ऑडियो फ़ाइल भेजना इस प्रकार कार्यान्वित किया जा सकता है:

 { "telegram": { "text": "https://s0.vocaroo.com/media/download_temp/Vocaroo_s0bXjLT1pSXK.mp3" } } 

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

उदाहरण

हम शीघ्र ही कौशल स्रोत कोड प्रकाशित करेंगे। इसके रिलीज होने के तुरंत बाद।

पुनश्च। हैकाथॉन में क्या हुआ।

2 दिन की व्यस्तता थी।
सबसे पहले शैक्षिक व्याख्यान हुए, और दोपहर में हमने अपनी परियोजनाओं को लागू करना शुरू कर दिया।
अगले दिन सक्रिय रूप से परियोजनाओं को संशोधित करना और प्रस्तुतियाँ तैयार करना था।

Google के सभी लोगों ने इस समय हमारी मदद की और सवालों के एक समूह का जवाब दिया जो काम में अनिवार्य रूप से उत्पन्न होते हैं। यह बहुत कुछ सीखने और प्रतिक्रिया छोड़ने का एक शानदार अवसर था जबकि लोहा अभी भी गर्म है।

सभी प्रतिभागियों, Google के आयोजकों और उन विशेषज्ञों का धन्यवाद जिन्होंने व्याख्यान दिया और हैकाथॉन में हमारी मदद की!

वैसे, हमने दूसरा स्थान लिया।

यदि आपके कोई प्रश्न हैं, तो आप लिख सकते हैं:
shipa_o
raenardev
comradeguest

और वॉइस इंटरफेस की चर्चा के लिए समर्पित एक टेलीग्राम चैट भी है:
https://t.me/conversational_interfaces_ru