মিথুনের সাথে Google চ্যাটের জন্য অ্যাপ তৈরি করুন

১. শুরু করার আগে

জেমিনির সাথে গুগল চ্যাট অ্যাপগুলো কী কী?

জেমিনি সহ গুগল চ্যাট অ্যাপগুলি নিম্নলিখিত কাজগুলি করে:

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

কেন জেমিনির সাথে গুগল চ্যাট অ্যাপস ইন্টিগ্রেট করবেন?

জেমিনির মতো জেনারেটিভ এআই মডেলের সাধারণ ব্যবহারগুলো নিম্নলিখিত বিভাগগুলোতে পড়ে:

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

যারা তাদের ব্যবহারকারীদের অভিজ্ঞতা ও কর্মদক্ষতা উন্নত করতে চান, তাদের জন্য গুগল চ্যাটের পরিচিত ইন্টারফেসের মধ্যেই এই সুবিধাগুলো সরাসরি একীভূত করার ক্ষমতা একটি বিশাল সুযোগ।

পূর্বশর্ত

আপনি যা তৈরি করেন

এই কোডল্যাবে, আপনি পূর্ববর্তী বিভাগে আলোচিত তিনটি ব্যবহারের ক্ষেত্র (use cases) পূরণের জন্য জেমিনি (Gemini) ব্যবহার করে তিনটি গুগল চ্যাট অ্যাপ তৈরি করবেন।

সমস্যা ব্যবস্থাপনা অ্যাপ (বিষয়বস্তু তৈরি এবং উন্নতকরণ)

এই অ্যাপটি নিম্নলিখিত কাজগুলো করে:

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

আপনি মিথুন রাশি ব্যবহার করে নিম্নলিখিত কাজগুলো করেন:

  • বার্তার ইতিহাস এবং সমস্যার বিবরণের উপর ভিত্তি করে সমস্যা প্রতিবেদন তৈরি করুন।
  • গেটেড প্রম্পট ব্যবহার করে বার্তা থেকে অন্তর্ভুক্তিমূলক নয় এমন শব্দ শ্রেণীবদ্ধ করুন।

ব্যবহৃত প্রধান প্রযুক্তিগুলো হলো ভার্টেক্স এআই, জেমিনি, অ্যাপস স্ক্রিপ্ট এবং গুগল ওয়ার্কস্পেস এপিআই (অ্যাডমিন, চ্যাট, ডক্স, ইভেন্টস)।

22efdecff4601417.png

2d127c63518673b2.png

9aea694937f2f3ed.png

এই অ্যাপটি স্বাভাবিক ভাষায় প্রশ্ন বুঝতে ও উত্তর দিতে এবং অসংগঠিত ডেটা থেকে উৎসের তথ্যসূত্র ফেরত দিতে জেমিনির ওপর নির্ভর করে।

ব্যবহৃত প্রধান প্রযুক্তিগুলো হলো Dialogflow CX data store agent, Dialogflow CX webhook, Google Cloud Functions, এবং Gemini।

9468866bfe848bb8.png

প্রতিক্রিয়া অ্যাপ (কথোপকথন)

এই অ্যাপটি স্বাভাবিক ভাষায় কথোপকথনসহ রিভিউ সংগ্রহ ও সংরক্ষণ করতে জেমিনির ওপর নির্ভর করে।

ব্যবহৃত প্রধান প্রযুক্তিগুলো হলো Dialogflow CX agent, Dialogflow CX tool, OpenAPI, Google Cloud Functions, এবং Gemini।

99a7a0295f122f31.png

আপনি যা শিখবেন

  • Vertex AI-এর মাধ্যমে Gemini-তে Google Chat অ্যাপগুলি কীভাবে সংযুক্ত করবেন।
  • Dialogflow CX এজেন্টের সাথে Google Chat অ্যাপগুলিকে কীভাবে সংযুক্ত করবেন।
  • গুগল চ্যাটের সর্বশেষ ফিচারগুলো কীভাবে ব্যবহার করবেন: অ্যাপ হোম, গুগল চ্যাট ইভেন্টস এবং অ্যাকসেসরি উইজেট।

তোমার যা দরকার

২. প্রস্তুত হন

সম্পদ প্রারম্ভিকীকরণ করুন

এই বিভাগে, আপনি আপনার পছন্দের ওয়েব ব্রাউজার থেকে নিম্নলিখিত রিসোর্সগুলো অ্যাক্সেস ও কনফিগার করতে পারবেন।

অ্যাপস স্ক্রিপ্ট প্রজেক্ট

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

  1. সেটিংসে ক্লিক করুন এবং তারপরে গুগল অ্যাপস স্ক্রিপ্ট এপিআই (Google Apps Script API) সক্রিয় করুন।

ea06c593b347b9d1.png

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. প্রজেক্ট সেটিংস-এ ক্লিক করুন।
  3. এডিটরে " appsscript.json " ম্যানিফেস্ট ফাইল দেখানোর চেকবক্সটি নির্বাচন করুন।
  4. প্রজেক্টটির নাম পরিবর্তন করে Chat Apps Gemini রাখুন।

12c1485bd248b766.png

গুগল ক্লাউড প্রকল্প

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. মেনু ☰ > এপিআই ও পরিষেবা > ওঅথ সম্মতি স্ক্রিন > অ্যাপ সম্পাদনা-তে ক্লিক করুন এবং তারপরে অ্যাপের নাম Chat Apps Gemini সেট করুন।

  1. Google Chat API কনফিগারেশনে যান এবং তারপরে অ্যাপের নাম ও বিবরণ Chat Apps Gemini হিসেবে সেট করুন।

a71f040755da3b8b.png

গুগল চ্যাট

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

  1. প্রয়োজনে আপনার গুগল চ্যাট অ্যাপ দিয়ে চ্যাট শুরু করুন।
  2. এটি কাজ করছে কিনা তা নিশ্চিত করতে, Hello মতো একটি বার্তা পাঠান।

9625418251528ae9.png

সোর্স কোড এবং রিসোর্স স্থানীয়ভাবে ডাউনলোড করুন

  1. এই গিটহাব রিপোজিটরিটি ডাউনলোড করুন।

  1. আপনার পছন্দের ডেভেলপমেন্ট এনভায়রনমেন্টে, apps-script ডিরেক্টরিটি খুলুন এবং তারপর আপনার টার্মিনালে একই ডিরেক্টরিতে যান।

da9478df97c99194.png

clasp ইনস্টল এবং কনফিগার করুন

আমরা লোকাল এনভায়রনমেন্ট থেকে অ্যাপস স্ক্রিপ্ট প্রজেক্টে সোর্স কোডের বিভিন্ন ভার্সন সহজে সম্পাদনা ও পুশ করার জন্য clasp ব্যবহার করি।

  1. আপনার লোকাল এনভায়রনমেন্টে node , npm , এবং clasp এর সর্বশেষ সংস্করণগুলো ইনস্টল করুন । 
npm install -g @google/clasp
  1. আপনার অ্যাকাউন্ট দিয়ে লগ ইন করুন : 
clasp login

8bc2434e6dc6f22a.png

সফল হলে, আপনি আপনার ওয়েব ব্রাউজারে একটি সাধারণ নিশ্চিতকরণ স্ক্রিন দেখতে পাবেন এবং আপনার ক্লায়েন্ট ক্রেডেনশিয়ালসহ .clasprc.json ফাইলটি আপডেট হয়ে যাবে। এটি আপনার টার্মিনালে কোথায় অবস্থিত, তা আপনি খুঁজে নিতে পারেন।

e1d833eb4d5b3a8f.png

৩. অ্যাপ ১: তৈরি করুন

ধারণা পর্যালোচনা করুন

ভার্টেক্স এআই

জেনারেটিভ এআই তৈরি ও ব্যবহারের জন্য আপনার প্রয়োজনীয় সবকিছুই ভার্টেক্স এআই প্রদান করে, যার মধ্যে রয়েছে এআই সলিউশন, এজেন্ট বিল্ডার, ১৩০টিরও বেশি ফাউন্ডেশন মডেল এবং একটি সমন্বিত এআই প্ল্যাটফর্ম।

c9e9c7a1945b22ac.png

মিথুন

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

উন্নত চ্যাট পরিষেবা

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

স্থাপত্য পর্যালোচনা

8c9c7b7328a69ea6.png

এই গুগল চ্যাট অ্যাপটি অ্যাপস স্ক্রিপ্ট দিয়ে তৈরি করা হয়েছে। এটি নিম্নোক্তভাবে কাজ করে:

  1. একজন ব্যবহারকারী সরাসরি বার্তা বা স্পেসের মাধ্যমে অ্যাপে একটি বার্তা পাঠান।
  2. অ্যাপটি, যা একটি অ্যাপস স্ক্রিপ্ট প্রজেক্টে বাস্তবায়িত এবং একটি গুগল ক্লাউড প্রজেক্টের সাথে যুক্ত, মেসেজটি প্রসেস করে।
  3. অ্যাপটি গুগল ডক্স এবং গুগল চ্যাট এপিআই-এর সাথে সমন্বিত হয়।
  4. অ্যাপটি স্ক্রিপ্ট প্রপার্টিতে ডেটা সংরক্ষণ করতে প্রপার্টিজ সার্ভিস ব্যবহার করে।
  5. অ্যাপটি সরাসরি বার্তায় অথবা মূল স্পেসে একযোগে প্রতিক্রিয়া পাঠায়।

পর্যালোচনা প্রবাহ

সমস্যা তৈরি করুন

7ca0e8ba3c8255bb.png

