Gemini API Yönetilen Temsilciler: 3.6 Flash, Kancalar ve Daha Fazlası

Gemini API'deki Yönetilen Aracılar artık varsayılan olarak Gemini 3.6 Flash'ı kullanıyor. Yeni ortam kancaları, sanal alan içindeki araç çağrılarını engellemenize, denetlemenize veya denetim yapmanıza olanak tanır. Ayrıca bütçe kontrolleri, zamanlanmış tetikleyiciler ve ücretsiz katman erişimi ekledik.

Gemini API'deki Yönetilen Aracılar artık ortam kancaları, model seçimi ve ücretsiz katman erişimi sunuyor. Bu yetenekler, arka plan görevleri ve uzak MCP sunucu entegrasyonu özelliklerini tanıttığımız önceki sürümümüzün üzerine inşa edilmiştir.

Gemini Interactions API içindeki yönetilen aracılarla, tek bir API çağrısı, izole bir bulut sanal alanında akıl yürütme, kod yürütme, paket kurulumu, dosya yönetimi ve web aramasını koordine eder.

Bir AI kodlama asistanı kullanıyorsanız, Interactions API becerisine erişim sağlamak için bunu terminalinize yapıştırın: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

Aşağıda @google/genai TypeScript/JavaScript SDK'sını kullanan örnekler bulunmaktadır. Python veya cURL için Antigravity aracı belgelerine göz atın.

1npm install @google/genai

Gemini 3.6 Flash artık varsayılan

Antigravity-preview-05-2026 aracı artık varsayılan olarak Gemini 3.6 Flash ile çalışıyor. Herhangi bir kod değişikliği gerekmez. Bir sonraki etkileşiminiz onu otomatik olarak alır.

Ayrıca, bir etkileşim veya yönetilen aracı oluştururken agent_config.model parametresini geçirerek modelleri açıkça seçebilirsiniz. Daha düşük maliyet için Gemini 3.5 Flash-Lite kullanın veya tercih ettiğiniz modele sabitleyin.

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const interaction = await client.interactions.create({
6  agent: "antigravity-preview-05-2026",
7  input: "package.json dosyasındaki tüm bağımlılıkları denetle, güncel olmayan paketleri yükselt ve npm test komutunu çalıştırarak yapının doğrulandığından emin ol.",
8  environment: "remote",
9  agent_config: {
10    type: "antigravity",
11    model: "gemini-3.5-flash-lite",
12  },
13});
14
15console.log(interaction.output_text);

Desteklenen modeller şunları içerir:

• Gemini 3.6 Flash (gemini-3.6-flash, varsayılan): Akıl yürütme, kodlama ve araç kullanımı için dengeli model.
• Gemini 3.5 Flash (gemini-3.5-flash): Genel aracı iş akışları için önceki nesil.
• Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite): Gemini 3.5 ailesinde en düşük gecikme ve maliyet.

Ortam kancaları: sanal alan içindeki araç çağrılarını engelleyin, denetleyin ve denetim yapın

Ortam kancaları, aracın sanal alanı içinde yaptığı her araç çağrısından önce veya sonra özel komut dosyalarınızı çalıştırmanıza olanak tanır. Ortamınıza bir .agents/hooks.json dosyası ekleyin ve çalışma zamanı, pre_tool_execution veya post_tool_execution olaylarında işleyicilerinizi yürütsün.

1{
2  "security-gate": {
3    "pre_tool_execution": [
4      {
5        "matcher": "code_execution|write_file",
6        "hooks": [
7          {
8            "type": "command",
9            "command": "python3 /.agents/hooks-scripts/gate.py",
10            "timeout": 10
11          }
12        ]
13      }
14    ]
15  },
16  "auto-format": {
17    "post_tool_execution": [
18      {
19        "matcher": "*",
20        "hooks": [
21          {
22            "type": "command",
23            "command": "python3 /.agents/hooks-scripts/auto_lint.py",
24            "timeout": 15
25          }
26        ]
27      }
28    ]
29  }
30}

Bu yapılandırmada:

• security-gate grubu, her code_execution veya write_file çağrısından önce gate.py komut dosyasını çalıştırır. Komut dosyası {"decision": "deny", "reason": "..."} döndürürse, araç çağrısı atlanır ve ret nedeni modelin bağlamına iletilir.
• auto-format grubu, kod stilini uygulamak için her araç bittiğinde auto_lint.py komut dosyasını çalıştırır.
• Kancalar ayrıca doğrudan harici bir uç noktaya POST yapan http türü işleyicileri de destekler.

