আপনার প্রথম এজেন্ট তৈরি করুন

পূর্বশর্ত

আপনার এজেন্ট তৈরি করুন

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

এই কুইকস্টার্টে, আপনি নিম্নলিখিত কাজগুলো করবেন:

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

নমুনা ব্যবহার না করে এজেন্ট তৈরি করতে, আপনার এজেন্ট তৈরি করুন দেখুন।

অংশীদার হিসেবে নিবন্ধন করুন

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোলটি খুলুন।
  2. বিজনেস মেসেজ- এর অধীনে, ক্রিয়েট পার্টনার অ্যাকাউন্ট-এ ক্লিক করুন।

  3. আপনার সঙ্গীর তথ্য প্রবেশ করান:

    মাঠ মূল্য
    আপনার নাম আপনার পুরো নাম
    অংশীদারের নাম আপনার প্রতিষ্ঠানের নাম
    অংশীদার ওয়েবসাইট আপনার সংস্থার ওয়েবসাইট
    অঞ্চল যে অঞ্চলে আপনি ব্যবসায়িক বার্তা পরিষেবাটি হোস্ট করতে চান

  4. বিজনেস মেসেজেস-এর পরিষেবার শর্তাবলী পর্যালোচনা করুন এবং গ্রহণ করুন।

  5. তৈরি করুন- এ ক্লিক করুন।

আপনাকে এখন বিজনেস মেসেজেস পার্টনার হিসেবে নিবন্ধিত করা হয়েছে। আপনার জন্য একটি নতুন গুগল ক্লাউড প্রজেক্ট তৈরি করা হয়েছে, যেখানে বিজনেস মেসেজেস এবং বিজনেস কমিউনিকেশনস এপিআই সক্রিয় করা আছে। এই প্রজেক্টে আপনার কোনো অ্যাক্সেস নেই এবং এটি আপনার বিদ্যমান কোনো গুগল ক্লাউড প্রজেক্টের কাজে হস্তক্ষেপ করবে না।

এখন আপনি বিজনেস মেসেজ এবং বিজনেস কমিউনিকেশন এপিআইগুলো ব্যবহার করতে পারবেন।

একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোল হোম পেজে, পার্টনার অ্যাকাউন্ট সেটিংস-এ ক্লিক করুন।
  2. বাম দিকের নেভিগেশনে, সার্ভিস অ্যাকাউন্ট- এ ক্লিক করুন।

  3. Create key-তে ক্লিক করুন, তারপর Create-এ ক্লিক করুন।

    আপনার ব্রাউজার সার্ভিস অ্যাকাউন্ট কী-টি ডাউনলোড করে। এটি একটি নিরাপদ স্থানে সংরক্ষণ করুন। ভবিষ্যতে একটি ওয়েব অ্যাপ্লিকেশন ডেপ্লয় করতে এবং বিজনেস মেসেজেস ও বিজনেস কমিউনিকেশনস এপিআই অ্যাক্সেস করতে আপনার এই কী-টির প্রয়োজন হবে।

একটি ব্র্যান্ড এবং একজন এজেন্ট তৈরি করুন

