Google Assistant के लिए कस्टम क्रियाएँ बनाएँ: 12 कदम

2024 लेखक: John Day | [email protected]. अंतिम बार संशोधित: 2024-01-30 09:20

Google सहायक की क्षमता को देखकर, जैसा कि Google I/O 18 के साथ-साथ वोल्वो कारों में उनके इंफोटेनमेंट सिस्टम में प्रस्तुत किया गया था, मैं इसे आज़माने से नहीं रोक सका। मैंने अपनी पुरानी परियोजनाओं में से एक, वास्तुपी का पुन: उपयोग किया और इसे Google सहायक के साथ इंटरफेस किया। यदि आप परियोजना के बारे में अधिक पढ़ना चाहते हैं, तो मुझे खुशी होगी यदि आप मेरे ब्लॉग पर संबंधित लेख पर एक नज़र डालें: Google सहायक के लिए कस्टम क्रियाएँ।

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

IFTTT जैसी सेवाओं का उपयोग करने पर ऐसा कुछ बनाने का एक मुख्य लाभ यह है कि आप अपने सर्वर में कस्टम प्रतिक्रियाएँ बना सकते हैं जिन्हें Google सहायक द्वारा पढ़ा जाएगा। जहां तक मेरा संबंध है, आईएफटीटीटी में संचार एकतरफा है।

निम्नलिखित विषयों को कवर किया जाएगा:

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

यहां आपको विभिन्न Google सहायक कार्यों और अवधारणाओं के बारे में कई विवरण या सिद्धांत नहीं मिलेंगे। यदि आप उनमें रुचि रखते हैं, तो मैं दृढ़ता से सुझाव देता हूं कि आप आधिकारिक ट्यूटोरियल का अनुसरण करें या इस वीडियो को देखें।

चरण 1: अपनी Google खाता अनुमतियां सेट करें

शुरू करने से पहले हमें यह सुनिश्चित करना होगा कि Google सहायक के पास उचित अनुमतियां हों।

1. गतिविधि नियंत्रण पर जाएं

2. सुनिश्चित करें कि निम्नलिखित सक्षम हैं:

   1. वेब और ऐप गतिविधि
   2. डिवाइस जानकारी
   3. आवाज और ऑडियो गतिविधि

चरण 2: अपनी कार्रवाई बनाएं

1. क्रियाएँ कंसोल पर जाएँ और "प्रोजेक्ट जोड़ें/आयात करें" पर क्लिक करें
2. आइए इस क्रिया परियोजना को "स्थानीय-यातायात-योजनाकार" कहते हैं।
3. "प्रोजेक्ट बनाएं" पर क्लिक करें।
4. अगले पृष्ठ पर, कोई श्रेणी न चुनें और "छोड़ें" पर क्लिक करें।
5. अब आपको मुख्य Actions कंसोल पेज में होना चाहिए।

चरण 3: कार्रवाई आमंत्रण

निर्धारित करें कि आप अपनी कार्रवाई शुरू करने के लिए Google सहायक को कैसे ट्रिगर करना चाहते हैं।

1. "त्वरित सेटअप" के तहत "तय करें कि आपकी कार्रवाई कैसे लागू की जाती है" पर क्लिक करें।
2. इसे "मेरा स्थानीय यातायात योजनाकार" कहें और "सहेजें" पर क्लिक करें।

3. "अपडेट सैंपल इनवोकेशन्स" प्रॉम्प्ट पर क्लिक करें जो सेव पर क्लिक करने के बाद पॉप अप होता है।

   आप इस विकल्प को "निर्देशिका सूचना" के अंतर्गत भी पा सकते हैं।

4. एक नए आह्वान के रूप में "आस्क माई लोकल ट्रैफिक प्लानर" जोड़ें और "सेव" पर क्लिक करें।

चरण 4: अपनी पहली क्रिया जोड़ें

1. बाएं हाथ के बार पर "क्रियाएँ" पर क्लिक करें।
2. "अपनी पहली कार्रवाई जोड़ें" पर क्लिक करें।
3. "कस्टम इंटेंट" चुनें और फिर "बिल्ड" पर क्लिक करें।
4. आपको डायलॉगफ्लो पेज पर ले जाया जाएगा, जहां आप मुख्य तर्क को लागू करेंगे।

चरण 5: आपके इरादे के लिए प्रशिक्षण वाक्यांश

