গুগল এআই স্টুডিওতে ফুল-স্ট্যাক অ্যাপ তৈরি করুন

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

সার্ভার-সাইড রানটাইম

গুগল এআই স্টুডিও অ্যাপ্লিকেশনগুলিতে এখন একটি সার্ভার-সাইড কম্পোনেন্ট (নোড.জেএস) অন্তর্ভুক্ত করা যায়। এর ফলে আপনি:

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

npm প্যাকেজ ব্যবহার করুন

আপনাকে ম্যানুয়ালি npm install চালানোর প্রয়োজন নেই। শুধু এজেন্টকে এমন কার্যকারিতা যোগ করতে বলুন যার জন্য প্যাকেজ প্রয়োজন, এবং এটি ইনস্টলেশন ও ইম্পোর্টের কাজটি সামলে নেবে।

উদাহরণ : > "বাহ্যিক এপিআই থেকে ডেটা আনতে axios ব্যবহার করুন।"

গোপনীয় তথ্য নিরাপদে পরিচালনা করুন

সার্ভার-সাইড কোড এবং সিক্রেটস ম্যানেজমেন্টের সাহায্যে, আপনি এখন এমন অ্যাপ তৈরি করতে পারেন যা বাইরের জগতের সাথে যোগাযোগ স্থাপন করে।

জেমিনি এপিআই কী

যখন আপনি জেমিনি এপিআই (Gemini API) ব্যবহার করে এমন একটি নতুন অ্যাপ তৈরি করেন, তখন এআই স্টুডিও (AI Studio) স্বয়ংক্রিয়ভাবে আপনার GEMINI_API_KEY একটি সার্ভার-সাইড সিক্রেট হিসেবে কনফিগার করে নেয় — এর জন্য কোনো ম্যানুয়াল সেটআপের প্রয়োজন হয় না। আপনি সেটিংস (Settings)-এর সিক্রেটস (Secrets ) প্যানেলে এই কী-টি দেখতে পারেন। আপনার অ্যাপের জেমিনি এপিআই কলগুলো এই কী ব্যবহার করে সার্ভার-সাইড কোড থেকে করা হয়, তাই এটি ব্রাউজারে কখনও প্রকাশ পায় না।

তৃতীয় পক্ষের এপিআই কী

অন্যান্য পরিষেবাগুলির জন্য, আপনি ম্যানুয়ালি এপিআই কী যোগ করতে পারেন:

  • তৃতীয় পক্ষের এপিআই : স্ট্রাইপ, সেন্ডগ্রিড বা কাস্টম REST এপিআই-এর মতো পরিষেবাগুলির সাথে সংযোগ করুন।
  • ডাটাবেস : সেশনের পরেও ডেটা সংরক্ষণ করতে বাহ্যিক ডাটাবেসের (যেমন, সুপাবেস, ফায়ারবেস বা মঙ্গোডিবি অ্যাটলাসের মাধ্যমে) সাথে সংযোগ স্থাপন করুন।

বাস্তব অ্যাপ তৈরি করার সময়, আপনাকে প্রায়শই তৃতীয় পক্ষের পরিষেবাগুলির (যেমন টুইলিও, স্ল্যাক, বা ডেটাবেস) সাথে সংযোগ করতে হয়, যেগুলির জন্য এপিআই কী (API key) প্রয়োজন। আপনি নিম্নলিখিত ধাপগুলি অনুসরণ করে ম্যানুয়ালি কী যোগ করতে পারেন:

  1. একটি গোপনীয় তথ্য যোগ করুন : Google AI Studio-এর সেটিংস মেনুতে যান এবং সিক্রেটস বিভাগটি খুঁজুন।
  2. আপনার কী সংরক্ষণ করুন : এখানে আপনার এপিআই কী বা গোপন টোকেন যোগ করুন।
  3. কোডের মাধ্যমে অ্যাক্সেস : এজেন্ট সার্ভার-সাইড কোড লিখতে পারে যা এই গোপনীয় তথ্যগুলোকে নিরাপদে অ্যাক্সেস করে (সাধারণত এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে), এবং এটি নিশ্চিত করে যে সেগুলো কখনোই ক্লায়েন্ট-সাইড ব্রাউজারের কাছে উন্মুক্ত হবে না।

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

ডাটাবেস এবং প্রমাণীকরণের জন্য ফায়ারবেস ইন্টিগ্রেশন

Google AI Studio এখন Firebase ইন্টিগ্রেশনের মাধ্যমে আপনার অ্যাপে ডেটাবেস বা অথেনটিকেশন যোগ করা সহজ করে দিয়েছে। Antigravity Agent আপনার জন্য নিম্নলিখিত পরিষেবাগুলি স্বয়ংক্রিয়ভাবে প্রোভিশন এবং সেট আপ করতে পারে:

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

এজেন্টকে শুধু "আমার অ্যাপে একটি ডেটাবেস যোগ করুন" বা "গুগল সাইন-ইন সেট আপ করুন" বলতে হবে, এবং এটি আপনার জন্য প্রয়োজনীয় কনফিগারেশন ও কোড জেনারেশনের কাজটি করে দেবে।

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

গুগল ওয়ার্কস্পেস এপিআই

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

এটি কীভাবে কাজ করে

আপনি দুটি উপায়ে ওয়ার্কস্পেস ইন্টিগ্রেশন যোগ করতে পারেন:

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