নির্দিষ্ট স্থান থেকে সমস্যার সমাধান করুন

51b47714c378a24b.png

নির্দিষ্ট স্থান থেকে বিষয়টি বন্ধ করুন

89e50228deeab0f9.png

সোর্স কোড পর্যালোচনা করুন

অ্যাপস স্ক্রিপ্ট প্রজেক্টটিতে নিম্নলিখিত স্ক্রিপ্টগুলো রয়েছে:

  • Configuration : পরিবেশের উপর ভিত্তি করে সম্পাদনাযোগ্য ধ্রুবকসমূহ।
  • ChatApp : গুগল চ্যাটের বিভিন্ন ইন্টারঅ্যাকশন ইভেন্ট, যেমন—মেসেজ, কার্ড ক্লিক, স্ল্যাশ কমান্ড এবং ডায়ালগ পরিচালনা করে।
  • Storage : ইউটিলিটি ফাংশন যা প্রোপার্টি সার্ভিসেস-এর উপর নির্ভর করে।
  • ChatAppAuth : এমন ইউটিলিটি ফাংশন যা গুগল চ্যাট অ্যাপ অথেনটিকেশনের উপর নির্ভর করে।
  • Docs : গুগল ডক্স-নির্ভর ইউটিলিটি ফাংশনসমূহ।
  • VertexAi : ভার্টেক্স এআই-এর উপর নির্ভরশীল ইউটিলিটি ফাংশন।

আর এখানে সেই অংশগুলো দেওয়া হলো যেগুলো জেমিনি দিয়ে রিপোর্ট ডকুমেন্ট এবং চ্যাট স্পেস হিস্ট্রি তৈরি করার সময় সক্রিয়ভাবে ব্যবহৃত হয়:

appsscript.json 

// Enables the Admin SDK Directory and Chat services, which you need to retrieve
// messages and usernames.

"enabledAdvancedServices": [
  ...
  {
    "userSymbol": "AdminDirectory",
    "version": "directory_v1",
    "serviceId": "admin"
  },
  {
    "userSymbol": "Chat",
    "version": "v1",
    "serviceId": "chat"
  }
  ...
]

// Includes the OAuth scopes to request the Admin SDK Directory, Google Chat,
// Google Docs, and Vertex AI APIs.

"oauthScopes": [
  ...
  "https://www.googleapis.com/auth/admin.directory.user.readonly",
  "https://www.googleapis.com/auth/chat.messages.readonly",
  "https://www.googleapis.com/auth/documents",
  "https://www.googleapis.com/auth/cloud-platform",
  ...
]

Configuration.js 

// Relies on two constants: the first one is the Google Cloud project ID and the
// second one is the Vertex AI location to be used.

...
const PROJECT_ID = 'replace-with-gcp-project-id';
const VERTEX_AI_LOCATION_ID = 'us-central1';
...

ChatApp.js 

// The slash command process function retrieves history, generates content, and passes
// it to the report generator.

function processSlashCommand(event) {
  ...
  if (event.message.slashCommand.commandId == CLOSE_COMMAND_ID
    && event.message.space.type !== "DM") {
    ...
    const history = exportSpaceHistory(spaceId);
    const summary = summarizeSpace(history);
    const docUrl = createReport(
      issue.title, issue.description, resolution, history, summary
    );
    ...
  }
  ...
}

/**
 * Fetches and concatenates the 100 first space messages by using the Google Chat API.
 *
 * Messages with slash commands are filtered (app command invocations).
 *
 * @return {string} concatenate space messages in the format "Sender's name: Message"
 */
function exportSpaceHistory(spaceName) {
  const messages = Chat.Spaces.Messages.list(spaceName, { 'pageSize': 100 }).messages;
  // Returns results after fetching message sender display names.
  let users = new Map();
  return messages
    .filter(message => message.slashCommand === undefined)
    .map(message =>
      `${getUserDisplayName(users, message.sender.name)}: ${message.text}`
    ).join('\n');
}

/**
 * Fetches a user's display name by using the Admin Directory API.
 *
 * A cache is used to only call the API once per user.
 *
 * @param {Map} cache the map containing users previously fetched
 * @param {string} userId the user ID to fetch
 * @return {string} the user's display name
 */
function getUserDisplayName(cache, userId) {
  if (cache.has(userId)) {
    return cache.get(userId);
  }
  let displayName = 'Unknown User';
  try {
    const user = AdminDirectory.Users.get(
      userId.replace("users/", ""),
      { projection: 'BASIC', viewType: 'domain_public' });
    displayName = user.name.displayName ? user.name.displayName : user.name.fullName;
  } catch (e) {
    // Ignores errors, uses 'Unknown User' by default.
  }
  cache.set(userId, displayName);
  return displayName;
}

VertexAi.js 

/**
 * Summarizes a Google Chat space history with the Gemini Pro model using
 * Vertex AI API.
 *
 * @param {string} history the history
 * @return {string} the summary
 */
function summarizeSpace(history) {
  const url = `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1`
    + `/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}`
    + "/publishers/google/models/gemini-1.0-pro:generateContent";
  const options = {
    method: "POST",
    headers: { Authorization: "Bearer " + ScriptApp.getOAuthToken() },
    contentType: "application/json",
    payload: JSON.stringify({
      contents: {
        role: "user",
        parts: {
          text: "Summarize the following conversation between engineers resolving"
              + " an issue in a few sentences.\n\n" + history
        }
      },
      safetySettings: {
        category: "HARM_CATEGORY_SEXUALLY_EXPLICIT",
        threshold: "BLOCK_LOW_AND_ABOVE"
      },
      generationConfig: {
        temperature: 0.2,
        topP: 0.8,
        topK: 40
      }
    })
  };

  return JSON.parse(UrlFetchApp.fetch(url, options).getContentText())
    .candidates[0].content.parts[0].text;
}

Docs.js 

// The report generator function adds two sections: the first one is for the summary and the second one is for history.
function createReport(..., history, summary) {
  ...
  body.appendParagraph("Summary").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(summary);
  body.appendParagraph("History").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(history);
  ...
}

গুগল ক্লাউড প্রজেক্ট আপডেট করুন

এপিআই সক্ষম করুন

  1. Google Cloud কনসোলে Google Docs , Google Admin SDK , এবং Vertex AI API-গুলো সক্রিয় করুন:

  1. মেনু ☰ > এপিআই ও পরিষেবা > সক্রিয় এপিআই ও পরিষেবা-তে ক্লিক করুন এবং তারপর এপিআইগুলো সক্রিয় আছে কিনা তা নিশ্চিত করুন।

পরিষেবা অ্যাকাউন্ট শুরু করুন

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > আইএএম ও অ্যাডমিন > সার্ভিস অ্যাকাউন্টস > + সার্ভিস অ্যাকাউন্ট তৈরি করুন- এ ক্লিক করুন।

74cf57426419f39.png

  1. সার্ভিস অ্যাকাউন্টের নাম chat-app এ সেট করুন।
  2. সার্ভিস অ্যাকাউন্টের বিবরণ Chat app auth -এ সেট করুন।
  3. তৈরি করুন-এ ক্লিক করুন এবং চালিয়ে যান ।
  4. 'সম্পন্ন' (Done ) ক্লিক করুন। আপনাকে পরিষেবা অ্যাকাউন্ট (Service accounts) পৃষ্ঠায় পুনঃনির্দেশিত করা হবে এবং আপনি আপনার তৈরি করা পরিষেবা অ্যাকাউন্টটি দেখতে পাবেন।

ca0468f1f93990f9.png

  1. নতুন তৈরি করা পরিষেবা অ্যাকাউন্টটি নির্বাচন করুন।
  2. Keys ট্যাবটি নির্বাচন করুন।
  3. চাবি যোগ করুন -এ ক্লিক করুন।
  4. নতুন কী তৈরি করুন -এ ক্লিক করুন।
  5. JSON নির্বাচন করুন।
  6. তৈরি করুন- এ ক্লিক করুন।

9f7e6ea020978ab0.png

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

গুগল চ্যাট এপিআই কনফিগারেশন আপডেট করুন

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  2. একটি স্ল্যাশ কমান্ড যোগ করুন।
  3. নাম /create এ সেট করুন।
  4. কমান্ড আইডি 1 এ সেট করুন।
  5. Create a new issue করতে বিবরণ সেট করুন।
  6. "একটি ডায়ালগ খোলে " চেকবক্সটি নির্বাচন করুন।
  7. আরেকটি স্ল্যাশ কমান্ড যোগ করুন।
  8. নাম /close এ সেট করুন।
  9. কমান্ড আইডি 2 এ সেট করুন।
  10. Close an issue করতে বিবরণ সেট করুন।
  11. সংরক্ষণ করুন- এ ক্লিক করুন।

bee2e7b63659ab33.png

অ্যাপস স্ক্রিপ্ট প্রকল্প আপডেট করুন

  • আপনার লোকাল টার্মিনালে বর্তমান ডিরেক্টরি পরিবর্তন করে issue-management/1-baseline এ যান। এখানেই সোর্স কোডটি রয়েছে। আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টে সোর্স কোডটি পুশ করার আগে, আপনাকে কয়েকটি বিষয় কনফিগার করতে হবে।

সোর্স কোড কনফিগার করুন

  1. Configuration.js ফাইলে CHAT_CREDENTIALS নামের JSON কনস্ট্যান্টটিতে আপনার পূর্বে ডাউনলোড করা প্রাইভেট কী ফাইলের কন্টেন্ট সেট করুন।

