অ্যাকশন হল আপনার অ্যাপের এন্ট্রি পয়েন্ট যা আপনার অ্যাপের জন্য ইনভোকেশন ও ডিসকভারি মডেলকে সংজ্ঞায়িত করে। আপনি অ্যাকশন প্যাকেজ নামে পরিচিত একটি JSON ফাইলে অ্যাকশন ঘোষণা করেন, যা আপনি পরে আপনার ডেভেলপার প্রোজেক্টে আপলোড করেন যখন আপনি অনুমোদনের জন্য আপনার অ্যাকশন প্রোজেক্ট পরীক্ষা করতে বা জমা দিতে চান। অ্যাকশন প্যাকেজ হল একটি JSON ফাইল যা আপনার অ্যাকশন প্রোজেক্টে অ্যাকশনকে সংজ্ঞায়িত করে।
আপনার অ্যাকশন প্যাকেজে অ্যাকশন নির্ধারণ করতে, আপনি একটি ইনটেন্ট তৈরি করেন যা নির্ধারণ করে যে কীভাবে অ্যাকশনটি চালু করা হয় এবং ইনটেন্টটি ট্রিগার করার সময় সংশ্লিষ্ট ফুলফিলমেন্ট এন্ডপয়েন্ট কী হবে। আপনি নিম্নলিখিত ধরনের অ্যাকশন তৈরি করতে পারবেন:
- ডিফল্ট অ্যাকশন: প্রতিটি অ্যাকশন প্রোজেক্টে একটি স্বাগত ইনটেন্ট থাকতে হবে যা
ব্যবহারকারীদের কথোপকথন শুরু করার জন্য এন্ট্রি পয়েন্ট হিসেবে কাজ করে। ব্যবহারকারী কোনও অ্যাকশনের নাম উচ্চারণ করে সেটি এক্সপ্লিসিট ইনভোক করলে
ওয়েলকাম ইনটেন্ট ট্রিগার হয় (যেমন, "Ok Google, ExampleAction-এর সাথে কথা বলো")। এই স্বাগত ইন্টেন্ট
actions.intent.MAINইন্টেন্ট নামের মাধ্যমে শনাক্ত করা হয়। - ডিপ-লিঙ্কিংয়ের জন্য অতিরিক্ত অ্যাকশন: আপনি নিজের অ্যাকশন প্যাকেজে অতিরিক্ত অ্যাকশন তৈরি করতে পারেন। এক্ষেত্রে আপনি নিজেই ইনটেন্ট নির্ধারণ করতে পারবেন। এর ফলে ব্যবহারকারীরা ইনটেন্টের সাথে অ্যাকশনের নাম বলে নির্দিষ্ট কার্যকারিতা চালু করতে পারেন (যেমন: "Ok Google, কিছু জুতো খুঁজতে ExampleAction-এর সাথে কথা বলো")।
এইসব ইনভোকেশন মডেল কীভাবে কাজ করে সেই সম্পর্কে আরও জানতে ইনটেন্ট ও ইনভোকেশন দেখুন।
ডিফল্ট অ্যাকশন নির্দিষ্ট করুন
প্রতিটি অ্যাকশন প্যাকেজে অবশ্যই একটি এবং শুধুমাত্র একটি ইন্টেন্ট থাকতে হবে যা
actions.intent.MAIN ইন্টেন্ট ম্যানেজ করে। ব্যবহারকারী আপনার অ্যাকশনকে নাম ধরে ডাকলে এই ইনটেন্ট ট্রিগার হয় (যেমন, "Ok Google, ExampleAction-এর সাথে কথা বলো")।
action.json নামের একটি বয়লারপ্লেট অ্যাকশন প্যাকেজ ফাইল তৈরি করতে,
নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
gactionsCLI ডাউনলোড করুন।- আপনার অ্যাকশন প্রোজেক্টের সোর্স ফাইলের জন্য একটি লোকাল ডিরেক্টরি তৈরি করুন।
টার্মিনালে এই কমান্ডগুলি রান করুন:
$ cd PROJECT_DIRECTORY $ gactions init
অ্যাকশন প্যাকেজ ফাইল তৈরি হয়ে গেলে, প্লেসহোল্ডার কন্টেন্ট আপনার
ভ্যালু দিয়ে পরিবর্তন করুন। ExampleAction-এর জন্য পরিবর্তন সহ action.json-এর একটি উদাহরণ এখানে দেওয়া হল:
{
"actions": [
{
"description": "Default welcome intent",
"name": "MAIN",
"fulfillment": {
"conversationName": "ExampleAction"
},
"intent": {
"name": "actions.intent.MAIN",
"trigger": {
"queryPatterns": [
"talk to ExampleAction"
]
}
}
}
],
"conversations": {
"ExampleAction": {
"name": "ExampleAction",
"url": "https://www.example.com/ExampleAction"
}
},
"locale": "en"
}অতিরিক্ত অ্যাকশন নির্দিষ্ট করুন
আপনি অতিরিক্ত অ্যাকশন প্রদান করতে পারেন যা এন্ট্রি পয়েন্ট হিসেবে কাজ করে। এর ফলে ব্যবহারকারীরা কী করতে চান সেই সম্পর্কে আরও বিবরণ নির্দিষ্ট করে তাদের উদ্দেশ্য স্পষ্ট করতে পারেন (যেমন, "Ok Google, আমার জন্য কিছু জুতো খুঁজতে ExampleAction-এর সাথে কথা বলো।")।
অতিরিক্ত অ্যাকশন নির্দিষ্ট করতে:
-
যেমন, নিম্নলিখিত কোডটি একটি অতিরিক্ত "কেনা" অ্যাকশন দেখায় যা এটি নির্ধারণ করে:actionsঅ্যারেতে, প্রতিটি এন্ট্রি পয়েন্টের জন্য একটি অ্যাকশন নির্দিষ্ট করুন।com.example.ExampleAction.BUY-এর ইন্টেন্ট নাম- এই ইনটেন্ট ট্রিগার করা হলে ব্যবহারকারীর ইনপুট থেকে পার্স করার জন্য
parameters। ব্যবহারকারী অ্যাকশন চালু করার সময় অ্যাকশন ফ্রেজ থেকে নির্দিষ্ট ডেটা প্রয়োজন হলে এটি কাজে লাগে। queryPatternsযা নির্ধারণ করে যে ইনটেন্ট ট্রিগার করার জন্য ব্যবহারকারীকে কী বলতে হবে। কোয়েরি প্যাটার্নে Schema.org টাইপ অন্তর্ভুক্ত থাকতে পারে যা পার্স করার জন্য প্যারামিটার নির্ধারণ করে।
{ "description": "Direct access", "name": "BUY", "fulfillment": { "conversationName": "ExampleAction" }, "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" ] } } }
-
conversationsঅবজেক্টের কোনও আইটেমের সাথে সম্পর্কিতconversationNameনির্দিষ্ট করে এই ইনটেন্টের ফুলফিলমেন্ট নির্দিষ্ট করুন।{ "conversations": { "ExampleAction": { "name": "ExampleAction", "url": "https://www.example.com/ExampleAction" } } }
সম্পূর্ণ অ্যাকশন প্যাকেজের একটি উদাহরণ এখানে দেওয়া হল:
{ "actions": [ { "description": "Default welcome intent", "name": "MAIN", "fulfillment": { "conversationName": "ExampleAction" }, "intent": { "name": "actions.intent.MAIN", "trigger": { "queryPatterns": [ "talk to ExampleAction" ] } } }, { "description": "Direct access", "name": "BUY", "fulfillment": { "conversationName": "ExampleAction" }, "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" ] } } } ], "conversations": { "ExampleAction": { "name": "ExampleAction", "url": "https://www.example.com/ExampleAction" } }, "locale": "en" }