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

পূর্বশর্ত

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

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

এই দ্রুত শুরুতে, আপনি নিম্নলিখিতগুলি করবেন:

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

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

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

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

  3. আপনার অংশীদার তথ্য লিখুন:

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

  4. ব্যবসা বার্তা পরিষেবার শর্তাবলী পর্যালোচনা করুন এবং স্বীকার করুন৷

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

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

আপনার কাছে এখন ব্যবসা বার্তা এবং ব্যবসায়িক যোগাযোগ API-এ অ্যাক্সেস আছে।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. এজেন্টের পরীক্ষার URL গুলি অ্যাক্সেস করুন৷ আপনি এটি করতে পারেন এমন কয়েকটি উপায় রয়েছে:

    • অ্যান্ড্রয়েড বোতাম বা iOS বোতামে ক্লিক করুন। তারপরে সংশ্লিষ্ট মোবাইল ডিভাইসের সাথে QR কোডটি স্ক্যান করুন এবং লঞ্চ এ ক্লিক করুন। বিকল্পভাবে, এজেন্টের পরীক্ষার URL কপি করতে Android URL অনুলিপি করুন বা iOS URL অনুলিপি করুন ক্লিক করুন৷
    • আপনার ইমেল ঠিকানায় URL পাঠাতে পাঠাতে ক্লিক করুন.

  2. আপনার মোবাইল ডিভাইসে URL খুলুন. (iOS ডিভাইসগুলির জন্য Google মানচিত্র অ্যাপ প্রয়োজন।)

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

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

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

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

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

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

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

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

আপনি নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করবেন:

  • জিসিপিতে ইকো বট নমুনা স্থাপন করুন
  • আপনার ব্যবসা বার্তা অংশীদার অ্যাকাউন্টের জন্য ওয়েবহুক URL কনফিগার করুন
  • আপনার এজেন্ট সম্পর্কে প্রাথমিক তথ্য প্রদান করুন

এই গাইডের শেষে, আপনার এজেন্ট বার্তা পাঠাতে এবং গ্রহণ করতে প্রস্তুত হবে।

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

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

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

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

একটি ক্লাউড পরিবেশ হিসাবে একটি GCP প্রকল্প তৈরি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

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

    আপনি যদি কখনও একটি Google ক্লাউড প্রকল্প তৈরি না করে থাকেন তবে আপনাকে শর্তাবলী এবং পরিষেবাগুলি স্বীকার করতে হবে৷

  2. প্রকল্প তৈরি করুন ক্লিক করুন।

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

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

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

  5. মেনুতে ক্লিক করুন।

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

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

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

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

  1. জিক্লাউড সিএলআই ইনস্টল করুন। আপনি Google ক্লাউডে নমুনা কোড স্থাপন করতে এটি ব্যবহার করবেন।

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

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

    Node.js

    ./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. নমুনা স্থাপন করতে একটি টার্মিনালে নিম্নলিখিত কমান্ডগুলি চালান:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID হল একটি ক্লাউড এনভায়রনমেন্ট তৈরিতে আপনার তৈরি করা প্রোজেক্টের আইডি। প্রোজেক্ট আইডি Google ক্লাউডে প্রোজেক্ট ড্যাশবোর্ডে তালিকাভুক্ত করা হয়েছে।

    জাভা

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

    PROJECT_ID হল একটি ক্লাউড এনভায়রনমেন্ট তৈরিতে আপনার তৈরি করা প্রোজেক্টের আইডি। প্রোজেক্ট আইডি Google ক্লাউডে প্রোজেক্ট ড্যাশবোর্ডে তালিকাভুক্ত করা হয়েছে।

    পাইথন

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID হল একটি ক্লাউড এনভায়রনমেন্ট তৈরিতে আপনার তৈরি করা প্রোজেক্টের আইডি। প্রোজেক্ট আইডি Google ক্লাউডে প্রোজেক্ট ড্যাশবোর্ডে তালিকাভুক্ত করা হয়েছে।

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

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

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

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

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

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

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

    আপনি GCP-তে যে নমুনা স্থাপন করেছেন তার প্রয়োগ যুক্তিতে এই শেষ পয়েন্টটি পূর্বনির্ধারিত।

  5. বিকাশকারী কনসোলে, যাচাই করুন ক্লিক করুন।

    যখন Business Messages আপনার ওয়েবহুক যাচাই করে, তখন ডায়ালগ বন্ধ হয়ে যায়।

ব্যবসায়িক যোগাযোগ API এর সাথে আপনার ওয়েবহুক কনফিগার করতে, উদাহরণ দেখুন: ওয়েবহুক URL আপডেট করুন ।

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

এজেন্ট তথ্য লিখুন

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

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

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

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

  4. Save এ ক্লিক করুন।

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

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

  1. বিজনেস কমিউনিকেশনস ডেভেলপার কনসোল খুলুন।
  2. বাম নেভিগেশনে, এজেন্ট তথ্য ক্লিক করুন।
  3. এজেন্ট পরীক্ষার URL- এর অধীনে, Android বোতাম বা iOS বোতামে ক্লিক করুন।

  4. সংশ্লিষ্ট মোবাইল ডিভাইসের সাথে QR কোডটি স্ক্যান করুন, অথবা এজেন্টের পরীক্ষার URL কপি করতে Android URL অনুলিপি করুন বা iOS URL অনুলিপি করুন ক্লিক করুন৷

    আপনি আপনার ইমেল ঠিকানায় URL পাঠাতে পাঠাতে ক্লিক করতে পারেন।

  5. আপনার মোবাইল ডিভাইসে URL খুলুন. (iOS ডিভাইসগুলির জন্য Google মানচিত্র অ্যাপ প্রয়োজন।)

আপনার এজেন্টের স্বাগত বার্তা আপনাকে শুভেচ্ছা জানায়। এই মুহুর্তে, আপনি ইকো বটের সাথে যোগাযোগ করতে পারেন। এটি আপনার কাছে ফেরত পাঠানো বার্তাগুলির প্রতিধ্বনি করে৷ অতিরিক্তভাবে, আপনি নির্দিষ্ট স্ট্রিংগুলি পাঠিয়ে সমৃদ্ধ বৈশিষ্ট্যগুলি আহ্বান করতে পারেন: "ক্যারোজেল", "কার্ড", "চিপস"৷

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

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