ইন্টারঅ্যাকশন API

ইন্টারঅ্যাকশনস এপিআই হলো আমাদের নতুন ইন্টারফেস এবং জেমিনি মডেল ও এজেন্ট তৈরির সবচেয়ে সহজ উপায়। জুন ২০২৬ থেকে এটি সর্বসাধারণের জন্য উপলব্ধ এবং সকল নতুন প্রোজেক্টের জন্য প্রস্তাবিত ইন্টারফেস।

যদিও এটিকে এখন পুরোনো পদ্ধতি হিসেবে বিবেচনা করা হয়, মূল generateContent API-টি এখনও সম্পূর্ণরূপে সমর্থিত।

ইন্টারঅ্যাকশন এপিআই কেন ব্যবহার করবেন?

• ডিফল্টভাবেই নতুন কিছু বৈশিষ্ট্য : previous_interaction_id ব্যবহার করে ঐচ্ছিক সার্ভার-সাইড কথোপকথনের অবস্থা, ডিবাগিং এবং UI রেন্ডারিংয়ের জন্য পর্যবেক্ষণযোগ্য এক্সিকিউশন ধাপ, এবং background=true ব্যবহার করে দীর্ঘ সময় ধরে চলা টাস্কের ব্যাকগ্রাউন্ড এক্সিকিউশন।
• উচ্চতর ক্যাশ হিট রেটের সাথে কম খরচ : সার্ভার-সাইড স্টেট ম্যানেজমেন্ট পালাক্রমে আরও কার্যকর কনটেক্সট ক্যাশিং সক্ষম করে, যা একাধিক পালার কথোপকথনের জন্য টোকেন খরচ কমিয়ে দেয়।
• অত্যাধুনিক মডেল এবং এজেন্টদের জন্য নির্মিত : চিন্তাশীল মডেল, বহু-ধাপের টুল ব্যবহার এবং জটিল যুক্তিপ্রবাহের জন্য বিশেষভাবে তৈরি — যা এজেন্টিক অ্যাপ্লিকেশন নির্মাণ, ডিবাগিং এবং অর্কেস্ট্রেট করার প্রক্রিয়াকে সহজ করে তোলে।
• মডেল এবং এজেন্টদের জন্য একক এপিআই : জেমিনি মডেল এবং এজেন্টদের, যেমন ডিপ রিসার্চ এবং কাস্টম পরিচালিত এজেন্টদের, সরাসরি কল করার জন্য একটি সমন্বিত ইন্টারফেস — আলাদা কোনো এন্ডপয়েন্ট বা প্যাটার্ন শেখার প্রয়োজন নেই।
• যেখানে নতুন কিছুর সূচনা হবে : ভবিষ্যতে, মূল মেইনলাইন ফ্যামিলির বাইরে নতুন মডেল ও সক্ষমতা, সেইসাথে নতুন এজেন্টিক সক্ষমতা ও টুলস, ইন্টারঅ্যাকশনস এপিআই-তে চালু করা হবে।

ডিফল্টরূপে, ইন্টারঅ্যাকশনস এপিআই অনুরোধগুলো সংরক্ষণ করে, তাই আপনি previous_interaction_id ব্যবহার করে সার্ভার-সাইড স্টেট ম্যানেজমেন্ট বৈশিষ্ট্যগুলো কাজে লাগাতে পারেন। store=false সেট করে আপনি স্টেটলেস আচরণ বেছে নিতে পারেন। বিস্তারিত জানতে ডেটা রিটেনশন বিভাগটি দেখুন।

শুরু করুন

• আপনার কোডিং এজেন্ট সেট আপ করুন : Gemini Docs MCP- এর সাথে সংযোগ করুন এবং আপনার অ্যাসিস্ট্যান্টকে সর্বশেষ ডেভেলপার ডক্স ও সেরা অনুশীলনগুলিতে সরাসরি অ্যাক্সেস দিতে gemini-interactions-api স্কিলটি ইনস্টল করুন। আপনার কোডিং এজেন্ট সেট আপ করুন →
• generateContent থেকে মাইগ্রেট করুন : আপনার যদি আগে থেকেই কোনো ইন্টিগ্রেশন থাকে, তাহলে Interactions API-তে স্থানান্তরিত হতে মাইগ্রেশন গাইড অনুসরণ করুন।
• শুরু করুন : ইন্টারঅ্যাকশন এপিআই শুরু করার নির্দেশিকা ।