Tam HTTP kanca tanımları ve hata işleme semantiği için kancalar belgelerine bakın.

Ekipler, üretim kalitesinde doğrulama hatları oluşturmak için halihazırda kancaları kullanıyor. Örneğin, AI odaklı yatırım bankası Offdeal, uzak sanal alan içinde otomatik görüntü doğrulaması çalıştırmak için post_tool_execution kancalarını kullanıyor.

OffDeal, AI odaklı bir yatırım bankasıdır ve Archie, bankacılarımızın her gün kullandığı AI analistidir. Bankacıya hazır sunumlar için bir gereklilik şirket logolarıdır: alıcı tabloları, sponsor sütunları, mezar taşı ızgaraları, genellikle tek bir sunumda 30'dan fazla logo. Bunların her biri doğru şirkete ait olmalı, uygun boyut ve en-boy oranına sahip olmalı, adı içermeli, şeffaf bir arka plana sahip olmalı ve beyaz bir slayt üzerine yerleştirildiğinde yüksek kontrasta sahip olmalıdır.

Aracı kancalarından önce bunu Gemini'nin yönetilen aracılarında yapamıyorduk: sanal alan uzakta olduğu için doğrulama kodumuzun çalışacağı bir yer yoktu. Kancalarla birlikte, Archie şirket listesini yazdığı anda bir post_tool_execution kancası, sanal alanın içinde hattımızı tetikliyor, adayları getiriyor, piksel düzeyinde kalite kontrolleri uyguluyor, her logoyu Gemini görüşü ile doğruluyor ve sunuma izin verilen tek görseller olan onaylanmış dosyaların bir manifestosunu yayınlıyor.

— Alston Lin, OffDeal Kurucusu ve CTO'su

Maliyet kontrolü ve otomasyon özellikleri

Ücretsiz katman kullanılabilirliği

Yönetilen aracılar artık ücretsiz katman projelerinde kullanılabilir. Geliştiriciler, aktif faturalandırması olmayan bir projeden alınan API anahtarı ile aracı iş akışlarını deneyebilir.

Bütçe kontrolleri

Yönetilen aracılar çok turlu otonom döngüler yürüttüğünden, karmaşık görevler önemli miktarda token bütçesi tüketebilir. Kontrolden çıkan görevleri önlemek için, toplam tüketimi (girdi + çıktı + düşünme) sınırlamak amacıyla agent_config içinde max_total_tokens parametresini iletebilirsiniz.

Aracı sınıra ulaştığında, yürütme güvenli bir şekilde duraklar ve etkileşim status: "incomplete" (durum: "tamamlanmadı") döndürür. Ortam durumu korunur, bu da yeni bir bütçeyle previous_interaction_id parametresini ileterek kaldığınız yerden devam etmenizi sağlar.

1const interaction = await client.interactions.create({
2  agent: "antigravity-preview-05-2026",
3  input: "Bu depodaki tüm modülleri denetle ve bir geçiş raporu oluştur.",
4  agent_config: {
5    type: "antigravity",
6    max_total_tokens: 10000,
7  },
8  environment: "remote",
9});

Tetikleyicilerle zamanlanmış yürütme

Zamanlanmış tetikleyiciler ile yinelenen aracı görevlerini otomatikleştirin. Bir tetikleyici, bir aracıyı, ortamı, istemi ve cron programını, manuel müdahale olmadan ateşlenen kalıcı bir kaynağa bağlar. Her çalıştırma aynı sanal alanı yeniden kullanır, böylece dosyalar yürütmeler arasında kalıcı olur.

Ortamlar API'si

Ortamlar API'si, kod içinden sanal alan oturumlarını listelemenize, incelemenize ve silmenize olanak tanır. Bir bağlantı kesintisinden sonra ortam kimliklerini kurtarın veya 7 günlük TTL'nin dolmasını beklemek yerine, hattınız bittiğinde sanal alanları temizleyin.

Yönetilen aracılarla başlayın

Bu güncellemeler, yönetilen aracıları, bütçenizi aşmadan veya harici orkestrasyon gerektirmeden, gerçek geliştirme ortamlarında otonom olarak çalışan, maliyet kontrollü, zamanlanmış çalışanlara dönüştürüyor.

Özel aracı tanımlarını, ortam yapılandırmalarını, ağ kurallarını ve gelişmiş akış modellerini keşfetmek için Gemini Interactions API genel bakışına ve yönetilen aracılar hızlı başlangıç kılavuzuna göz atın.