একটি ওয়েবহুক কলে, আপনি হোম স্টোরেজে একই পরিবারের ( হোম গ্রাফের উপর ভিত্তি করে) একাধিক সেশন জুড়ে প্যারামিটার মান সংরক্ষণ করতে পারেন। আপনার অ্যাকশন সেই সঞ্চিত মানগুলিকে পরবর্তীতে প্রম্পট এবং শর্তে ব্যবহার করতে পারে এবং আপনার ওয়েবহুক কোড প্রয়োজনে একটি নির্দিষ্ট পরিবারের জন্য হোম স্টোরেজে মানগুলি অ্যাক্সেস করতে পারে।
হোম স্টোরেজের অবস্থা একটি app.handle()
অনুরোধে পাস করা হয় এবং home
অবজেক্টে সংরক্ষণ করা হয়।
সীমাবদ্ধতা
হোম স্টোরেজ মোবাইল ডিভাইসের সাথে ব্যবহার করা যাবে না, কারণ সেগুলি হোম গ্রাফের অংশ নয়৷ আপনার ওয়েবহুক কোডে, ব্যবহারকারীর ডিভাইসটি কী সক্ষম তার উপর ভিত্তি করে ব্যবসায়িক যুক্তির শাখায় HOME_STORAGE
ডিভাইসের ক্ষমতা ব্যবহার করুন৷
হোম স্টোরেজ ব্যবহার করার জন্য আপনাকে অবশ্যই নির্বাচন করতে হবে:
- অ্যাকশন কনসোলে, Deploy > Directory information এ যান।
- অতিরিক্ত তথ্য বিভাগে, হোম স্টোরেজের জন্য বাক্সটি চেক করুন।
একটি পরিবারের ডেটা পড়ুন এবং লিখুন
হোম স্টোরেজে একটি নতুন মান আপডেট করতে বা সেট করতে, একটি ওয়েবহুক কলে home
অবজেক্টের params
ফিল্ডে মান নির্ধারণ করুন। নিম্নলিখিত উদাহরণটি হোম স্টোরেজে "exampleColor" কে "লাল" এ সেট করে:
Node.js
// Assign color to home storage app.handle('storeColor', conv => { let color = 'red'; conv.home.params.exampleColor = color; });
JSON
{ "responseJson": { "session": { "id": "1234567890123456789", "params": {} }, "prompt": { "override": false }, "home": { "params": { "exampleColor": "red" } } } }
হোম স্টোরেজে সংরক্ষিত ডেটা অ্যাক্সেস করতে, এটি একটি ওয়েবহুক কলে একটি ভেরিয়েবলের সাথে বরাদ্দ করুন। নিম্নলিখিত উদাহরণটি হোম স্টোরেজে "exampleColor" থেকে একটি মান পুনরুদ্ধার করে:
Node.js
// Retrieve color from home storage app.handle('getStoredColor', conv => { let color = conv.home.params.exampleColor; });
JSON
{ "responseJson": { "session": { "id": "1234567890123456789", "params": {} }, "prompt": { "override": false }, "home": { "params": { "homeColor": "red" } } } }
একটি পূর্বে সংরক্ষিত মান সাফ করতে, একটি ওয়েবহুক কলে মানটিকে null
সেট করুন৷ নিম্নলিখিত উদাহরণটি হোম স্টোরেজে "exampleColor" এর মান পরিষ্কার করে:
Node.js
// Clear color from home storage app.handle('clearStoredColor', conv => { conv.home.params.exampleColor = null; });
JSON
{ "responseJson": { "session": { "id": "1234567890123456789", "params": {} }, "prompt": { "override": false }, "home": { "params": {} } } }
প্রম্পটের মধ্যে সংরক্ষিত মান উল্লেখ করুন
আপনি একটি প্রম্পটে হোম স্টোরেজে সংরক্ষিত মান উল্লেখ করতে পারেন। মান উল্লেখ করতে, $home.params. PARAMETER_NAME
সিনট্যাক্স, যেখানে প্যারামিটার সেট করার সময় PARAMETER_NAME
ওয়েবহুকে দেওয়া নাম।
উদাহরণস্বরূপ, আপনি পূর্বে হোম স্টোরেজে একটি রঙের মান সংরক্ষণ করেছেন প্যারামিটার exampleColor
হিসাবে। একটি প্রম্পটে সেই মানটি অ্যাক্সেস করতে, আপনি $home.params.exampleColor
ব্যবহার করে সেই মানটি উল্লেখ করেন:
JSON
{ "candidates": [{ "first_simple": { "variants": [{ "speech": "Your favorite color is $home.params.exampleColor." }] } }] }
শর্তের মধ্যে সংরক্ষিত মান উল্লেখ করুন
আপনি শর্তে বাড়ির স্টোরেজে সঞ্চিত মানগুলিও উল্লেখ করতে পারেন। মান উল্লেখ করতে, home.params. PARAMETER_NAME
সিনট্যাক্স, যেখানে প্যারামিটার সেট করার সময় PARAMETER_NAME
ওয়েবহুকে দেওয়া নাম।
উদাহরণ স্বরূপ, আপনি পূর্বে হোম স্টোরেজে একটি রঙের মান সংরক্ষন করেছেন যেমন প্যারামিটার exampleColor
, এবং আপনি এটিকে একটি শর্তে "লাল" মানের সাথে মেলাতে চান। আপনার অবস্থায়, আপনি home.params.exampleColor
ব্যবহার করে সঞ্চিত মান উল্লেখ করেন। আপনার অবস্থার অভিব্যক্তি তারপর এই মত দেখায়:
কন্ডিশন সিনট্যাক্স
home.params.exampleColor == "red"
হোম স্টোরেজ ডেটার মেয়াদ শেষ
ক্রমাগত 90 দিন অ্যাকশন না নেওয়ার পরে হোম স্টোরেজ ডেটা মুছে ফেলা হয়। হোম গ্রাফ স্ট্রাকচারের সাথে যুক্ত যেকোন ডিভাইসে অ্যাকশন চালু করা 90 দিনের টাইমার রিসেট করে। একটি হোম গ্রাফ কাঠামো মুছে ফেলা হলে, সংশ্লিষ্ট হোম স্টোরেজ ডেটা সাফ করা হয়।
হোম স্টোরেজ ব্যবহার করে এমন অ্যাকশনগুলির জন্য, হোম গ্রাফ স্ট্রাকচার ম্যানেজাররা অ্যাসিস্ট্যান্ট ডিরেক্টরিতে অ্যাকশনের পৃষ্ঠা থেকে ম্যানেজ করা কাঠামোর জন্য হোম স্টোরেজ সাফ করতে পারেন:
- আপনি যে অ্যাকশন দেখতে চান বা আপনার ব্যবহারকারীর স্টোরেজ সাফ করতে চান তা খুঁজুন এবং নির্বাচন করুন।
- পৃষ্ঠার নীচে স্ক্রোল করুন:
- হোম স্টোরেজে আপনার জন্য সংরক্ষিত ডেটা সরাতে, আমাকে মনে রাখার থেকে অ্যাকশন_নাম বন্ধ করুন ক্লিক করুন।
যখন একটি ডিভাইসের ম্যানেজার এটিকে কাঠামো থেকে বিচ্ছিন্ন করে, তখন বাড়ির স্টোরেজও বিচ্ছিন্ন হয়ে যায়। স্ট্রাকচার ম্যানেজার পরিবর্তিত হলেও হোম স্টোরেজ ডেটা একটি ডিভাইসের সাথে যুক্ত হতে থাকে, যদি না কোনো স্ট্রাকচার ম্যানেজার এটি পরিষ্কার করে।
সিমুলেটরে হোম স্টোরেজ ডেটা
অ্যাকশন কনসোলে সিমুলেটর ব্যবহার করে আপনার অ্যাকশন পরীক্ষা করার সময়, হোম স্টোরেজে সংরক্ষিত ডেটা একটি ফিজিক্যাল ডিভাইসের থেকে কিছুটা আলাদা আচরণ করে। সিমুলেটরটিকে তার নিজস্ব হোম গ্রাফের অংশ হিসাবে বিবেচনা করা হয়, তাই আপনার নেটওয়ার্কে থাকা অন্যান্য ডিভাইসগুলিতে ডেটা স্থির থাকে না। অতিরিক্তভাবে, হোম স্টোরেজ ডেটা সেশন জুড়ে টিকে থাকে না যখন সিমুলেট অযাচাইকৃত ব্যবহারকারী সিমুলেটর সেটিং সক্ষম করা থাকে।
নমুনা মিথস্ক্রিয়া
এখানে একটি সাইন-ইন করা ব্যবহারকারীর কর্মের প্রথম আহ্বানের একটি নমুনা ইন্টারঅ্যাকশন রয়েছে:
ব্যবহারকারীর প্রশ্ন | ওহে Google, ExampleAction-এর সাথে কথা বলুন। |
---|---|
সহকারীর প্রতিক্রিয়া | ExampleAction পাওয়া। |
সহকারীর প্রতিক্রিয়া | আপনার জানার জন্য, ExampleAction আপনি যতবারই এটি খেলবেন সেটি সংরক্ষিত হবে, যাতে আপনার পরিবারের অন্যরা আপনি যেখান থেকে ছেড়েছিলেন তা শুরু করতে পারে। |
উদাহরণ অ্যাকশন প্রতিক্রিয়া | হ্যালো যাচাইকৃত ব্যবহারকারী. আপনি লেভেল 0 এ আছেন। পরবর্তী বলুন, রিসেট করুন বা বাতিল করুন। |
ব্যবহারকারীর প্রশ্ন | পরবর্তী |
উদাহরণ অ্যাকশন প্রতিক্রিয়া | আপনি লেভেল 1 এ আছেন। |
ব্যবহারকারীর প্রশ্ন | ছেড়ে দিন। |
তারপর, যখন একই যাচাইকৃত ব্যবহারকারী কিছু সময়ের পরে অ্যাকশনে ফিরে আসে:
ব্যবহারকারীর প্রশ্ন | ওহে Google, ExampleAction-এর সাথে কথা বলুন। |
---|---|
সহকারীর প্রতিক্রিয়া | ExampleAction পাওয়া। |
উদাহরণ অ্যাকশন প্রতিক্রিয়া | হ্যালো যাচাইকৃত ব্যবহারকারী. আপনি লেভেল 1 এ আছেন। পরবর্তী বলুন, রিসেট করুন বা বাতিল করুন। |
ব্যবহারকারীর প্রশ্ন | পরবর্তী |
উদাহরণ অ্যাকশন প্রতিক্রিয়া | আপনি লেভেল 2 এ আছেন। |
ব্যবহারকারীর প্রশ্ন | ছেড়ে দিন। |
পরের দিন, একজন অযাচাই করা ব্যবহারকারী একই পরিবারের অন্য ডিভাইসে অ্যাকশনের সাথে ইন্টারঅ্যাক্ট করে (যেমন হোম গ্রাফে উল্লেখ করা হয়েছে)।
ব্যবহারকারীর প্রশ্ন | ওহে Google, ExampleAction-এর সাথে কথা বলুন। |
---|---|
সহকারীর প্রতিক্রিয়া | ExampleAction পাওয়া। |
সহকারীর প্রতিক্রিয়া | আপনার জানার জন্য, ExampleAction আপনি যতবারই এটি খেলবেন সেটি সংরক্ষিত হবে, যাতে আপনার পরিবারের অন্যরা আপনি যেখান থেকে ছেড়েছিলেন তা শুরু করতে পারে। |
উদাহরণ অ্যাকশন প্রতিক্রিয়া | হ্যালো গেস্ট ব্যবহারকারী. আপনি লেভেল 2 এ আছেন। পরবর্তী বলুন, রিসেট করুন বা বাতিল করুন। |
ব্যবহারকারীর প্রশ্ন | পরবর্তী |
উদাহরণ অ্যাকশন প্রতিক্রিয়া | আপনি লেভেল 3 এ আছেন। |
ব্যবহারকারীর প্রশ্ন | ছেড়ে দিন। |