Actions SDK टूल और बिल्डर के बारे में आसानी से बताने/सिखाने वाली गाइड

इस गाइड में, Actions SDK टूल और Actions बिल्डर, दोनों का इस्तेमाल करके कार्रवाइयां बनाने का तरीका बताया गया है. आपको ये काम करने होंगे:

  • Node.js इंस्टॉल करें: हमारी Node.js फ़ुलफ़िलमेंट लाइब्रेरी का इस्तेमाल करने के लिए, आपको इस रनटाइम एनवायरमेंट की ज़रूरत होगी.
  • Firebase सीएलआई इंस्टॉल करें: इस कमांड-लाइन टूल की मदद से, Firebase डिपेंडेंसी को डेवलप और डिप्लॉय किया जा सकता है. जैसे, इंटरैक्टिव कैनवस के वेब ऐप्लिकेशन और Firebase होस्टिंग.
  • gactions कमांड-लाइन टूल इंस्टॉल करें: Actions SDK टूल के साथ डेवलप करते समय, इस टूल का इस्तेमाल अपनी सेट की गई कार्रवाई के लिए कार्रवाई पैकेज बनाने, उसे मैनेज, और डिप्लॉय करने के लिए किया जाता है.
  • ऐक्शन प्रोजेक्ट बनाएं: ऐक्शन प्रोजेक्ट, आपकी Conversational Actions के लिए लॉजिकल कंटेनर होता है. आपको प्रॉपर्टी बनाना शुरू करने से पहले, ऐक्शन कंसोल में एक नई प्रॉपर्टी बनानी होगी.
  • सैंपल को शुरू करें और डिप्लॉय करें: इस आसान सैंपल में, इंटरैक्टिव कैनवस की मदद से ऐक्शन बनाने का तरीका बताया गया है.

इस क्विक स्टार्ट को पूरा करने के बाद, अपने ऐक्शन प्रोजेक्ट को अपने लोकल डेवलपमेंट एनवायरमेंट और Actions Builder के वेब अनुभव के बीच सिंक किया जा सकता है.

Node.js और Firebase सीएलआई को इंस्टॉल करें

हमारी फ़ुलफ़िलमेंट लाइब्रेरी का इस्तेमाल करने के लिए, Node.js दस्तावेज़ के मुताबिक Node.js को डाउनलोड और इंस्टॉल करें. Node.js को इंस्टॉल करने से, आपको npm के साथ Firebase सीएलआई इंस्टॉल करने की अनुमति मिल जाती है. इसके बाद, स्थानीय तौर पर, बातचीत के तरीके को पूरा करने की सुविधा को लागू किया जा सकता है.

Firebase दस्तावेज़ के मुताबिक Firebase सीएलआई को इंस्टॉल और सेट अप करें. Firebase सीएलआई की मदद से, आपको Firebase होस्टिंग के लिए इंटरैक्टिव कैनवस वेब ऐप्लिकेशन डिप्लॉय करने की सुविधा मिलती है. साथ ही, ज़रूरत पड़ने पर, Firebase के लिए Cloud Functions पर, मैन्युअल तरीके से डिप्लॉय करें.

gactions कमांड-लाइन टूल इंस्टॉल करें

gaction कमांड लाइन इंटरफ़ेस (सीएलआई) टूल को डाउनलोड करने के लिए डाउनलोड करें. इंस्टॉल करने के बाद उसे अनपैक करें और अपने एक्ज़ीक्यूशन पाथ को कॉन्फ़िगर करें.

गड़बड़ियों को इंस्टॉल और कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

  1. अपने ऑपरेटिंग सिस्टम के लिए, सही पैकेज डाउनलोड करें:

    प्लैटफ़ॉर्म पैकेज चेकसम
    Windows डाउनलोड करें SHA256
    Linux डाउनलोड करें SHA256
    Mac OS डाउनलोड करें SHA256

  2. पैकेज को अपनी पसंद की जगह पर एक्सट्रैक्ट करें. साथ ही, बाइनरी को अपने एनवायरमेंट के PATH वैरिएबल में जोड़ें. इसके अलावा, पैकेज को उस जगह पर निकालें जो पहले से आपके PATH वैरिएबल में मौजूद है (उदाहरण के लिए, /usr/local/bin).

  3. अगर ज़रूरी हो, तो Linux और Mac पर, एक्ज़ीक्यूट करने की अनुमतियां चालू करें:

    chmod +x PATH_TO/gactions

  4. सीएलआई की पुष्टि करने के लिए, नीचे दिया गया कमांड चलाएं. इस निर्देश से पुष्टि करने की प्रक्रिया शुरू होती है और इसके लिए वेब ब्राउज़र की ज़रूरत होती है:

    gactions login

    फ़्लो पूरा होने पर, सीएलआई अपने-आप पुष्टि करता है.

