Dialogflow ES ব্যবহার করে একটি Google Chat অ্যাড-অন তৈরি করুন

এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে যে কীভাবে একটি Google Workspace অ্যাড-অন হিসেবে Google Chat অ্যাপ তৈরি করবেন যা Dialogflow ES ব্যবহার করে প্রাকৃতিক ভাষা বুঝতে এবং প্রতিক্রিয়া জানাতে পারে। আপনি Dialogflow CX ব্যবহার করে একটি Dialogflow CX Google Chat অ্যাপ তৈরি করতে পারেন, যার Google Chat-এর সাথে সরাসরি ইন্টিগ্রেশন রয়েছে, Dialogflow CX Google Chat নির্দেশিকা অনুসরণ করে।

উদ্দেশ্য

  • তোমার পরিবেশ ঠিক করো।
  • একটি Dialogflow ES এজেন্ট তৈরি এবং স্থাপন করুন।
  • Dialogflow ES এজেন্ট দ্বারা চালিত একটি চ্যাট অ্যাপ তৈরি এবং স্থাপন করুন।
  • চ্যাট অ্যাপটি পরীক্ষা করে দেখুন।

পূর্বশর্ত

স্থাপত্য

নিম্নলিখিত চিত্রটি ডায়ালগফ্লো দিয়ে তৈরি একটি চ্যাট অ্যাপের আর্কিটেকচার দেখায়:

ডায়ালগফ্লো ব্যবহার করে বাস্তবায়িত একটি চ্যাট অ্যাপের স্থাপত্য।

পূর্ববর্তী চিত্রে, একজন ব্যবহারকারী ডায়ালগফ্লো চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করছেন, তার তথ্যের প্রবাহ নিম্নরূপ:

  1. একজন ব্যবহারকারী চ্যাট অ্যাপে চ্যাটের মাধ্যমে একটি বার্তা পাঠান, হয় সরাসরি বার্তায় অথবা চ্যাট স্পেসে।
  2. একটি ডায়ালগফ্লো ভার্চুয়াল এজেন্ট, যা থাকে , বার্তাটি গ্রহণ করে এবং প্রতিক্রিয়া তৈরি করার জন্য প্রক্রিয়া করে।
  3. ঐচ্ছিকভাবে, একটি Dialogflow ওয়েবহুক ব্যবহার করে, Dialogflow এজেন্ট বহিরাগত তৃতীয় পক্ষের পরিষেবাগুলির সাথে ইন্টারঅ্যাক্ট করতে পারে, যেমন একটি প্রকল্প ব্যবস্থাপনা সিস্টেম বা একটি টিকিটিং টুল।
  4. ডায়ালগফ্লো এজেন্ট চ্যাটে চ্যাট অ্যাপ পরিষেবাতে একটি প্রতিক্রিয়া পাঠায়।
  5. উত্তরটি চ্যাট স্পেসে পৌঁছে দেওয়া হবে।

পরিবেশ ঠিক করুন

গুগল এপিআই ব্যবহার করার আগে, আপনাকে গুগল ক্লাউড প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি গুগল ক্লাউড প্রোজেক্টে এক বা একাধিক এপিআই চালু করতে পারেন।

  1. Google API কনসোলে, Google Chat API এবং Dialogflow API সক্ষম করুন।

    API গুলি সক্ষম করুন

  2. নিশ্চিত করুন যে আপনি সঠিক ক্লাউড প্রজেক্টে API গুলি সক্রিয় করছেন, তারপর Next এ ক্লিক করুন।

  3. নিশ্চিত করুন যে আপনি সঠিক API গুলি সক্রিয় করছেন, তারপর সক্ষম করুন এ ক্লিক করুন।

একটি Dialogflow ES এজেন্ট তৈরি করুন

যদি আপনার কাছে বিদ্যমান Dialogflow ES এজেন্ট না থাকে:

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

বিস্তারিত নির্দেশিকার জন্য, "একজন এজেন্ট তৈরি করুন" দেখুন।

একটি চ্যাট অ্যাপ তৈরি করুন এবং এটিকে Dialogflow এজেন্টের সাথে সংযুক্ত করুন

