Agjenti Antigravity është një agjent i menaxhuar me qëllim të përgjithshëm në Gemini API. Një thirrje e vetme API ju jep një agjent që arsyeton, ekzekuton kodin, menaxhon skedarët dhe shfleton uebin brenda sandbox-it tuaj të sigurt Linux, të organizuar nga Google.
Funksionon me Gemini 3.5 Flash dhe përdor të njëjtën teknologji si Antigravity IDE. Mund ta përdorni përmes Interactions API dhe Google AI Studio .
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
environment="remote",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
environment: "remote",
}, { timeout: 300000 });
console.log(interaction.output_text);
PUSHTIM
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": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
"environment": "remote"
}'
Aftësitë
Çdo thirrje mund të sigurojë një sandbox Linux dhe të fillojë një cikël përdorimi të mjeteve. Agjenti planifikon, vepron, vëzhgon rezultatet dhe përsërit derisa detyra të përfundojë.
- Ekzekutimi i kodit: Ekzekutimi i komandave Bash, Python dhe Node.js. Instalimi i paketave, ekzekutimi i testeve, ndërtimi i aplikacioneve.
- Menaxhimi i skedarëve: Lexoni, shkruani, modifikoni, kërkoni dhe listoni skedarët në sandbox. Skedarët ruhen gjatë ndërveprimeve.
- Qasje në internet: Kërkimi në Google dhe marrja e URL-ve për të dhëna.
- Kompaktimi i kontekstit: Kompaktimi automatik i kontekstit (aktivizohet në ~135 mijë tokena) për të mbështetur seanca të gjata me shumë kthesa pa humbur kontekstin ose pa arritur kufijtë e tokenave.
Shihni Fillim të Shpejtë për përdorimin me shumë kthesa dhe transmetimin.
Mjetet e mbështetura
Si parazgjedhje, agjenti ka qasje në code_execution , google_search dhe url_context . Mjetet e sistemit të skedarëve aktivizohen automatikisht kur specifikoni parametrin e environment . Ju duhet të specifikoni vetëm parametrin e tools kur personalizoni ose kufizoni grupin e parazgjedhur:
| Mjet | Vlera e tipit | Përshkrimi |
|---|---|---|
| Ekzekutimi i Kodit | code_execution | Ekzekutoni komandat e shell (bash, Python, Node) me kapjen stdout/stderr. |
| Kërkimi në Google | google_search | Kërko në uebin publik. |
| Konteksti i URL-së | url_context | Merrni dhe lexoni faqet e internetit. |
| Sistemi i skedarëve | (aktivizuar nëpërmjet environment ) | Lexo, shkruaj, modifiko, kërko dhe listo skedarët në sandbox. Asnjë lloj mjeti i veçantë — aktivizohet automatikisht kur caktohet environment . |
Për ta kufizuar agjentin në mjete specifike, kaloni vetëm ato që ju nevojiten:
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Search for the latest AI research papers on reasoning and summarize them.",
environment="remote",
tools=[
{"type": "google_search"},
{"type": "url_context"},
],
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Search for the latest AI research papers on reasoning and summarize them.",
environment: "remote",
tools: [
{ type: "google_search" },
{ type: "url_context" },
],
}, { timeout: 300000 });
console.log(interaction.output_text);
PUSHTIM
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": "Search for the latest AI research papers on reasoning and summarize them.",
"environment": "remote",
"tools": [
{"type": "google_search"},
{"type": "url_context"}
]
}'
Hyrje Multimodale
Agjenti Antigravity mbështet hyrjet multimodale. Aktualisht, mbështeten vetëm hyrjet e text dhe image . Imazhet duhet të ofrohen si vargje të koduara në linjë base64 ( data ).
Python
import base64
from google import genai
client = genai.Client()
with open("path/to/chart.png", "rb") as f:
image_bytes = f.read()
interaction_inline = client.interactions.create(
agent="antigravity-preview-05-2026",
input=[
{"type": "text", "text": "Analyze this chart and summarize the trends."},
{
"type": "image",
"data": base64.b64encode(image_bytes).decode("utf-8"),
"mime_type": "image/png",
},
],
environment="remote",
)
JavaScript
import { GoogleGenAI } from "@google/genai";
import * as fs from "node:fs";
const client = new GoogleGenAI({});
const base64Image = fs.readFileSync("path/to/chart.png", { encoding: "base64" });
const interactionInline = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: [
{ type: "text", text: "Analyze this chart and summarize the trends." },
{
type: "image",
data: base64Image,
mime_type: "image/png",
},
],
environment: "remote",
}, { timeout: 300000 });
PUSHTIM
BASE64_IMAGE=$(base64 -w0 /path/to/chart.png)
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\": \"Analyze this chart and summarize the trends.\"},
{
\"type\": \"image\",
\"mime_type\": \"image/png\",
\"data\": \"$BASE64_IMAGE\"
}
],
\"environment\": \"remote\"
}"
Udhëzimet e sistemit
Personalizoni sjelljen e agjentit me system_instruction për udhëzimet brenda rreshtit, ose duke montuar skedarët e udhëzimeve në mjedis:
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Analyze the uploaded CSV and create a report.",
environment="remote",
system_instruction="You are a data analyst. Always include visualizations and export results as PDF.",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Analyze the uploaded CSV and create a report.",
environment: "remote",
system_instruction: "You are a data analyst. Always include visualizations and export results as PDF.",
}, { timeout: 300000 });
console.log(interaction.output_text);
PUSHTIM
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": "Analyze the uploaded CSV and create a report.",
"environment": "remote",
"system_instruction": "You are a data analyst. Always include visualizations and export results as PDF."
}'
Agjenti ngarkon automatikisht skedarët e udhëzimeve nga mjedisi:
-
AGENTS.md: Shtohet si udhëzim i sistemit kur gjendet në.agents/ose në rrënjën e hapësirës së punës. -
SKILL.md: Ngarkuar nga.agents/skills/dhe regjistruar si aftësi që agjenti mund të thirrë.
Për shembull:
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-05-2026",
input="Analyze the Q1 revenue data and create a slide deck.",
environment={
"type": "remote",
"sources": [
{
"type": "inline",
"target": ".agents/AGENTS.md",
"content": "You are a data analyst. Always use matplotlib for charts.",
},
{
"type": "inline",
"target": ".agents/skills/slide-maker/SKILL.md",
"content": "---\nname: slide-maker\n---\n# Slide Maker\nCreate HTML slide decks...",
},
],
},
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
agent: "antigravity-preview-05-2026",
input: "Analyze the Q1 revenue data and create a slide deck.",
environment: {
type: "remote",
sources: [
{
type: "inline",
target: ".agents/AGENTS.md",
content: "You are a data analyst. Always use matplotlib for charts.",
},
{
type: "inline",
target: ".agents/skills/slide-maker/SKILL.md",
content: "---\nname: slide-maker\n---\n# Slide Maker\nCreate HTML slide decks...",
},
],
},
}, { timeout: 300000 });
console.log(interaction.output_text);
PUSHTIM
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $API_KEY" \
-d '{
"agent": "antigravity-preview-05-2026",
"input": "Analyze the Q1 revenue data and create a slide deck.",
"environment": {
"type": "remote",
"sources": [
{
"type": "inline",
"target": ".agents/AGENTS.md",
"content": "You are a data analyst. Always use matplotlib for charts."
},
{
"type": "inline",
"target": ".agents/skills/slide-maker/SKILL.md",
"content": "---\nname: slide-maker\n---\n# Slide Maker\nCreate HTML slide decks..."
}
]
}
}'
Shih Ndërtimi i Agjentëve të Personalizuar për formatin e plotë të përkufizimit të agjentit dhe agjentët e emërtuar të ripërdorshëm.
Mjediset
Çdo thirrje krijon ose ripërdor një sandbox Linux. Parametri environment merr tre forma:
| Formular | Përshkrimi |
|---|---|
"remote" | Sigurimi i një sandbox-i të ri me cilësime fillestare. |
"env_abc123" | Ripërdorni një mjedis ekzistues sipas ID-së, duke ruajtur të gjithë skedarët dhe gjendjen. |
{...} | Konfigurim i plotë EnvironmentConfig me burime dhe rregulla të rrjetit të personalizuara. |
Shihni Mjediset për detaje mbi burimet (Git, GCS, inline), rrjetëzimin, ciklin jetësor dhe kufizimet e burimeve.
Disponueshmëria dhe çmimet
Agjenti antigravitacional është i disponueshëm në pamje paraprake përmes Interactions API në Google AI Studio dhe Gemini API.
Çmimi ndjek një model "paguaj sipas përdorimit" bazuar në tokenët themelorë të modelit Gemini dhe mjetet që përdor agjenti. Ndryshe nga një kërkesë standarde bisede që prodhon një rezultat të vetëm, një ndërveprim Antigravity është një rrjedhë pune agjentësh. Një kërkesë e vetme shkakton një cikël autonom arsyetimi, ekzekutimi mjetesh, ekzekutimi të kodit dhe menaxhimi të skedarëve.
Kostot e vlerësuara
Kostot ndryshojnë në bazë të kompleksitetit të detyrës. Agjenti përcakton në mënyrë autonome se sa thirrje mjetesh, ekzekutime kodi dhe operacione skedarësh nevojiten. Vlerësimet e mëposhtme bazohen në ekzekutime.
| Kategoria e detyrës | Shenjat e hyrjes | Tokenat e daljes | Kosto tipike |
|---|---|---|---|
| Hulumtim dhe sintezë informacioni | 100 mijë–500 mijë | 10 mijë–40 mijë | 0,30 dollarë–1,00 dollarë |
| Gjenerimi i dokumenteve dhe përmbajtjes | 100 mijë–500 mijë | 15 mijë–50 mijë | 0,30 dollarë–1,30 dollarë |
| Dizajni i procesit dhe sistemit | 100 mijë–400 mijë | 10 mijë–30 mijë | 0,25 dollarë–0,80 dollarë |
| Përpunimi dhe analiza e të dhënave | 300 mijë–3 milionë | 30 mijë–150 mijë | 0,70 dollarë–3,25 dollarë |
50–70% e tokenëve të hyrjes zakonisht ruhen në memorien e përkohshme. Flukset komplekse të punës së agjentëve me shumë thirrje mjetesh mund të grumbullojnë 3–5 milionë tokena në një bashkëveprim të vetëm, me kosto deri në ~$5.
Llogaritja e mjedisit (CPU, memoria, ekzekutimi i sandbox) nuk faturohet gjatë periudhës së pamjes paraprake.
Kufizime
- Statusi i pamjes paraprake: Agjenti Antigravity dhe API-ja e Ndërveprimeve janë në pamje paraprake. Karakteristikat dhe skemat mund të ndryshojnë.
- Konfigurim gjenerimi i pambështetur: Parametrat e mëposhtëm nuk mbështeten dhe kthejnë një gabim 400:
temperature,top_p,top_k,stop_sequences,max_output_tokens. - Dalje e strukturuar: Agjenti Antigravity nuk mbështet dalje të strukturuara.
- Mjetet e padisponueshme:
file_search,computer_use,google_maps,function_callingdhemcpnuk mbështeten ende. - Mjet i sistemit të skedarëve: Për momentin nuk ka asnjë mjet të sistemit të skedarëve. Është pjesë e
environment. - Sfondi: Agjenti nuk mbështet përdorimin e
background=Truedhe kërkonstore=True. - Llojet multimodale të pambështetura. Futjet audio, video dhe dokumente nuk mbështeten për momentin. Lejohen vetëm teksti dhe imazhi.
Çfarë vjen më pas
- Përmbledhje e Agjentëve : Mësoni rreth koncepteve kryesore të agjentëve të menaxhuar.
- Fillim i shpejtë : Filloni ndërtimin me biseda dhe transmetime me shumë kthesa.
- Mjediset e Agjentëve : Konfiguroni sandbox-et, burimet dhe rrjetëzimin.
- Ndërtimi i Agjentëve të Personalizuar : Përcaktoni agjentët tuaj duke përdorur
AGENTS.mddheSKILL.md.