प्रोजेक्ट बनाना और उसे सेट अप करना

gactions कमांड-लाइन टूल का इस्तेमाल करने से पहले, आपको Actions कंसोल में एक प्रोजेक्ट बनाना होगा और प्रोजेक्ट को gactions को ऐक्सेस देना होगा. प्रोजेक्ट बनाने और सेट अप करने के लिए, ये काम करें:

  1. Actions कंसोल पर जाएं.
  2. नया प्रोजेक्ट पर क्लिक करें. इसके बाद, प्रोजेक्ट का नाम डालें और प्रोजेक्ट बनाएं पर क्लिक करें.
  3. कोई कैटगरी चुनें और आगे बढ़ें पर क्लिक करें.
  4. खाली प्रोजेक्ट चुनें और बिल्डिंग शुरू करें पर क्लिक करें.
  5. एपीआई को चालू और बंद करें में दिए गए निर्देशों का पालन करके, Google Cloud कंसोल में Actions API चालू करें. इससे, गंगों को आपके प्रोजेक्ट से इंटरैक्ट करने की अनुमति मिलती है.

hello वर्ल्ड सैंपल पाएं

hello वर्ल्ड इंटरैक्टिव सैंपल में आपको इंटरैक्टिव कैनवस से चलने वाली एक Action की मदद से, आसान Actions प्रोजेक्ट बनाने का तरीका बताया गया है.

  1. एक खाली डायरेक्ट्री बनाएं और उस डायरेक्ट्री में इंटरैक्टिव कैनवस सैंपल शुरू करें. उदाहरण के लिए, यह कोड interactive-canvas-sample/ डायरेक्ट्री में सैंपल को शुरू करता है, जिसका इस्तेमाल इस दस्तावेज़ में उदाहरण के तौर पर किया जाता है:

    gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample

  2. interactive-canvas-sample/sdk/settings/settings.yaml फ़ाइल खोलें और projectId फ़ील्ड की वैल्यू को अपने प्रोजेक्ट आईडी में बदलें.

सैंपल को डिप्लॉय करें और उसकी जांच करें

सैंपल सेट अप करने के बाद, इंटरैक्टिव कैनवस वेब ऐप्लिकेशन और ऐक्शन प्रोजेक्ट को डिप्लॉय किया जा सकता है. यह प्रोसेस आपके ऐक्शन प्रोजेक्ट का एक ड्राफ़्ट वर्शन बनाती है. इसे ऐक्शन सिम्युलेटर पर डिप्लॉय किया जा सकता है, ताकि इसकी झलक देखी जा सके और जांच की जा सके:

  1. इंटरैक्टिव कैनवस वेब ऐप्लिकेशन (public/ डायरेक्ट्री का कॉन्टेंट) को डिप्लॉय करने के लिए, interactive-canvas-sample/ डायरेक्ट्री में जाकर ये कमांड चलाएं.

    firebase deploy --project PROJECT_ID --only hosting

    वेब ऐप्लिकेशन का रेंडर किया गया वर्शन, यूआरएल पर देखा जा सकता है. इसे ब्राउज़र में Firebase सीएलआई से दिखाया जाता है: https://PROJECT_ID.web.app.

  2. interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js फ़ाइल खोलें और CANVAS_URL वैरिएबल की वैल्यू को अपने प्रोजेक्ट के वेब ऐप्लिकेशन यूआरएल में बदलें.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';

  3. अपने Actions प्रोजेक्ट के लोकल वर्शन को कंसोल में, ड्राफ़्ट वर्शन के तौर पर पुश करने के लिए, interactive-canvas-sample/sdk/ डायरेक्ट्री से यह निर्देश चलाएं:

    gactions push

  4. अपने Actions प्रोजेक्ट को सिम्युलेटर में टेस्ट करने के लिए, interactive-canvas-sample/sdk/ डायरेक्ट्री से, नीचे दिया गया निर्देश चलाएं:

    gactions deploy preview

  5. सिम्युलेटर पर जाने के लिए, कमांड-लाइन टूल वाला लिंक खोलें.

  6. सिम्युलेटर में, कार्रवाई शुरू करने के लिए "इंटरैक्टिव कैनवस सैंपल से बात करें" डालें. आपको https://PROJECT_ID.web.app पर डिप्लॉय किया गया, वेब ऐप्लिकेशन से चलने वाला एक स्पिनिंग ट्राईऐंगल दिखेगा

    पहली इमेज. ऐक्शन प्रोजेक्ट की झलक दिखाने वाला सिम्युलेटर