এজেন্ট হলো একটি ব্র্যান্ডের কথোপকথনমূলক উপস্থাপনা—সেই কথোপকথনমূলক সত্তা যার সাথে ব্যবহারকারীরা মিথস্ক্রিয়া করে। আপনি ব্যবসার প্রতিনিধিত্ব করার জন্য একটি ব্র্যান্ড তৈরি করেন এবং একটি এজেন্ট তৈরি করেন যাতে ভোক্তারা এর সাথে কথোপকথনের মাধ্যমে সংযোগ স্থাপন করতে পারে।

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোলটি খুলুন এবং আপনার বিজনেস মেসেজেস গুগল অ্যাকাউন্ট দিয়ে সাইন ইন করুন।
  2. এজেন্ট তৈরি করুন -এ ক্লিক করুন।
  3. এজেন্ট টাইপের জন্য বিজনেস মেসেজ নির্বাচন করুন।
  4. ব্র্যান্ডের নাম এবং এজেন্টের নামের জন্য মান লিখুন।
  5. নিম্নলিখিতগুলির মধ্যে যেকোনো একটি করুন:
    • আপনার এজেন্টের সাথে কথোপকথনের অভিজ্ঞতা লাভ করতে এবং উপলব্ধ বৈশিষ্ট্যগুলি অন্বেষণ করতে, 'ব্যবসা বার্তা সহায়ক বট সক্ষম করুন ' নির্বাচন করুন।
    • আপনার এজেন্টকে কাস্টমাইজ করতে এবং মেসেজ হ্যান্ডলিংয়ের জন্য প্রস্তুত করতে, ‘Enable the Business Messages Helper Bot’ অপশনটি অনির্বাচিত করুন।
  6. এজেন্ট তৈরি করুন -এ ক্লিক করুন।

আপনি যদি বিজনেস মেসেজেস হেল্পার বটটি সক্রিয় করে থাকেন, তাহলে অবিলম্বে একটি কথোপকথন শুরু করতে পারেন। অন্যথায়, বার্তা পরিচালনার জন্য আপনার এজেন্ট সেট আপ করতে এগিয়ে যান।

বিজনেস মেসেজ হেল্পার বটের ফিচারগুলো অন্বেষণ করুন

বিজনেস মেসেজেস হেল্পার বট আপনাকে আপনার এজেন্টের সাথে দ্রুত কথোপকথন শুরু করার সুযোগ দেয়, যাতে আপনি প্ল্যাটফর্মটির সুবিধাগুলো পরখ করে দেখতে পারেন। হেল্পার বটটি চালু করা ঐচ্ছিক, তবে আপনার প্রথম এজেন্ট তৈরি করার সময় এটি চালু করার জন্য বিশেষভাবে সুপারিশ করা হয়।

হেল্পার বট আপনাকে অনুমতি দেয়

  • সমৃদ্ধ বৈশিষ্ট্যগুলি অন্বেষণ করুন
  • ফিচারগুলো কীভাবে প্রয়োগ করতে হয় তা শিখুন
  • এজেন্ট সেটআপের জন্য রিসোর্স খুঁজুন

যখন হেল্পার বট সক্রিয় করা হয়, তখন এটি আপনার এজেন্টের জন্য বার্তা পাঠায় এবং গ্রহণ করে; এর জন্য কোনো ওয়েবহুকের প্রয়োজন হয় না। ওয়েবহুক সেট করার আগে অথবা ব্যবহারকারীর বার্তা পরিচালনার জন্য ডায়ালগফ্লো সক্রিয় করার আগে আপনাকে হেল্পার বট নিষ্ক্রিয় করতে হবে।

হেল্পার বটের সাথে কথোপকথন শুরু করুন

একবার আপনি বিজনেস মেসেজেস হেল্পার বট সক্রিয় করলে, একটি কথোপকথন শুরু করতে পারবেন। এজেন্ট তৈরির পরপরই একটি ডায়ালগ বক্স খোলে যা আপনাকে কাজ শুরু করতে সাহায্য করে।

হেল্পার বটের সাথে যোগাযোগ করতে, এই ডায়ালগ থেকে নিম্নলিখিত পদক্ষেপগুলি অনুসরণ করুন:

  1. এজেন্টের টেস্ট ইউআরএলগুলো অ্যাক্সেস করুন। কয়েকটি উপায়ে আপনি এটি করতে পারেন:

    • অ্যান্ড্রয়েড বা আইওএস বোতামে ক্লিক করুন। তারপর সংশ্লিষ্ট মোবাইল ডিভাইস দিয়ে কিউআর কোডটি স্ক্যান করুন এবং 'Launch'-এ ক্লিক করুন। বিকল্পভাবে, এজেন্টের টেস্ট ইউআরএল কপি করতে 'Copy Android URL' বা 'Copy iOS URL'-এ ক্লিক করুন।
    • আপনার ইমেল ঠিকানায় ইউআরএলগুলো পাঠাতে 'প্রেরণ করুন'- এ ক্লিক করুন।

  2. আপনার মোবাইল ডিভাইসে ইউআরএলটি খুলুন। (আইওএস ডিভাইসের জন্য গুগল ম্যাপস অ্যাপ প্রয়োজন।)

