আপনার Google AI স্টুডিও অ্যাপে ক্লাউড ফায়ারস্টোর এবং প্রমাণীকরণ যোগ করুন

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

সংক্ষিপ্ত বিবরণ: আপনার গুগল এআই স্টুডিও অ্যাপে একটি ব্যাকএন্ড যোগ করুন

1. আপনার ধারণাটি বর্ণনা করুন : Google AI Studio- তে একটি নতুন অ্যাপ তৈরি করুন এবং এমন একটি ফিচারের বর্ণনা দিন যার জন্য ডাটাবেস বা অথেনটিকেশন প্রয়োজন। উদাহরণস্বরূপ, আপনি এই প্রম্পটটি লিখতে পারেন: Build a shared to-do list app using Firebase as a backend.

2. ফায়ারবেস ইন্টিগ্রেশন সক্রিয় করুন : এজেন্ট অনুরোধ করলে, ফায়ারবেস সক্রিয় করুন, আপনার প্রোজেক্টের জন্য একটি অবস্থান নির্বাচন করুন এবং ফায়ারবেসের শর্তাবলী গ্রহণ করুন। এরপর এজেন্ট স্বয়ংক্রিয়ভাবে আপনার অ্যাপকে আপনার ফায়ারবেস প্রোজেক্টের সাথে সংযুক্ত করে এবং আপনার অ্যাপের জন্য প্রয়োজনীয় Cloud Firestore ও Authentication কোড তৈরি করে, যার মধ্যে একটি /src/lib/firebase.ts ফাইল এবং একটি firestore.rules ফাইল অন্তর্ভুক্ত থাকে।

3. স্থাপন করুন : প্রস্তুত হয়ে গেলে, আপনার ওয়েব অ্যাপটি Cloud Run এ স্থাপন করতে শেয়ার > পাবলিশ বিকল্পটি ব্যবহার করুন।

Cloud Firestore জন্য শেয়ার্ড কোটা বুঝুন

Google AI Studio এজেন্ট দ্বারা প্রোভিশন করা সমস্ত Cloud Firestore ডেটাবেস আপনার ফায়ারবেস প্রোজেক্টের একই ডেটাবেস "গ্রুপে" রাখা হয়। তাদের সকলের মধ্যে এই বৈশিষ্ট্যগুলো বিদ্যমান:

• যৌথ কোটা : গ্রুপের সমস্ত ডেটাবেস একটি ব্যবহারের কোটা ভাগ করে নেয় ( বিস্তারিত নিচে দেখুন )।
• কোনো Cloud Billing অ্যাকাউন্টের প্রয়োজন নেই : আপনি বিলিং যোগ না করেই আপনার অ্যাপ তৈরি ও পরীক্ষা করতে পারেন। ঐচ্ছিকভাবে বিলিং যোগ করার বিষয়ে বিস্তারিত জানতে নিচে দেখুন।
• দৈনিক রিসেট : যদি আপনি দৈনিক কোটার সীমায় পৌঁছে যান (উদাহরণস্বরূপ, প্রতিদিন ৫০ হাজার রিড), তাহলে গ্রুপের অন্তর্ভুক্ত সমস্ত ডেটাবেসের জন্য পরিষেবাটি বিরতি নেবে এবং পরের দিন প্যাসিফিক সময় অনুযায়ী প্রায় মধ্যরাতে পুনরায় চালু হবে।

শেয়ার্ড কোটা গ্রুপের Cloud Firestore ডেটাবেসগুলো নিম্নলিখিত সীমাগুলো শেয়ার করে:

(ঐচ্ছিক) আরও Cloud Firestore কোটা পেতে বিলিং যোগ করুন।

যদি আপনার অ্যাপটি জনপ্রিয়তা লাভ করে এবং আপনার Cloud Firestore বিনামূল্যের সীমা অতিক্রম করার প্রয়োজন হয়, তাহলে আপনি আপনার প্রজেক্টটি পে-অ্যাজ-ইউ-গো ব্লেজ প্রাইসিং প্ল্যানে আপগ্রেড করতে পারেন।

1. বিলিং যোগ করুন (যদি আগে থেকে করা না থাকে) : Firebase কনসোলে যান এবং আপনার প্রোজেক্টের সাথে একটি বিলিং অ্যাকাউন্ট লিঙ্ক করুন ।