d721f6bff73c5304.png

  1. Google Cloud কনসোলে , মেনু ☰ > IAM ও অ্যাডমিন > সেটিংস- এ ক্লিক করুন।

  1. প্রজেক্ট আইডিটি কপি করুন।

82592fa0bd113469.png

  1. Configuration.js ফাইলে PROJECT_ID নামের স্ট্রিং কনস্ট্যান্টটিকে প্রজেক্ট আইডিতে সেট করুন।

383cee561130ceba.png

clasp সেটিংস কনফিগার করুন

সোর্স কোড সঠিক অ্যাপস স্ক্রিপ্ট প্রজেক্টে পুশ করার জন্য clasp ) সেটিংস ইনিশিয়ালাইজ করতে, এই ধাপগুলো অনুসরণ করুন:

  1. অ্যাপস স্ক্রিপ্ট কনসোলে আপনার প্রজেক্টটি নির্বাচন করুন।
  2. প্রজেক্ট সেটিংস নির্বাচন করুন।
  3. আইডি-এর নিচে, কপি-তে ক্লিক করুন।

20ea033b6de882c6.png

  1. বর্তমান ডিরেক্টরিতে একটি .clasp.json ফাইল তৈরি করুন।
  2. <your-script-id> এর জায়গায় কপি করা আইডিটি বসান।
  3. ফলাফলটি .clasp.json ফাইলে কপি করুন।
  4. .clasp.json ফাইলটি সংরক্ষণ করুন। 
{
  "scriptId": "<your-script-id>"
}

সোর্স কোড পুশ করুন

  • নিম্নলিখিত কমান্ডটি চালান: 
$clasp push
? Manifest file has been updated. Do you want to push and overwrite? Yes
└─ appsscript.json
└─ ChatApp.js
└─ ChatAppAuth.js
└─ Configuration.js
└─ Docs.js
└─ Storage.js
└─ VertexAi.js
Pushed 7 files.

চেষ্টা করে দেখুন

  1. গুগল চ্যাটে , অ্যাপটিকে সরাসরি মেসেজে Hello! পাঠান। অ্যাপটি কোনো উত্তর দেয় না, কিন্তু একটি মেসেজ আসে যা কনফিগারেশন করতে বলে।

4c1fc68121dcffed.png

  1. কনফিগার-এ ক্লিক করুন।
  2. আপনার গুগল অ্যাকাউন্ট নির্বাচন করুন।
  3. প্রমাণীকরণ করুন।
  4. পর্যালোচনা করুন এবং অ্যাপটিতে প্রবেশের অনুমতি দিন।

4a2fd7ac5918bf1a.png

সফল হলে, আপনি ওয়েব পেজে একটি সাধারণ নিশ্চিতকরণ স্ক্রিন এবং আপনার মূল বার্তার জবাবে অ্যাপ থেকে একটি প্রকৃত প্রতিক্রিয়া দেখতে পাবেন।

acb9065568fe47d2.png

2d6ef9c62f47e082.png

  1. অ্যাপটিতে আরেকটি সরাসরি বার্তা পাঠান, কিন্তু স্ল্যাশ কমান্ড /create ব্যবহার করে।

be3f3c6eb0f929c1.png

  1. ডায়ালগ বক্সে, Title-কে Issue Title 1 এ সেট করুন।
  2. বিবরণকে ইস্যু Description 1 এ সেট করুন।
  3. তৈরি করুন- এ ক্লিক করুন।

22efdecff4601417.png

অ্যাপটি নিম্নলিখিত কাজগুলো করে:

  1. ডায়ালগটি বন্ধ করে।
  2. একই শিরোনামে নতুন সৃষ্ট ইস্যুটির জন্য একটি নির্দিষ্ট স্থান তৈরি করে।
  3. নতুন তৈরি করা স্থানটিতে যোগদান করে।
  4. নতুন তৈরি করা স্পেসটিতে সমস্যাটির বিবরণসহ একটি বার্তা পাঠায়।
  5. নতুন তৈরি করা স্পেসটির লিঙ্কসহ আপনাকে একটি সরাসরি বার্তা পাঠানো হয়।

3253cec2392e281f.png

  1. নতুন তৈরি করা স্পেসে, স্ল্যাশ কমান্ড /close এবং Not reproducible এর মতো রেজোলিউশন সহ একটি মেসেজ পাঠান।

132cc4acfc10b98c.png

অ্যাপটি নিম্নলিখিত কাজগুলো করে:

  1. গুগল ডক্স-এ একটি রিপোর্ট ডকুমেন্ট তৈরি করে।
  2. সমস্যাটির জন্য নির্ধারিত স্থানে নতুন তৈরি হওয়া রিপোর্ট ডকুমেন্টের একটি লিঙ্কসহ একটি বার্তা পাঠায়।

2d127c63518673b2.png

  1. রিপোর্ট ডকুমেন্টটি খুলুন। এতে মৌলিক তথ্য, ইতিহাস এবং একটি সারসংক্ষেপ রয়েছে।

9aea694937f2f3ed.png

৪. ঐচ্ছিক: অ্যাপ ১: অ্যাপের হোমপেজে যোগ করুন

ধারণা পর্যালোচনা করুন

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

65f56f70f67a32e4.png

পর্যালোচনা প্রবাহ

সমস্যাগুলি পরিচালনা করুন

10663f5fc107fb3f.png

সোর্স কোড পর্যালোচনা করুন

অ্যাপস স্ক্রিপ্ট প্রজেক্টটি সম্পাদনা করা প্রয়োজন।

ChatApp.js 

/**
 * Handles app home requests in Google Chat.
 * 
 * Displays the latest status of all issues.
 */
function onAppHome() {
  // Generates one card section per issue.
  var sections = [];
  for (var issueKey in appProperties.getProperties()) {
    const issue = JSON.parse(appProperties.getProperty(issueKey));
    if (issue.spaceId) {
      sections.push({
        header: `${issue.status} - ${issue.title}`,
        widgets: [{ textParagraph: {
            text: `Description: ${issue.description}`
          }}, { textParagraph: {
            text: `Resolution: ${issue.resolution}`
          }}, { buttonList: { buttons: [{
              text: "Open space",
              onClick: { openLink: {
                url: `https://mail.google.com/mail/u/0/#chat/space/${issue.spaceId}`
              }}
            }, {
              text: "Open report",
              onClick: { openLink: {
                url: issue.reportUrl !== "" ? issue.reportUrl : "docs.new"
              }},
              disabled: issue.reportUrl === ""
          }]}
        }]
      });
    }
  }

  return { action: { navigations: [{ push_card: {
    sections: sections
  }}]}};
}

গুগল ক্লাউড প্রজেক্ট আপডেট করুন

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  2. ইন্টারেক্টিভ ফিচারস সেকশনের অধীনে, সাপোর্ট অ্যাপ হোম চেকবক্সটি সিলেক্ট করুন।

97159c1c69ca8303.png

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

  1. আপনার টার্মিনালে বর্তমান ডিরেক্টরি পরিবর্তন করে issue-management/2-app-home এ যান। এতে আপনার প্রয়োজনীয় সোর্স কোডটি রয়েছে।
  2. issue-management/1-baseline/.clasp.json ফাইলটি আপনার বর্তমান ডিরেক্টরিতে কপি করুন।
  3. issue-management/1-baseline/Configuration.js ফাইলটি আপনার বর্তমান ডিরেক্টরিতে কপি করুন, যাতে এটি বিদ্যমান ফাইলটিকে প্রতিস্থাপন করে।
  4. নিম্নলিখিত কমান্ডটি চালান: 
clasp push

চেষ্টা করে দেখুন

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

  1. স্ল্যাশ কমান্ড /create ব্যবহার করে অ্যাপটিতে একটি সরাসরি বার্তা পাঠান। অ্যাপটি একটি ডায়ালগ বক্স খুলবে।
  2. শিরোনামটি Issue Title 2 এ সেট করুন।
  3. বিবরণকে ইস্যু Description 2 এ সেট করুন।
  4. তৈরি করুন- এ ক্লিক করুন।

3b2a8690e758f965.png

  1. Google Chat অ্যাপে আপনার স্পেস থেকে হোম ট্যাবটি নির্বাচন করুন। সেখানে আপনি আপনার তৈরি করা ইস্যুগুলোর বিস্তারিত দেখতে পাবেন।

ed8e32da0e6f2ac6.png

৫. ঐচ্ছিক: অ্যাপ ১: স্থান পর্যবেক্ষণ যোগ করুন

ধারণা পর্যালোচনা করুন

পাব/সাব

পাব/সাব হলো একটি অ্যাসিঙ্ক্রোনাস এবং স্কেলেবল মেসেজিং পরিষেবা যা মেসেজ উৎপাদনকারী পরিষেবাগুলোকে সেই মেসেজগুলো প্রক্রিয়াকারী পরিষেবাগুলো থেকে বিচ্ছিন্ন করে। পাব/সাব আপনাকে ইভেন্ট উৎপাদনকারী এবং গ্রহণকারী সিস্টেম তৈরি করতে দেয়, যাদেরকে পাবলিশার এবং সাবস্ক্রাইবার বলা হয়। পাবলিশাররা সিঙ্ক্রোনাস রিমোট প্রসিডিউর কল (RPC)-এর পরিবর্তে ইভেন্ট ব্রডকাস্ট করার মাধ্যমে অ্যাসিঙ্ক্রোনাসভাবে সাবস্ক্রাইবারদের সাথে যোগাযোগ করে।