1. अपना समय क्षेत्र चुनें और "बनाएँ" पर क्लिक करें।
2. अगले पेज पर, मौजूदा इंटेंट को छोड़ दें और "क्रिएट इंटेंट" पर क्लिक करें।
3. आशय को एक उचित नाम दें, अर्थात "प्रस्थान"।
4. "प्रशिक्षण वाक्यांश" पर जाएं और "प्रशिक्षण वाक्यांश जोड़ें" पर क्लिक करें।

5. अपने मॉडल को प्रशिक्षित करने के लिए निम्नलिखित वाक्यांशों का उपयोग करें ताकि यह व्याख्या कर सके कि आप इसे क्या कह रहे हैं:

   1. मैं अभी घर पर हूँ
   2. फिलहाल मैं घर पर हूं
   3. मैं इस समय हमारे अपार्टमेंट में हूँ
   4. मैं घर पर बैठा हूँ
   5. वर्तमान में मैं काम के करीब हूँ
   6. मैं काम पर हूँ
   7. मैं दफ़्तर में हूं
   8. काम
   9. घर

चरण 6: संस्थाएं

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

1. यदि आप प्रशिक्षण वाक्यांशों के एक या अधिक शब्दों पर डबल क्लिक करते हैं, तो आपको पूर्वनिर्धारित संस्थाओं की एक सूची मिलेगी। आप उनमें से प्रत्येक के बारे में यहाँ अधिक पढ़ सकते हैं। कुल मिलाकर, सबसे उपयुक्त एक @sys.location होगा, हालांकि मुझे लगता है कि यह सबसे अच्छा और आसान है यदि हम अपनी खुद की इकाई बनाते हैं जिसे हमें @current-location कहना चाहिए।
2. बाईं ओर "इकाई" विकल्प पर क्लिक करें।
3. "इकाई बनाएं" पर क्लिक करें।

4. नाम को "वर्तमान-स्थान" पर सेट करें और दो संदर्भ मानों को उनके समानार्थक शब्द के साथ परिभाषित करें:

   1. घर

      घर, घर, अपार्टमेंट, पालना

   2. काम

      काम, कार्यालय, Aptiv, कोड माइंस (बस मजाक कर रहे हैं)

5. "सहेजें" पर क्लिक करें। अतिरिक्त प्रभाव के लिए आप "स्वचालित विस्तार की अनुमति दें" पर भी क्लिक कर सकते हैं ताकि Google सहायक को अपने संदर्भ मूल्यों के साथ अधिक समानार्थक शब्द का प्रयास करने और मिलान करने की स्वतंत्रता मिल सके।

चरण 7: क्रिया और पैरामीटर

अपने प्रशिक्षण वाक्यांशों के अंदर खोजशब्दों को कुछ अर्थ देने का समय।

1. "इरादे" पर क्लिक करें और फिर अपने कस्टम इरादे पर नेविगेट करें, यानी "प्रस्थान" यदि आप मेरे नाम सुझावों का पालन कर रहे हैं।
2. "प्रशिक्षण वाक्यांश" तक नीचे स्क्रॉल करें।
3. उन शब्दों पर डबल क्लिक करें जो आपके वर्तमान स्थान को इंगित करते हैं और पॉप अप विंडो से @current-location टैग चुनें।
4. "कार्रवाइयां और पैरामीटर" तक नीचे स्क्रॉल करें, "प्रबंधित करें" पर क्लिक करें
5. यदि सब कुछ सही ढंग से किया गया था, तो आप अपनी नई इकाई को वहां सूचीबद्ध होते हुए देखेंगे।
6. "आवश्यक" बॉक्स को चेक करें जो एक नया कॉलम बनाता है, "संकेत", प्रकट होता है। संकेत वह है जो उपयोगकर्ता सुनेगा यदि अपेक्षा से मेल खाने वाला कुछ भी आपूर्ति नहीं की गई है।
7. "डिफाइन प्रॉम्प्ट्स" पर क्लिक करें और कुछ ऐसा डालें जैसे "मुझे आपकी लोकेशन समझ में नहीं आई। इस समय आप कहां हैं?"।

चरण 8: पूर्ति

अब आपकी वेब सेवा को Google Assistant Action से जोड़ने का समय आ गया है। आपके हुक को तब बुलाया जाएगा जब इस विशिष्ट आशय को ट्रिगर किया जाएगा और इस क्रिया की पूर्ति का उत्पादन करना चाहिए। उससे पहले हम भी पूरा होने के बाद कार्रवाई समाप्त करने के लिए अपना इरादा निर्धारित करना चाहते हैं।