2. ডাটাবেস আপগ্রেড করুন : ডিফল্টরূপে, Google AI Studio এজেন্ট দ্বারা তৈরি Cloud Firestore ডাটাবেসগুলি আপনার প্রাইসিং প্ল্যান আপগ্রেড করার পরেও শেয়ার্ড কোটা ব্যবহার করতে থাকে। একটি নির্দিষ্ট ডাটাবেসের জন্য সম্পূর্ণ পেইড স্কেলিং সক্রিয় করতে, আপনাকে অবশ্যই একটি curl কমান্ড ব্যবহার করে সেটিকে ম্যানুয়ালি গ্রুপ থেকে সরিয়ে নিতে হবে।

   • PROJECT_ID : ফায়ারবেস প্রজেক্ট আইডি; এই আইডিটি Firebase কনসোলের প্রজেক্ট সেটিংসে খুঁজুন।

   • DATABASE_ID : Cloud Firestore ডেটাবেস আইডি, যা আপনার অ্যাপলেট আইডির সাথে মিলবে; Firebase কনসোলের Cloud Firestore ডেটাবেস পৃষ্ঠার ' Name' কলামে এই ডেটাবেস আইডিটি খুঁজুন।

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=free_tier_limited" \
   -d '{"free_tier_limited": false}'
   

Security Rules তৈরি

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

মনে রাখবেন যে, আপনি যদি সরাসরি Firebase কনসোলে ম্যানুয়ালি আপনার Security Rules পরিবর্তন করেন, তাহলে Google AI Studio এজেন্ট সেই পরিবর্তনগুলো সম্পর্কে জানতে পারবে না এবং পরবর্তী অ্যাপ সংস্করণগুলোতে সেগুলো ওভাররাইট হয়ে যাবে। আমরা আপনার Firebase Security Rules পরিবর্তন করার জন্য Google AI Studio এজেন্ট ব্যবহার করার পরামর্শ দিই, যাতে আপনার পরিবর্তনগুলো সংরক্ষিত থাকে এবং আপনার অ্যাপের লজিকের সাথে সামঞ্জস্যপূর্ণ থাকে।

একটি বিদ্যমান প্রকল্প ব্যবহার করুন

আপনি আপনার মালিকানাধীন কোনো বিদ্যমান Google Cloud প্রজেক্টে Cloud Firestore প্রোভিশন করার জন্য গুগল এআই স্টুডিও এজেন্টকে অনুরোধ করতে পারেন। এজেন্টকে আপনার বিদ্যমান প্রজেক্টটি ব্যবহার করার জন্য নিম্নলিখিত প্রম্পটের মাধ্যমে নির্দেশ দিন:

Add Firestore to this app using project PROJECT_ID.

• শেয়ার্ড কোটা ব্যবহার করে ওই প্রজেক্টে একটি নতুন Cloud Firestore ডেটাবেস প্রোভিশন করা হবে ।
• গুগল সাইন-ইন সহ Firebase Authentication কনফিগার করা হবে।
• একটি সার্ভিস অ্যাকাউন্টকে আপনার Cloud Firestore ডেটাবেসে অ্যাক্সেস দেওয়া হবে। গুগল এআই স্টুডিও থেকে অ্যাডমিনিস্ট্রেটর অ্যাক্সেস দেওয়ার জন্য, ais-sandbox@ PROJECT_ID .iam.gservice.com নামের একটি নতুন সার্ভিস অ্যাকাউন্টকে আপনার Cloud Firestore ডেটাবেস অ্যাক্সেস করার অনুমতি দেওয়া হবে। এই অ্যাকাউন্টটি শুধুমাত্র আপনার গুগল এআই স্টুডিও অ্যাপগুলোর সাথে যুক্ত থাকবে।
• সীমাবদ্ধতা : যদি Firebase প্রজেক্টটিতে আগে থেকেই একটি Cloud Firestore ডেটাবেস থাকে, তাহলে এজেন্টটি নতুন কোনো ডেটাবেস যোগ করতে পারবে না। এটি ব্যবহার করার জন্য আপনাকে একটি নতুন, খালি প্রজেক্ট তৈরি করতে হবে।

Firebase কনসোল ব্যবহার করুন