পাবলিশাররা ইভেন্টগুলো কীভাবে বা কখন প্রসেস করা হবে তা বিবেচনা না করেই পাব/সাব সার্ভিসে পাঠায়। এরপর পাব/সাব সেই সমস্ত সার্ভিসে ইভেন্টগুলো পৌঁছে দেয়, যারা সেগুলোতে সাড়া দেয়। RPC-এর মাধ্যমে যোগাযোগকারী সিস্টেমে, পাবলিশারদের অবশ্যই সাবস্ক্রাইবারদের ডেটা পাওয়ার জন্য অপেক্ষা করতে হয়। তবে, পাব/সাব-এর অ্যাসিঙ্ক্রোনাস ইন্টিগ্রেশন পুরো সিস্টেমের নমনীয়তা এবং দৃঢ়তা বৃদ্ধি করে।

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

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

গুগল ওয়ার্কস্পেস ইভেন্ট

গুগল ওয়ার্কস্পেস ইভেন্টগুলো গুগল ওয়ার্কস্পেস রিসোর্সের পরিবর্তন নির্দেশ করে, যেমন রিসোর্স তৈরি, আপডেট বা ডিলিট করা হলে। অ্যাপগুলো অ্যাসিঙ্ক্রোনাসভাবে প্রাসঙ্গিক ইভেন্টগুলো গ্রহণ ও প্রসেস করার জন্য গুগল ওয়ার্কস্পেস রিসোর্সগুলোতে সাবস্ক্রাইব করতে পারে।

7816e477b112bfb6.png

সাবস্ক্রিপশনের মাধ্যমে গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই যেভাবে একটি অ্যাপে ইভেন্ট সরবরাহ করে, তা নিচে দেওয়া হলো:

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

পর্যালোচনা প্রবাহ

সমস্যাটি তৈরি করুন (আপডেট)

6d7a9d7a68666a80.png

নির্দিষ্ট স্থান থেকে সমস্যার সমাধান করুন (আপডেট)

17e60f052f222456.png

নির্দিষ্ট স্থান থেকে সমস্যাটি বন্ধ করুন (আপডেট)

742d490ea0b6fe3a.png

সাবস্ক্রিপশন প্রক্রিয়া করুন

de3017100dec6401.png

সোর্স কোড পর্যালোচনা করুন

অ্যাপস স্ক্রিপ্ট প্রজেক্টটি সম্পাদনা করা প্রয়োজন।

appsscript.json 

// Enables the Workspace Events service.

"enabledAdvancedServices": [
  ...
  {
    "userSymbol": "WorkspaceEvents",
    "version": "v1",
    "serviceId": "workspaceevents"
  }
  ...
]

Configuration.js 

// Adds two constants: the first one is the Pub/Sub topic ID and the second one
// is the Pub/Sub subscription ID to be used to retrieve Google Workspace events.

...
const GWS_PUBSUB_TOPIC_ID = `projects/${PROJECT_ID}/topics/workspace-events`;
const GWS_PUBSUB_SUBSCRIPTION_ID =
  `projects/${PROJECT_ID}/subscriptions/workspace-events-sub`;
...

ChatApp.js 

// Edits the function to delete the subscription at issue closure.

function processSlashCommand(event) {
  ...
  if (event.message.slashCommand.commandId == CLOSE_COMMAND_ID
    && event.message.space.type !== "DM") {
    ...
    deleteSubscription(issue.subscriptionId);
    ...
  }
  ...
}

// Edits the function to create the subscription.

function createIssue(event) {
  ...
  const subscriptionId = createSpaceSubscription(spaceUrl);
  const createdIssue = saveCreatedIssue(..., subscriptionId);
  ...
}

// Edits the function to delete the subscription.

function onRemoveFromSpace(event) {
  ...
  deleteSubscription(issue.subscriptionId);
  ...
}

স্টোরেজ.জেএস 

// Edits the function to keep track of the subscription ID.

function saveCreatedIssue(..., spaceId, subscriptionId) {
  ...
  appProperties.setProperty(spaceId, JSON.stringify({
    ...
    subscriptionId: subscriptionId,
    ...
  }));
  ...
}

WorkspaceEvent.js 

/**
 * Creates a new subscription to Google Workspace Events associated to a
 * Google Chat space.
 * 
 * The subscription scope includes message creation events and resources.
 * 
 * @param {string} spaceId the space ID to create a subscription for
 * @return the ID of the newly created subscription
 */
function createSpaceSubscription(spaceId) {
  const operation = WorkspaceEvents.Subscriptions.create({
    targetResource: `//chat.googleapis.com/${spaceId}`,
    eventTypes: ["google.workspace.chat.message.v1.created"],
    notificationEndpoint: { pubsubTopic: GWS_PUBSUB_TOPIC_ID },
    payloadOptions: { includeResource: true },
  });

  return operation.response.name;
}

/**
 * Processes events from subscription by using the Google Cloud PubSub API.
 * 
 * It pulls and acknowledges each event.
 */
function processSubscription() {
  const response = UrlFetchApp.fetch(
    `https://pubsub.googleapis.com/v1/${GWS_PUBSUB_SUBSCRIPTION_ID}:pull`,
    {
      method: "POST",
      contentType: "application/json",
      headers: { "Authorization": "Bearer " + ScriptApp.getOAuthToken() },
      payload: JSON.stringify({ maxMessages: 10 })
    }
  );

  const messages = JSON.parse(response.getContentText()).receivedMessages;
  for (var messageIndex in messages) {
    const message = messages[messageIndex];
    const ceType = message.message.attributes["ce-type"];
    const dataStr = Utilities.newBlob(Utilities.base64Decode(message.message.data))
      .getDataAsString();
    if (ceType === "google.workspace.events.subscription.v1.expirationReminder") {
      // Renews subscription.
      renewSubscription(JSON.parse(dataStr).subscription.name);
    } else if (ceType === "google.workspace.chat.message.v1.created") {
      // Processes the message text when it's sent in a space.
      const chatMessage = JSON.parse(dataStr).message;
      if (chatMessage.sender.type !== "BOT") {
        console.log("Message was processed.");
      }
    }
    // Acknowledges successful processing to avoid getting it again next time.
    ackSubscription(message.ackId);
  }
}

/**
 * Acknowledges a subscription event by using the Google Cloud PubSub API.
 * 
 * @param {string} ackId the ID of the event acknowledgment to send
 */
function ackSubscription(ackId) {
  UrlFetchApp.fetch(
    `https://pubsub.googleapis.com/v1/${GWS_PUBSUB_SUBSCRIPTION_ID}:acknowledge`,
    {
      method: "POST",
      contentType: "application/json",
      headers: { "Authorization": "Bearer " + ScriptApp.getOAuthToken() },
      payload: JSON.stringify({
        ackIds: [ackId]
      })
    }
  );
}

/**
 * Renews a subscription to Google Workspace Events.
 * 
 * The default time to live option is used.
 * 
 * @param {string} subscriptionId the ID of the subscription to renew
 */
function renewSubscription(subscriptionId) {
  WorkspaceEvents.Subscriptions.patch({ttl: '0s'}, subscriptionId);
}

/**
 * Deletes a subscription to Google Workspace Events.
 * 
 * @param {string} subscriptionId the ID of the subscription to delete
 */
function deleteSubscription(subscriptionId) {
  WorkspaceEvents.Subscriptions.remove(subscriptionId);
}

গুগল ক্লাউড প্রজেক্ট আপডেট করুন

এপিআই সক্ষম করুন

  1. Google Cloud কনসোলে Google Workspace Events এবং PubSub সক্রিয় করুন।

  1. মেনু ☰ > এপিআই ও পরিষেবা > সক্রিয় এপিআই ও পরিষেবা- তে ক্লিক করুন এবং তারপর নিশ্চিত করুন যে উভয়ই সক্রিয় আছে।

সাবস্ক্রিপশন শুরু করুন

ওয়ার্কস্পেসের সমস্ত ইভেন্ট পোস্ট করার জন্য আপনাকে একটি পাব/সাব টপিক তৈরি করে তাতে সাবস্ক্রাইব করতে হবে।

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > পাব/সাব > টপিকস- এ যান।

  1. বিষয় তৈরি করুন- এ ক্লিক করুন।
  2. টপিক আইডি workspace-events এ সেট করুন।
  3. ডিফল্ট সাবস্ক্রিপশন যোগ করুন চেকবক্সটি নির্বাচন করুন।
  4. তৈরি করুন- এ ক্লিক করুন।

b39f9a0aec7c9939.png

গুগল চ্যাট থেকে আপনার নতুন তৈরি করা টপিকে পাব/সাব মেসেজ প্রকাশ করার অ্যাক্সেস দিতে, এই ধাপগুলো অনুসরণ করুন:

  1. তালিকা থেকে বিষয়টি নির্বাচন করুন।
  2. অনুমতি ট্যাবটি নির্বাচন করুন।
  3. নতুন প্রিন্সিপালগুলিতে chat-api-push@system.gserviceaccount.com যোগ করুন।
  4. ভূমিকার জন্য পাব/সাব প্রকাশক নির্বাচন করুন।
  5. সংরক্ষণ করুন- এ ক্লিক করুন।

8d4016c37532503.png

অ্যাপস স্ক্রিপ্ট প্রকল্প আপডেট করুন

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > আইএএম ও অ্যাডমিন > সেটিংস- এ যান।

  1. প্রজেক্ট আইডিটি কপি করুন।

