मैंने यैंडेक्स को कैसे सिखाया। सेक्स के खिलौने के बारे में बात करने के लिए

हम स्प्रिंग बूट के माध्यम से यैंडेक्स.एलिसा और सेक्स की दुकानों को एकीकृत करते हैं।

आवाज सहायकों का विषय गति प्राप्त कर रहा है, और मैंने इस प्रवृत्ति में शामिल होने का फैसला किया, जो अंतरंग वस्तुओं और Yandex.Alisa के सबसे बड़े थोक आपूर्तिकर्ता को एकीकृत करता है।

आइडिया : आपूर्तिकर्ता के पास ऑनलाइन स्टोर के मालिकों के व्यक्तिगत खाते हैं, और एलिस के वॉइस चैनल के माध्यम से आपूर्तिकर्ता से विश्लेषणात्मक डेटा देना आवश्यक है।

एकीकरण में दो भाग शामिल हैं:

• वेब सेवा का एकीकरण और माल के आपूर्तिकर्ता का REST एपीआई।
• Yandex.Alice का एकीकरण और उपयोगकर्ता अनुरोधों को संसाधित करने के लिए एक वेब सेवा।

वेब सेवा का एकीकरण और माल आपूर्तिकर्ता का REST एपीआई

सेवा को यह समझना चाहिए कि उपयोगकर्ता ने आपूर्तिकर्ता के सर्वर से इस डेटा के लिए वास्तव में क्या मांगा और अनुरोध किया है। हमने स्प्रिंग बूट पर एक सेवा लिखने का फैसला किया।

प्रोजेक्ट सेटअप

हम गिट में एक रिपॉजिटरी का निर्माण करते हैं और स्प्रिंग इनिशियलज़ का उपयोग करके हम स्प्रिंग बूट पर परियोजना को तैनात करते हैं (हम निर्भरता में वेब निर्दिष्ट करते हैं)।

सेवा के लिए अनुरोध JSON प्रारूप में आता है। इसमें एक अच्छी तरह से प्रलेखित संरचना है , इसलिए कक्षाएं उत्पन्न करना काफी सरल है:



आसानी से, कीवर्ड अनुरोध में हाइलाइट किए जाते हैं, जैसे कि एक मान्यता प्राप्त पता। वे “entities” ब्लॉक में स्थित हैं:



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

प्रदाता के साथ एकीकरण अपाचे httpclients पुस्तकालय के माध्यम से लागू किया गया था, और XML प्रतिक्रिया jaxb के माध्यम से deserialization।

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

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

ठेस में पूर्ण परीक्षण और आगे के काम के लिए, हमने हरोकू में क्लाउड में एप्लिकेशन को तैनात करने का निर्णय लिया। ऐसा करने के लिए, हरोकू वेबसाइट पर जाएं, पंजीकरण करें, हरोकू क्ली डाउनलोड करें और इसे इंस्टॉल करें। फिर कंसोल खोलें और heroku login दर्ज करें। प्रोजेक्ट cd ~ / myapp के साथ डायरेक्टरी पर जाएं और heroku create निष्पादित करें।

जब आप एप्लिकेशन बनाते हैं, तो Git एक दूरस्थ रिपॉजिटरी बनाता है जिसे हरोकू कहा जाता है, जो आपके स्थानीय Git रिपॉजिटरी से जुड़ा होता है। डिफ़ॉल्ट रूप से, हरोकू आपकी परियोजना के लिए सर्वर पर एक यादृच्छिक नाम उत्पन्न करता है। आप उसे heroku create myapp का उपयोग करके एप्लिकेशन नाम को heroku create myapp बदल सकते हैं।

एप्लिकेशन के लॉन्च की जांच करने के लिए, कमांड निष्पादित करें।

heroku ps:scale web=1

और अगर आपको "/" पथ पर जाने की आवश्यकता है, तो हम heroku open निष्पादित heroku open ।
पहला एकीकरण बिंदु तैयार है।

Yandex.Alice और अनुरोध प्रसंस्करण सेवा का एकीकरण

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



टैब "सेटिंग" पर और आपको फ़ील्ड भरने की आवश्यकता है:

• कौशल नाम - वह नाम जो ऐलिस सूची में प्रदर्शित किया जाएगा। इसके साथ, उपयोगकर्ता कौशल को सक्रिय करने में सक्षम होगा, उदाहरण के लिए, "कौशल लॉन्च करें [कौशल नाम]"।
• सक्रियण नाम - यहाँ आप कौशल तक पहुँचने के लिए विभिन्न विकल्पों को निर्दिष्ट कर सकते हैं। डिफ़ॉल्ट रूप से, सक्रियण नाम का एक विकल्प कौशल नाम है।
• अनुरोध का एक उदाहरण एक वाक्यांश है जिसके द्वारा ऐलिस इस कौशल को सक्रिय करता है। प्रकाशन के बाद निर्देशिका में बटन के रूप में अनुरोध प्रस्तुत किए जाएंगे।
• Webhook URL - आपको हमारी वेब सेवा का URL निर्दिष्ट करना होगा जो उपयोगकर्ता के अनुरोध को संसाधित करेगा।
• Yandex.Cloud - Yandex अपने क्लाउड को एक अनुदान दे सकता है, लेकिन हम सेवा को हेरोकू पर तैनात करेंगे, इसलिए हम इसे टिक नहीं करते हैं।
• आवाज - यहां आप उस आवाज को चुन सकते हैं जो आपका कौशल बोलेंगे। नर और मादा के विभिन्न रूप होते हैं। लेकिन यह विचार करने के लायक है कि उपयोगकर्ता सबसे अधिक संभावना कहेगा: "ऐलिस, कौशल लॉन्च", और यदि ऐलिस पुरुष बैरिटोन के साथ उत्तर देता है, तो यह कुछ हद तक भ्रमित हो सकता है।
• उपयोग किए गए प्लेटफार्मों पर सीमाएं - एक कौशल के साथ काम करते समय एक स्क्रीन की आवश्यकता होती है या नहीं। हमारे मामले में, नहीं, इसलिए एक टिक न लगाएं।
• गोपनीयता - यदि आप कैटलॉग में प्रतिबिंबित कौशल नहीं चाहते हैं तो बॉक्स को चेक करें।
• ब्रांड सत्यापन साइट - कौशल के लिए साइट का पता। वह कौशल जिसके लिए आपने यह फ़ील्ड भरा है, केवल तभी मॉडरेट किया जाएगा जब आपने Yandex.Webmaster में निर्दिष्ट साइट के अधिकारों की पुष्टि की हो।
• श्रेणी - हमारे मामले में, यह "व्यवसाय और वित्त" है।
• विवरण - आपको अपने कौशल की आवश्यकता क्यों है। कौशल विवरण कौशल सूची में प्रदर्शित किया जाएगा और उपयोगकर्ताओं के लिए उपलब्ध होगा।
• मॉडरेटर के लिए नोट्स - शायद सबसे दिलचस्प क्षेत्र। कैटलॉग में जाने के लिए, कौशल को मॉडरेट किया जाना चाहिए, जिसका अर्थ है कि इसे यहां वर्णित कुछ नियमों का पालन करना चाहिए। इस क्षेत्र में आप परीक्षण प्रक्रिया का वर्णन कर सकते हैं। उदाहरण के लिए, प्राधिकरण और एक विशिष्ट उपयोगकर्ता परिदृश्य के माध्यम से कैसे जाना है।
• आयु प्रतिबंध - कौशल के विषय के बावजूद, हम किसी भी आयु वर्ग के लिए उपयुक्त डेटा संचारित करेंगे। इसलिए, टिक न लगाएं।
• चिह्न एक होना चाहिए :)

संवाद सहेजें। कौशल सेटिंग के सभी परिवर्तन "सेव" बटन पर क्लिक करने के बाद ही प्रभावी होते हैं।

हमने एकीकरण को कॉन्फ़िगर किया, सेवा लिखी, अब आप इसका परीक्षण कर सकते हैं।

"परीक्षण" टैब पर जाएं।



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

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



मॉडरेशन के बाद, इस बटन के बजाय पब्लिश बटन दिखाई देगा। प्रकाशन के बाद, कौशल आधिकारिक यैंडेक्स कैटलॉग में दिखाई देगा।

सुविधाएँ और सीमाएँ

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

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