আপনি Firebase কনসোলে আপনার অ্যাপের ডেটা এবং সেটিংস দেখতে পারেন। Google AI Studio- এর সাথে যুক্ত আপনার প্রোজেক্টগুলো অ্যাক্সেস করতে, এই ধাপগুলো অনুসরণ করুন:

1. Firebase কনসোলে যান এবং AI Studio লেবেলযুক্ত প্রজেক্টটি নির্বাচন করুন।

2. বাম দিকের নেভিগেশন প্যানে, Cloud Firestore আপনার ডেটা দেখতে ও সম্পাদনা করতে Build > Cloud Firestore Database-এ ক্লিক করুন, অথবা আপনার Authentication সেটিংস ও ডেটা কনফিগার করতে Build > Authentication ক্লিক করুন।

সমস্যা সমাধান এবং প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী

আপনার গুগল এআই স্টুডিও অ্যাপের সাথে ফায়ারবেস ইন্টিগ্রেট করার সময় সাধারণ প্রশ্নের উত্তর খুঁজুন এবং সমস্যা সমাধানের উপায় জানুন।

আমার গুগল ক্লাউড / ফায়ারবেস প্রজেক্টটি কীভাবে নির্বাচন করা হয়?

আপনি যখন 'Add Firebase backend' ফিচারটি ব্যবহার করেন, তখন Google AI Studio এজেন্ট আপনার অ্যাপের ব্যাকএন্ড পরিষেবাগুলির ( Cloud Firestore এবং Firebase Authentication ) জন্য স্বয়ংক্রিয়ভাবে একটি Firebase প্রজেক্ট নির্বাচন করে।

এর পরিবর্তে আপনি যদি কোনো নির্দিষ্ট প্রজেক্ট ব্যবহার করতে চান, তাহলে এজেন্টকে নিম্নলিখিত প্রম্পটের মাধ্যমে তা করার নির্দেশ দিতে পারেন:

Use project PROJECT_ID for the Firebase backend.

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

কোন কোন প্রমাণীকরণ পদ্ধতি সমর্থিত?

আপনি যখন 'Add Firebase backend ' ফিচারটি ব্যবহার করেন, তখন Google AI Studio এজেন্ট Google Sign-In সেট আপ করে। অতিরিক্ত মেথড সেট আপ করার জন্য, Firebase কনসোলে সেগুলোকে সক্রিয় করুন এবং আপনার কোডবেস আপডেট করার জন্য Google AI Studio এজেন্টের কাছে সহায়তা চান।

আমি কি গুগল এআই স্টুডিও দিয়ে মোবাইল অ্যাপ (যেমন অ্যান্ড্রয়েড বা আইওএস) তৈরি করতে পারি?

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

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

firebase-blueprint.json ফাইলটি কী?

এটি একটি অন্তর্বর্তী ফাইল যা গুগল এআই স্টুডিও এজেন্ট আপনার অ্যাপের কোডবেস বোঝার জন্য ব্যবহার করে। এই ফাইলটি নিজে থেকে পরিবর্তন করবেন না, কারণ এর ফলে এজেন্ট ভুল কোড অথবা অনিরাপদ Security Rules তৈরি করতে পারে।

"কোটা অতিক্রম করেছে" ত্রুটি পেলে আমার কী করা উচিত?

Cloud Firestore কোটার সীমায় পৌঁছানোর অর্থ হলো, আপনার অ্যাপটি Cloud Firestore ডাটাবেস শেয়ার্ড কোটা গ্রুপের জন্য নির্ধারিত দৈনিক ব্যবহারের সর্বোচ্চ সীমায় পৌঁছে গেছে। এটি সমাধান করার দুটি উপায় রয়েছে:

• বিকল্প ১: অপেক্ষা করুন : প্যাসিফিক সময় অনুযায়ী প্রতিদিন মধ্যরাতের কাছাকাছি সময়ে কোটা রিসেট হয়।
• বিকল্প ২: আপগ্রেড : পে-অ্যাজ-ইউ-গো ব্লেজ প্রাইসিং প্ল্যানে আপগ্রেড করুন।
  • যদি গুগল এআই স্টুডিও এজেন্ট আপনার জন্য Cloud Firestore সেট আপ করে থাকে, তাহলে আপনার ডাটাবেসকে একটি নিয়মিত পেইড অবস্থায় নিয়ে যাওয়ার জন্য আরও ক্লাউড ফায়ারস্টোর কোটা পেতে আপনাকে অবশ্যই 'বিলিং যোগ করুন' অংশে বর্ণিত curl কমান্ডটি ব্যবহার করতে হবে। যদি আপনি নিজে Cloud Firestore সেট আপ করে থাকেন, তাহলে curl কমান্ডটি চালানোর প্রয়োজন নেই।