একটি Dialogflow ES এজেন্ট তৈরি করার পরে, এটিকে একটি Chat অ্যাপে রূপান্তর করতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. Google API কনসোলে, Google Chat API-এ যান। "Google Chat API" অনুসন্ধান করুন এবং Google Chat API-এ ক্লিক করুন, তারপর Manage এ ক্লিক করুন।

    চ্যাট API-তে যান

  2. কনফিগারেশনে ক্লিক করুন এবং চ্যাট অ্যাপ সেট আপ করুন:

    1. অ্যাপের নামে , Dialogflow App লিখুন।
    2. Avatar URL- এ, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png লিখুন।
    3. বর্ণনা বিভাগে, Responds to real human conversation লিখুন।
    4. কার্যকারিতার অধীনে, Join spaces and group conversations নির্বাচন করুন।
    5. সংযোগ সেটিংসের অধীনে, ডায়ালগফ্লো নির্বাচন করুন।
    6. Dialogflow সেটিংস এর অধীনে, Dialogflow ES নির্বাচন করুন।
    7. এই চ্যাট অ্যাপটি আপনার ডোমেনের নির্দিষ্ট ব্যক্তি এবং গোষ্ঠীর জন্য উপলব্ধ করুন এবং আপনার ইমেল ঠিকানা লিখুন।
    8. লগস এর অধীনে, লগ ত্রুটি থেকে লগিং নির্বাচন করুন।

  3. সংরক্ষণ করুন ক্লিক করুন।

চ্যাট অ্যাপটি চ্যাটে বার্তা গ্রহণ এবং উত্তর দেওয়ার জন্য প্রস্তুত।

চ্যাট অ্যাপটি পরীক্ষা করুন

Google Chat-এ মেসেজ করে Dialogflow ES Chat অ্যাপটি পরীক্ষা করুন।

  1. বিশ্বস্ত পরীক্ষক হিসেবে নিজেকে যোগ করার সময় যে Google Workspace অ্যাকাউন্টটি দিয়েছিলেন, সেটি ব্যবহার করে Google Chat খুলুন।

    গুগল চ্যাটে যান

  2. নতুন চ্যাট এ ক্লিক করুন।
  3. ১ বা তার বেশি লোক যোগ করুন ফিল্ডে, আপনার চ্যাট অ্যাপের নাম টাইপ করুন।

  4. ফলাফল থেকে আপনার চ্যাট অ্যাপটি নির্বাচন করুন। একটি সরাসরি বার্তা খুলবে।

  5. অ্যাপের নতুন সরাসরি বার্তায়, Hello টাইপ করুন এবং enter টিপুন।

    ডায়ালগফ্লো চ্যাট অ্যাপটি একটি শুভেচ্ছা বার্তার মাধ্যমে সাড়া দেয়।

টেক্সট প্রতিক্রিয়া

টেক্সট উত্তরগুলি গুগল চ্যাটে টেক্সট মেসেজ হিসেবে পাঠানো হয়। এই ফর্ম্যাটিংয়ের মাধ্যমে আপনি নির্দিষ্ট (মার্কডাউন লাইট) চিহ্নে টেক্সট মোড়ানোর মাধ্যমে টেক্সটকে বোল্ড বা ইটালিক করতে পারেন।

টেক্সট মেসেজের প্রতিক্রিয়াটি দৃশ্যত ডায়ালগফ্লো কনসোলে ডিফল্ট টেক্সট প্রতিক্রিয়ার মতোই দেখায়। তবে, কাঁচা API প্রতিক্রিয়াটি একটু আলাদা দেখাবে। এটি প্ল্যাটফর্ম কনফিগারেশনটিকে GOOGLE_HANGOUTS তে সেট করে, যা একাধিক ইন্টিগ্রেশনের জন্য এজেন্ট তৈরি করার সময় আকর্ষণীয় হতে পারে।

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

কার্ড

কার্ডের উত্তরগুলি Google Chat-এ কার্ড বার্তা হিসেবে পাঠানো হয়।

ছবি

ছবির প্রতিক্রিয়াগুলি Google Chat-এ Google Chat Image Widgets হিসেবে পাঠানো হয়।

কাস্টম পেলোড

অন্যান্য ধরণের Google Chat বার্তা পাঠাতে, আপনি একটি কাস্টম পেলোড ব্যবহার করতে পারেন।

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

কার্ড দিয়ে বার্তা তৈরি করার জন্য একটি কাস্টম পেলোডের উদাহরণ এখানে দেওয়া হল:

{ "hangouts": { "hostAppDataAction": { "chatDataAction": {
  "createMessageAction": { "message": { "cardsV2": [{
    "cardId": "pizza",
    "card": {
      "header": {
        "title": "Pizza Delivery Customer Support",
        "subtitle": "pizzadelivery@example.com",
        "imageUrl": "https://goo.gl/aeDtrS"
      },
      "sections": [{ "widgets": [{ "textParagraph": {
        "text": " Your pizza is here!"
      }}]}]
    }
  }]}}
}}}}

