প্রম্পট

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

প্রতিক্রিয়ার ধরন

প্রতিটি প্রম্পটের জন্য, ব্যবহারকারীদের কাছে উপস্থাপন করার জন্য Assistant-এর জন্য আপনি বিভিন্ন ধরনের আকর্ষক প্রতিক্রিয়ার ধরন থেকে বেছে নিন:

  • সরল প্রতিক্রিয়া : সরল প্রতিক্রিয়াগুলি দৃশ্যত চ্যাট বাবলের আকার নেয় এবং শব্দের জন্য পাঠ্য-টু-স্পীচ (TTS) বা স্পিচ সিন্থেসিস মার্কআপ ল্যাঙ্গুয়েজ (SSML) ব্যবহার করে। সহজ প্রতিক্রিয়াগুলি হল একমাত্র প্রতিক্রিয়া যা সমস্ত ডিভাইসের প্রকারে সমর্থিত৷
  • সমৃদ্ধ প্রতিক্রিয়া : সমৃদ্ধ প্রতিক্রিয়াগুলিতে ভিজ্যুয়াল বা কার্যকরী উপাদান থাকে যা আপনার অ্যাকশনগুলির সাথে ব্যবহারকারীর মিথস্ক্রিয়াকে উন্নত করে। সমৃদ্ধ প্রতিক্রিয়া সহ, আপনি ট্যাবুলার ডেটা প্রদর্শন করতে পারেন বা দীর্ঘ আকারের অডিও সামগ্রী চালাতে পারেন।
  • ভিজ্যুয়াল সিলেকশন রেসপন্স : ভিজ্যুয়াল সিলেকশন রেসপন্স ব্যবহারকারীদের একাধিক বিকল্পের মধ্যে বেছে নেওয়ার জন্য একটি ভিজ্যুয়াল ইন্টারফেস প্রদান করে যা তাদের শিরোনাম বা ছবি দ্বারা সবচেয়ে সহজে আলাদা করা যায়।
  • মিডিয়া প্রতিক্রিয়া : মিডিয়া প্রতিক্রিয়াগুলি আপনার অ্যাকশনগুলিকে SSML-এর তুলনায় অডিও সামগ্রীর আকারে দীর্ঘায়িত করতে দেয় এবং মিডিয়া নিয়ন্ত্রণের সাথে একটি ভিজ্যুয়াল উপাদান সরবরাহ করে।
  • ইন্টারেক্টিভ ক্যানভাস : ইন্টারেক্টিভ ক্যানভাস প্রতিক্রিয়াগুলিকে পূর্ণ-স্ক্রীন ওয়েব ভিউ এবং ফাংশনগুলিকে একটি ইন্টারেক্টিভ ওয়েব অ্যাপ হিসাবে রেন্ডার করে যা সহকারী কথোপকথনে ব্যবহারকারীকে প্রতিক্রিয়া হিসাবে পাঠায়। HTML, CSS, এবং JavaScript এর মত ওয়েব স্ট্যান্ডার্ড থেকে অতিরিক্ত নমনীয়তা মিটমাট করার জন্য ক্যানভাস একটি সামান্য ভিন্ন প্রম্পট ফর্ম্যাট ব্যবহার করে।

এই প্রতিক্রিয়া প্রকারগুলির প্রতিটি একই বেস প্রম্পট ফর্ম্যাট ব্যবহার করে এবং নীচে বর্ণিত একই সাধারণ বৈশিষ্ট্যগুলিতে অ্যাক্সেস রয়েছে।

একটি প্রম্পটের বিন্যাস