বৈশিষ্ট্য নির্দেশিকা

এই গাইডগুলির মাধ্যমে ইন্টারঅ্যাকশনস এপিআই (Interactions API)-এর নির্দিষ্ট ক্ষমতাগুলি সম্পর্কে জানুন। আপনি এই পৃষ্ঠাগুলিতে থাকা টগল ব্যবহার করে জেনারেটকন্টেন্ট (generateContent) এবং ইন্টারঅ্যাকশনস এপিআই (Interactions API)-এর মধ্যে পরিবর্তন করতে পারেন:

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

ইন্টারঅ্যাকশন এপিআই কীভাবে কাজ করে

ইন্টারঅ্যাকশনস এপিআই একটি মূল রিসোর্সকে কেন্দ্র করে গঠিত: Interaction । একটি Interaction কোনো কথোপকথন বা কাজের একটি সম্পূর্ণ পালাকে উপস্থাপন করে। এটি একটি সেশন রেকর্ড হিসেবে কাজ করে, যেখানে একটি ইন্টারঅ্যাকশনের সম্পূর্ণ ইতিহাস তার সম্পাদনের ধাপগুলোর কালানুক্রমিক অনুক্রম হিসেবে থাকে। এই ধাপগুলোর মধ্যে রয়েছে মডেলের ভাবনা, সার্ভার-সাইড বা ক্লায়েন্ট-সাইড টুলের কল এবং তার ফলাফল (যেমন function_call এবং function_result ), এবং চূড়ান্ত model_output । সংরক্ষিত রিসোর্সটিতে (যা interactions.get এর মাধ্যমে পাওয়া যায়) সম্পূর্ণ প্রেক্ষাপটের জন্য user_input ধাপগুলোও অন্তর্ভুক্ত থাকে, যদিও interactions.create রেসপন্সটি শুধুমাত্র মডেল-জেনারেটেড ধাপগুলোই ফেরত দেয়।

যখন আপনি interactions.create কল করেন, তখন আপনি একটি নতুন Interaction রিসোর্স তৈরি করেন।

সার্ভার-সাইড স্টেট ম্যানেজমেন্ট

পরবর্তী কলে কথোপকথন চালিয়ে যাওয়ার জন্য, আপনি previous_interaction_id প্যারামিটার ব্যবহার করে একটি সম্পন্ন হওয়া ইন্টারঅ্যাকশনের id ব্যবহার করতে পারেন। সার্ভার এই আইডি ব্যবহার করে কথোপকথনের ইতিহাস পুনরুদ্ধার করে, ফলে আপনাকে সম্পূর্ণ চ্যাট ইতিহাস পুনরায় পাঠাতে হয় না।

previous_interaction_id প্যারামিটারটি শুধুমাত্র previous_interaction_id ব্যবহার করে হওয়া কথোপকথনের ইতিহাস (ইনপুট এবং আউটপুট) সংরক্ষণ করে। অন্যান্য প্যারামিটারগুলো ইন্টারঅ্যাকশন-ভিত্তিক এবং শুধুমাত্র সেই নির্দিষ্ট ইন্টারঅ্যাকশনটির ক্ষেত্রেই প্রযোজ্য যা আপনি বর্তমানে তৈরি করছেন:

• tools
• system_instruction
• generation_config ( thinking_level , temperature ইত্যাদি সহ)

এর মানে হলো, এই প্যারামিটারগুলো প্রয়োগ করতে চাইলে প্রতিটি নতুন ইন্টারঅ্যাকশনে আপনাকে অবশ্যই সেগুলো পুনরায় উল্লেখ করতে হবে। এই সার্ভার-সাইড স্টেট ম্যানেজমেন্ট ঐচ্ছিক; আপনি প্রতিটি অনুরোধে সম্পূর্ণ কথোপকথনের ইতিহাস পাঠিয়ে স্টেটলেস মোডেও কাজ করতে পারেন।