হেল্পার বট নিষ্ক্রিয় করুন

আপনার এজেন্টকে কাস্টমাইজ করার এবং লঞ্চের জন্য প্রস্তুত করার আগে, আপনাকে বিজনেস মেসেজেস হেল্পার বটটি নিষ্ক্রিয় করতে হবে।

হেল্পার বট নিষ্ক্রিয় করতে,

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোলটি খুলুন।
  2. আপনার এজেন্ট নির্বাচন করুন।
  3. বাম দিকের নেভিগেশনে, ইন্টিগ্রেশন- এ ক্লিক করুন।
  4. হেল্পার বটের জন্য, নিষ্ক্রিয় করুন- এ ক্লিক করুন।

যখন হেল্পার বট নিষ্ক্রিয় করা হয়, তখন এটি আপনার এজেন্টের জন্য আর বার্তা পাঠায় না বা গ্রহণ করে না। এখন আপনি মেসেজিং প্রবাহটি পরিচালনা করার জন্য আপনার এজেন্টকে সেট আপ করতে পারেন।

বার্তা পরিচালনার জন্য আপনার এজেন্ট সেট আপ করুন।

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

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

আপনাকে নিম্নলিখিত ধাপগুলো সম্পন্ন করতে হবে:

  • GCP-তে ইকো বট নমুনাটি স্থাপন করুন
  • আপনার বিজনেস মেসেজেস পার্টনার অ্যাকাউন্টের জন্য ওয়েবহুক ইউআরএল কনফিগার করুন।
  • আপনার এজেন্ট সম্পর্কে প্রাথমিক তথ্য প্রদান করুন।

এই নির্দেশিকাটি শেষ করার পর, আপনার এজেন্ট বার্তা পাঠাতে ও গ্রহণ করতে প্রস্তুত হয়ে যাবে।

ওয়েব অ্যাপ্লিকেশনটি GCP-তে ডিপ্লয় করুন

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

একটি ক্লাউড পরিবেশ তৈরি করুন

ইকো বট স্যাম্পলটি ডেপ্লয় করার জন্য আপনার একটি ক্লাউড এনভায়রনমেন্ট প্রয়োজন।

একটি GCP প্রজেক্টকে ক্লাউড এনভায়রনমেন্ট হিসেবে তৈরি করতে, এই ধাপগুলো অনুসরণ করুন:

  1. গুগল ক্লাউড কনসোল প্রজেক্ট সিলেক্টরটি খুলুন।

    আপনি যদি আগে কখনও গুগল ক্লাউড প্রজেক্ট তৈরি না করে থাকেন, তাহলে আপনাকে শর্তাবলী ও পরিষেবাগুলো গ্রহণ করতে হবে।

  2. প্রজেক্ট তৈরি করুন -এ ক্লিক করুন।

  3. আপনার নতুন প্রকল্পের জন্য একটি নাম এবং অবস্থান লিখুন।

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

  4. তৈরি করুন- এ ক্লিক করুন।

  5. ক্লিক করুন ।

  6. বিলিং-এ ক্লিক করুন।

  7. বিলিং অ্যাকাউন্ট লিঙ্ক করতে ক্লিক করুন।

  8. প্রকল্পে একটি নতুন বিলিং অ্যাকাউন্ট তৈরি করুন অথবা একটি বিদ্যমান বিলিং অ্যাকাউন্ট যোগ করুন। পেমেন্টের বিকল্পগুলো বুঝতে গুগল ক্লাউড ফ্রি প্রোগ্রামের বৈশিষ্ট্যগুলো দেখুন।