আপনার অ্যাকশন প্রকল্পে, আপনি YAML বা JSON ফর্ম্যাটে প্রম্পট সংজ্ঞায়িত করেন। প্রতিটি প্রম্পটে দুটি সহজ প্রতিক্রিয়া থাকতে পারে এবং ঐচ্ছিকভাবে একটি সমৃদ্ধ প্রতিক্রিয়া সংজ্ঞায়িত করতে পারে। প্রতিক্রিয়া নিম্নলিখিত উপায়ে সংজ্ঞায়িত করা হয়:

  • first_simple : ব্যবহারকারীকে পাঠানোর জন্য প্রাথমিক পাঠ্য বা বক্তৃতা (সহজ) প্রতিক্রিয়া।
  • content : সাধারণ প্রতিক্রিয়ার পরে পাঠানোর জন্য সম্পূরক সমৃদ্ধ প্রতিক্রিয়া সামগ্রী।
  • last_simple ব্যবহারকারীকে পাঠানোর জন্য চূড়ান্ত পাঠ বা বক্তৃতা (সরল) প্রতিক্রিয়া।
  • canvas : ইন্টারেক্টিভ ক্যানভাসের সাথে সংহত একটি ওয়েব অ্যাপের উল্লেখ করে।

ডিফল্টরূপে, প্রম্পটগুলি একটি প্রম্পট সারিতে উপরের ক্রমে একে অপরের সাথে যুক্ত করা হয়। ব্যবহারকারীর প্রতিক্রিয়া জানানোর আগে, সহকারী ব্যবহারকারীকে প্রম্পট সারিতে সমস্ত প্রম্পট সহ উপস্থাপন করে।

আপনি অতিরিক্তভাবে নিম্নলিখিত বৈশিষ্ট্যগুলি ব্যবহার করে প্রম্পটে নমনীয়তা প্রদান করেন:

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

একটি ডিফল্ট প্রম্পট একটি প্রার্থী, একটি বৈকল্পিক এবং একটি first_simple প্রতিক্রিয়া ব্যবহার করে।

প্রার্থী

একটি প্রম্পটে, candidates অবজেক্ট আপনাকে ব্যবহারকারীর ডিভাইসের ক্ষমতার উপর ভিত্তি করে প্রতিক্রিয়া সংজ্ঞায়িত করতে দেয়। উদাহরণ স্বরূপ, আপনি শুধুমাত্র তখনই অ্যাসিস্ট্যান্ট ডিসপ্লে সমৃদ্ধ প্রতিক্রিয়া পেতে পারেন যখন কোনো ব্যবহারকারী ডিসপ্লে-সক্ষম ডিভাইসে আপনার অ্যাকশনের সাথে ইন্টারঅ্যাক্ট করে। ডিভাইসের ধরন নির্ধারণ করতে যেখানে Assistant একজন প্রার্থীকে ফেরত দিতে পারে, candidates অবজেক্টের selector প্রপার্টি ব্যবহার করুন।

নীচের উদাহরণে, selector বৈশিষ্ট্যে ডিভাইসের ক্ষমতার তথ্য রয়েছে। প্রথম প্রার্থীতে সেট করা প্রম্পটগুলি এমন একটি ডিভাইসে ব্যবহারকারীদের কাছে পাঠানো হয় যা সমৃদ্ধ প্রতিক্রিয়া প্রদান করতে পারে। দ্বিতীয় প্রার্থীটিতে ব্যবহারকারীদের জন্য প্রম্পট রয়েছে যা শুধুমাত্র পাঠ্য এবং বক্তৃতা প্রতিক্রিয়া পেতে পারে।

YAML

candidates:
  - selector:
      surface_capabilities:
        capabilities:
          - RICH_RESPONSE
    first_simple:
      variants:
        - speech: Here's a simple message.
    content:
      card:
        title: Image card title
        text: Some details about the image
        image:
          url: 'https://www.example.com/image/'
  - first_simple:
      variants:
        - speech: Text explains what the image might have shown in more detail.
    

JSON

{
  "candidates": [{
    "selector": {
      "surface_capabilities": {
        "capabilities": ["RICH_RESPONSE"]
      }
    },
    "first_simple": {
      "variants": [{
        "speech": "Here's a simple message."
      }]
    },
    "content": {
      "card": {
        "title": "Image card title",
        "text": "Some details about the image",
        "image": {
          "url": "https://www.example.com/image/"
        }
      }
    }
  }, {
    "first_simple": {
      "variants": [{
        "speech": "Text explains what the image might have shown in more detail."
      }]
    }
  }]
}
    