"অনুপস্থিত বা অপর্যাপ্ত অনুমতি" ত্রুটি পেলে আমার কী করা উচিত?

এই ত্রুটিটি তখন ঘটে যখন আপনার অ্যাপ আপনার Cloud Firestore ডেটাবেসে ডেটা পড়তে বা লিখতে চেষ্টা করে, কিন্তু আপনার Security Rules দ্বারা অনুরোধটি প্রত্যাখ্যাত হয়। এটি নির্দেশ করে যে Security Rules বর্তমান প্রমাণীকরণ অবস্থা বা ডেটা পাথের উপর ভিত্তি করে চেষ্টাকৃত অপারেশনটির অনুমতি দিচ্ছে না। গুগল এআই স্টুডিও এজেন্টকে Security Rules সংশোধন করার চেষ্টা করতে নির্দেশ দেওয়ার জন্য 'ত্রুটি সংশোধন করুন' (Fix error) বোতামটিতে ক্লিক করুন।

আমি আমার গুগল এআই স্টুডিও অ্যাপটি ডিলিট করলে আমার ফায়ারবেস ব্যাকএন্ডের কী হবে?

Google AI Studio থেকে আপনার অ্যাপ্লিকেশন ডিলিট করলে এর সাথে সংযুক্ত Firebase প্রজেক্ট, Cloud Firestore ডেটাবেস বা Firebase Authentication কনফিগারেশন স্বয়ংক্রিয়ভাবে ডিলিট হয় না।

আপনি যদি একটি Firebase ব্যাকএন্ড যোগ করে থাকেন, তবে সমস্ত ডেটা এবং কনফিগারেশন মুছে ফেলা নিশ্চিত করতে আপনাকে অবশ্যই ম্যানুয়ালি Firebase কনসোলে গিয়ে প্রজেক্টটি ডিলিট করতে হবে অথবা স্বতন্ত্র রিসোর্সগুলো (যেমন Cloud Firestore ডেটাবেস ইনস্ট্যান্স এবং Authentication প্রোভাইডার) ক্লিন আপ করতে হবে।

গুগল এআই স্টুডিও এজেন্ট কি আমার Cloud Firestore ডেটাবেস থেকে ডেটা মুছে ফেলতে বা সম্পাদনা করতে পারে?

গুগল এআই স্টুডিও এজেন্টটি প্রয়োজনীয় ব্যাকএন্ড রিসোর্স সরবরাহ করতে এবং কোড ও Security Rules তৈরি করতে সাহায্য করার জন্য ডিজাইন করা হয়েছে। যদিও এজেন্টটি নিজে আপনার Cloud Firestore ডেটাবেসের ডেটা এন্ট্রি সরাসরি ডিলিট, এডিট বা ম্যানিপুলেট করতে পারে না, তবে এটি আপনার অ্যাপলেটে এমন কোড লিখতে পারে যা এই কাজগুলো করার জন্য ডিজাইন করা হয়েছে। এন্ট্রি ডিলিট করার মতো ডেটা ম্যানেজমেন্টের কাজগুলো করতে, Firebase কনসোলে Cloud Firestore ডেটাবেস পেজে যান।

আমি এমন একটি প্রতিষ্ঠানে কর্মরত যেটি Google Cloud ব্যবহার করে; আমি কি আমার গুগল এআই স্টুডিও অ্যাপটিকে আমার প্রতিষ্ঠানের Google Cloud পরিবেশে থাকা কোনো বিদ্যমান প্রকল্পের সাথে সংযুক্ত করতে পারি?

আপনার Firebase প্রজেক্টটি একটি নির্দিষ্ট Google Cloud অর্গানাইজেশন ফোল্ডারের মধ্যে রাখা নিশ্চিত করুন:

1. আপনার ফায়ারবেস প্রজেক্টটি আগে থেকেই ম্যানুয়ালি তৈরি করে নিন।

