এই ডকুমেন্টটি Actions on Google এবং একটি পরিপূর্ণতা পরিষেবার মধ্যে যোগাযোগের জন্য ওয়েবহুক ফর্ম্যাট বর্ণনা করে যা একটি কাস্টম কথোপকথনমূলক ব্যবহারকারী ইন্টারফেসকে সংজ্ঞায়িত করে।
Actions on Google এবং আপনার পূর্ণতা কীভাবে Actions on Google ওয়েবহুক ফর্ম্যাটের মাধ্যমে যোগাযোগ করে তা বোঝা গুরুত্বপূর্ণ:
- Actions on Google-এর সাথে কথোপকথনে অংশগ্রহণ করার জন্য, আপনার পূর্ণতা একটি ওয়েবহুক প্রয়োগ করে যা Actions on Google-এর HTTP অনুরোধে সাড়া দিতে পারে।
- যখন ব্যবহারকারীরা আপনার অ্যাকশন শুরু করেন, তখন আপনার পূর্ণতা একটি JSON পেলোড সহ একটি
HTTP POSTপায় যা ব্যবহারকারীর অনুরোধ বর্ণনা করে। - পরিবর্তে, অনুরোধ পেলোড থেকে প্যারামিটারগুলি পড়ার জন্য, একটি উপযুক্ত JSON ফর্ম্যাট করা প্রতিক্রিয়া তৈরি করা এবং এই প্রতিক্রিয়া সহ সহকারীকে একটি উত্তর পাঠানোর জন্য আপনার পূর্ণতা দায়ী।
অনুরোধের ধরন
এই সারণীটি আপনার ওয়েবহুক সহকারীর কাছ থেকে যে ধরনের অনুরোধ পেতে পারে তার সংক্ষিপ্ত বিবরণ দেয়:
| টাইপ | বর্ণনা | JSON উদাহরণ |
|---|---|---|
| আমন্ত্রণ অনুরোধ | ব্যবহারকারীর উচ্চারণ যা আপনার পূর্ণতার সাথে কথোপকথন শুরু করে বা গভীর-লিঙ্ক অ্যাকশন ট্রিগার করে (উদাহরণস্বরূপ, "রাতের খাবারের রেসিপি খুঁজতে ব্যক্তিগত শেফের সাথে কথা বলুন" )।
| |
| কথোপকথনের অনুরোধ | আপনার পূর্ণতার সাথে কথোপকথন শুরু হয়ে গেলে একই সেশনে ব্যবহারকারীদের দ্বারা উচ্চারণ। কথোপকথনের ওয়েবহুক ফরম্যাটে, এগুলি হল ব্যবহারকারীর কাছ থেকে আসা কাঁচা টেক্সট প্রতিক্রিয়া যা actions.intent.TEXT ইন্টেন্টের সাথে সম্পর্কিত যা আপনার পূর্ববর্তী বারে পূরণ করার অনুরোধ করা হয়েছিল। | |
| সাহায্যকারী ফলাফল | আপনার ওয়েবহুক কথোপকথনের কিছু অংশ (উদাহরণস্বরূপ, actions.intent.OPTION এবং actions.intent.PERMISSION ) পরিচালনা করার জন্য কথোপকথনের আগের মোড়তে সাহায্যকারী অভিপ্রায়ের অনুরোধ করলে আপনার পূরণের জন্য সহকারীর দ্বারা পাঠানো অনুরোধগুলি। |
কথোপকথনের অনুরোধ এবং প্রতিক্রিয়া
একটি সাধারণ অ্যাকশন অন গুগল ইন্টারঅ্যাকশন দৃশ্যে, ব্যবহারকারীরা একটি অ্যাকশন আহ্বান করতে একটি বাক্যাংশ উচ্চারণ করে। একটি প্রতিক্রিয়া প্রদান করার জন্য, অ্যাকশন অন Google ব্যবহারকারীর দ্বারা আহ্বান করা অ্যাকশনের সাথে মেলে এমন পরিপূর্ণতা খুঁজে পায় এবং সেখানে অনুরোধ পাঠায়।
একবার অ্যাকশনস অন Google প্রতিষ্ঠিত করে যে আপনার পূর্ণতা ব্যবহারকারীর আহ্বানের জন্য উপযুক্ত মিল, এটি একটি HTTP অনুরোধ পাঠিয়ে একটি কথোপকথন সেশন শুরু করে যাতে ব্যবহারকারীর অনুরোধের তথ্য সহ একটি JSON পেলোড থাকে আপনার পূরণের শেষ পয়েন্টে। আপনার পূর্ণতা অনুরোধটি পার্স করে এবং একটি JSON পেলোড ধারণকারী একটি প্রতিক্রিয়া প্রদান করে। গুগলে অ্যাকশন তারপর পেলোডকে ব্যবহারকারীদের জন্য রেন্ডার করা স্পিচ এবং মাল্টিমিডিয়া আউটপুটে রূপান্তর করে।
অ্যাকশনস অন Google যখন অ্যাকশন SDK-এর মাধ্যমে আপনার পূর্ণতাকে আহ্বান করে তখন JSON পেলোডের ফর্ম্যাট সম্পর্কে আরও জানতে, কথোপকথন ওয়েবহুক ফর্ম্যাট দেখুন।
ডায়ালগফ্লো অনুরোধ এবং প্রতিক্রিয়া
আপনি যখন অ্যাকশন তৈরি করেন, তখন আপনি কথোপকথনমূলক ইন্টারফেস তৈরির কাজটি সহজ করতে ডায়ালগফ্লো ব্যবহার করতে পারেন। এই পরিস্থিতিতে, Dialogflow Actions on Google এবং আপনার পূরণের মধ্যে একটি প্রক্সি হিসেবে কাজ করে। HTTP/JSON অনুরোধ সরাসরি আপনার পূরণের এন্ডপয়েন্টে পাঠানোর পরিবর্তে, Actions on Google এটি ডায়ালগফ্লোতে পাঠায়।
ডায়ালগফ্লো মূল অনুরোধে থাকা JSON পেলোডকে ডায়ালগফ্লো ওয়েবহুক ফর্ম্যাটে মুড়ে দেয় এবং ফলস্বরূপ অনুরোধটি আপনার ডায়ালগফ্লো পূরণে ফরোয়ার্ড করে।
বিপরীতভাবে, যখন আপনার পূর্ণতা Dialogflow-এ একটি প্রতিক্রিয়া পাঠায়, তখন প্রতিক্রিয়ার JSON পেলোড অবশ্যই ডায়ালগফ্লো ওয়েবহুক ফর্ম্যাট মেনে চলতে হবে। আপনার পূর্ণতা ডায়ালগফ্লো JSON অনুরোধের প্যারামিটারগুলি পার্স করে এবং ডায়ালগফ্লো ওয়েবহুক ফর্ম্যাটে একটি প্রতিক্রিয়া তৈরি করে। Dialogflow তারপর আপনার পূর্ণতা থেকে প্রতিক্রিয়াটিকে একটি প্রতিক্রিয়া বার্তায় রূপান্তর করে যা সহকারী বুঝতে পারে।
অ্যাকশনস অন Google যখন ডায়ালগফ্লো-এর মাধ্যমে আপনার পূর্ণতাকে আহ্বান করে তখন JSON পেলোডের ফর্ম্যাট সম্পর্কে আরও জানতে, ডায়ালগফ্লো ওয়েবহুক ফর্ম্যাট দেখুন।