ইকো বট নমুনাটি স্থাপন করুন

  1. gcloud CLI ইনস্টল করুন। স্যাম্পল কোডটি গুগল ক্লাউডে ডেপ্লয় করতে আপনি এটি ব্যবহার করবেন।

  2. ইকো বট স্যাম্পলটি ডাউনলোড এবং এক্সট্র্যাক্ট করুন ( Node.js , Java , Python )।

  3. "Create a service account" অংশে ডাউনলোড করা JSON ক্রেডেনশিয়ালস ফাইলটি স্যাম্পলের রিসোর্স ফোল্ডারে কপি করুন এবং ক্রেডেনশিয়ালস-এর নাম পরিবর্তন করে "bm-agent-service-account-credentials.json" রাখুন। এই ক্রেডেনশিয়ালস ফাইলের পাথটি আপনার ডাউনলোড করা স্যাম্পলের উপর নির্ভর করে।

    নোড.জেএস 

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    জাভা 

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    পাইথন 

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. টার্মিনালে, স্যাম্পলটির full_sample ডিরেক্টরিতে যান।

  5. স্যাম্পলটি ডিপ্লয় করতে টার্মিনালে নিম্নলিখিত কমান্ডগুলো চালান:

    নোড.জেএস 

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID হলো 'Create a Cloud environment'- এ আপনার তৈরি করা প্রজেক্টের আইডি। এই প্রজেক্ট আইডিটি গুগল ক্লাউডের প্রজেক্ট ড্যাশবোর্ডে তালিকাভুক্ত থাকে।

    জাভা 

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID হলো 'Create a Cloud environment'- এ আপনার তৈরি করা প্রজেক্টের আইডি। এই প্রজেক্ট আইডিটি গুগল ক্লাউডের প্রজেক্ট ড্যাশবোর্ডে তালিকাভুক্ত থাকে।

    পাইথন 

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID হলো 'Create a Cloud environment'- এ আপনার তৈরি করা প্রজেক্টের আইডি। এই প্রজেক্ট আইডিটি গুগল ক্লাউডের প্রজেক্ট ড্যাশবোর্ডে তালিকাভুক্ত থাকে।

  6. শেষ কমান্ডের আউটপুটে ডেপ্লয় করা অ্যাপ্লিকেশনটির URL-টি নোট করুন। এটিই আপনার ওয়েবহুক URL-এর ভিত্তি:

    Deployed service [default] to [https:// PROJECT_ID .appspot.com]

আপনার ওয়েবহুক সেট করুন

এখন যেহেতু ইকো বটটি স্থাপন করা হয়েছে, বার্তা গ্রহণ শুরু করার জন্য আপনাকে একটি ওয়েবহুক ইউআরএল (যা আপনি পরিচালনা করেন) নির্দিষ্ট করতে হবে।

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোলে অ্যাকাউন্ট সেটিংস খুলুন।
  2. সঠিক পার্টনার অ্যাকাউন্টটি নির্বাচন করা হয়েছে কিনা তা নিশ্চিত করুন।
  3. ব্যবসায়িক বার্তার ওয়েবহুক ইউআরএল-এর জন্য, কনফিগার-এ ক্লিক করুন।

  4. ওয়েবহুক এন্ডপয়েন্ট URL-এর জন্য, আপনার অ্যাপ্লিকেশনের URL-এর সাথে '/callback' লিখুন।

    আপনার এন্ডপয়েন্টটি "https:// PROJECT_ID .appspot.com/callback" ফরম্যাট অনুসরণ করবে।

    আপনি GCP-তে যে স্যাম্পলটি ডেপ্লয় করেছেন, তার অ্যাপ্লিকেশন লজিকে এই এন্ডপয়েন্টটি আগে থেকেই সংজ্ঞায়িত করা আছে।

  5. ডেভেলপার কনসোলে, ভেরিফাই- এ ক্লিক করুন।

    বিজনেস মেসেজেস আপনার ওয়েবহুক যাচাই করলে, ডায়ালগটি বন্ধ হয়ে যায়।

বিজনেস কমিউনিকেশনস এপিআই-এর সাথে আপনার ওয়েবহুক কনফিগার করতে, উদাহরণ: ওয়েবহুক ইউআরএল আপডেট করুন দেখুন।

আপনার ওয়েবহুকটি বিজনেস মেসেজেস পেলোডগুলিতে সফলভাবে সাড়া দিচ্ছে কিনা, তা পরীক্ষা করতে আপনি বিজনেস মেসেজেস টেস্ট ফ্রেমওয়ার্ক ব্যবহার করতে পারেন।

এজেন্টের তথ্য প্রবেশ করান

আপনার এজেন্ট সেটআপ সম্পূর্ণ করতে কিছু প্রাথমিক তথ্য প্রদান করুন।

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোলটি খুলুন।
  2. বাম দিকের নেভিগেশনে, ‘এজেন্ট তথ্য’- তে ক্লিক করুন।

  3. আপনার পছন্দমতো মানগুলো আপডেট করুন, অথবা নিম্নলিখিত পরামর্শগুলো ব্যবহার করুন:

    মাঠ মূল্য
    স্বাগতম বার্তা ইকো বট আলোচনায় স্বাগতম!
    গোপনীয়তা নীতি https://policies.google.com/privacy

  4. সংরক্ষণ করুন- এ ক্লিক করুন।

কথোপকথন শুরু করুন

ইকো বটের সাথে যোগাযোগ করতে, এই ধাপগুলো অনুসরণ করুন:

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোলটি খুলুন।
  2. বাম দিকের নেভিগেশনে, ‘এজেন্ট তথ্য’- তে ক্লিক করুন।
  3. এজেন্ট টেস্ট ইউআরএল-এর অধীনে, অ্যান্ড্রয়েড বা আইওএস বোতামে ক্লিক করুন।

  4. সংশ্লিষ্ট মোবাইল ডিভাইস দিয়ে কিউআর কোডটি স্ক্যান করুন, অথবা এজেন্টের টেস্ট ইউআরএল কপি করতে ‘কপি অ্যান্ড্রয়েড ইউআরএল’ বা ‘কপি আইওএস ইউআরএল’-এ ক্লিক করুন।

    আপনি 'প্রেরণ করুন' বোতামে ক্লিক করে ইউআরএলগুলো আপনার ইমেল ঠিকানায়ও পাঠাতে পারেন।

  5. আপনার মোবাইল ডিভাইসে ইউআরএলটি খুলুন। (আইওএস ডিভাইসের জন্য গুগল ম্যাপস অ্যাপ প্রয়োজন।)

আপনার এজেন্টের স্বাগত বার্তা আপনাকে অভিবাদন জানায়। এই পর্যায়ে, আপনি ইকো বটের সাথে যোগাযোগ করতে পারেন। এটি আপনার পাঠানো বার্তাগুলো আপনাকে প্রতিধ্বনি করে ফেরত পাঠায়। এছাড়াও, আপনি নির্দিষ্ট স্ট্রিং যেমন: “carousel”, “card”, “chips” পাঠিয়ে উন্নত ফিচারগুলো ব্যবহার করতে পারেন।

পরবর্তী পদক্ষেপ

এখন যেহেতু আপনি আপনার প্রথম এজেন্ট তৈরি করে ফেলেছেন, বিজনেস মেসেজ এবং এই প্ল্যাটফর্মে আপনি আর কী কী করতে পারেন সে সম্পর্কে আরও জানুন।