এই নির্দেশিকাটি আপনাকে অ্যান্টিগ্র্যাভিটি এজেন্ট ব্যবহার করে জেমিনি এপিআই-তে ম্যানেজড এজেন্ট তৈরি এবং ব্যবহার করার পদ্ধতি ধাপে ধাপে দেখাবে। আপনি আপনার প্রথম এজেন্ট কলটি করবেন, একাধিক পালাক্রমে কথোপকথন চালিয়ে যাবেন, প্রতিক্রিয়া স্ট্রিম করবেন, স্যান্ডবক্স থেকে ফাইল ডাউনলোড করবেন এবং অ্যান্টিগ্র্যাভিটি ম্যানেজড এজেন্টের সাথে কাজ করবেন।
আপনার প্রথম এজেন্ট ইন্টারঅ্যাকশন চালান
ইন্টারঅ্যাকশনস এপিআই -তে একটিমাত্র কল একটি লিনাক্স স্যান্ডবক্স প্রস্তুত করে, এজেন্ট লুপটি চালায় এবং ফলাফল ফেরত দেয়। আপনাকে তিনটি প্যারামিটার নির্ধারণ করতে হবে:
-
agentহিসেবে"antigravity-preview-05-2026"পাস করুন, যেটি আমাদের পূর্বনির্ধারিত এবং সাধারণ উদ্দেশ্যমূলক পরিচালিত এজেন্টের বর্তমান সংস্করণ। - একটি নতুন স্যান্ডবক্স এনভায়রনমেন্ট তৈরি করতে
environment="remote"নির্ধারণ করুন। এজেন্ট কী করবে তা নির্ধারণ করে একটি ইনপুট তৈরি করুন।
পাইথন
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Write a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt. Then read the file and print its contents.",
environment="remote",
)
# Print the agent's final output
print(f"Interaction ID: {interaction.id}")
print(f"Environment ID: {interaction.environment_id}")
print(f"Output: {interaction.output_text}")
জাভাস্ক্রিপ্ট
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Write a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt. Then read the file and print its contents.",
environment: "remote",
});
console.log(`Interaction ID: ${interaction.id}`);
console.log(`Environment ID: ${interaction.environment_id}`);
console.log(`Output: ${interaction.output_text}`);
বিশ্রাম
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"agent": "antigravity-preview-05-2026",
"input": [{"type": "text", "text": "Write a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt. Then read the file and print its contents."}],
"environment": {"type": "remote"}
}'
প্রতিক্রিয়াটি একটি Interaction অবজেক্ট ফেরত দেয়। একই স্যান্ডবক্সে কথোপকথন চালিয়ে যাওয়ার জন্য interaction.id এবং interaction.environment_id সংরক্ষণ করুন। এজেন্টের চূড়ান্ত প্রতিক্রিয়া অ্যাক্সেস করতে interaction.output_text ব্যবহার করুন। interaction.steps এজেন্টের নেওয়া প্রতিটি ধাপের তালিকা দেখায় (যুক্তি প্রদান, টুল কল, কোড সম্পাদন)।
কথোপকথন চালিয়ে যান (একাধিক পালা)
এপিআই দুটি স্বাধীন অবস্থার মাত্রা ট্র্যাক করে:
- কথোপকথনের প্রেক্ষাপট: চ্যাটের ইতিহাস, যুক্তির বিবরণ, টুলের ব্যবহার,
previous_interaction_idব্যবহার। - পরিবেশের অবস্থা: ফাইল, ইনস্টল করা প্যাকেজ এবং স্যান্ডবক্সের অবস্থা,
environmentব্যবহার করে নির্ধারিত হয়।
কথোপকথন পুনরায় শুরু করতে উভয়কে তাদের নিজ নিজ স্থানে পাস করুন:
পাইথন
interaction_2 = client.interactions.create(
agent="antigravity-preview-05-2026",
previous_interaction_id=interaction.id,
environment=interaction.environment_id,
input="Now plot the Fibonacci sequence as a line chart and save it as chart.png.",
)
print(interaction_2.output_text)
জাভাস্ক্রিপ্ট
const interaction2 = await client.interactions.create({
agent: "antigravity-preview-05-2026",
previous_interaction_id: interaction.id,
environment: interaction.environment_id,
input: "Now plot the Fibonacci sequence as a line chart and save it as chart.png.",
}, { timeout: 300_000 });
console.log(interaction2.output_text);
বিশ্রাম
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"agent": "antigravity-preview-05-2026",
"previous_interaction_id": "interaction_id_from_step_1",
"environment": "environment_id_from_step_1",
"input": [{"type": "text", "text": "Now plot the Fibonacci sequence as a line chart and save it as chart.png."}]
}'
প্রথম টার্নের ফাইলগুলো ( fibonacci.txt ) দ্বিতীয় টার্নেও থেকে যায়। এজেন্ট কথোপকথনের প্রেক্ষাপটও ধরে রাখে।
আপনি এই অবস্থাগুলোকে স্বাধীনভাবে মিশ্রিত ও সমন্বয় করতে পারেন:
- কথোপকথন মুছে ফেলুন, ফাইল রাখুন:
previous_interaction_idবাদ দিন, একই ওয়ার্কস্পেসে নতুন কথোপকথনের জন্য শুধুenvironmentব্যবহার করে এনভায়রনমেন্ট আইডি দিন। - কথোপকথন চালু রাখুন, নতুন ওয়ার্কস্পেস:
previous_interaction_idপাস করুন, একটি নতুন স্যান্ডবক্সের জন্যenvironment="remote"সেট করুন।
স্বয়ংক্রিয় প্রসঙ্গ সংক্ষেপণ
দীর্ঘস্থায়ী, একাধিক পালাবিশিষ্ট কথোপকথনে, যুক্তির ধাপগুলোর মূল ইতিহাস, টুল কল এবং বড় ফাইলের বিষয়বস্তু দ্রুত বাড়তে পারে এবং উল্লেখযোগ্য পরিমাণে কনটেক্সট স্পেস দখল করতে পারে। টোকেন লিমিটজনিত ত্রুটি এড়াতে এবং এজেন্টের ফোকাস বজায় রাখতে (যা ‘কনটেক্সট রট’ প্রতিরোধ করে), ম্যানেজড এজেন্টটিতে প্রায় ১৩৫ হাজার টোকেনে একটি নেটিভ কনটেক্সট কম্প্যাকশন ধাপ রয়েছে। এটি সম্পন্ন করার জন্য আপনাকে কিছুই করতে হবে না।
প্রতিক্রিয়াটি স্ট্রিম করুন
দীর্ঘ সময় ধরে চলা কাজগুলোর ক্ষেত্রে, এজেন্টের কাজ রিয়েল টাইমে দেখতে, আপনি stream: true সেট করে রেসপন্সটি স্ট্রিম করতে পারেন।
পাইথন
from google import genai
client = genai.Client()
stream = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Read Hacker News, summarize the top 5 stories, and save the results as a PDF.",
environment="remote",
stream=True,
)
for event in stream:
print(event)
জাভাস্ক্রিপ্ট
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const stream = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Read Hacker News, summarize the top 5 stories, and save the results as a PDF.",
environment: "remote",
stream: true,
});
for await (const event of stream) {
console.log(event);
}
বিশ্রাম
curl -N -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"agent": "antigravity-preview-05-2026",
"input": "Read Hacker News, summarize the top 5 stories, and save the results as a PDF.",
"environment": "remote",
"stream": true
}'
স্ট্রিমিং স্টেপ ডেল্টা-র একটি ইটারেবল রিটার্ন করে, যেগুলো হলো ক্রমবর্ধমান টেক্সট, রিজনিং টোকেন এবং টুল কল আপডেট। স্ট্রিমিং গাইড- এ কীভাবে রেসপন্স স্ট্রিম করতে হয় সে সম্পর্কে আরও জানুন।
পরিবেশ থেকে ফাইল ডাউনলোড করুন
এজেন্ট স্যান্ডবক্সের ভিতরে ফাইল তৈরি করতে পারে। সেগুলি ডাউনলোড করতে, আপনি সরাসরি HTTP অনুরোধের মাধ্যমে ফাইলস এপিআই (Files API) ব্যবহার করতে পারেন:
পাইথন
import os
import requests
import tarfile
env_id = interaction.environment_id
api_key = os.environ["GEMINI_API_KEY"]
response = requests.get(
f"https://generativelanguage.googleapis.com/v1beta/files/environment-{env_id}:download",
params={"alt": "media"},
headers={"x-goog-api-key": api_key},
allow_redirects=True,
)
with open("snapshot.tar", "wb") as f:
f.write(response.content)
with tarfile.open("snapshot.tar") as tar:
tar.extractall(path="extracted_snapshot")
জাভাস্ক্রিপ্ট
import fs from "fs";
import { execSync } from "child_process";
const envId = interaction.environment_id;
const apiKey = process.env.GEMINI_API_KEY || "";
const url = `https://generativelanguage.googleapis.com/v1beta/files/environment-${envId}:download?alt=media`;
const response = await fetch(url, {
headers: {
"x-goog-api-key": apiKey,
},
});
if (!response.ok) {
throw new Error(`Failed to download file: ${response.statusText}`);
}
const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("snapshot.tar", buffer);
if (!fs.existsSync("extracted_snapshot")) {
fs.mkdirSync("extracted_snapshot");
}
execSync("tar -xf snapshot.tar -C extracted_snapshot");
console.log(fs.readdirSync("extracted_snapshot"));
বিশ্রাম
curl -L -X GET "https://generativelanguage.googleapis.com/v1beta/files/environment-$ENV_ID:download?alt=media" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-o snapshot.tar
tar -xf snapshot.tar -C extracted_snapshot
একটি কাস্টম এজেন্ট তৈরি করুন
পূর্ববর্তী ধাপগুলিতে, আমরা ডিফল্ট এজেন্ট—অ্যান্টিগ্র্যাভিটি এজেন্ট—ব্যবহার করেছি। এর পরিবর্তে, আপনি নির্দেশাবলী, টুলস এবং এনভায়রনমেন্ট সোর্সগুলিকে একটি নামযুক্ত এজেন্টের মধ্যে একত্রিত করে একটি কাস্টম এজেন্ট তৈরি করতে পারেন। কনফিগারেশনের পুনরাবৃত্তি না করে, আইডি দ্বারা এটিকে চালু করুন।
একবার আপনি উৎস থেকে বা কোনো বিদ্যমান পরিবেশ থেকে মূল পরিবেশটি নির্ধারণ করে নিলে, এজেন্ট ডিফল্ট নতুন স্যান্ডবক্সের পরিবর্তে প্রতিটি নতুন ইন্টারঅ্যাকশনের জন্য সেটিই ব্যবহার করবে। পরিবেশ সম্পর্কে আরও তথ্যের জন্য, ‘পরিবেশসমূহ’ দেখুন।
উৎস থেকে: আপনি ইনলাইনে, অথবা গিটহাব বা ক্লাউড স্টোরেজের মতো অন্যান্য উৎস থেকে উৎস নির্ধারণ করতে পারেন। এই উদাহরণটি গিটহাব থেকে একটি AGENTS.md ফাইল এবং একটি Skills ডিরেক্টরি নির্ধারণ করে:
পাইথন
agent = client.agents.create(
id="fibonacci-analyst",
base_agent="antigravity-preview-05-2026",
system_instruction="You are a math analysis agent. Generate sequences, visualize them, and export results as PDF reports.",
base_environment={
"type": "remote",
"sources": [
{
"type": "inline",
"target": ".agents/AGENTS.md",
"content": "Always include a chart and a summary table in your reports.",
},
{
"type": "repository",
"source": "https://github.com/your-org/skills",
"target": ".agents/skills"
}
],
},
)
print(f"Created agent: {agent.id}")
জাভাস্ক্রিপ্ট
const agent = await client.agents.create({
id: "fibonacci-analyst",
base_agent: "antigravity-preview-05-2026",
system_instruction: "You are a math analysis agent. Generate sequences, visualize them, and export results as PDF reports.",
base_environment: {
type: "remote",
sources: [
{
type: "inline",
target: ".agents/AGENTS.md",
content: "Always include a chart and a summary table in your reports.",
},
{
type: "repository",
source: "https://github.com/your-org/skills",
target: ".agents/skills"
}
],
},
});
console.log(`Created agent: ${agent.id}`);
বিশ্রাম
curl -X POST "https://generativelanguage.googleapis.com/v1beta/agents" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"id": "fibonacci-analyst",
"base_agent": "antigravity-preview-05-2026",
"system_instruction": "You are a math analysis agent. Generate sequences, visualize them, and export results as PDF reports.",
"base_environment": {
"type": "remote",
"sources": [
{
"type": "inline",
"target": ".agents/AGENTS.md",
"content": "Always include a chart and a summary table in your reports."
},
{
"type": "repository",
"source": "https://github.com/your-org/skills",
"target": ".agents/skills"
}
]
}
}'
বিদ্যমান পরিবেশ থেকে: ইন্টারঅ্যাকশনের মাধ্যমে একটি পরিবেশে পুনরাবৃত্তি করুন, এবং তারপর এর আইডি উল্লেখ করে এটিকে আপনার এজেন্টের ভিত্তি হিসাবে সেট করুন:
পাইথন
agent = client.agents.create(
id="fibonacci-analyst",
base_agent="antigravity-preview-05-2026",
system_instruction="You are a math analysis agent.",
base_environment=interaction.environment_id,
)
জাভাস্ক্রিপ্ট
const agent = await client.agents.create({
id: "fibonacci-analyst",
base_agent: "antigravity-preview-05-2026",
system_instruction: "You are a math analysis agent.",
base_environment: interaction.environment_id,
});
বিশ্রাম
curl -X POST "https://generativelanguage.googleapis.com/v1beta/agents" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"id": "fibonacci-analyst",
"base_agent": "antigravity-preview-05-2026",
"system_instruction": "You are a math analysis agent.",
"base_environment": "environment_id_from_previous_interaction"
}'
এজেন্ট স্বয়ংক্রিয়ভাবে .agents/AGENTS.md সিস্টেম নির্দেশাবলী হিসেবে এবং .agents/skills/ অধীনে থাকা যেকোনো SKILL.md ফাইলকে সক্ষমতা হিসেবে লোড করে। সম্পূর্ণ এজেন্ট ডেফিনিশন ফরম্যাট, স্কিল এবং অ্যাডভান্সড কনফিগারেশনের জন্য "বিল্ডিং কাস্টম এজেন্টস" দেখুন।
কাস্টম এজেন্টকে আহ্বান করুন
একবার আপনি একটি কাস্টম এজেন্ট তৈরি করে নিলে, কনফিগারেশনের পুনরাবৃত্তি না করে নাম দিয়ে সেটিকে চালু করতে পারেন। প্রতিবার চালু করার ফলে মূল এনভায়রনমেন্টটি ফর্ক হয়, তাই প্রতিটি রান নতুন করে শুরু হয়:
পাইথন
result = client.interactions.create(
agent="fibonacci-analyst",
input="Generate the first 50 prime numbers, plot their distribution, and save a PDF report.",
environment="remote",
)
print(result.output_text)
জাভাস্ক্রিপ্ট
const result = await client.interactions.create({
agent: "fibonacci-analyst",
input: "Generate the first 50 prime numbers, plot their distribution, and save a PDF report.",
environment: "remote",
}, {
timeout: 300_000,
});
console.log(result.output_text);
বিশ্রাম
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Api-Revision: 2026-05-20" \
-d '{
"agent": "fibonacci-analyst",
"environment": "remote",
"input": "Generate the first 50 prime numbers, plot their distribution, and save a PDF report."
}'
এটি base_environment থেকে পূর্বে সংজ্ঞায়িত system_instruction , tools , এবং environment ফর্কগুলো ব্যবহার করে। প্রতিটি ইন্টারঅ্যাকশনের জন্য সবকিছু ওভাররাইডও করা যেতে পারে।
এরপর কী?
- এজেন্টদের সংক্ষিপ্ত বিবরণ : পরিচালিত এজেন্টদের মূল ধারণাগুলো সম্পর্কে জানুন।
- অ্যান্টিগ্র্যাভিটি এজেন্ট : ডিফল্ট এজেন্টের সক্ষমতা, টুল এবং মূল্য সম্পর্কে জানুন।
- এজেন্ট পরিবেশ : স্যান্ডবক্স, উৎস এবং নেটওয়ার্কিং কনফিগার করুন।
- কাস্টম এজেন্ট তৈরি করা :
AGENTS.mdএবংSKILL.mdব্যবহার করে আপনার নিজস্ব এজেন্ট সংজ্ঞায়িত করুন।