82592fa0bd113469.png

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

  1. আপনার টার্মিনালে বর্তমান ডিরেক্টরি পরিবর্তন করে issue-management/3-message-monitoring এ যান। এতে আপনার প্রয়োজনীয় সোর্স কোডটি রয়েছে।
  2. Configuration.js ফাইলে PROJECT_ID নামের স্ট্রিং কনস্ট্যান্টটিতে কপি করা প্রজেক্ট আইডিটি সেট করুন।
  3. Configuration.js ফাইলে CHAT_CREDENTIALS নামের JSON কনস্ট্যান্টটিকে আপনার পূর্বে ডাউনলোড করা প্রাইভেট কী ফাইলের কন্টেন্ট দিয়ে সেট করুন।
  4. issue-management/2-app-home/.clasp.json ফাইলটি আপনার বর্তমান ডিরেক্টরিতে কপি করুন।
  5. নিম্নলিখিত কমান্ডটি চালান: 
clasp push

চেষ্টা করে দেখুন

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

  1. স্ল্যাশ কমান্ড /create ব্যবহার করে অ্যাপটিতে একটি সরাসরি বার্তা পাঠান। অ্যাপটি একটি ডায়ালগ বক্স খুলবে।
  2. শিরোনামটি Issue Title 3 এ সেট করুন।
  3. বিবরণকে ইস্যু Description 3 এ সেট করুন।
  4. তৈরি করুন- এ ক্লিক করুন।
  5. নতুন তৈরি করা স্থানটিতে বিষয়টি নিয়ে আলোচনা করে কয়েকটি বার্তা পাঠান।
  6. স্ল্যাশ কমান্ড /close এবং Fixed মতো রেজোলিউশন ব্যবহার করে একটি বার্তা পাঠান।

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > পাব/সাব > সাবস্ক্রিপশন- এ যান।

  1. `workspace-events-sub` সাবস্ক্রিপশনটি নির্বাচন করুন।
  2. মেসেজ ট্যাবটি নির্বাচন করুন।
  3. পুল-এ ক্লিক করুন। টেবিলটি নতুন তৈরি করা স্পেসে আপনার পাঠানো বার্তাগুলো প্রদর্শন করবে।

82631c9792d83889.png

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

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. সম্পাদক নির্বাচন করুন।
  3. WorkspaceEvent.gs ফাইলটি নির্বাচন করুন।
  4. রান সেকশনে processSubscription নির্বাচন করুন।
  5. Run ক্লিক করুন। এক্সিকিউশন লগ থেকে আপনি দেখতে পাবেন যে মেসেজগুলো প্রসেস করা হয়েছে।

c612e8fa2bd0a163.png

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > পাব/সাব > সাবস্ক্রিপশন- এ যান।

  1. `workspace-events-sub` সাবস্ক্রিপশনটি নির্বাচন করুন।
  2. মেসেজ ট্যাবটি নির্বাচন করুন।
  3. পুল-এ ক্লিক করুন। নতুন তৈরি করা স্পেসে আপনার পাঠানো বার্তাগুলো টেবিলটিতে আর দেখা যাবে না।

e185454cac862a7b.png

  • গুগল চ্যাটে , /create স্ল্যাশ কমান্ড দিয়ে আপনার তৈরি করা তৃতীয় ইস্যুটির জন্য নির্ধারিত জায়গায়, বিষয়টি নিয়ে আলোচনা করে আরও কয়েকটি মেসেজ পাঠান।

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > পাব/সাব > সাবস্ক্রিপশন- এ যান।

  1. `workspace-events-sub` সাবস্ক্রিপশনটি নির্বাচন করুন।
  2. মেসেজ ট্যাবটি নির্বাচন করুন।
  3. পুল-এ ক্লিক করুন। আপনি নতুন তৈরি করা স্পেসে যা পাঠিয়েছেন, তার সাথে সম্পর্কিত বার্তাগুলো টেবিলে প্রদর্শিত হয় না।

৬. ঐচ্ছিক: অ্যাপ ১: অন্তর্ভুক্তিমূলক সহায়তা যোগ করুন

ধারণা পর্যালোচনা করুন

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

পর্যালোচনা প্রবাহ

সাবস্ক্রিপশন প্রক্রিয়া করুন (আপডেট)

780d0802f77dd180.png

সোর্স কোড পর্যালোচনা করুন

অ্যাপস স্ক্রিপ্ট প্রজেক্টটি সম্পাদনা করা প্রয়োজন।

WorkspaceEvent.js 

// Edits the function to replace logging by an actual card message.

function processSubscription() {
  ...
  for (var messageIndex in messages) {
    ...
    } else if (ceType === "google.workspace.chat.message.v1.created") {
      ...
      const inclusivityCheck = getInclusivityFeedback(chatMessage.text);
      if (inclusivityCheck !== "It's inclusive!") {
        createAppMessageUsingChatService({
          cardsV2: [{ cardId: "1", card: { header: {
              title: "Inclusivity",
              subtitle: `The following words are not inclusive: ${inclusivityCheck}`
          }}}]
        },
        chatMessage.space.name);
      }
      ...
    }
    ...
  }
  ...
}

VertexAi.js 

/**
 * Gets feedback on inclusivity for a text with the Gemini Pro model using
 * Vertex AI API.
 * 
 * Returns "It's inclusive!" when it is otherwise a list of word(s) that might not
 * be optimal.
 *
 * @param {string} text the text
 * @return {string} the feedback
 */
function getInclusivityFeedback(text) {
  const url = `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1`
    + `/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}`
    + "/publishers/google/models/gemini-1.0-pro:generateContent";
  const options =  {
    method: "POST",
    headers: { Authorization: "Bearer " + ScriptApp.getOAuthToken() },
    contentType: "application/json",
    payload: JSON.stringify({
      contents: {
        role: "user",
        parts: {
          text: "Are there any words that obviously go against inclusivity "
            + "in this text:"
            + `\n\n----------\n${text}\n----------\n\n`
            + "If there are not, answer \"It's inclusive!\" "
            + "otherwise answer by listing them separated by commas. "
            + "Do not answer with any explanation."
        }
      },
      safetySettings: {
        category: "HARM_CATEGORY_SEXUALLY_EXPLICIT",
        threshold: "BLOCK_LOW_AND_ABOVE"
      },
      generationConfig: {
        temperature: 0.2,
        topP: 0.8,
        topK: 40
      }
    })
  };

  return JSON.parse(UrlFetchApp.fetch(url, options).getContentText())
    .candidates[0].content.parts[0].text;
}

অ্যাপস স্ক্রিপ্ট প্রকল্প আপডেট করুন

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

  1. আপনার টার্মিনালে বর্তমান ডিরেক্টরি পরিবর্তন করে issue-management/4-inclusivity-help এ যান। এতে আপনার প্রয়োজনীয় সোর্স কোডটি রয়েছে।
  2. issue-management/3-message-monitoring/.clasp.json ফাইলটি আপনার বর্তমান ডিরেক্টরিতে কপি করুন।
  3. issue-management/3-message-monitoring/Configuration.js ফাইলটি আপনার বর্তমান ডিরেক্টরিতে কপি করুন, যাতে এটি বিদ্যমান ফাইলটিকে প্রতিস্থাপন করে।
  4. নিম্নলিখিত কমান্ডটি চালান: 
clasp push

চেষ্টা করে দেখুন

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

  1. স্ল্যাশ কমান্ড /create ব্যবহার করে অ্যাপটিতে একটি সরাসরি বার্তা পাঠান। অ্যাপটি একটি ডায়ালগ বক্স খুলবে।
  2. শিরোনামটি Issue Title 4 এ সেট করুন।
  3. বিবরণকে ইস্যু Description 4 এ সেট করুন।
  4. তৈরি করুন- এ ক্লিক করুন।
  5. নতুন তৈরি করা জায়গায় পাঠান, It happened to me last week as well ।

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

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. সম্পাদক নির্বাচন করুন।
  3. WorkspaceEvent.gs ফাইলটি নির্বাচন করুন।
  4. রান সেকশনে processSubscription নির্বাচন করুন।
  5. রান-এ ক্লিক করুন। এক্সিকিউশন লগ থেকে আপনি দেখতে পাবেন যে মেসেজগুলো প্রসেস করা হয়েছে।

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

  1. লক্ষ্য করুন যে, অ্যাপটি নতুন তৈরি করা স্থানটিতে অন্তর্ভুক্তিমূলক কোনো সাহায্য পাঠায়নি।
  2. নতুন তৈরি করা স্পেসে এই বার্তাটি পাঠান যে, I had to add myself from the master to fix it ।

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

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. সম্পাদক নির্বাচন করুন।
  3. WorkspaceEvent.gs ফাইলটি নির্বাচন করুন।
  4. রান সেকশনে processSubscription নির্বাচন করুন।
  5. রান-এ ক্লিক করুন। এক্সিকিউশন লগ থেকে আপনি দেখতে পাবেন যে মেসেজগুলো প্রসেস করা হয়েছে। গুগল চ্যাট- এ, অ্যাপটি নতুন তৈরি করা স্পেসটিতে একটি ইনক্লুসিভিটি হেল্প মেসেজ পাঠিয়েছে।

7936342847acbe2d.png

৭. ঐচ্ছিক: অ্যাপ ১: পছন্দসমূহ যোগ করুন

.

ধারণা পর্যালোচনা করুন

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

eebe88238f6b13f.png

পর্যালোচনা প্রবাহ

অন্তর্ভুক্তি সহায়তা অক্ষম করুন

1bb7a8592ee6221e.png

সোর্স কোড পর্যালোচনা করুন

অ্যাপস স্ক্রিপ্ট প্রজেক্টটি সম্পাদনা করা প্রয়োজন।