1. "प्रतिक्रियाएं" पर जाएं और "प्रतिक्रिया जोड़ें" पर क्लिक करें।
2. कोई प्रतिक्रिया न जोड़ें, बस "इस आशय को बातचीत के अंत के रूप में सेट करें" सक्षम करें।
3. "पूर्ति" के लिए नीचे स्क्रॉल करें "पूर्णता सक्षम करें" पर क्लिक करें और फिर "इस आशय के लिए वेबहुक कॉल सक्षम करें" चालू करें।
4. "सहेजें" पर क्लिक करें और फिर बाईं ओर "पूर्ति" विकल्प पर जाएं।

5. "वेबहुक" विकल्प को सक्षम करें और वह यूआरएल डालें जो आपके वेबसर्वर द्वारा "सुना" जा रहा है।

   जब भी इरादा ट्रिगर होता है, तो यह आपकी वेबसाइट पर उपयोगकर्ता के वर्तमान स्थान के साथ JSON ऑब्जेक्ट वाले अनुरोध के मुख्य भाग के साथ एक POST अनुरोध भेजेगा।

6. सहेजें क्लिक करें.
7. अब हम अपनी वेब सेवा बनाने के लिए तैयार हैं, लेकिन इससे पहले, आइए सुनिश्चित करें कि हमारा Action उचित तरीके से हमारा स्वागत करता है।

चरण 9: स्वागत आशय

उपयोगकर्ता अनुभव को अनुकूलित करने के लिए, जब भी हम अपनी कार्रवाई को ट्रिगर करते हैं, तो हमें हमारे लिए उपयुक्त ग्रीटिंग बनाना चाहिए।

1. "इरादे" पर जाएं और फिर "डिफ़ॉल्ट स्वागत आशय" पर क्लिक करें।
2. "प्रतिक्रियाओं" के लिए नीचे स्क्रॉल करें, मौजूदा को हटा दें और जो आप चाहते हैं उसे सम्मिलित करें एक बार शुरू होने के बाद आपका स्वागत कैसे किया जाए।
3. "सहेजें" पर क्लिक करें।

चरण 10: आपकी पायथन वेब सेवा

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

1. एक नया टैब खोलें और pythonanywhere.com पर एक खाता बनाएं
2. अपना ई मेल सत्यापित करें।
3. "ओपन वेब टैब" पर क्लिक करके अपना वेब एप्लिकेशन सेट करें।
4. "एक नया वेब ऐप जोड़ें" पर क्लिक करें और अपने पायथन वेब फ्रेमवर्क के रूप में "फ्लास्क" चुनें।
5. पायथन 3.6 का चयन करें और "अगला" पर क्लिक करें।
6. वह पथ चुनें जिसमें आप चाहते हैं कि आपका "flask_app.py" निवास करे। मैंने इसे सीधे अपने होम फ़ोल्डर के अंदर "/home/your-username/flask_app.py" के रूप में रखा है।
7. ऊपरी बाएँ कोने पर Python लोगो पर क्लिक करके मुख्य पृष्ठ पर वापस जाएँ।
8. फ़ाइलों के अंतर्गत, इसे संपादित करना प्रारंभ करने के लिए "flask_app.py" पर क्लिक करें।
9. जब वेब टेक्स्ट एडिटर खुलता है, तो निम्न कोड पेस्ट करें और "सहेजें" पर क्लिक करें। समग्र विचार यह है कि Google सहायक से आने वाले पार्स किए गए JSON के आधार पर हमारा सर्वर एक क्रिया करेगा (उदाहरण के लिए पढ़ना या लिखना) और इसे प्रतिक्रिया के रूप में वापस रिपोर्ट करना होगा। /पूर्ति जिसे उपयोगकर्ता को पढ़ा जाना चाहिए।
10. फिर से "ओपन वेब टैब" पर क्लिक करें और फिर हरे "रीलोड बटन" पर क्लिक करें।
11. अब तक आपके पास अपना खुद का पायथन वेब सर्वर "https://your-username.pythonanywhere.com/departures" पर चल रहा होना चाहिए।

चरण 11: अपनी कार्रवाई का परीक्षण करें