2. Google AI Studio- তে আপনার Firebase ব্যাকএন্ড সেট আপ করার সময়, এজেন্টকে আপনার বিদ্যমান প্রজেক্টটি ব্যবহার করার নির্দেশ দিন:

   Add Firestore to this app using project PROJECT_ID.
   

আমি Firebase কনসোলে নির্দিষ্ট কিছু ডকুমেন্ট খুঁজে পাচ্ছি না কেন?

যখন AI Studio এজেন্ট প্রথমে প্যারেন্ট ডকুমেন্ট ( user1 ) তৈরি না করেই কোনো নেস্টেড পাথে (যেমন /users/user1/messages/msg1 ) ডেটা সেভ করে, তখন এটি একটি অস্তিত্বহীন প্যারেন্ট ডকুমেন্ট তৈরি করে। এই ডকুমেন্টগুলো Firebase কনসোলে প্রদর্শিত হয় না, যার ফলে আপনার Cloud Firestore ডেটাবেস ব্রাউজ করার সময় এগুলো খুঁজে পাওয়া কঠিন হতে পারে। যদিও এটি আপনার অ্যাপের কার্যকারিতাকে প্রভাবিত করে না, তবুও আপনি প্রায়শই AI Studio এজেন্টকে সমস্যাটি বর্ণনা করে অনুপস্থিত প্যারেন্ট ডকুমেন্টগুলো তৈরি করার জন্য নির্দেশ দিতে পারেন।

আরও বিস্তারিত তথ্যের জন্য, অস্তিত্বহীন মূল নথিগুলো দেখুন।

গুগল এআই স্টুডিও -তে গুগল আমার ডেটা (যেমন, কোড এবং প্রম্পট) কীভাবে ব্যবহার করে?

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

আমি Google Cloud থেকে 'আপনার Google Cloud প্রজেক্টের জন্য একটি সর্বজনীনভাবে অ্যাক্সেসযোগ্য গুগল এপিআই কী' সম্পর্কে একটি ইমেল পেয়েছি। আমাকে কী করতে হবে?

আপনি যদি Google Cloud থেকে "আপনার Google Cloud প্রজেক্টের জন্য একটি সর্বজনীনভাবে অ্যাক্সেসযোগ্য গুগল এপিআই কী" সম্পর্কে কোনো ইমেল পেয়ে থাকেন এবং ইমেলে তালিকাভুক্ত এপিআই কী-টি আপনার ফায়ারবেস এপিআই কী হয় , তাহলে আপনার কোড বা কনফিগারেশন ফাইলে নিরাপদে অন্তর্ভুক্ত করার জন্য এপিআই কী-টি নিম্নলিখিত শর্তগুলো পূরণ করছে কিনা তা নিশ্চিত করুন। আপনি Google Cloud কনসোলের APIs & Services > Credentials প্যানেলে নিম্নলিখিত বিষয়গুলো যাচাই করতে পারেন।

• এটি হলো সেই এপিআই কী যা আপনি আপনার ফায়ারবেস অ্যাপের জন্য এবং শুধুমাত্র ফায়ারবেস পরিষেবাগুলোর জন্য ব্যবহার করেন। এই কীগুলোকে সাধারণত Browser key (auto created by Firebase) , Android key (auto created by Firebase) বা iOS key (auto created by Firebase) বলা হয়।
• কী-টির 'API restrictions' allowlist-এ Firebase-সম্পর্কিত সমস্ত প্রয়োজনীয় API অন্তর্ভুক্ত রয়েছে।
• এর 'এপিআই সীমাবদ্ধতা' অনুমোদিত তালিকায় অন্য কোনো এপিআই নেই । বিশেষ করে, এই তালিকায় Generative Language API থাকা উচিত নয় ।

এছাড়াও, নিশ্চিত করুন যে আপনি আপনার ব্যবহৃত Firebase প্রোডাক্টগুলোর জন্য সুপারিশ অনুযায়ী Firebase Security Rules এবং App Check ব্যবহার করছেন।

আপনি Firebase-এর জন্য API কী সম্পর্কে বিস্তারিত জানতে এবং প্রায়শই জিজ্ঞাসিত প্রশ্নগুলির একটি তালিকা পেতে পারেন "Firebase-এর জন্য API কী ব্যবহার এবং পরিচালনা সম্পর্কে জানুন" অংশে।