হোম স্টোরেজ

একটি ওয়েবহুক কলে, আপনি হোম স্টোরেজে একই পরিবারের ( হোম গ্রাফের উপর ভিত্তি করে) একাধিক সেশন জুড়ে প্যারামিটার মান সংরক্ষণ করতে পারেন। আপনার অ্যাকশন সেই সঞ্চিত মানগুলিকে পরবর্তীতে প্রম্পট এবং শর্তে ব্যবহার করতে পারে এবং আপনার ওয়েবহুক কোড প্রয়োজনে একটি নির্দিষ্ট পরিবারের জন্য হোম স্টোরেজে মানগুলি অ্যাক্সেস করতে পারে।

হোম স্টোরেজের অবস্থা একটি app.handle() অনুরোধে পাস করা হয় এবং home অবজেক্টে সংরক্ষণ করা হয়।

গুরুত্বপূর্ণ: কোনো ব্যক্তিগত তথ্য সংরক্ষণ করতে হোম স্টোরেজ ব্যবহার করবেন না। হোম স্টোরেজ ডেটা একই পরিবারের একাধিক ব্যক্তির জন্য প্রযোজ্য যারা একই অ্যাকশন ব্যবহার করে। ব্যবহারকারী-নির্দিষ্ট ডেটার জন্য, পরিবর্তে ব্যবহারকারীর সঞ্চয়স্থান ব্যবহার করুন এবং কোনও ব্যক্তিগত ডেটা সংরক্ষণ করার আগে ব্যবহারকারীর সম্মতির জন্য জিজ্ঞাসা করুন।

সীমাবদ্ধতা

হোম স্টোরেজ মোবাইল ডিভাইসের সাথে ব্যবহার করা যাবে না, কারণ সেগুলি হোম গ্রাফের অংশ নয়৷ আপনার ওয়েবহুক কোডে, ব্যবহারকারীর ডিভাইসটি কী সক্ষম তার উপর ভিত্তি করে ব্যবসায়িক যুক্তির শাখায় HOME_STORAGE ডিভাইসের ক্ষমতা ব্যবহার করুন৷

হোম স্টোরেজ ব্যবহার করার জন্য আপনাকে অবশ্যই নির্বাচন করতে হবে:

1. অ্যাকশন কনসোলে, Deploy > Directory information এ যান।
2. অতিরিক্ত তথ্য বিভাগে, হোম স্টোরেজের জন্য বাক্সটি চেক করুন।

দ্রষ্টব্য: হোম স্টোরেজ ব্যবহার করার সময়, Google অতিরিক্তভাবে যাচাইকৃত ব্যবহারকারীদের কাছে একবার একটি দাবিত্যাগ উপস্থাপন করে এবং অতিথি ব্যবহারকারীদের প্রতি আহ্বানে (10 মিনিটে একবার পর্যন্ত)।

একটি পরিবারের ডেটা পড়ুন এবং লিখুন

হোম স্টোরেজে একটি নতুন মান আপডেট করতে বা সেট করতে, একটি ওয়েবহুক কলে 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 দিনের টাইমার রিসেট করে। একটি হোম গ্রাফ কাঠামো মুছে ফেলা হলে, সংশ্লিষ্ট হোম স্টোরেজ ডেটা সাফ করা হয়।

হোম স্টোরেজ ব্যবহার করে এমন অ্যাকশনগুলির জন্য, হোম গ্রাফ স্ট্রাকচার ম্যানেজাররা অ্যাসিস্ট্যান্ট ডিরেক্টরিতে অ্যাকশনের পৃষ্ঠা থেকে ম্যানেজ করা কাঠামোর জন্য হোম স্টোরেজ সাফ করতে পারেন:

1. আপনি যে অ্যাকশন দেখতে চান বা আপনার ব্যবহারকারীর স্টোরেজ সাফ করতে চান তা খুঁজুন এবং নির্বাচন করুন।
2. পৃষ্ঠার নীচে স্ক্রোল করুন:
   • হোম স্টোরেজে আপনার জন্য সংরক্ষিত ডেটা সরাতে, আমাকে মনে রাখার থেকে অ্যাকশন_নাম বন্ধ করুন ক্লিক করুন।

দ্রষ্টব্য: হোম স্টোরেজ ক্লিয়ার করা গেস্ট এবং অন্যান্য হোম গ্রাফ স্ট্রাকচার ম্যানেজারদের জন্য সঞ্চিত মান সাফ করে।

যখন একটি ডিভাইসের ম্যানেজার এটিকে কাঠামো থেকে বিচ্ছিন্ন করে, তখন বাড়ির স্টোরেজও বিচ্ছিন্ন হয়ে যায়। স্ট্রাকচার ম্যানেজার পরিবর্তিত হলেও হোম স্টোরেজ ডেটা একটি ডিভাইসের সাথে যুক্ত হতে থাকে, যদি না কোনো স্ট্রাকচার ম্যানেজার এটি পরিষ্কার করে।