ठीक है, आप अब तक बहुत कुछ कर चुके हैं। आइए अब पूरे स्टैक का परीक्षण करें और इस "हैलो वर्ल्ड" उदाहरण को काम में लाएं!

1. बाईं ओर के बार से "एकीकरण" पर क्लिक करें।
2. Google सहायक विकल्प के तहत "एकीकरण सेटिंग्स" पर क्लिक करें।
3. "अंतर्निहित आमंत्रण के तहत अपने इरादे का नाम जोड़ें, यानी "प्रस्थान" ताकि इसे "हे Google, घर से प्रस्थान के बारे में मेरे स्थानीय यातायात योजनाकार से बात करें" जैसा कुछ कहकर सीधे ट्रिगर किया जा सके।
4. "ऑटो-पूर्वावलोकन" परिवर्तन सक्षम करें।
5. "टेस्ट" पर क्लिक करें जो एक नया पेज खोलेगा।
6. "मेरे स्थानीय यातायात योजनाकार से बात करें" टाइप करें।
7. आपकी कार्रवाई को लागू किया जाना चाहिए जो पहले से निर्धारित स्वागत इरादे प्रतिक्रियाओं में से एक के साथ आपका अभिवादन करना चाहिए।
8. फिर "मैं काम पर हूँ" टाइप करें। आपके पायथन सर्वर से संपर्क किया जाना चाहिए और प्रतिक्रिया Google सहायक द्वारा पढ़ी जाएगी।

कूल है ना? अब कल्पना करें कि आप अपने Google सहायक के माध्यम से सेंसर, एक्चुएटर और अन्य एपीआई के साथ क्या कर सकते हैं।

चरण 12: अपनी कार्रवाई जारी करें

आपके द्वारा अपनी क्रिया का परीक्षण करने के बाद और यह एक अच्छी स्थिति में है, यह दुनिया के साथ प्यार साझा करने का समय है, या अगर इसका कोई मतलब नहीं है, तो अपने दोस्तों और परिवार के साथ।

1. अपने Actions कंसोल पर वापस जाएँ और अपनी स्थानीय ट्रैफ़िक योजनाकार कार्रवाई चुनें।
2. "तैनाती के लिए तैयार हो जाओ" के तहत "क्रिया निर्देशिका में अपनी कार्रवाई सूचीबद्ध करने के लिए आवश्यक जानकारी दर्ज करें" पर क्लिक करें।
3. एक संक्षिप्त विवरण, एक लंबा विवरण, एक छोटा लोगो, आपका संपर्क विवरण, एक गोपनीयता नीति लिंक (यदि आप इसे सार्वजनिक रूप से साझा नहीं करने जा रहे हैं तो बस अपनी वेबसाइट या कुछ और के लिए एक लिंक डालें) और एक श्रेणी दर्ज करें।
4. ऊपर स्क्रॉल करें और "सहेजें" पर क्लिक करें।
5. बाईं ओर के बार से "रिलीज़" विकल्प पर क्लिक करें।
6. यहां आप चुन सकते हैं कि आपकी कार्रवाई किस स्थिति में है। यदि आप "आइए माई लोकल ट्रैफिक प्लानर का परीक्षण संस्करण प्राप्त करें" प्रतिक्रिया नहीं सुनना चाहते हैं, तो आपको एक पूर्ण सार्वजनिक रिलीज बनाना होगा। हालाँकि, इसके लिए Google द्वारा समीक्षा की आवश्यकता है और इस ट्यूटोरियल में शामिल नहीं किया जाएगा। इसके बजाय, आप अभी भी इसे अधिकतम २० लोगों के साथ अल्फ़ा रिलीज़ चुनकर और उन्हें अल्फ़ा परीक्षकों के रूप में जोड़कर साझा कर सकते हैं।
7. किसी भी अल्फा परीक्षक को या तो एक लिंक भेजकर या उनके ईमेल जोड़कर जोड़ें।
8. "सबमिट फॉर अल्फा" पर क्लिक करें, बॉक्स पर टिक करें, "सबमिट" पर क्लिक करें और आपका काम हो गया!

अब आपका एक्शन लाइव है और इसे आप और आपके दोस्त एक्सेस कर सकते हैं। मज़े करो!

यदि आप मेरे द्वारा उपयोग किए गए कोड में रुचि रखते हैं, तो GitHub पर प्रोजेक्ट देखें।