আপনি একটি প্রদত্ত প্রার্থীর জন্য এক বা একাধিক ক্ষমতা প্রয়োজনীয়তা প্রদান করতে পারেন। নিম্নলিখিত তালিকা উপলব্ধ ক্ষমতা প্রয়োজনীয়তা প্রতিটি বর্ণনা করে:

  • SPEECH : ডিভাইসটি টেক্সট-টু-স্পিচ বা SSML এর মাধ্যমে ব্যবহারকারীর সাথে কথা বলতে পারে।
  • RICH_RESPONSE : ডিভাইসটি কার্ড, তালিকা এবং টেবিলের মতো সমৃদ্ধ প্রতিক্রিয়া প্রদর্শন করতে পারে।
  • LONG_FORM_AUDIO : ডিভাইসটি দীর্ঘ ফর্মের অডিও মিডিয়া যেমন সঙ্গীত এবং পডকাস্ট চালাতে পারে৷
  • INTERACTIVE_CANVAS : ডিভাইস একটি ইন্টারেক্টিভ ক্যানভাস প্রতিক্রিয়া প্রদর্শন করতে পারে।
  • WEB_LINK : একটি ওয়েব ব্রাউজার খুলতে ডিভাইসটি সমৃদ্ধ প্রতিক্রিয়ায় ওয়েব লিঙ্ক ব্যবহার করতে পারে।
  • HOME_STORAGE : ডিভাইসটি বাড়ির স্টোরেজ থেকে ডেটা সংরক্ষণ এবং অ্যাক্সেস করতে পারে।

বৈকল্পিক

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

উদাহরণ স্বরূপ, স্বাগত বার্তার ভিন্ন ভিন্ন রূপ প্রদান করুন যাতে ব্যবহারকারীরা প্রতিবার আপনার ক্রিয়াকে আহ্বান করার সময় একই প্রতিক্রিয়া শুনতে না পায়:

YAML

candidates:
  - first_simple:
      variants:
        - speech: Hello.
        - speech: Hi there.
        - speech: Welcome.
    

JSON

{
  "candidates": [{
    "first_simple": {
      "variants": [{
        "speech": "Hello."
      },{
        "speech": "Hi there."
      },{
        "speech": "Welcome."
      }]
    }
  }]
}
    

পরামর্শ

একটি স্মার্ট ডিসপ্লেতে সাজেশন চিপসের উদাহরণ

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

আপনার কাছে একটি একক প্রম্পটে সর্বাধিক 8 টি পরামর্শ থাকতে পারে, প্রতিটিতে সর্বোচ্চ 25টি প্লেইনটেক্সট অক্ষর রয়েছে।

একটি সাজেশন যোগ করতে, একটি Suggestion অবজেক্ট প্রদান করুন যাতে একটি আলাদা title ক্ষেত্রে প্রতিটি পরামর্শ থাকে। প্রতিটি শিরোনাম সাজেশন চিপ সেটের মধ্যে অনন্য হতে হবে। অ্যাকশন বিল্ডারে, এই অবজেক্টটি YAML এবং JSON-এ suggestions হিসাবে উপস্থাপন করা হয়েছে।

উদাহরণস্বরূপ, আপনি একটি প্রশ্নের পাশাপাশি "হ্যাঁ" এবং "না" পরামর্শ প্রদান করতে পারেন:

YAML

candidates:
  - first_simple:
      variants:
        - speech: 'Welcome, do you want to play a game?'
    suggestions:
      - title: 'Yes'
      - title: 'No'
    

JSON

{
  "candidates": [{
    "first_simple": {
      "variants": [{
        "speech": "Welcome, do you want to play a game?"
      }]
    },
    "suggestions": [{
      "title": "Yes"
    }, {
      "title": "No"
    }]
  }]
}