সিমুলেটরে হোম স্টোরেজ ডেটা

অ্যাকশন কনসোলে সিমুলেটর ব্যবহার করে আপনার অ্যাকশন পরীক্ষা করার সময়, হোম স্টোরেজে সংরক্ষিত ডেটা একটি ফিজিক্যাল ডিভাইসের থেকে কিছুটা আলাদা আচরণ করে। সিমুলেটরটিকে তার নিজস্ব হোম গ্রাফের অংশ হিসাবে বিবেচনা করা হয়, তাই আপনার নেটওয়ার্কে থাকা অন্যান্য ডিভাইসগুলিতে ডেটা স্থির থাকে না। অতিরিক্তভাবে, হোম স্টোরেজ ডেটা সেশন জুড়ে টিকে থাকে না যখন সিমুলেট অযাচাইকৃত ব্যবহারকারী সিমুলেটর সেটিং সক্ষম করা থাকে।

নমুনা মিথস্ক্রিয়া

এখানে একটি সাইন-ইন করা ব্যবহারকারীর কর্মের প্রথম আহ্বানের একটি নমুনা ইন্টারঅ্যাকশন রয়েছে:

ব্যবহারকারীর প্রশ্ন	ওহে Google, ExampleAction-এর সাথে কথা বলুন।
সহকারীর প্রতিক্রিয়া	ExampleAction পাওয়া।
সহকারীর প্রতিক্রিয়া	আপনার জানার জন্য, ExampleAction আপনি যতবারই এটি খেলবেন সেটি সংরক্ষিত হবে, যাতে আপনার পরিবারের অন্যরা আপনি যেখান থেকে ছেড়েছিলেন তা শুরু করতে পারে।
উদাহরণ অ্যাকশন প্রতিক্রিয়া	হ্যালো যাচাইকৃত ব্যবহারকারী. আপনি লেভেল 0 এ আছেন। পরবর্তী বলুন, রিসেট করুন বা বাতিল করুন।
ব্যবহারকারীর প্রশ্ন	পরবর্তী.
উদাহরণ অ্যাকশন প্রতিক্রিয়া	আপনি লেভেল 1 এ আছেন।
ব্যবহারকারীর প্রশ্ন	ছেড়ে দিন।

তারপর, যখন একই যাচাইকৃত ব্যবহারকারী কিছু সময়ের পরে অ্যাকশনে ফিরে আসে:

ব্যবহারকারীর প্রশ্ন	ওহে Google, ExampleAction-এর সাথে কথা বলুন।
সহকারীর প্রতিক্রিয়া	ExampleAction পাওয়া।
উদাহরণ অ্যাকশন প্রতিক্রিয়া	হ্যালো যাচাইকৃত ব্যবহারকারী. আপনি লেভেল 1 এ আছেন। পরবর্তী বলুন, রিসেট করুন বা বাতিল করুন।
ব্যবহারকারীর প্রশ্ন	পরবর্তী.
উদাহরণ অ্যাকশন প্রতিক্রিয়া	আপনি লেভেল 2 এ আছেন।
ব্যবহারকারীর প্রশ্ন	ছেড়ে দিন।

পরের দিন, একজন অযাচাই করা ব্যবহারকারী একই পরিবারের অন্য ডিভাইসে অ্যাকশনের সাথে ইন্টারঅ্যাক্ট করে (যেমন হোম গ্রাফে উল্লেখ করা হয়েছে)।

দ্রষ্টব্য: Google সেই পরিবারে অ্যাকশনের শেষ আহ্বানের পর থেকে কমপক্ষে 10 মিনিট হয়ে গেলেই দাবিত্যাগটি উপস্থাপন করে৷

ব্যবহারকারীর প্রশ্ন	ওহে Google, ExampleAction-এর সাথে কথা বলুন।
সহকারীর প্রতিক্রিয়া	ExampleAction পাওয়া।
সহকারীর প্রতিক্রিয়া	আপনার জানার জন্য, ExampleAction আপনি যতবারই এটি খেলবেন সেটি সংরক্ষিত হবে, যাতে আপনার পরিবারের অন্যরা আপনি যেখান থেকে ছেড়েছিলেন তা শুরু করতে পারে।
উদাহরণ অ্যাকশন প্রতিক্রিয়া	হ্যালো গেস্ট ব্যবহারকারী. আপনি লেভেল 2 এ আছেন। পরবর্তী বলুন, রিসেট করুন বা বাতিল করুন।
ব্যবহারকারীর প্রশ্ন	পরবর্তী.
উদাহরণ অ্যাকশন প্রতিক্রিয়া	আপনি লেভেল 3 এ আছেন।
ব্যবহারকারীর প্রশ্ন	ছেড়ে দিন।