আপনি যখন একটি ওয়ার্কস্পেস অ্যাপ যোগ করেন, AI Studio স্বয়ংক্রিয়ভাবে:

  1. আপনার অ্যাপের জন্য প্রয়োজনীয় গুগল এপিআই সংযুক্ত করে।
  2. এপিআই কল করার জন্য সার্ভার-সাইড কোড তৈরি করে।
  3. একটি সুরক্ষিত 'গুগল দিয়ে সাইন ইন' প্রক্রিয়া যোগ করে, যাতে আপনার অ্যাপের ব্যবহারকারীরা তাদের নিজেদের ডেটাতে অ্যাক্সেসের অনুমোদন দিতে পারেন।

সমর্থিত অ্যাপগুলি

নিম্নলিখিত গুগল ওয়ার্কস্পেস অ্যাপগুলি উপলব্ধ আছে:

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

প্রমাণীকরণ এবং অনুমতি

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

যেসব অ্যাপে ওয়ার্কস্পেস এপিআই (Workspace API) সংযুক্ত থাকে, সেগুলো ব্যবহারকারীদের প্রমাণীকরণের জন্য 'সাইন ইন উইথ গুগল' (Sign in with Google) ব্যবহার করে। যখন কোনো ব্যবহারকারী আপনার অ্যাপটি খোলেন, তখন তাকে সাইন ইন করতে এবং আপনার অ্যাপের প্রয়োজনীয় নির্দিষ্ট অনুমতিগুলো (যেমন, তার ক্যালেন্ডারে শুধু-পড়ার অ্যাক্সেস, বা একটি স্প্রেডশিট সম্পাদনা করার ক্ষমতা) দেওয়ার জন্য অনুরোধ করা হয়। আপনার অ্যাপটি শুধুমাত্র ব্যবহারকারীর ডেটা অ্যাক্সেস করতে পারে। প্রত্যেক ব্যবহারকারী তার নিজের অ্যাকাউন্টে অ্যাক্সেসের অনুমোদন দেন।

উদাহরণ প্রম্পট

ওয়ার্কস্পেস ইন্টিগ্রেশন শুরু করার জন্য এখানে কয়েকটি উপায় দেওয়া হলো:

  • এমন একটি অ্যাপ তৈরি করুন যা আমার গুগল ক্যালেন্ডার পড়ে প্রতিটি মিটিংয়ের জন্য জিমেইলে প্রস্তুতিমূলক ইমেলের খসড়া তৈরি করবে।
  • এমন একটি টুল তৈরি করুন যা একটি গুগল ডক থেকে গুগল স্লাইডসে ৫টি স্লাইডের একটি সারাংশ প্রেজেন্টেশন তৈরি করবে।
  • একটি খরচ ট্র্যাকার তৈরি করুন যেখানে আমি একটি রসিদ আপলোড করব, জেমিনি তার বিবরণ বের করে নেবে এবং আমার গুগল শিটে একটি নতুন সারি যোগ করবে।

OAuth সেট আপ করুন

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

মাল্টিপ্লেয়ার অভিজ্ঞতা তৈরি করুন

ফুল-স্ট্যাক রানটাইম রিয়েল-টাইম কোলাবোরেশন ফিচারগুলো সক্ষম করে।

  • রিয়েল-টাইম অবস্থা : আপনি এজেন্টকে 'একটি লাইভ চ্যাট,' 'একটি সহযোগিতামূলক হোয়াইটবোর্ড,' বা 'একটি মাল্টিপ্লেয়ার গেম'-এর মতো ফিচার তৈরি করতে বলতে পারেন।
  • সিঙ্কড সেশন : সার্ভার স্টেট পরিচালনা করে, যার ফলে একাধিক ব্যবহারকারী রিয়েল-টাইমে একই অ্যাপ্লিকেশন ইনস্ট্যান্সের সাথে ইন্টারঅ্যাক্ট করতে পারে।

উদাহরণ নির্দেশ : > 'এটিকে একটি মাল্টিপ্লেয়ার গেম বানান যেখানে খেলোয়াড়রা একে অপরের কার্সার দেখতে পাবে।'

মাল্টিপ্লেয়ার অ্যাপ পরীক্ষা করার জন্য কিছু পরামর্শ

আপনার অ্যাপটি প্রকাশ করার আগে আপনি দুইভাবে মাল্টিপ্লেয়ার মোড পরীক্ষা করতে পারেন।

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

সর্বোত্তম অনুশীলন

  • জেমিনি এপিআই কল : আপনার GEMINI_API_KEY স্বয়ংক্রিয়ভাবে একটি সার্ভার-সাইড সিক্রেট হিসেবে কনফিগার করা হয়। এই কী ব্যবহার করে আপনার সার্ভার-সাইড কোড থেকে জেমিনি এপিআই কল করুন। আপনি এটি সিক্রেটস প্যানেলে দেখতে পারেন।
  • গোপনীয় তথ্যের নিরাপত্তা : সংবেদনশীল কী-গুলোর জন্য সর্বদা সিক্রেটস ম্যানেজার ব্যবহার করুন। আপনার ফাইলগুলিতে এগুলি কখনও হার্ডকোড করবেন না।
  • দায়িত্বের পৃথকীকরণ : আপনার UI লজিক ক্লায়েন্ট-সাইড ফ্রেমওয়ার্কে (React/Angular) এবং বিজনেস লজিক ও ডেটা হ্যান্ডলিং সার্ভার-সাইডে রাখুন।
  • ত্রুটি পরিচালনা : অ্যাপটি ক্র্যাশ হওয়া থেকে বাঁচাতে, আপনার সার্ভার-সাইড কোড যেন বাহ্যিক API কল থেকে আসা ত্রুটিগুলো দৃঢ়ভাবে পরিচালনা করে, তা নিশ্চিত করুন।

এরপর কী?