সীমাবদ্ধতা এবং বিবেচনা

  • Dialogflow-এর সাথে Google Workspace অ্যাড-অন ব্যবহার করার সময়, Chat ইভেন্ট অবজেক্টের নিম্নলিখিত সীমাবদ্ধতা এবং বিবেচনা রয়েছে:
    • অ্যাপ হোম ইভেন্ট: APP_HOME ইভেন্টের জন্য সমর্থন এখনও উপলব্ধ নয়।
    • ডায়ালগফ্লো কোয়েরি ইনপুট: ডায়ালগফ্লো এজেন্টের কাছে কোয়েরি ইনপুট হিসেবে পাঠানো টেক্সট ইভেন্টের ধরণের উপর নির্ভর করে:
      • MESSAGE : চ্যাট বার্তা থেকে argumentText ক্ষেত্রের মান।
      • APP_COMMAND : "APP_COMMAND_PAYLOAD" স্ট্রিং।
      • ADDED_TO_SPACE : একটি ডিফল্ট স্বাগত ইভেন্ট পাঠানো হয়।
      • REMOVED_FROM_SPACE : "REMOVED_FROM_SPACE_PAYLOAD" স্ট্রিং।
      • CARD_CLICKED : "BUTTON_CLICKED_PAYLOAD" স্ট্রিং।
      • WIDGET_UPDATED : "WIDGET_UPDATED_PAYLOAD" স্ট্রিং (স্বয়ংক্রিয়ভাবে সম্পূর্ণ করার জন্য ব্যবহৃত)।
    • সম্পূর্ণ ইভেন্ট পেলোড: চ্যাট ইন্টারঅ্যাকশন ইভেন্টের সম্পূর্ণ JSON পেলোড WebhookRequest.payload ক্ষেত্রের মধ্যে Dialogflow-এ পাঠানো হয়। আপনি আপনার Dialogflow ওয়েবহুক-এ এটি অ্যাক্সেস করতে পারেন। আরও তথ্যের জন্য, Dialogflow ES ওয়েবহুক অনুরোধ ডকুমেন্টেশন দেখুন।
  • কমান্ডের প্রতিক্রিয়া এবং কার্ড বা ডায়ালগ থেকে তথ্য গ্রহণের জন্য বিবেচ্য বিষয়গুলি:
  • লিঙ্ক প্রিভিউ সমর্থিত নয়।
  • যদি Dialogflow এজেন্ট শুধুমাত্র একটি বার্তার মাধ্যমে উত্তর দেয়, তাহলে বার্তাটি Google Chat-এ সিঙ্ক্রোনাসভাবে পাঠানো হবে। যদি Dialogflow এজেন্ট একাধিক বার্তার মাধ্যমে উত্তর দেয়, তাহলে প্রতিটি বার্তার জন্য একবার Chat API-তে spaces.messages রিসোর্সে create পদ্ধতিতে কল করে সমস্ত বার্তা অ্যাসিঙ্ক্রোনাসভাবে Chat-এ পাঠানো হবে।
  • চ্যাটের সাথে Dialogflow ES ইন্টিগ্রেশন ব্যবহার করার সময়, Dialogflow এজেন্ট এবং Chat অ্যাপ একই Google ক্লাউড প্রোজেক্টে সেট আপ করতে হবে।

সমস্যা সমাধান

আপনার চ্যাট অ্যাপটি ডিবাগ করতে, ত্রুটি লগগুলি পর্যালোচনা করে শুরু করুন। যেহেতু এই অ্যাপটি Dialogflow ব্যবহার করে, তাই আপনার কাছে বেশ কয়েকটি লগিং এবং সমস্যা সমাধানের সংস্থান উপলব্ধ রয়েছে:

পরিষ্কার করা

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

  1. Google API কনসোলে, Manage resources পৃষ্ঠায় যান। Menu > IAM & Admin > Manage Resources এ ক্লিক করুন।

    রিসোর্স ম্যানেজারে যান

  2. প্রকল্পের তালিকায়, আপনি যে প্রকল্পটি মুছতে চান তা নির্বাচন করুন এবং তারপরে মুছুন মুছে ফেলুন করুন।
  3. ডায়ালগে, প্রজেক্ট আইডি টাইপ করুন এবং তারপর প্রজেক্টটি মুছে ফেলতে Shut down এ ক্লিক করুন।