1. ওভারভিউ
গুগল অ্যাসিস্ট্যান্ট ডেভেলপার প্ল্যাটফর্ম আপনাকে স্মার্ট স্পিকার, ফোন, গাড়ি, টিভি, হেডফোন এবং আরও অনেক কিছু সহ 1 বিলিয়নেরও বেশি ডিভাইস জুড়ে Google সহকারী, একজন ভার্চুয়াল ব্যক্তিগত সহকারীর কার্যকারিতা বাড়ানোর জন্য সফ্টওয়্যার তৈরি করতে দেয়। ব্যবহারকারীরা সহকারীকে কথোপকথনে নিযুক্ত করে কাজগুলি সম্পন্ন করতে, যেমন মুদি কেনা বা রাইড বুক করা। একজন ডেভেলপার হিসেবে, আপনি সহকারী ডেভেলপার প্ল্যাটফর্ম ব্যবহার করে সহজেই ব্যবহারকারীদের এবং আপনার নিজের তৃতীয় পক্ষের পরিপূর্ণতা পরিষেবার মধ্যে আনন্দদায়ক এবং কার্যকর কথোপকথনের অভিজ্ঞতা তৈরি এবং পরিচালনা করতে পারেন।
এই কোডল্যাবটি Google সহকারীর জন্য অ্যাকশন SDK-এর সাথে বিকাশের জন্য প্রাথমিক স্তরের ধারণাগুলি কভার করে; প্ল্যাটফর্মটি সম্পূর্ণ করার জন্য আপনার কোনো পূর্ব অভিজ্ঞতার প্রয়োজন নেই। এই কোডল্যাবে, আপনি Google অ্যাসিস্ট্যান্টের জন্য একটি সাধারণ অ্যাকশন তৈরি করেন যা ব্যবহারকারীদের তাদের ভাগ্য জানায় যখন তারা গ্রিফিনবার্গের পৌরাণিক দেশে তাদের দুঃসাহসিক কাজ শুরু করে। অ্যাকশন SDK লেভেল 2 কোডল্যাবে, আপনি তাদের ইনপুটের উপর ভিত্তি করে ব্যবহারকারীর ভাগ্য কাস্টমাইজ করতে এই অ্যাকশনটি আরও তৈরি করেন।
আপনি কি নির্মাণ করবেন
এই কোডল্যাবে, আপনি নিম্নলিখিত ফাংশনগুলির সাথে একটি সাধারণ অ্যাকশন তৈরি করেন:
- একটি শুভেচ্ছা বার্তা সহ ব্যবহারকারীদের প্রতিক্রিয়া
- ব্যবহারকারীদের একটি প্রশ্ন জিজ্ঞাসা করে এবং ব্যবহারকারীর নির্বাচনের যথাযথভাবে উত্তর দেয়
- পরামর্শ চিপ প্রদান করে ব্যবহারকারীরা ইনপুট প্রদান করতে ক্লিক করতে পারেন
- ব্যবহারকারীরা ফিরে আসা ব্যবহারকারী কিনা তার ভিত্তিতে অভিবাদন বার্তা পরিবর্তন করে
আপনি যখন এই কোডল্যাবটি শেষ করবেন, আপনার সম্পন্ন অ্যাকশনে নিম্নলিখিত কথোপকথন প্রবাহ থাকবে (মাইক্রোফোনের পাশের পাঠ্যটি ব্যবহারকারীর ইনপুটকে প্রতিনিধিত্ব করে, যখন স্পিকারের পাশের পাঠ্যটি অ্যাকশনের প্রতিক্রিয়া উপস্থাপন করে):
আপনি কি শিখবেন
- অ্যাকশন কনসোলে কীভাবে একটি প্রকল্প তৈরি করবেন
- অ্যাকশন কনসোল এবং আপনার স্থানীয় ফাইল সিস্টেমের মধ্যে আপনার অ্যাকশন প্রকল্পটি পুশ এবং টানতে গ্যাকশন টুলটি কীভাবে ব্যবহার করবেন
- ব্যবহারকারীরা আপনার অ্যাকশন আহ্বান করার পরে কীভাবে একটি প্রম্পট পাঠাবেন
- কিভাবে একটি ব্যবহারকারীর ইনপুট প্রক্রিয়া এবং একটি প্রতিক্রিয়া ফেরত
- অ্যাকশন সিমুলেটরে আপনার অ্যাকশন কীভাবে পরীক্ষা করবেন
- ক্লাউড ফাংশন এডিটর ব্যবহার করে কীভাবে পরিপূর্ণতা বাস্তবায়ন করবেন
আপনি কি প্রয়োজন হবে
নিম্নলিখিত সরঞ্জামগুলি আপনার পরিবেশে থাকতে হবে:
- আপনার পছন্দের একটি IDE বা পাঠ্য সম্পাদক
- Node.js এবং npm এর জন্য শেল কমান্ড চালানোর জন্য একটি টার্মিনাল
- একটি ওয়েব ব্রাউজার, যেমন Google Chrome
2. সেট আপ করুন
নিম্নলিখিত বিভাগগুলি বর্ণনা করে যে কীভাবে আপনার বিকাশের পরিবেশ সেট আপ করবেন এবং আপনার অ্যাকশন প্রকল্প তৈরি করবেন।
আপনার Google অনুমতি সেটিংস পরীক্ষা করুন
এই কোডল্যাবে আপনি যে অ্যাকশন তৈরি করেছেন তা পরীক্ষা করতে, আপনাকে প্রয়োজনীয় অনুমতিগুলি সক্ষম করতে হবে যাতে সিমুলেটর আপনার অ্যাকশন অ্যাক্সেস করতে পারে।
অনুমতি সক্ষম করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- অ্যাক্টিভিটি কন্ট্রোলে যান।
- আপনি যদি ইতিমধ্যে এটি না করে থাকেন তবে আপনার Google অ্যাকাউন্ট দিয়ে সাইন ইন করুন৷
- নিম্নলিখিত অনুমতিগুলি সক্রিয় করুন:
- ওয়েব এবং অ্যাপ কার্যকলাপ
- ওয়েব ও অ্যাপ অ্যাক্টিভিটির অধীনে, Google পরিষেবা ব্যবহার করে এমন সাইট, অ্যাপ এবং ডিভাইস থেকে Chrome ইতিহাস এবং কার্যকলাপ অন্তর্ভুক্ত করুন চেকবক্সটি নির্বাচন করুন**।**
একটি অ্যাকশন প্রকল্প তৈরি করুন
আপনার অ্যাকশন প্রকল্প আপনার অ্যাকশনের জন্য একটি ধারক।
এই কোডল্যাবের জন্য আপনার অ্যাকশন প্রকল্প তৈরি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- অ্যাকশন কনসোল খুলুন।
- নতুন প্রকল্প ক্লিক করুন.
- একটি প্রকল্পের নাম লিখুন, যেমন
actions-codelab
। (নামটি আপনার অভ্যন্তরীণ রেফারেন্সের জন্য। পরে, আপনি আপনার প্রকল্পের জন্য একটি বাহ্যিক নাম সেট করতে পারেন।)
- প্রকল্প তৈরি করুন ক্লিক করুন।
- আপনি কি ধরনের অ্যাকশন তৈরি করতে চান? স্ক্রীন, কাস্টম কার্ড নির্বাচন করুন।
- পরবর্তী ক্লিক করুন.
- আপনি কিভাবে এটি নির্মাণ করতে চান? স্ক্রীনে, ফাঁকা প্রকল্প কার্ড নির্বাচন করুন।
- বিল্ডিং শুরু করুন ক্লিক করুন।
আপনার কর্মের জন্য প্রকল্প আইডি সংরক্ষণ করুন
প্রজেক্ট আইডি আপনার অ্যাকশনের জন্য একটি অনন্য শনাক্তকারী। এই কোডল্যাবে বেশ কিছু ধাপের জন্য আপনার প্রোজেক্ট আইডি প্রয়োজন।
আপনার প্রকল্প আইডি পুনরুদ্ধার করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- অ্যাকশন কনসোলে, তিনটি উল্লম্ব বিন্দুতে ক্লিক করুন (এখানে আইকন সন্নিবেশ করুন)।
- প্রকল্প সেটিংস ক্লিক করুন.
- প্রকল্প আইডি কপি করুন**.**
একটি বিলিং অ্যাকাউন্ট সংযুক্ত করুন
আপনার যদি ইতিমধ্যেই একটি বিলিং অ্যাকাউন্ট না থাকে, তাহলে আপনাকে একটি বিলিং অ্যাকাউন্ট তৈরি করতে হবে এবং ক্লাউড ফাংশনগুলির সাথে পরে আপনার পরিপূর্ণতা স্থাপন করতে Google ক্লাউডে আপনার প্রকল্পের সাথে এটি সংযুক্ত করতে হবে৷
আপনার প্রকল্পের সাথে একটি বিলিং অ্যাকাউন্ট সংযুক্ত করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- Google ক্লাউড প্ল্যাটফর্ম বিলিং পৃষ্ঠাতে যান।
- বিলিং অ্যাকাউন্ট যোগ করুন বা অ্যাকাউন্ট তৈরি করুন ক্লিক করুন।
- আপনার পেমেন্ট তথ্য লিখুন.
- আমার বিনামূল্যে ট্রায়াল শুরু করুন বা জমা দিন এবং বিলিং সক্ষম করুন ক্লিক করুন।
- Google ক্লাউড প্ল্যাটফর্ম বিলিং পৃষ্ঠাতে যান।
- My Projects ট্যাবে ক্লিক করুন।
- কোডল্যাবের জন্য অ্যাকশন প্রকল্পের পাশে অ্যাকশনের অধীনে তিনটি বিন্দুতে ক্লিক করুন।
- বিলিং পরিবর্তন করুন ক্লিক করুন।
- ড্রপ-ডাউন মেনুতে, আপনার কনফিগার করা বিলিং অ্যাকাউন্ট নির্বাচন করুন।
- অ্যাকাউন্ট সেট করুন ক্লিক করুন।
চার্জ এড়াতে, এই কোডল্যাবের শেষে আপনার প্রকল্প পরিষ্কার করুন বিভাগে পদক্ষেপগুলি অনুসরণ করুন৷
গ্যাকশন কমান্ড-লাইন ইন্টারফেস ইনস্টল করুন
এই কোডল্যাবে, আপনি অ্যাকশন কনসোল এবং আপনার স্থানীয় ফাইল সিস্টেমের মধ্যে আপনার অ্যাকশন প্রকল্প সিঙ্ক্রোনাইজ করতে গ্যাকশন কমান্ড-লাইন ইন্টারফেস (CLI) টুল ব্যবহার করেন।
গ্যাকশন CLI ইনস্টল করতে, গ্যাকশন কমান্ড-লাইন টুল ইনস্টল করার নির্দেশাবলী অনুসরণ করুন।
আপনার অ্যাকশন প্রকল্প ডাউনলোড করুন
অ্যাকশন কনসোল থেকে আপনার অ্যাকশন প্রকল্প ডাউনলোড করে আপনার অ্যাকশন ডেভেলপ করা শুরু করুন।
আপনার অ্যাকশন প্রকল্প ডাউনলোড করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- একটি নতুন ডিরেক্টরি তৈরি করতে এবং সেই ডিরেক্টরিতে পরিবর্তন করতে, নিম্নলিখিত কমান্ডগুলি চালান:
mkdir myproject cd myproject
- আপনার স্থানীয় ফাইল সিস্টেমে আপনার অ্যাকশন প্রকল্পের কনফিগারেশন অনুলিপি করতে, নিম্নলিখিত কমান্ডটি চালান:
gactions pull --project-id <projectID>
ফাইলের গঠন বুঝুন
অ্যাকশন কনসোল থেকে আপনি যে অ্যাকশন প্রকল্পটি ডাউনলোড করেন সেটি একটি YAML ফাইল কাঠামোতে উপস্থাপন করা হয়। নিম্নলিখিত চিত্রটি ফাইল কাঠামোর একটি উচ্চ-স্তরের উপস্থাপনা দেখায়:
ফাইল গঠন নিম্নলিখিত গঠিত:
-
actions/
: আপনার অ্যাকশন প্রকল্পের প্রতিনিধিত্ব করে। আপনার অ্যাকশন চালু করা হলে সিস্টেমটিactions.yaml
কল করে, যা তারপরcustom/global/actions.intent.MAIN.yaml
ফাইলটিকে কল করে। -
custom/
: যে ডিরেক্টরিতে আপনি আপনার অ্যাকশন পরিবর্তন করতে কাজ করবেন। -
global/
: এই ডিরেক্টরিতে সিস্টেম ইন্টেন্ট রয়েছে যা প্ল্যাটফর্ম স্বয়ংক্রিয়ভাবে আপনার প্রকল্পে যোগ করে। আপনি এই কোডল্যাবে পরে সিস্টেম ইন্টেন্ট সম্পর্কে আরও শিখবেন। -
manifest.yaml
: একটি ফাইল যাতে পরিবহনযোগ্য, বা কোনো প্রদত্ত প্রকল্পের জন্য নির্দিষ্ট নয় এবং প্রকল্পের মধ্যে স্থানান্তর করা যায় এমন তথ্য রয়েছে। -
settings/
: একটি অ্যাকশন প্রকল্পের সেটিংস প্রতিনিধিত্ব করে, যেমন প্রদর্শনের নাম, ডিফল্ট লোকেল এবং বিভাগ।
3. একটি কথোপকথন শুরু করুন
ব্যবহারকারীরা আমন্ত্রণের মাধ্যমে আপনার অ্যাকশনের সাথে কথোপকথন শুরু করে। উদাহরণস্বরূপ, আপনার যদি MovieTime নামে একটি অ্যাকশন থাকে, তাহলে ব্যবহারকারীরা "Hey Google, মুভিটাইমের সাথে কথা বলুন" এর মত একটি বাক্যাংশ বলে আপনার অ্যাকশনকে আহ্বান করতে পারেন, যেখানে MovieTime হল প্রদর্শনের নাম৷ আপনার অ্যাকশনের একটি প্রদর্শন নাম থাকতে হবে যদি আপনি এটিকে উৎপাদনে স্থাপন করতে চান; যাইহোক, আপনার অ্যাকশন পরীক্ষা করতে, আপনাকে ডিসপ্লে নামটি সংজ্ঞায়িত করতে হবে না। পরিবর্তে, আপনি আপনার অ্যাকশনের জন্য সিমুলেটরে "টক টু মাই টেস্ট অ্যাপ" বাক্যাংশটি ব্যবহার করতে পারেন। আপনি এই বিভাগে পরে সিমুলেটর সম্পর্কে আরও শিখবেন।
একজন ব্যবহারকারী আপনার অ্যাকশন আহ্বান করার পরে কী ঘটবে তা নির্ধারণ করতে আপনাকে অবশ্যই প্রধান আহ্বান সম্পাদনা করতে হবে।
ডিফল্টরূপে, যখন আপনার আহ্বান ট্রিগার হয় তখন আপনার অ্যাকশন একটি জেনেরিক প্রম্পট প্রদান করে ( "প্রধান আহ্বান সংজ্ঞায়িত করে আপনার অ্যাকশন তৈরি করা শুরু করুন।")।
পরবর্তী বিভাগে, আপনি custom/global/actions.intent.MAIN.yaml
ফাইলে আপনার প্রধান আহ্বানের জন্য প্রম্পটটি কাস্টমাইজ করুন।
প্রধান আহ্বান সেট আপ করুন
আপনি actions.intent.MAIN.yaml
ফাইলে আপনার প্রধান আহ্বান প্রম্পট সম্পাদনা করতে পারেন।
ব্যবহারকারীরা যখন আপনার অ্যাকশন শুরু করে তখন আপনার অ্যাকশন যে প্রম্পটটি ফেরত পাঠায় তা পরিবর্তন করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার টেক্সট এডিটরে
custom/global/actions.intent.MAIN.yaml
খুলুন। -
speech
ক্ষেত্রের পাঠ্যটি প্রতিস্থাপন করুন (Start building your action...
) নিম্নলিখিত স্বাগত বার্তা দিয়ে:A wondrous greeting, adventurer! Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you're on your way to an epic journey.
actions.intent.MAIN.yaml
handler:
staticPrompt:
candidates:
- promptResponse:
firstSimple:
variants:
- speech: A wondrous greeting, adventurer! Welcome to the mythical land of
Gryffinberg! Based on your clothes, you are not from around these lands.
It looks like you're on your way to an epic journey.
transitionToScene: actions.scene.END_CONVERSATION
- ফাইলটি সংরক্ষণ করুন।
সিমুলেটরে প্রধান আহ্বান পরীক্ষা করুন
অ্যাকশন কনসোল আপনার অ্যাকশন পরীক্ষা করার জন্য একটি ওয়েব টুল সরবরাহ করে যাকে সিমুলেটর বলা হয়। ইন্টারফেসটি হার্ডওয়্যার ডিভাইস এবং তাদের সেটিংস অনুকরণ করে, যাতে আপনি আপনার অ্যাকশনের সাথে কথোপকথন করতে পারেন যেন এটি একটি স্মার্ট ডিসপ্লে, ফোন, স্পিকার বা KaiOS-এ চলছে।
আপনি যখন আপনার অ্যাকশন আহ্বান করেন, তখন এটি এখন আপনার যোগ করা কাস্টমাইজড প্রম্পটের সাথে সাড়া দেওয়া উচিত ( "একটি বিস্ময়কর অভিবাদন, সাহসী!...") ।
আপনি আপনার অ্যাকশন প্রকল্পের সংস্করণ আপডেট না করেই কনসোলে আপনার অ্যাকশন পরীক্ষা করার জন্য gactions deploy preview
কমান্ড ব্যবহার করতে পারেন। আপনি যখন এই কমান্ডটি চালান, তখন আপনার স্থানীয় ফাইল সিস্টেমে আপনি যে পরিবর্তনগুলি করেন তার কোনোটিই আপনার অ্যাকশন প্রকল্পের স্থাপন করা সংস্করণগুলিতে প্রচারিত হয় না, তবে আপনি একটি পূর্বরূপ সংস্করণে সেগুলি পরীক্ষা করতে পারেন।
সিমুলেটরে আপনার অ্যাকশনের মূল আহ্বান পরীক্ষা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- পরীক্ষার জন্য অ্যাকশন কনসোলে আপনার প্রকল্প স্থাপন করতে, টার্মিনালে নিম্নলিখিত কমান্ডটি চালান:
gactions deploy preview
আপনি নিম্নলিখিত মত দেখায় যে আউটপুট গ্রহণ করা উচিত:
✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview
- প্রদত্ত URL অনুলিপি করুন এবং একটি ব্রাউজারে পেস্ট করুন।
- সিমুলেটরে আপনার অ্যাকশন চালু করতে, ইনপুট ফিল্ডে
Talk to my test app
টাইপ করুন এবংEnter
টিপুন।
আপনি যখন আপনার অ্যাকশনের মূল আহ্বান ট্রিগার করেন, তখন সহকারী আপনার কাস্টমাইজড স্বাগত বার্তার সাথে প্রতিক্রিয়া জানায়। এই মুহুর্তে, সহকারী অভিবাদনের সাথে সাড়া দেওয়ার পরে কথোপকথন শেষ হয়। পরবর্তী বিভাগে, আপনি আপনার অ্যাকশন পরিবর্তন করুন যাতে কথোপকথন চলতে থাকে।
ইভেন্ট লগ দেখুন
আপনি যখন অ্যাকশন কনসোলে টেস্ট ট্যাবে থাকেন, প্যানেলটি ইভেন্ট লগগুলি দেখায়, যা ইভেন্ট লগ হিসাবে কথোপকথনের ইতিহাস প্রদর্শন করে৷ প্রতিটি ইভেন্ট লগ কথোপকথনের সেই মোড়ের সময় ঘটে যাওয়া ঘটনাগুলি প্রদর্শন করে৷
আপনার অ্যাকশনে বর্তমানে একটি ইভেন্ট লগ রয়েছে, যা ব্যবহারকারীর ইনপুট ( "আমার পরীক্ষার অ্যাপে কথা বলুন" ) এবং আপনার অ্যাকশনের প্রতিক্রিয়া উভয়ই দেখায়৷ নিম্নলিখিত স্ক্রিনশটটি আপনার অ্যাকশনের ইভেন্ট লগ দেখায়:
আপনি যদি ইভেন্ট লগে Talk to my test app
পাশের নিচের দিকের তীরটিতে ক্লিক করেন, তাহলে আপনি ঘটনাগুলি দেখতে পাবেন, কালানুক্রমিকভাবে সাজানো, যা কথোপকথনের সেই পালাটিতে ঘটেছে:
-
userInput
: ব্যবহারকারীর ইনপুটের সাথে মিলে যায় ( "আমার পরীক্ষার অ্যাপের সাথে কথা বলুন" ) -
interactionMatch
: আপনার অ্যাকশনের প্রধান আহ্বানের প্রতিক্রিয়ার সাথে মিলে যায়, যা ব্যবহারকারীর ইনপুট দ্বারা ট্রিগার হয়েছিল। আপনি যদি তীরটিতে ক্লিক করে এই সারিটি প্রসারিত করেন, তাহলে আপনি মূল আহ্বানের জন্য যুক্ত করা প্রম্পটটি দেখতে পাবেন (A wondrous greeting, adventurer!...
) -
endConversation
:Main invocation
অভিপ্রায়ে নির্বাচিত স্থানান্তরের সাথে মিলে যায়, যা বর্তমানে কথোপকথনটি শেষ করে। আপনি এই কোডল্যাবের পরবর্তী বিভাগে ট্রানজিশন সম্পর্কে আরও শিখবেন।
আপনার অ্যাকশন কীভাবে কাজ করছে তা ইভেন্ট লগগুলি দৃশ্যমানতা প্রদান করে এবং আপনার কোনো সমস্যা থাকলে আপনার অ্যাকশন ডিবাগ করার জন্য দরকারী টুল। একটি ইভেন্টের বিশদ বিবরণ দেখতে, ইভেন্টের নামের পাশের তীরটিতে ক্লিক করুন, যেমনটি নিম্নলিখিত স্ক্রিনশটে দেখানো হয়েছে:
4. আপনার অ্যাকশনের কথোপকথন তৈরি করুন
এখন যেহেতু আপনি সংজ্ঞায়িত করেছেন একজন ব্যবহারকারী আপনার অ্যাকশন আহ্বান করার পরে কী ঘটবে, আপনি আপনার অ্যাকশনের বাকি কথোপকথন তৈরি করতে পারেন। এই কোডল্যাবটি চালিয়ে যাওয়ার আগে, আপনার অ্যাকশনের কথোপকথন কীভাবে কাজ করে তা বোঝার জন্য নিম্নলিখিত শর্তগুলির সাথে নিজেকে পরিচিত করুন:
আপনার অ্যাকশনে এক বা একাধিক দৃশ্য থাকতে পারে এবং প্রতিটি দৃশ্য চালানোর আগে আপনাকে অবশ্যই সক্রিয় করতে হবে। এই কোডল্যাবে আপনি যে অ্যাকশনটি তৈরি করেন তাতে Start
শিরোনামের একটি দৃশ্য রয়েছে। একটি দৃশ্য সক্রিয় করার সবচেয়ে সাধারণ উপায় হল আপনার অ্যাকশন কনফিগার করা যাতে, যখন ব্যবহারকারীর ইনপুট একটি দৃশ্যের মধ্যে একটি অভিপ্রায়ের সাথে মেলে, তখন সেই অভিপ্রায়টি অন্য দৃশ্যে রূপান্তরকে ট্রিগার করে এবং এটি সক্রিয় করে।
উদাহরণস্বরূপ, একটি অনুমানমূলক ক্রিয়া কল্পনা করুন যা ব্যবহারকারীকে প্রাণীর তথ্য প্রদান করে। যখন ব্যবহারকারী এই অ্যাকশনটি আহ্বান করেন, Main invocation
অভিপ্রায় মিলে যায় এবং Facts.
এই রূপান্তরটি Facts
দৃশ্যকে সক্রিয় করে, যা ব্যবহারকারীকে নিম্নলিখিত প্রম্পট পাঠায়: Would you like to hear a fact about cats or dogs?
Facts
দৃশ্যের মধ্যে Cat
নামে একটি কাস্টম অভিপ্রায় রয়েছে, যেটিতে প্রশিক্ষণ বাক্যাংশ রয়েছে যা ব্যবহারকারী একটি বিড়ালের ঘটনা শোনার জন্য বলতে পারে, যেমন "আমি একটি বিড়ালের ঘটনা শুনতে চাই" বা "বিড়াল" । যখন ব্যবহারকারী একটি বিড়ালের ঘটনা শুনতে বলেন, তখন Cat
অভিপ্রায় মিলে যায় এবং Cat fact.
Cat fact
সিন সক্রিয় করে এবং ব্যবহারকারীকে একটি প্রম্পট পাঠায় যাতে একটি বিড়াল ঘটনা অন্তর্ভুক্ত থাকে।
চিত্র 1. অ্যাকশন SDK-এর সাহায্যে নির্মিত অ্যাকশনে একটি সাধারণ কথোপকথনের প্রবাহ।
একসাথে, দৃশ্য, অভিপ্রায় এবং রূপান্তরগুলি আপনার কথোপকথনের জন্য যুক্তি তৈরি করে এবং আপনার ব্যবহারকারী আপনার অ্যাকশনের কথোপকথনের মাধ্যমে যে বিভিন্ন পথ গ্রহণ করতে পারে তা সংজ্ঞায়িত করে৷ নিম্নলিখিত বিভাগে, আপনি একটি দৃশ্য তৈরি করুন এবং একজন ব্যবহারকারী আপনার অ্যাকশন আহ্বান করার পরে সেই দৃশ্যটি কীভাবে সক্রিয় হয় তা সংজ্ঞায়িত করুন।
মূল আহ্বান থেকে দৃশ্যে রূপান্তর
এই বিভাগে, আপনি Start
নামে একটি নতুন দৃশ্য তৈরি করেন, যা ব্যবহারকারীর কাছে একটি প্রম্পট পাঠায় যে তারা তাদের ভাগ্য বলতে চান কিনা। আপনি মূল আহ্বান থেকে নতুন Start
দৃশ্যে একটি রূপান্তর যোগ করুন।
এই দৃশ্য তৈরি করতে এবং এতে একটি রূপান্তর যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার টেক্সট এডিটরে
custom/global/actions.intent.MAIN.yaml
খুলুন। -
transitionToScene
ক্ষেত্রের পাঠ্যটি প্রতিস্থাপন করুন (actions.scene.END_CONVERSATION
) নিম্নলিখিতটি দিয়ে:transitionToScene: Start
actions.intent.MAIN.yaml
handler:
staticPrompt:
candidates:
- promptResponse:
firstSimple:
variants:
- speech: Welcome to the mythical land of Gryffinberg! Based on your clothes,
you are not from around these lands. It looks like you're on your way
to an epic journey.
transitionToScene: Start
এটি আপনার অ্যাকশনকে মূল আহ্বান থেকে Start
দৃশ্যে রূপান্তর করতে বলে।
- ফাইলটি সংরক্ষণ করুন।
- টার্মিনালে,
custom
ডিরেক্টরিতে একটি নতুনscenes
ডিরেক্টরি তৈরি করুন:
mkdir custom/scenes
-
scenes
ডিরেক্টরিতেStart.yaml
নামে একটি নতুন ফাইল তৈরি করুন, যা আপনার অ্যাকশনেstart
দৃশ্যকে উপস্থাপন করে:
touch custom/scenes/Start.yaml
- আপনার টেক্সট এডিটরে
Start.yaml
খুলুন। -
Start.yaml
ফাইলে নিম্নলিখিত কোড পেস্ট করুন:
স্টার্ট.ইয়ামল
onEnter:
staticPrompt:
candidates:
- promptResponse:
firstSimple:
variants:
- speech: Before you continue on your quest, would you like your fortune
told?
Start.yaml
ফাইল কোডে, onEnter
নামে একটি ক্ষেত্র রয়েছে, যা একটি দৃশ্যের জীবনচক্রের প্রথম পর্যায়।
এই ক্ষেত্রে, ব্যবহারকারী যখন প্রথম Start
দৃশ্যে প্রবেশ করে তখন প্রম্পট ( Before you continue on your quest...
) প্রম্পট সারিতে যোগ করা হয়।
পরামর্শ চিপ যোগ করুন
সাজেশন চিপ ব্যবহারকারীর জন্য ক্লিকযোগ্য পরামর্শ অফার করে যা আপনার অ্যাকশন ব্যবহারকারীর ইনপুট হিসাবে প্রক্রিয়া করে। এই বিভাগে, আপনি Yes
এবং No
পরামর্শ চিপগুলি যুক্ত করেন যা আপনি এইমাত্র কনফিগার করা প্রম্পটের নীচে প্রদর্শিত হবে ( Before you continue on your quest, would you like your fortune told?
) স্ক্রীন সহ ডিভাইসগুলিতে ব্যবহারকারীদের সমর্থন করতে।
Start
দৃশ্যের প্রম্পটে পরামর্শ চিপ যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- নিম্নলিখিত কোড স্নিপেটের সাথে মেলে
Start.yaml
এ কোডটি আপডেট করুন, যাতে সাজেশন চিপ কনফিগার করার কোড রয়েছে:
স্টার্ট.ইয়ামল
onEnter:
staticPrompt:
candidates:
- promptResponse:
firstSimple:
variants:
- speech: Before you continue on your quest, would you like your fortune
told?
suggestions:
- title: "Yes"
- title: "No"
- ফাইলটি সংরক্ষণ করুন।
সিমুলেটরে আপনার অ্যাকশন পরীক্ষা করুন
এই মুহুর্তে, আপনার অ্যাকশনটি মূল আহ্বান থেকে Start
দৃশ্যে স্থানান্তর করা উচিত এবং ব্যবহারকারীকে জিজ্ঞাসা করা উচিত যে তারা তাদের ভাগ্য বলতে চায় কিনা। সিমুলেটেড ডিসপ্লেতে সাজেশন চিপগুলিও উপস্থিত হওয়া উচিত।
সিমুলেটরে আপনার ক্রিয়া পরীক্ষা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে, নিম্নলিখিত কমান্ডটি চালান:
gactions deploy preview
আপনি নিম্নলিখিত মত দেখায় যে আউটপুট গ্রহণ করা উচিত:
✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview
- প্রদত্ত URL অনুলিপি করুন এবং একটি ব্রাউজারে পেস্ট করুন।
- আপনাকে সিমুলেটরে নিয়ে যেতে টেস্টে ক্লিক করুন।
- ইনপুট ফিল্ডে
Talk to my test app
টাইপ করুন এবংEnter
টিপুন। আপনার অ্যাকশনMain invocation
প্রম্পট এবং যোগ করাStart
সিন প্রম্পটের সাথে সাড়া দেওয়া উচিত, "আপনি আপনার অনুসন্ধান চালিয়ে যাওয়ার আগে, আপনি কি আপনার ভাগ্য জানাতে চান?" , সাজেশন চিপস সহ প্রদর্শিত হয়।
নিম্নলিখিত স্ক্রিনশট এই মিথস্ক্রিয়া দেখায়:
- প্রম্পটে প্রতিক্রিয়া জানাতে হ্যাঁ বা না পরামর্শ চিপে ক্লিক করুন। (আপনি "হ্যাঁ" বা "না" বলতে পারেন বা ইনপুট ক্ষেত্রে
Yes
বাNo
লিখতে পারেন৷)
আপনি যখন প্রম্পটে সাড়া দেন, আপনার অ্যাকশন একটি বার্তার সাথে প্রতিক্রিয়া জানায় যে এটি আপনার ইনপুট বুঝতে পারে না: "দুঃখিত, আমি এটি ধরতে পারিনি। আপনি আবার চেষ্টা করতে পারেন?" যেহেতু আপনি এখনও "হ্যাঁ" বা "না" ইনপুট বোঝার এবং প্রতিক্রিয়া জানাতে আপনার অ্যাকশন কনফিগার করেননি, তাই আপনার অ্যাকশন আপনার ইনপুটের সাথে NO_MATCH
উদ্দেশ্যের সাথে মেলে।
ডিফল্টরূপে, NO_MATCH
সিস্টেমের অভিপ্রায় জেনেরিক প্রতিক্রিয়া প্রদান করে, তবে আপনি ব্যবহারকারীকে নির্দেশ করতে এই প্রতিক্রিয়াগুলি কাস্টমাইজ করতে পারেন যে আপনি তাদের ইনপুট বুঝতে পারেন নি। সহকারী আপনার অ্যাকশনের সাথে ব্যবহারকারীর কথোপকথন শেষ করে যখন এটি ব্যবহারকারীর ইনপুট তিনবার মেলে না।
yes
এবং no
ইন্টেন্ট যোগ করুন
এখন যেহেতু ব্যবহারকারীরা আপনার অ্যাকশন পোজ করা প্রশ্নের উত্তর দিতে পারে, আপনি ব্যবহারকারীদের প্রতিক্রিয়া বোঝার জন্য আপনার অ্যাকশন কনফিগার করতে পারেন ( "হ্যাঁ" বা "না" )। নিম্নলিখিত বিভাগগুলিতে, আপনি কাস্টম ইন্টেন্টগুলি তৈরি করেন যা ব্যবহারকারী যখন "হ্যাঁ" বা "না" বলে তখন মিলে যায় এবং এই অভিপ্রায়গুলি Start
দৃশ্যে যুক্ত করুন৷
yes
অভিপ্রায় তৈরি করুন
yes
অভিপ্রায় তৈরি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে,
custom
ডিরেক্টরিতেintents
নামে একটি নতুন ডিরেক্টরি তৈরি করুন:
mkdir custom/intents
-
intents
ডিরেক্টরিতেyes.yaml
নামে একটি নতুন ফাইল তৈরি করুন:
touch custom/intents/yes.yaml
- আপনার টেক্সট এডিটরে
yes.yaml
খুলুন। - প্রশিক্ষণ বাক্যাংশ সম্বলিত নিম্নলিখিত কোড স্নিপেটটি
yes.yaml
এ আটকান:
হ্যাঁ.ইয়ামল
trainingPhrases:
- of course
- let's do it
- ok
- sure
- "y"
- "yes"
- ফাইলটি সংরক্ষণ করুন।
Start
দৃশ্যে yes
অভিপ্রায় যোগ করুন
এখন, অ্যাকশন বুঝতে পারে যখন একজন ব্যবহারকারী "হ্যাঁ" অভিপ্রায় প্রকাশ করেন। আপনি Start
দৃশ্যে yes
কাস্টম অভিপ্রায় যোগ করতে পারেন, যেহেতু ব্যবহারকারী Start
প্রম্পটে সাড়া দিচ্ছেন (" আপনি আপনার অনুসন্ধান চালিয়ে যাওয়ার আগে, আপনি কি আপনার ভাগ্য জানাতে চান?" )।
Start
দৃশ্যে এই কাস্টম অভিপ্রায় যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার টেক্সট এডিটরে
custom/scenes/Start.yaml
খুলুন। -
Start.yaml
ফাইলের শেষেintentEvents
এবংyes
হ্যান্ডলার যোগ করুন:
স্টার্ট.ইয়ামল
intentEvents:
- handler:
staticPrompt:
candidates:
- promptResponse:
firstSimple:
variants:
- speech: Your future depends on the item you choose to use for your quest. Choose wisely! Farewell, stranger.
intent: "yes"
transitionToScene: actions.scene.END_CONVERSATION
যখন yes
অভিপ্রায় মিলে যায়, তখন প্রম্পট "আপনার ভবিষ্যত নির্ভর করে আপনার অনুসন্ধানের জন্য যে আইটেমটি ব্যবহার করতে চান তার উপর..." প্রম্পট সারিতে যোগ করা হয়। Start
দৃশ্য তারপর actions.scene.END_CONVERSATION
এ রূপান্তরিত হয়।END_CONVERSATION সিস্টেম দৃশ্য, যা প্রম্পট সারিতে প্রম্পট সরবরাহ করে এবং কথোপকথন শেষ করে।
সিমুলেটরে yes
অভিপ্রায় পরীক্ষা করুন
এই মুহুর্তে, আপনার অ্যাকশন বুঝতে পারে যখন ব্যবহারকারী তাদের ভাগ্য শুনতে চায় এবং উপযুক্ত প্রতিক্রিয়া প্রদান করে।
সিমুলেটরে এই অভিপ্রায় পরীক্ষা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে, নিম্নলিখিত কমান্ডটি চালান:
gactions deploy preview
আপনি নিম্নলিখিত মত দেখায় যে আউটপুট গ্রহণ করা উচিত:
✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview
- প্রদত্ত URL অনুলিপি করুন এবং একটি ব্রাউজারে পেস্ট করুন।
- আপনাকে সিমুলেটরে নিয়ে যেতে টেস্টে ক্লিক করুন।
- সিমুলেটরে আপনার অ্যাকশন পরীক্ষা করতে, ইনপুট ফিল্ডে
Talk to my test app
টাইপ করুন এবংEnter
টিপুন। - ইনপুট ক্ষেত্রে
Yes
টাইপ করুন এবংEnter
টিপুন। বিকল্পভাবে, হ্যাঁ পরামর্শ চিপে ক্লিক করুন।
আপনার অ্যাকশন ব্যবহারকারীকে সাড়া দেয় এবং তাদের বলে যে তাদের ভাগ্য নির্ভর করে তারা যে সহায়তা বেছে নেয় তার উপর। আপনার অ্যাকশনটি সেশনটি শেষ করে কারণ আপনি yes
অভিপ্রায়ের জন্য End conversation
রূপান্তরটি কনফিগার করেছেন।
কোনো অভিপ্রায় তৈরি করবেন no
এখন, আপনি no
ইন্টেন্ট তৈরি করতে পারেন যাতে আপনার অ্যাকশন বুঝতে পারে এবং ব্যবহারকারী যখন তাদের ভাগ্য শুনতে চায় না তখন তাদের প্রতিক্রিয়া জানাতে পারে।
এই অভিপ্রায় তৈরি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে,
intents
ডিরেক্টরিতেno.yaml
নামে একটি নতুন ফাইল তৈরি করুন:
touch custom/intents/no.yaml
- আপনার টেক্সট এডিটরে
no.yaml
খুলুন। -
no.yaml
ফাইলে নিম্নলিখিত প্রশিক্ষণ বাক্যাংশ পেস্ট করুন:
no.yaml
trainingPhrases:
- nope
- I don't want
- "n"
- "no"
- nah
- no thanks
- ফাইলটি সংরক্ষণ করুন।
Start
দৃশ্যে কোন অভিপ্রায় যোগ করবেন no
এখন, অ্যাকশন বুঝতে পারে যখন একজন ব্যবহারকারী "না" বা "না" এর মত কিছু প্রকাশ করছে, যেমন "না" । আপনাকে Start
দৃশ্যে no
কাস্টম উদ্দেশ্য যোগ করতে হবে কারণ ব্যবহারকারী Start
প্রম্পটে সাড়া দিচ্ছেন (" আপনি আপনার অনুসন্ধান চালিয়ে যাওয়ার আগে, আপনি কি আপনার ভাগ্য জানাতে চান?" )।
Start
দৃশ্যের জন্য এই অভিপ্রায় যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার টেক্সট এডিটরে
custom/scenes/Start.yaml
খুলুন। -
Start.yaml
এyes
হ্যান্ডলারের নীচে নিম্নলিখিতno
হ্যান্ডলার যোগ করুন:
স্টার্ট.ইয়ামল
- handler:
staticPrompt:
candidates:
- promptResponse:
firstSimple:
variants:
- speech: I understand, stranger. Best of luck on your quest! Farewell.
intent: "no"
transitionToScene: actions.scene.END_CONVERSATION
- ফাইলটি সংরক্ষণ করুন।
সিমুলেটরে কোন উদ্দেশ্য পরীক্ষা করবেন no
এই মুহুর্তে, আপনার অ্যাকশন বুঝতে পারে যখন ব্যবহারকারী তাদের ভাগ্য শুনতে চায় না এবং উপযুক্ত প্রতিক্রিয়া ফেরত দেয়।
সিমুলেটরে এই অভিপ্রায় পরীক্ষা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে, নিম্নলিখিত কমান্ডটি চালান:
gactions deploy preview
আপনি নিম্নলিখিত মত দেখায় যে আউটপুট গ্রহণ করা উচিত:
✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview
- প্রদত্ত URL অনুলিপি করুন এবং একটি ব্রাউজারে পেস্ট করুন।
- আপনাকে সিমুলেটরে নিয়ে যেতে টেস্টে ক্লিক করুন।
- ইনপুট ফিল্ডে
Talk to my test app
টাইপ করুন এবংEnter
টিপুন। - ইনপুট ক্ষেত্রে
No
টাইপ করুন এবংEnter
টিপুন। বিকল্পভাবে,No
সাজেশন চিপে ক্লিক করুন।
ব্যবহারকারীকে তাদের ভাগ্য দেওয়ার পরিবর্তে, আপনার অ্যাকশন তাদের যাত্রায় সৌভাগ্য কামনা করে। আপনার অ্যাকশনটি সেশনটি শেষ করে কারণ আপনি কোন উদ্দেশ্য no
End conversation
রূপান্তরটি কনফিগার করেছেন।
5. পূর্ণতা বাস্তবায়ন
বর্তমানে, আপনার অ্যাকশনের প্রতিক্রিয়া স্থির; যখন একটি প্রম্পট সম্বলিত একটি দৃশ্য সক্রিয় করা হয়, তখন আপনার অ্যাকশন প্রতিবার একই প্রম্পট পাঠায়। এই বিভাগে, আপনি একটি গতিশীল কথোপকথনমূলক প্রতিক্রিয়া তৈরি করার যুক্তি ধারণ করে পরিপূর্ণতা বাস্তবায়ন করেন।
আপনার পূর্ণতা সনাক্ত করে যে ব্যবহারকারী একজন প্রত্যাবর্তনকারী ব্যবহারকারী বা একজন নতুন ব্যবহারকারী এবং ফিরে আসা ব্যবহারকারীদের জন্য অ্যাকশনের শুভেচ্ছা বার্তা পরিবর্তন করে। অভিবাদন বার্তাটি ফিরে আসা ব্যবহারকারীদের জন্য সংক্ষিপ্ত করা হয়েছে এবং ব্যবহারকারীর প্রত্যাবর্তন স্বীকার করে: " একটি বিস্ময়কর অভিবাদন, দুঃসাহসিক! গ্রিফিনবার্গের পৌরাণিক ভূমিতে আবার স্বাগতম!"
এই কোডল্যাবের জন্য, আপনি ক্লাউড ফাংশন এডিটর ব্যবহার করে আপনার পূর্ণতা কোড সম্পাদনা করতে এবং স্থাপন করেন।
আপনার অ্যাকশন ওয়েবহুকগুলিকে ট্রিগার করতে পারে যা একটি ইভেন্টের পূর্ণতা সম্পর্কে অবহিত করে যা একটি আমন্ত্রণ বা দৃশ্য সম্পাদনের নির্দিষ্ট অংশগুলির সময় ঘটে। যখন একটি ওয়েবহুক ট্রিগার করা হয়, তখন আপনার অ্যাকশন একটি JSON পেলোড সহ একটি অনুরোধ পাঠায় এবং ইভেন্টটি প্রক্রিয়া করার জন্য হ্যান্ডলারের নাম সহ আপনার পূরণের জন্য। এই হ্যান্ডলার কিছু যুক্তি বহন করে এবং একটি সংশ্লিষ্ট JSON প্রতিক্রিয়া প্রদান করে।
আপনার পরিপূর্ণতা তৈরি করুন
এই বিভাগে, প্রত্যাবর্তনকারী ব্যবহারকারী এবং নতুন ব্যবহারকারীরা যখন আপনার অ্যাকশন শুরু করে তখন তাদের জন্য বিভিন্ন প্রম্পট তৈরি করতে আপনি আপনার পূর্ণতা পরিবর্তন করেন।
আপনার পরিপূর্ণতায় এই যুক্তি যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে, নিশ্চিত করুন যে আপনি আপনার প্রকল্পের রুট ডিরেক্টরিতে আছেন এবং একটি নতুন
webhooks
ডিরেক্টরি তৈরি করুন:
mkdir webhooks
-
webhooks
ডিরেক্টরিতেActionsOnGoogleFulfillment.yaml
নামে একটি নতুন ফাইল তৈরি করুন:
touch webhooks/ActionsOnGoogleFulfillment.yaml
- আপনার টেক্সট এডিটরে
ActionsOnGoogleFulfillment.yaml
খুলুন। -
ActionsOnGoogleFulfillment.yaml
ফাইলেgreeting
হ্যান্ডলার এবংinlineCloudFunction
কন্টেন্ট যোগ করুন:
ActionsOnGoogleFulfillment.yaml
handlers:
- name: greeting
inlineCloudFunction:
executeFunction: ActionsOnGoogleFulfillment
ActionsOnGoogleFulfillment.yaml
ফাইলটি আপনার ওয়েবহুক হ্যান্ডলারকে সংজ্ঞায়িত করে (যেমন greeting
হ্যান্ডলার) এবং আপনার অ্যাকশনকে ক্লাউড ফাংশনকে ওয়েবহুক এন্ডপয়েন্ট হিসেবে ব্যবহার করতে বলে।
-
webhooks
ডিরেক্টরিতে একটি নতুনActionsOnGoogleFulfillment
ডিরেক্টরি তৈরি করুন:
mkdir webhooks/ActionsOnGoogleFulfillment
-
ActionsOnGoogleFulfillment
ডিরেক্টরিতেindex.js
নামে একটি নতুন ফাইল তৈরি করুন:
touch webhooks/ActionsOnGoogleFulfillment/index.js
- আপনার টেক্সট এডিটরে
index.js
খুলুন। -
index.js
এ নিম্নলিখিত কোড যোগ করুন:
index.js
const { conversation } = require('@assistant/conversation');
const functions = require('firebase-functions');
const app = conversation({debug: true});
app.handle('greeting', conv => {
let message = 'A wondrous greeting, adventurer! Welcome back to the mythical land of Gryffinberg!';
if (!conv.user.lastSeenTime) {
message = 'Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you\'re on your way to an epic journey.';
}
conv.add(message);
});
exports.ActionsOnGoogleFulfillment = functions.https.onRequest(app);
এই কোডটি greeting
হ্যান্ডলারকে সংজ্ঞায়িত করে, যা উপযুক্ত অভিবাদন পাঠায়
ব্যবহারকারী
- ফাইলটি সংরক্ষণ করুন।
-
ActionsOnGoogleFulfillment
ডিরেক্টরিতেpackage.json
নামে একটি নতুন ফাইল তৈরি করুন:
touch webhooks/ActionsOnGoogleFulfillment/package.json
package.json
ফাইলটি আপনার ওয়েবহুকের জন্য নির্ভরতা এবং অন্যান্য মেটাডেটা নির্দিষ্ট করে।
- আপনার টেক্সট এডিটরে
package.json
খুলুন। - এই GitHub সংগ্রহস্থল থেকে কোডটি অনুলিপি করুন এবং এটি
package.json
ফাইলে পেস্ট করুন। - ফাইলটি সংরক্ষণ করুন।
কোড বুঝুন
আপনার পূর্ণতা, যেটি Node.js-এর জন্য অ্যাকশন অন Google ফিলফিলমেন্ট লাইব্রেরি ব্যবহার করে, Google অ্যাসিস্ট্যান্ট থেকে HTTP অনুরোধে সাড়া দেয়।
পূর্ববর্তী কোড স্নিপেটে, আপনি greeting
হ্যান্ডলারকে সংজ্ঞায়িত করেন, যা ব্যবহারকারী পূর্বে lastSeenTime
প্রপার্টি সহ অ্যাকশন পরিদর্শন করেছে কিনা তা পরীক্ষা করে। lastSeenTime
সম্পত্তি সংজ্ঞায়িত না হলে, ব্যবহারকারী নতুন এবং নতুন ব্যবহারকারীদের উদ্দেশ্যে অভিবাদন গ্রহণ করে। অন্যথায়, বার্তাটি ব্যবহারকারীর প্রত্যাবর্তন স্বীকার করে এবং একটি পরিবর্তিত অভিবাদন তৈরি করে।
একটি ওয়েবহুক ট্রিগার করতে প্রধান আহ্বান আপডেট করুন
এখন যেহেতু আপনি greeting
ফাংশনটি সংজ্ঞায়িত করেছেন, আপনি আপনার প্রধান আহ্বানের অভিপ্রায়ে greeting
ইভেন্ট হ্যান্ডলারকে কনফিগার করতে পারেন যাতে ব্যবহারকারী আপনার অ্যাকশনকে আহ্বান করলে আপনার অ্যাকশন এই ফাংশনটিকে কল করতে জানে৷
নতুন greeting
হ্যান্ডলারকে কল করার জন্য আপনার অ্যাকশন কনফিগার করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার টেক্সট এডিটরে
custom/global/actions.intent.MAIN.yaml
খুলুন। - নিম্নলিখিত কোড দিয়ে
actions.intent.MAIN.yaml
এ কোডটি প্রতিস্থাপন করুন:
actions.intent.MAIN.yaml
handler:
webhookHandler: greeting
transitionToScene: Start
- ফাইলটি সংরক্ষণ করুন।
এখন, যখন আপনার মূল আহ্বানের অভিপ্রায় মিলে যায়, তখন greeting
ওয়েবহুক হ্যান্ডলারকে ডাকা হয়।
সিমুলেটরে প্রধান আহ্বান পরীক্ষা করুন
সিমুলেটরে আপনার ক্রিয়া পরীক্ষা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে, নিম্নলিখিত কমান্ডটি চালান:
gactions deploy preview
আপনি নিম্নলিখিত মত দেখায় যে আউটপুট গ্রহণ করা উচিত:
✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview
- প্রদত্ত URL অনুলিপি করুন এবং একটি ব্রাউজারে পেস্ট করুন।
- সিমুলেটরে আপনার অ্যাকশন পরীক্ষা করতে, ইনপুট ফিল্ডে
Talk to my test app
টাইপ করুন এবংEnter
টিপুন।
যেহেতু আপনি এই কোডল্যাবে আগে আপনার অ্যাকশন পরীক্ষা করেছেন, আপনি একজন নতুন ব্যবহারকারী নন, তাই আপনি নিম্নলিখিত সংক্ষিপ্ত অভিবাদন পেয়েছেন: " একটি বিস্ময়কর অভিবাদন, দুঃসাহসিক! গ্রিফিনবার্গের পৌরাণিক দেশে আবার স্বাগতম!..."
6. অ্যাকশন বিল্ডারের সাথে অ্যাকশন ভিজ্যুয়ালাইজ করুন
অ্যাকশন SDK-এর একটি ওয়েব-ভিত্তিক IDE-এর সাথে আন্তঃঅপারেবিলিটি রয়েছে যাকে বলা হয় অ্যাকশন বিল্ডার যা অ্যাকশন কনসোলে একত্রিত করা হয়েছে। আপনি gactions push
কমান্ডের সাহায্যে কনসোলে আপনার স্থানীয় ফাইল সিস্টেমকে আপনার অ্যাকশনের খসড়াতে পুশ করতে পারেন। gactions deploy preview
থেকে ভিন্ন, যা আপনাকে শুধুমাত্র সিমুলেটরে আপনার অ্যাকশন পরীক্ষা করার অনুমতি দেয়, gactions push
আপনার স্থানীয় ফাইল থেকে অ্যাকশন বিল্ডারে সমস্ত বিষয়বস্তু নিয়ে যায়।
অ্যাকশন কনসোল আপনার অ্যাকশন কনফিগারেশনের একটি ভিজ্যুয়াল উপস্থাপনা প্রদান করে। আপনার অ্যাকশনকে দৃশ্যমানভাবে ম্যাপ করা দেখা বিকাশের সময় উপযোগী হতে পারে এবং আপনার অ্যাকশনের সংস্করণকে প্রভাবিত করে না যা পরীক্ষার জন্য পরিবেশিত হয়।
আপনার অ্যাকশন প্রকল্পটি পুশ করতে এবং এটিকে অ্যাকশন কনসোলে দেখতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- টার্মিনালে, আপনার প্রোজেক্টকে অ্যাকশন কনসোলে পুশ করতে নিম্নলিখিত কমান্ডটি চালান:
gactions push
আপনি নিম্নলিখিত মত দেখায় যে আউটপুট গ্রহণ করা উচিত:
✔ Done. Files were pushed to Actions Console, and you can now view your project with this URL: https://console.actions.google.com/project/{project-id}/overview. If you want to test your changes, run "gactions deploy preview", or navigate to the Test section in the Console.
- প্রদত্ত URL অনুলিপি করুন এবং একটি ব্রাউজারে পেস্ট করুন।
- অ্যাকশন কনসোলে , উপরের নেভিগেশন বারে বিকাশে ক্লিক করুন।
- দৃশ্যের পাশের ড্রপ-ডাউন তীরটিতে ক্লিক করুন এবং শুরুতে ক্লিক করুন। আপনি আপনার অ্যাকশনের
Start
দৃশ্যের একটি ভিজ্যুয়াল উপস্থাপনা দেখতে পাবেন, যেমনটি নিম্নলিখিত স্ক্রিনশটে দেখানো হয়েছে:
আপনার প্রকল্প পরিষ্কার করুন [প্রস্তাবিত]
সম্ভাব্য চার্জ এড়াতে, আপনি যে প্রকল্পগুলি ব্যবহার করতে চান না সেগুলি সরিয়ে ফেলার সুপারিশ করা হয়৷ এই কোডল্যাবে আপনার তৈরি করা প্রকল্পগুলি মুছতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- ক্লাউড প্রকল্প এবং সংস্থানগুলি মুছতে, প্রকল্পগুলি বন্ধ করা (মুছে ফেলা) বিভাগে তালিকাভুক্ত পদক্ষেপগুলি সম্পূর্ণ করুন৷
- ঐচ্ছিক: অবিলম্বে অ্যাকশন কনসোল থেকে আপনার প্রকল্পটি সরাতে, একটি প্রকল্প মুছুন বিভাগে তালিকাভুক্ত পদক্ষেপগুলি সম্পূর্ণ করুন। আপনি যদি এই ধাপটি সম্পূর্ণ না করেন, আপনার প্রকল্পটি প্রায় 30 দিন পরে স্বয়ংক্রিয়ভাবে সরানো হবে৷
7. অভিনন্দন!
অ্যাকশন SDK-এর সাহায্যে Google অ্যাসিস্ট্যান্টের জন্য অ্যাকশন তৈরি করার প্রাথমিক বিষয়গুলি আপনি জানেন।
আপনি কি আচ্ছাদিত
- অ্যাকশন কনসোলে কীভাবে একটি অ্যাকশন প্রকল্প সেট আপ করবেন
- আপনার স্থানীয় ফাইল সিস্টেমে আপনার অ্যাকশন প্রকল্প তৈরি করতে অ্যাকশন SDK কীভাবে ব্যবহার করবেন
- মূল আহ্বানে কীভাবে একটি প্রম্পট যুক্ত করবেন যাতে ব্যবহারকারীরা আপনার অ্যাকশনের সাথে একটি কথোপকথন শুরু করতে পারে
- দৃশ্য, অভিপ্রায়, ট্রানজিশন, সাজেশন চিপস এবং পূর্ণতা সহ একটি কথোপকথনমূলক ইন্টারফেস কীভাবে তৈরি করবেন
- অ্যাকশন সিমুলেটর দিয়ে কীভাবে আপনার অ্যাকশন পরীক্ষা করবেন
আরও জানুন
Google সহকারীর জন্য অ্যাকশন তৈরির বিষয়ে আরও জানতে নিম্নলিখিত সংস্থানগুলি অন্বেষণ করুন:
- Google অ্যাসিস্ট্যান্টের জন্য অ্যাকশন তৈরির অফিসিয়াল ডকুমেন্টেশন সাইট
- নমুনা কোড এবং লাইব্রেরির জন্য Google GitHub পৃষ্ঠায় অ্যাকশন
- সহকারীর সাথে কাজ করা বিকাশকারীদের জন্য অফিসিয়াল Reddit সম্প্রদায়
সর্বশেষ ঘোষণার জন্য টুইটারে @ActionsOnGoogle অনুসরণ করুন এবং আপনি যা তৈরি করেন তা শেয়ার করতে #AoGDevs- এর সাথে টুইট করুন!
প্রতিক্রিয়া সমীক্ষা
আপনি যাওয়ার আগে, আপনার অভিজ্ঞতা সম্পর্কে একটি সংক্ষিপ্ত জরিপ পূরণ করুন.