Actions SDK टूल के बारे में खास जानकारी (Dialogflow)

Actions on Google सुविधा की मदद से, Google Assistant की सुविधाओं को कार्रवाई के साथ बेहतर बनाया जा सकता है. कार्रवाइयों से उपयोगकर्ताओं को बातचीत वाले इंटरफ़ेस के ज़रिए काम पूरे करने में मदद मिलती है. इन कार्रवाइयों में फटाफट निर्देश देने से लेकर, कुछ लाइटों को चालू करने या ट्रिविया गेम खेलने जैसी कार्रवाइयां शामिल हैं.

Actions SDK, Dialogflow का इस्तेमाल किए बिना बातचीत पूरी करने का एक तरीका है. Actions SDK टूल का इस्तेमाल करते समय, इंटेंट को उनके फ़ुल ऐक्शन में मैप करने के लिए, ऐक्शन पैकेज का इस्तेमाल किया जाता है. आपको कार्रवाई के पैकेज में क्वेरी के पैटर्न भी देने होंगे, ताकि यह तय किया जा सके कि आपके उपयोगकर्ता क्या कह सकते हैं.

इंटरैक्शन सीएलआई

Actions SDK टूल के साथ डेवलप करते समय, अपने Actions प्रोजेक्ट को टेस्ट करने और अपडेट करने के लिए, gactions कमांड लाइन इंटरफ़ेस (सीएलआई) का इस्तेमाल किया जाता है. gactions सीएलआई से यह तय करने में भी मदद मिलती है कि आपकी बातचीत से जुड़ी कार्रवाई के लिए कौनसा ऐक्शन पैकेज बनाया जाएगा.

अपने ऐक्शन पैकेज में 'कार्रवाइयां' बनाएं

आप ऑर्डर से जुड़ी कार्रवाइयों को पूरा करने के लिए, ऐक्शन पैकेज में 'कार्रवाइयां' बनाते हैं. एक कार्रवाई किसी खास पहचानकर्ता से बातचीत शुरू करने के लिए एक एंट्री पॉइंट के बारे में बताती है, जिसे इंटेंट कहा जाता है. इंटेंट को पूरा करने वाला मैप. यह इंटेंट को प्रोसेस करता है.

उदाहरण के लिए, मान लें कि आपको एक ऐसा प्रोजेक्ट बनाना था जिसमें कुछ सामान खरीदने, ऑर्डर की स्थिति देखने, और रोज़ाना की कुछ डील दिखाने के लिए Actions शामिल था. आप ये इंटेंट ट्रिगर करने वाले इंटेंट तय कर सकते हैं:

  • "Ok Google, ExampleAction से बात करो."
  • "Ok Google, कुछ जूते खरीदने के लिए ExampleAction से बात करो."
  • "Ok Google, अपने ऑर्डर की जांच करने के लिए, ExampleAction से बात करें."
  • "Ok Google, आज की डील दिखाने के लिए, ExampleAction से बात करें."

ऐक्शन पैकेज JSON फ़ाइल कुछ इस तरह दिख सकती है:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [{
          "name": "color",
          "type": "org.schema.type.Color"
        }],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

वेबहुक बनाएं और उसे डिप्लॉय करें

जब आपके प्रोजेक्ट में कोई कार्रवाई शुरू की जाती है, तो Google पर कार्रवाइयां, उपयोगकर्ताओं को कार्रवाई पूरी करने के लिए बातचीत शुरू करने के लिए आपकी कार्रवाई को कॉल करती हैं.

वेबहुक के लिए आपके हर अनुरोध में, आपको टेक्स्ट स्ट्रिंग के तौर पर उपयोगकर्ता का इनपुट मिलेगा. इंटेंट को प्रोसेस करने के लिए, आम तौर पर टेक्स्ट इनपुट को पार्स किया जाता है और जवाब दिया जाता है. इस तरह की बातचीत तब तक होती रहती है, जब तक कि आपकी Action की बातचीत खत्म नहीं हो जाती.

अपने ऐक्शन पैकेज को अपलोड करें

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

जब आपके पास कोई प्रोजेक्ट हो जाए, तो आप अपने ऐक्शन पैकेज को अपलोड कर सकते हैं. यह पैकेज gactions सीएलआई का इस्तेमाल करके, आपकी सभी कार्रवाइयों की जानकारी देता है.

अनुमति के लिए अपना प्रोजेक्ट सबमिट करना और उसे उपयोगकर्ताओं के लिए उपलब्ध कराना

सैंपल

पूरे हो चुके प्रोजेक्ट को एक्सप्लोर करने के लिए, Node.js और Java Actions SDK टूल के नमूने देखें.