ChatApp.js 

// Edits the function to handle the inclusivity help disablement action for a
// given space.

function onCardClick(event) {
  ...
  if (event.action.actionMethodName === "disableInclusivityHelp") {
    disableInclusivityHelp(event.common.parameters.spaceId);
  }
}

স্টোরেজ.জেএস 

// Edits the function to keep track of the inclusivity help setting.

function saveCreatedIssue(title, description, spaceId, subscriptionId) {
  appProperties.setProperty(spaceId, JSON.stringify({
    ...
    inclusivityHelp: true,
    ...
  }));
  ...
}

/**
 * Disables inclusivity help in a space.
 * 
 * @param {string} spaceId the ID of dedicated space of the issue
 */
function disableInclusivityHelp(spaceId) {
  var issue = JSON.parse(appProperties.getProperty(spaceId));
  issue.inclusivityHelp = false;
  appProperties.setProperty(spaceId, JSON.stringify(issue));
}

/**
 * Checks whether the app should help with inclusivity in a given space.
 * 
 * @param {string} spaceId the ID of dedicated space of the issue
 * @return whether the app should help with inclusivity
 */
function shouldHelpWithInclusivity(spaceId) {
  return JSON.parse(appProperties.getProperty(spaceId)).inclusivityHelp;
}

WorkspaceEvent.js 

// Edits the function to display the accessory widget to the existing card message.

function processSubscription() {
  ...
  for (var messageIndex in messages) {
    ...
    } else if (ceType === "google.workspace.chat.message.v1.created") {
      ...
      if (... && shouldHelpWithInclusivity(chatMessage.space.name)) {
        createAppMessageUsingChatService({
          ...
          accessoryWidgets: [{ buttonList: { buttons: [{
            altText: "Disable inclusivity help",
            icon: {
              iconUrl: "https://upload.wikimedia.org/.../Stop_hand_rugen.png"
            },
            onClick: { action: {
              function: "disableInclusivityHelp",
              parameters: [{
                key: "spaceId",
                value: chatMessage.space.name
              }]
            }}
          }]}}]
        }, ...);
        ...
      }
      ...
    }
    ...
  }
  ...
}

অ্যাপস স্ক্রিপ্ট প্রকল্প আপডেট করুন

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

  1. আপনার টার্মিনালে বর্তমান ডিরেক্টরি পরিবর্তন করে issue-management/5-disable-help এ যান। এর মধ্যেই আপনার প্রয়োজনীয় সোর্স কোডটি রয়েছে।
  2. issue-management/4-inclusivity-help/.clasp.json ফাইলটি আপনার বর্তমান ডিরেক্টরিতে কপি করুন।
  3. issue-management/4-inclusivity-help/Configuration.js ফাইলটি আপনার বর্তমান ডিরেক্টরিতে কপি করুন, যাতে এটি বিদ্যমান ফাইলটিকে প্রতিস্থাপন করে।
  4. নিম্নলিখিত কমান্ডটি চালান: 
clasp push

চেষ্টা করে দেখুন

অক্ষম সাহায্য

  • গুগল চ্যাটে , /create স্ল্যাশ কমান্ড দিয়ে আপনার তৈরি করা চতুর্থ ইস্যুটির জন্য নির্ধারিত জায়গায়, I had to add myself from the master to fix মেসেজটি পাঠান।

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

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. সম্পাদক নির্বাচন করুন।
  3. WorkspaceEvent.gs ফাইলটি নির্বাচন করুন।
  4. রান সেকশনে processSubscription নির্বাচন করুন।
  5. রান-এ ক্লিক করুন। এক্সিকিউশন লগ থেকে আপনি দেখতে পাবেন যে মেসেজগুলো প্রসেস করা হয়েছে।

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

  1. লক্ষ্য করুন যে, অ্যাপটি একটি অ্যাক্সেসরি উইজেটসহ সমস্যাটির জন্য নির্ধারিত স্থানে অন্তর্ভুক্তিমূলক সহায়তার একটি বার্তা পাঠিয়েছে।
  2. অন্তর্ভুক্তিমূলক সহায়তা নিষ্ক্রিয় করতে অ্যাকসেসরি উইজেটটিতে ক্লিক করুন।

de722cff1928dec9.png

চেক নিষ্ক্রিয়করণ

  • গুগল চ্যাটে , /create স্ল্যাশ কমান্ড দিয়ে আপনার তৈরি করা চতুর্থ ইস্যুটির জন্য নির্ধারিত জায়গায়, I had to add myself from the master to fix মেসেজটি পাঠান।

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

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. সম্পাদক নির্বাচন করুন।
  3. WorkspaceEvent.gs ফাইলটি নির্বাচন করুন।
  4. রান সেকশনে processSubscription নির্বাচন করুন।
  5. রান-এ ক্লিক করুন। এক্সিকিউশন লগ থেকে আপনি দেখতে পাবেন যে মেসেজগুলো প্রসেস করা হয়েছে। গুগল চ্যাট- এ, অ্যাপটি সমস্যাটির জন্য নির্ধারিত স্থানে ইনক্লুসিভিটি সংক্রান্ত সাহায্যের কোনো মেসেজ পাঠায়নি, কারণ সেটি নিষ্ক্রিয় করা ছিল।

347d659db53b73e9.png

৮. অ্যাপ ২: তৈরি করুন

ধারণা পর্যালোচনা করুন

জেন এআই গ্রাউন্ডিং

এর মূল উদ্দেশ্য হলো এআই মডেলগুলোকে যাচাইযোগ্য জ্ঞানের উৎসের সাথে সংযুক্ত করার মাধ্যমে সেগুলোকে আরও তথ্যভিত্তিক ও নির্ভরযোগ্য করে তোলা। এই কৌশলটি এআই-কে মনগড়া তথ্য তৈরি করা থেকে বিরত রাখতে সাহায্য করে এবং এর প্রতিক্রিয়াগুলোকে প্রাসঙ্গিকভাবে প্রাসঙ্গিক ও কম পক্ষপাতদুষ্ট করতে সহায়ক হতে পারে।

স্বাভাবিক ভাষা

দৈনন্দিন যোগাযোগের জন্য মানুষের ব্যবহৃত বা লিখিত যেকোনো ভাষা, যা কৃত্রিম বা কম্পিউটার-ভিত্তিক ভাষার বিপরীত।

ক্লাউড স্টোরেজ

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

ডায়ালগফ্লো সিএক্স ডেটা স্টোর

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

স্থাপত্য পর্যালোচনা

9d3342d12f3b4dda.png

এই গুগল চ্যাট অ্যাপটি Dialogflow CX দিয়ে তৈরি এবং এটি নিম্নোক্তভাবে কাজ করে:

  1. একজন ব্যবহারকারী সরাসরি বার্তা বা স্পেসের মাধ্যমে অ্যাপে একটি বার্তা পাঠান।
  2. অ্যাপটি, যা একটি Dialogflow CX এজেন্ট এবং একটি Google Cloud প্রজেক্টের সাথে যুক্ত, মেসেজটি প্রসেস করে।
  3. অ্যাপটি ক্লাউড স্টোরেজে অবস্থিত একটি ডেটা স্টোরের সাথে সমন্বিত হয়।
  4. অ্যাপটি সরাসরি বার্তায় অথবা মূল স্পেসে একযোগে প্রতিক্রিয়া পাঠায়।

পর্যালোচনা প্রবাহ

প্রশ্নের উত্তর দিন

aad9fb5a7ca48956.png

সোর্স কোড পর্যালোচনা করুন

আপনার একমাত্র যে উৎসটির প্রয়োজন, তা কোড নয়, বরং গ্রাউন্ডিংয়ের জন্য ব্যবহৃত ডেটা।

google-chat-overview.pdf

এতে গুগল চ্যাট অ্যাপগুলোর অসংগঠিত তথ্য এবং গুগল ওয়ার্কস্পেস ডেভেলপারস ওয়েবসাইটের একটি পৃষ্ঠার মুদ্রিত সংস্করণ রয়েছে।

e9b91c4587b1a3a0.png

গুগল ক্লাউড প্রজেক্ট আপডেট করুন

গুগল ক্লাউড কনসোলে, এই ধাপগুলো অনুসরণ করুন:

  1. Dialogflow এবং Cloud Storage API-গুলো সক্রিয় করুন।

  1. Vertex AI Agent Builder API সক্রিয় করুন।

  1. মেনু ☰ > এপিআই ও পরিষেবা > সক্রিয় এপিআই ও পরিষেবা- তে ক্লিক করুন এবং তারপর নিশ্চিত করুন যে সমস্ত এপিআই সক্রিয় আছে।

.

Dialogflow CX ডেটা স্টোর এজেন্ট তৈরি করুন

জ্ঞান ডেটা শুরু করুন

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনুতে যেতে ক্লিক করুন ☰ > ক্লাউড স্টোরেজ > বাকেটস ।

4f15978ae9f1b687.png

  1. তৈরি করুন- এ ক্লিক করুন।
  2. নাম gchat-knowledge এ সেট করুন।
  3. তৈরি করুন- এ ক্লিক করুন।

6b38c6d4d2c41bba.png

  1. gchat-knowledge বাকেটটি নির্বাচন করুন।
  2. ফাইল আপলোড করতে ক্লিক করুন।
  3. আপনার স্থানীয় পরিবেশ থেকে google-chat-overview.pdf ফাইলটি ডাউনলোড করে নির্বাচন করুন।

df89acb22e1762af.png

