এই নির্দেশিকাটি জেমিনি এপিআই (Gemini API)-এর উপর ভিত্তি করে লাইব্রেরি, প্ল্যাটফর্ম এবং গেটওয়ে তৈরির স্থাপত্যগত কৌশলগুলির রূপরেখা দেয়। এটি অফিসিয়াল জেনএআই এসডিকে (GenAI SDK), ডিরেক্ট এপিআই (Direct API) (REST/gRPC) এবং ওপেনএআই কম্প্যাটিবিলিটি লেয়ার (OpenAI compatibility layer) ব্যবহারের মধ্যেকার প্রযুক্তিগত সুবিধা-অসুবিধাগুলো বিস্তারিতভাবে বর্ণনা করে।
আপনি যদি অন্যান্য ডেভেলপারদের জন্য ওপেন-সোর্স ফ্রেমওয়ার্ক, এন্টারপ্রাইজ গেটওয়ে বা SaaS অ্যাগ্রিগেটরের মতো টুল তৈরি করেন এবং ডিপেন্ডেন্সি হাইজিন, বান্ডেল সাইজ বা ফিচার প্যারিটির জন্য অপটিমাইজ করার প্রয়োজন হয়, তাহলে এই গাইডটি ব্যবহার করুন।
অংশীদার একীকরণ বলতে কী বোঝায়?
যিনি জেমিনি এপিআই এবং এন্ড-ইউজার ডেভেলপারদের মধ্যে ইন্টিগ্রেশন তৈরি করেন, তিনিই পার্টনার। আমরা পার্টনারদের চারটি আর্কিটাইপে ভাগ করি। আপনার সাথে কোনটি সবচেয়ে বেশি মেলে তা শনাক্ত করা আপনাকে সঠিক ইন্টিগ্রেশন পথ বেছে নিতে সাহায্য করবে।
বাস্তুতন্ত্রের কাঠামো
- আপনার পরিচয়: কোনো ওপেন-সোর্স ফ্রেমওয়ার্ক (যেমন, LangChain, LlamaIndex, Spring AI) অথবা ভাষা-নির্দিষ্ট ক্লায়েন্টের রক্ষণাবেক্ষণকারী।
- আপনার লক্ষ্য: ব্যাপক সামঞ্জস্যতা। আপনি চান আপনার লাইব্রেরিটি ব্যবহারকারীর পছন্দের যেকোনো পরিবেশে কোনো রকম সংঘাত সৃষ্টি না করেই কাজ করুক।
রানটাইম এবং এজ প্ল্যাটফর্ম
- আপনি কারা: SaaS প্ল্যাটফর্ম, AI গেটওয়ে, বা ক্লাউড অবকাঠামো প্রদানকারী (যেমন, Vercel, Cloudflare, Zapier) যেখানে সীমাবদ্ধ পরিবেশে কোড নির্বাহ হয়।
- আপনার লক্ষ্য: পারফরম্যান্স। আপনার প্রয়োজন কম ল্যাটেন্সি, ন্যূনতম বান্ডেল সাইজ এবং দ্রুত কোল্ড স্টার্ট।
অ্যাগ্রিগেটর
- আপনার পরিচয়: প্ল্যাটফর্ম, প্রক্সি, বা অভ্যন্তরীণ "মডেল গার্ডেন" যা বিভিন্ন এলএলএম প্রদানকারীর (যেমন ওপেনএআই, অ্যানথ্রোপিক, গুগল) অ্যাক্সেসকে একটি একক ইন্টারফেসে স্বাভাবিক করে তোলে।
- আপনার লক্ষ্য: বহনযোগ্যতা এবং অভিন্নতা।
এন্টারপ্রাইজ গেটওয়ে
- আপনার পরিচয়: বড় কোম্পানিগুলোর অভ্যন্তরীণ প্ল্যাটফর্ম ইঞ্জিনিয়ারিং টিম, যারা শত শত অভ্যন্তরীণ ডেভেলপারের জন্য 'গোল্ডেন পাথ' তৈরি করে।
- আপনার লক্ষ্য: মানসম্মতকরণ, সুশাসন এবং সমন্বিত প্রমাণীকরণ।
এক নজরে তুলনা
বিশ্বব্যাপী সর্বোত্তম রীতি: নির্বাচিত পাথ নির্বিশেষে সকল পার্টনারকে অবশ্যই x-goog-api-client হেডারটি পাঠাতে হবে।
| যদি আপনি... | প্রস্তাবিত পথ | মূল সুবিধা | মূল আপস | সর্বোত্তম অনুশীলন |
|---|---|---|---|---|
| এন্টারপ্রাইজ গেটওয়ে, ইকোসিস্টেম ফ্রেমওয়ার্ক | গুগল জেনএআই এসডিকে | জেমিনি এন্টারপ্রাইজ এজেন্ট প্ল্যাটফর্মের সমতা ও গতি। টাইপ, অথেন্টিকেশন এবং জটিল ফিচার (যেমন, ফাইল আপলোড) পরিচালনার জন্য অন্তর্নির্মিত ব্যবস্থা। গুগল ক্লাউডে নির্বিঘ্ন মাইগ্রেশন। | নির্ভরতার গুরুত্ব। ট্রানজিটিভ নির্ভরতা জটিল এবং আপনার নিয়ন্ত্রণের বাইরে হতে পারে। শুধুমাত্র সমর্থিত ভাষাগুলোর (পাইথন/নোড/গো/জাভা) জন্য সীমাবদ্ধ। | ভার্সন লক করুন। বিভিন্ন টিমের মধ্যে স্থিতিশীলতা নিশ্চিত করতে আপনার অভ্যন্তরীণ বেস ইমেজগুলিতে SDK ভার্সন পিন করুন। |
| বাস্তুতন্ত্রের কাঠামো, এজ প্ল্যাটফর্ম এবং অ্যাগ্রিগেটর | সরাসরি এপিআই (REST / gRPC) | কোনো নির্ভরতা নেই। আপনি HTTP ক্লায়েন্ট এবং সঠিক বান্ডেল সাইজ নিয়ন্ত্রণ করতে পারবেন। সমস্ত API এবং মডেল ফিচারে সম্পূর্ণ অ্যাক্সেস। | ডেভেলপারদের জন্য এতে অনেক বেশি কাজ করতে হয়। JSON কাঠামো গভীরভাবে নেস্টেড হতে পারে এবং এর জন্য কঠোর ম্যানুয়াল ভ্যালিডেশন ও টাইপ-চেকিং প্রয়োজন। | OpenAPI স্পেকস ব্যবহার করুন। হাতে লেখার পরিবর্তে আমাদের অফিসিয়াল স্পেকস ব্যবহার করে টাইপ জেনারেশন স্বয়ংক্রিয় করুন। |
| ওপেনএআই এসডিকে ব্যবহার করে এমন অ্যাগ্রিগেটর যার জন্য শুধুমাত্র টেক্সট-ভিত্তিক ওয়ার্কফ্লো প্রয়োজন (ঐতিহ্যবাহী বহনযোগ্যতার জন্য অপ্টিমাইজ করা) |