ডেটা সংরক্ষণ এবং ধরে রাখা

ডিফল্টরূপে, এপিআই সমস্ত ইন্টারঅ্যাকশন অবজেক্ট সংরক্ষণ করে ( store=true ), যাতে সার্ভার-সাইড স্টেট ম্যানেজমেন্ট ফিচার ( previous_interaction_id ব্যবহার করে), ব্যাকগ্রাউন্ড এক্সিকিউশন ( background=true ব্যবহার করে) এবং পর্যবেক্ষণযোগ্যতার উদ্দেশ্যগুলো সহজ হয়।

• পেইড টিয়ার : সিস্টেমটি ৫৫ দিনের জন্য ইন্টারঅ্যাকশন সংরক্ষণ করে।
• ফ্রি টিয়ার : সিস্টেমটি ১ দিনের জন্য ইন্টারঅ্যাকশন সংরক্ষণ করে।

আপনি যদি এটি না চান, তাহলে আপনার অনুরোধে store=false সেট করতে পারেন। এই নিয়ন্ত্রণটি স্টেট ম্যানেজমেন্ট থেকে আলাদা; আপনি যেকোনো ইন্টারঅ্যাকশনের জন্য স্টোরেজ বাদ দিতে পারেন। তবে, মনে রাখবেন যে store=false background=true এর সাথে সামঞ্জস্যপূর্ণ নয় এবং পরবর্তী টার্নগুলোর জন্য previous_interaction_id ব্যবহার করতে বাধা দেয়।

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

সংরক্ষণের সময়সীমা শেষ হওয়ার পর আপনার ডেটা স্বয়ংক্রিয়ভাবে মুছে যাবে।

সিস্টেমটি শর্তাবলী অনুসারে ইন্টারঅ্যাকশন অবজেক্টগুলো প্রক্রিয়াকরণ করে।

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

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

সমর্থিত মডেল এবং এজেন্ট

এসডিকে

ইন্টারঅ্যাকশনস এপিআই অ্যাক্সেস করার জন্য আপনি গুগল জেনএআই এসডিকে-এর সর্বশেষ সংস্করণ ব্যবহার করতে পারেন।

• পাইথনে, 1.55.0 সংস্করণ থেকে এটি হলো google-genai প্যাকেজ।
• জাভাস্ক্রিপ্টে, 1.33.0 সংস্করণ থেকে এটি হলো @google/genai প্যাকেজ।

লাইব্রেরি পেজে আপনি এসডিকেগুলো কীভাবে ইনস্টল করবেন সে সম্পর্কে আরও জানতে পারবেন।

সীমাবদ্ধতা

• রিমোট এমসিপি : জেমিনি ৩ রিমোট এমসিপি সমর্থন করে না, এটি শীঘ্রই আসছে।

নিম্নলিখিত বৈশিষ্ট্যগুলি generateContent API দ্বারা সমর্থিত, কিন্তু Interactions API-তে এখনও উপলব্ধ নয় :

• ভিডিও মেটাডেটা : video_metadata ফিল্ড, যা ভিডিও বোঝার জন্য ক্লিপিং ব্যবধান এবং কাস্টম ফ্রেম রেট নির্ধারণ করতে ব্যবহৃত হয়।
• ব্যাচ এপিআই
• স্বয়ংক্রিয় ফাংশন কলিং (পাইথন)
• সুস্পষ্ট ক্যাশিং : উল্লেখ্য যে, ইন্টারঅ্যাকশনস এপিআই-তে previous_interaction_id এর মাধ্যমে সার্ভার-সাইড অন্তর্নিহিত ক্যাশিং উপলব্ধ রয়েছে।

প্রতিক্রিয়া

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

এরপর কী?

• ইন্টারঅ্যাকশনস এপিআই কুইকস্টার্ট নোটবুকটি ব্যবহার করে দেখুন।
• জেমিনি ডিপ রিসার্চ এজেন্ট সম্পর্কে আরও জানুন।