অ্যাপ তৈরি করুন

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > এজেন্ট বিল্ডার > অ্যাপস-এ ক্লিক করুন।

  1. নতুন অ্যাপে ক্লিক করুন।
  2. চ্যাটের ধরণ নির্বাচন করুন।

44276003074bcf14.png

  1. Company name আপনার কোম্পানির নামে সেট করুন।
  2. Agent name knowledge হিসেবে সেট করুন।
  3. চালিয়ে যান-এ ক্লিক করুন।

c4fedfd7556f723b.png

  1. নতুন ডেটা স্টোর তৈরি করুন -এ ক্লিক করুন।
  2. ডেটা উৎস হিসেবে ক্লাউড স্টোরেজ নির্বাচন করুন।

6e2440ecf0f8f9bd.png

  1. ফাইল নির্বাচন করুন।
  2. ব্রাউজ-এ ক্লিক করুন।
  3. google-chat-overview.pdf ফাইলটি নির্বাচন করুন।
  4. চালিয়ে যান-এ ক্লিক করুন।
  5. ডেটা স্টোরের নাম gchat-knowledge-ds এ সেট করুন।
  6. তৈরি করুন- এ ক্লিক করুন।

a675df7490b83900.png

  1. টেবিল থেকে gchat-knowledge-ds ডেটা স্টোরটি নির্বাচন করুন।
  2. তৈরি করুন- এ ক্লিক করুন।

f121d580771ed96.png

  1. কয়েক মিনিট পর, মেনু ☰ > এজেন্ট বিল্ডার > অ্যাপস-এ ক্লিক করুন এবং লক্ষ্য করুন যে আপনি অ্যাপটি দেখতে পাচ্ছেন।

d929a7431dd84968.png

  1. মেনু ☰ > এজেন্ট বিল্ডার > ডেটা স্টোর-এ ক্লিক করুন।

  1. gchat-knowledge-ds ডেটা স্টোরে ক্লিক করুন। ডকুমেন্টের সংখ্যা 1 , যা নির্দেশ করে যে এটি প্রস্তুত।

558319790a0accf2.png

অ্যাপটি সম্পূর্ণ এবং পরীক্ষা করুন

Dialogflow CX কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. আপনার গুগল ক্লাউড প্রজেক্টটি নির্বাচন করুন।
  2. নলেজ এজেন্ট নির্বাচন করুন।

ca9b2fb4be92e8e4.png

  1. এজেন্ট সেটিংস > জেনারেটিভ এআই > জেনারেটিভ এজেন্ট নির্বাচন করুন।
  2. মডেলটি টেক্সট বাইসন থেকে জেমিনি প্রো -তে পরিবর্তন করুন।
  3. সংরক্ষণ করুন- এ ক্লিক করুন।

68cc4713ec9b25a0.png

  1. টেস্ট এজেন্ট-এ ক্লিক করুন।
  2. What is Google Chat? " পাঠান। এজেন্ট অর্থপূর্ণ কিছু দিয়ে উত্তর দেয়।

8e3a2cb02469041a.png

গুগল চ্যাট অ্যাপ একীভূত করুন

Dialogflow CX কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. আপনার গুগল ক্লাউড প্রজেক্টটি নির্বাচন করুন।
  2. নলেজ এজেন্টের সারিতে ক্লিক করুন 1e7ede7abae4aa3c.png নামটি অনুলিপি করুন ।

e19f61185158110d.png

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. গুগল চ্যাট এপিআই কনফিগারেশনে যান।

  1. কানেকশন সেটিংস-এর অধীনে, ডায়ালগফ্লো নির্বাচন করুন।
  2. Dialogflow সেটিংস-এর অধীনে, Dialogflow CX নির্বাচন করুন।
  3. এজেন্ট বা এনভায়রনমেন্ট রিসোর্সের নাম হিসেবে আপনার কপি করা এজেন্টের নামটি সেট করুন।
  4. দুটি স্ল্যাশ কমান্ড মুছে ফেলুন।

505ff39a50880904.png

  1. গুগল চ্যাটে , গুগল চ্যাট অ্যাপে একটি সরাসরি মেসেজে What is Google Chat? পাঠান। এজেন্ট অর্থপূর্ণ কিছু দিয়ে উত্তর দেয়।

abda9e43b81fb0ea.png

৯. ঐচ্ছিক: অ্যাপ ২: উৎস যোগ করুন

ধারণা পর্যালোচনা করুন

Dialogflow CX ওয়েবহুক

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

ক্লাউড ফাংশন

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

পর্যালোচনা প্রবাহ

প্রশ্নের উত্তর দিন (আপডেট)

92767c07c7b252aa.png

সোর্স কোড পর্যালোচনা করুন

আপনার শুধু গুগল চ্যাট মেসেজের সাথে এজেন্টের প্রতিক্রিয়া মানিয়ে নেওয়ার ফাংশনটির সোর্স কোড প্রয়োজন। এটি একটি ওয়েবহুক হিসেবে ব্যবহৃত হয়।

প্যাকেজ.json 

// The function relies on the Cloud Functions framework to run.

{
  "name": "agent-response-adapter",
  "version": "0.0.1",
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  },
  ...
}

index.js 

/** 
 * Handles all incoming requests.
 *
 * It takes a Dialogflow CX agent response as input and returns a
 * valid Google Chat card message with both the text and source links
 */
functions.http('agent-response-adapter', (request, response) => {
  // Creates Google Chat buttons based on the data store agent response
  // grounding details.
  var linkTitles = [];
  var linkButtons = [];
  const grounding = request.body.messages[1].payload.richContent[0][0];
  if (grounding.type === "match_citations") {
    // Supports citation match type.
    grounding.citations.forEach((citation) => {
      // Avoid duplications.
      if (linkTitles.indexOf(citation.title) < 0) {
        linkButtons.push({
          text: citation.title,
          onClick: { openLink: {
            url: citation.actionLink
          }}
        });
        linkTitles.push(citation.title);
      }
    });
  } else if (grounding.type === "info") {
    // Supports info type.
    if (linkTitles.indexOf(grounding.title) < 0) {
      linkButtons.push({
        text: grounding.title,
        onClick: { openLink: {
          url: grounding.actionLink
        }}
      });
      linkTitles.push(grounding.title);
    }
  }

  // Sends the Dialogflow CX fulfillment response to replace the agent response
  // with the Chat message with text and source buttons.
  response.send({ fulfillment_response: {
    merge_behavior: "REPLACE",
    messages: [{ payload: {
      // Reuses the original data store agent response text.
      text: request.body.messages[0].text.text[0],
      cardsV2: [{
        cardId: "sourcesCard",
        card: { sections: [{
          header: "Sources",
          widgets: [{ buttonList: {
            buttons: linkButtons
          }}]
        }]}
      }]
    }}]
  }});
});

গুগল ক্লাউড প্রজেক্ট আপডেট করুন

গুগল ক্লাউড কনসোলে, এই ধাপগুলো অনুসরণ করুন:

  1. ক্লাউড বিল্ড, ক্লাউড ফাংশন, ক্লাউড লগিং, আর্টিফ্যাক্ট রেজিস্ট্রি এবং ক্লাউড রান এপিআইগুলো সক্রিয় করুন।

  1. মেনু ☰ > এপিআই ও পরিষেবা > সক্রিয় এপিআই ও পরিষেবা-তে ক্লিক করুন এবং তারপর এপিআইগুলো সক্রিয় আছে কিনা তা নিশ্চিত করুন।

Dialogflow CX ডেটা স্টোর এজেন্ট আপডেট করুন

আপনাকে একটি ক্লাউড ফাংশন ডেপ্লয় করতে হবে এবং ডায়ালগফ্লো সিএক্স ওয়েবহুক আপডেট করতে হবে, যাতে সম্ভব হলে একাধিক উৎস থেকে এটিকে ট্রিগার করা যায়।

একাধিক উৎস ফেরত দিন

ডিফল্টরূপে, একটি নতুন ডেটা স্টোর এজেন্ট সর্বোচ্চ একটি উৎসই ফেরত দেয়, কিন্তু আপনি চাইলে আরও উৎসের জন্য এটি পরিবর্তন করতে পারেন।

Dialogflow CX কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. আপনার গুগল ক্লাউড প্রজেক্টটি নির্বাচন করুন।
  2. নলেজ এজেন্ট নির্বাচন করুন।
  3. প্রারম্ভিক পৃষ্ঠা নির্বাচন করুন।
  4. ডেটা স্টোর সম্পাদনা নির্বাচন করুন।
  5. এজেন্ট প্রতিক্রিয়া বিভাগের অধীনে, ডেটা স্টোর প্রতিক্রিয়া বিকল্পগুলি 5 -এ সেট করুন।
  6. সংরক্ষণ করুন- এ ক্লিক করুন।

f5932d03057df645.png

ক্লাউড ফাংশন শুরু করুন

গুগল ক্লাউড কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. মেনু ☰ > ক্লাউড ফাংশন-এ ক্লিক করুন।

  1. ফাংশন তৈরি করুন -এ ক্লিক করুন।
  2. বেসিকস-এর অধীনে, নাম হিসেবে function-1 সেট করুন।
  3. Authentication-এর অধীনে, Allow unauthenticated invocations রেডিও বাটনটি নির্বাচন করুন।
  4. রানটাইম, বিল্ড, কানেকশন এবং সিকিউরিটি সেটিংস- এর অধীনে, ইনস্ট্যান্সের সর্বোচ্চ সংখ্যা 3 এ সেট করুন।
  5. পরবর্তী ধাপে যান।

bd3790a9285f9c07.png

  1. এন্ট্রি পয়েন্ট agent-response-adapter এ সেট করুন।
  2. ডিফল্ট কন্টেন্টটি package.json এবং index.js ফাইল দুটি দিয়ে প্রতিস্থাপন করুন।
  3. ডিপ্লয়-এ ক্লিক করুন।

b379bb8ca0fc1079.png

  1. ফাংশনটি ডেপ্লয় হওয়ার জন্য কয়েক মিনিট অপেক্ষা করার সময় URL-টি কপি করে নিন।

eaae08cf048b9b1c.png

ওয়েবহুক শুরু করুন

নতুনভাবে ডেপ্লয় করা ফাংশনটি ট্রিগার করার জন্য আপনাকে Dialogflow CX এজেন্টকে একটি ওয়েবহুক ব্যবহার করতে কনফিগার করতে হবে।

Dialogflow CX কনসোলে , এই ধাপগুলো অনুসরণ করুন:

  1. আপনার গুগল ক্লাউড প্রজেক্টটি নির্বাচন করুন।
  2. নলেজ এজেন্ট নির্বাচন করুন।
  3. ম্যানেজ > ওয়েবহুকস > ক্রিয়েট নির্বাচন করুন।
  4. ডিসপ্লে নাম হিসেবে Google Chat Response Adapter সেট করুন।
  5. পূর্বে কপি করা URL-টিতে ওয়েবহুক URL সেট করুন।
  6. সংরক্ষণ করুন- এ ক্লিক করুন।

5f3c6804d52b87c1.png

  1. বিল্ড-এ ক্লিক করুন।
  2. প্রারম্ভিক পৃষ্ঠা নির্বাচন করুন।
  3. ডেটা স্টোর সম্পাদনা নির্বাচন করুন।
  4. Under Webhook settings , click the Enable webhook toggle.
  5. Select Google Chat Response Adapter for Webhook .
  6. Set tag to arbitrary_tag .
  7. সংরক্ষণ করুন- এ ক্লিক করুন।

442fcaaec9b8f2e3.png

Test app

  • In Google Chat , send What is Google Chat? in a direct message to the Google Chat app. The agent responds with something meaningful and a card with sources, if any.

9468866bfe848bb8.png

10. App 3: Build

Review concepts

Conversational interactions

They are the back-and-forth exchanges of information or ideas between two or more people through natural language. This contrasts to technical interfaces that often rely on stateless, highly structured, and intolerant exchanges.

OpenAPI Specification

It provides a consistent means to carry information through each stage of the API lifecycle. It is a specification language for HTTP APIs that defines structure and syntax in a way that is not wedded to the programming language the API is created in. API specifications are typically written in YAML or JSON, allowing for easy sharing and consumption of the specification.

Dialogflow CX agent

The basic building block of agent apps . An agent app typically has many agents , where each agent is defined to handle specific tasks. The agent data is provided to the LLM, so it has the information it needs to answer questions and execute tasks. Each agent can provide information, send queries to external services, or defer conversation handling to a Dialogflow CX flow or another agent to handle sub-tasks.

Dialogflow CX tool

Tools are used to connect agent apps to external systems. These systems can augment the knowledge of agent apps and empower them to execute complex tasks efficiently.

Review architecture

9d3342d12f3b4dda.png

This Google Chat app is built with Dialogflow CX and works as follows:

  1. A user sends a message to the app, either in a direct message or in a space.
  2. The app, which is a Dialogflow CX agent and is associated with a Google Cloud project, processes the message.
  3. The app integrates with an agent.
  4. The app sends a synchronous response, either in a direct message or in the original space.

Review flows

Collect review

a67a5b8b513bfc2c.png

Review source code

The only source code that you need is the function to mock the backend service that the agent uses as a tool.

প্যাকেজ.json 

// The function relies on the Cloud Functions framework to run.

{
  "name": "feedback-app-backend",
  "version": "0.0.1",
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  },
  ...
}

index.js 

/** 
 * Handles all incoming requests.
 * 
 * It always returns OK in plain text.
 */
functions.http('feedback-app-backend', (request, response) => {
    response.send('OK');
});

service-openapi.yaml 

// Defines the backend service structure and how to request it.

openapi: 3.1.0
info:
  title: Review Store
  license:
    name: Apache 2.0
    identifier: Apache-2.0
  version: 0.0.1
servers:
  - url: https://us-central1-project-0.cloudfunctions.net
paths:
  /store-review:
    post:
      operationId: storeReview
      summary: Store a new review
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                stars:
                  type: integer
                  format: int64
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                type: string

Initiate backend service mock

You deploy a Cloud Function to simulate a backend service that the Dialogflow CX agent app needs to integrate and call as a tool.

In the Google Cloud console , follow these steps:

  1. Click Menu ☰ > Cloud Functions .

  1. Click Create function .
  2. Under Basics , set name to function-2 .
  3. Under Authentication , select the Allow unauthenticated invocations radio button.
  4. Under Runtime, build, connections and security settings , set Maximum number of instances to 3 .
  5. পরবর্তী ধাপে যান।

e8cf0ee7441bf634.png

  1. Set Entry point to feedback-app-backend .
  2. Replace the default content with the files package.json and index.js .
  3. ডিপ্লয়-এ ক্লিক করুন।

bdb5cf9f503aa7f6.png

  1. Copy the URL while you wait a couple minutes for the function to deploy.

Create Dialogflow CX agent app

অ্যাপ তৈরি করুন

In the Google Cloud console , follow these steps:

  1. Click Menu ☰ > Agent builder > Apps .

  1. Click New app .
  2. Select Agent .
  3. Set Display name to Feedback App .
  4. তৈরি করুন- এ ক্লিক করুন।

7ef3dbacee96c5aa.png

Initiate tool

In the Google Cloud console , follow these steps:

  1. Click Menu ☰ > Agent builder > Apps .

  1. Select the Feedback App agent.
  2. Click Tools > + Create .
  3. Set Name to review .
  4. Select OpenAPI .
  5. Set description to the following value: 
The tool takes the number of stars as a parameter of the store review method and saves it in a database for later use.
  1. Download and replace $URL in the file service-openapi.yaml with the URL that you copied previously.
  2. Set YAML Schema to the edited content of the service-openapi.yaml file.
  3. সংরক্ষণ করুন- এ ক্লিক করুন।

58085d6d56b603f7.png

Initiate agent

In the Google Cloud console , follow these steps:

  1. Click Menu ☰ > Agent builder > Apps .

  1. Select the Feedback App agent.
  2. Select Agents > Default Generative Agent .
  3. Set Agent name to Feedback collector .
  4. Set goal to the following value: 
You are an agent that collects reviews from Google Chat app developers.
A review may be between 0 and 5 stars. The more stars, the more positive the review.
  1. Set instructions to the following value: 
If the developer didn't provide the number of stars, ask for the number of stars.
After the developer provides the number of stars of the review, confirm the number with the developer and use ${TOOL: review} to store the review with the number of stars.
If ${TOOL: review} fails, apologize and ask to try again later. Otherwise, thank the developer for the review.
  1. সংরক্ষণ করুন- এ ক্লিক করুন।

ebee7fdfa826b487.png

Test app

In the Google Cloud console , follow these steps:

  1. Click Menu ☰ > Agent builder > Apps .

  1. Select the Feedback App agent.
  2. Go to Preview agent .
  3. Under Agent , select Feedback collector .
  4. Under Select generative model , select gemini-pro .
  5. Send the message Hello! to start.

90ca8cb7b2c1cb4b.png

In the Google Cloud console , follow these steps:

  1. Click Menu ☰ > Cloud Functions .

  1. Select function-2 > Logs . Some logs show Google-Dialogflow as caller.

48bfdf1788004d18.png

Integrate Google Chat app

In the Dialogflow CX console , follow these steps:

  1. Select your Google Cloud project.
  2. Click the action menu of the Feedback App agent.
  3. Click Copy name .

In the Google Cloud console , follow these steps:

  1. Go to the Google Chat API configuration.

  1. Set Agent or Environment resource name to the agent name that you copied previously.

df16619a1cb85cf8.png

  • In Google Chat , send Hello! in a direct message to the Google Chat app to start. The agent responds similarly to your test from the Dialogflow CX console.

99a7a0295f122f31.png

১১. পরিষ্কার করুন

Delete Google Cloud project

To avoid incurring charges to your Google Cloud Account for the resources used in this codelab, we recommend that you delete the Google Cloud project.

In the Google Cloud console , follow these steps:

  1. Click Menu ☰ > IAM & Admin > Settings .

  1. Click Shut down .
  2. Enter the project ID.
  3. Click Shut down anyway .

407699a4e03afea6.png

Delete Apps Script project

We recommend that you delete your Apps Script project, too.

In the Apps Script console , follow these steps:

  1. আপনার প্রকল্পটি নির্বাচন করুন।
  2. Click the action menu.
  3. Click Remove .

fa3a42d7d2201eb9.png

১২. অভিনন্দন

Congratulations! You built Google Chat apps with Gemini!

এরপর কী?

We only showcased simple use cases in this codelab, but there are plenty of expansion areas that you might want to consider in your Google Chat apps, such as the following:

  • Integrate with other Generative AI models, including customs.
  • Support other types of media, such as audio, image, and video.
  • Use multimodality.
  • Rely on longer context windows and feedback loops.
  • Publish production-ready Google Chat apps on the marketplace. There are plenty of resources available for developers such as YouTube videos, documentation websites, code samples, and tutorials.
  • Enable Google Chat for your organization. The import mode feature makes it easier to get started.

আরও জানুন