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

Yeni Özellikler ve Güncellemeler

Google, Gemini API'deki Yönetilen Ajanlar (Managed Agents) için önemli güncellemeler duyurdu. Bu güncellemeler, geliştiricilerin daha güvenilir ve üretime hazır ajanlar oluşturmasını sağlıyor. Yeni özellikler arasında ortam kancaları (environment hooks), model seçimi ve ücretsiz katman erişimi yer alıyor. Bu yetenekler, önceki sürümde tanıtılan arka plan görevleri (background tasks) ve uzak MCP sunucu entegrasyonu (remote MCP server integration) üzerine inşa edilmiştir.

Gemini Interactions API ile yönetilen ajanlar, tek bir API çağrısıyla izole bir bulut sanal alanında (cloud sandbox) akıl yürütme, kod yürütme, paket kurulumu, dosya yönetimi ve web arama işlemlerini koordine eder. Bu, geliştiricilerin karmaşık görevleri otomatikleştirmesini kolaylaştırır.

Gemini 3.6 Flash Varsayılan Model Oldu

Antigravity ajanı (antigravity-preview-05-2026) artık varsayılan olarak Gemini 3.6 Flash modelini kullanıyor. Bu değişiklik için herhangi bir kod değişikliği gerekmez; bir sonraki etkileşim otomatik olarak yeni modeli kullanır. Geliştiriciler, `agent_config.model` parametresini kullanarak farklı modelleri de açıkça seçebilir. Desteklenen modeller şunlardır:

• 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 ajan iş akışları için önceki nesil.
• Gemini 3.5 Flash-Lite (`gemini-3.5-flash-lite`): En düşük gecikme ve maliyet.

Örneğin, daha düşük maliyet için Gemini 3.5 Flash-Lite kullanmak üzere aşağıdaki gibi bir yapılandırma yapılabilir:

```javascript import { GoogleGenAI } from "@google/genai"; const client = new GoogleGenAI({}); const interaction = await client.interactions.create({ agent: "antigravity-preview-05-2026", input: "package.json'daki tüm bağımlılıkları denetle, güncel olmayan paketleri yükselt ve npm test çalıştırarak derlemeyi doğrula.", environment: "remote", agent_config: { type: "antigravity", model: "gemini-3.5-flash-lite", }, }); console.log(interaction.output_text); ```

Ortam Kancaları ile Doğrulama ve Denetim

Ortam kancaları (environment hooks), geliştiricilerin ajanın sanal alan içinde yaptığı her araç çağrısından önce veya sonra özel betikler çalıştırmasına olanak tanır. `.agents/hooks.json` dosyasına kanca tanımları eklenir. `pre_tool_execution` ve `post_tool_execution` olayları için işleyiciler tanımlanabilir. `matcher` alanı, düzenli ifadeler (regular expressions) destekler; böylece birden çok aracı hedeflemek için `|` veya tüm araçları yakalamak için `*` kullanılabilir.

Örnek bir yapılandırma:

```json { "security-gate": { "pre_tool_execution": [ { "matcher": "code_execution|write_file", "hooks": [ { "type": "command", "command": "python3 /.agents/hooks-scripts/gate.py", "timeout": 10 } ] } ] }, "auto-format": { "post_tool_execution": [ { "matcher": "*", "hooks": [ { "type": "command", "command": "python3 /.agents/hooks-scripts/auto_lint.py", "timeout": 15 } ] } ] } } ```

Bu yapılandırmada:

• `security-gate` grubu, her `code_execution` veya `write_file` çağrısından önce `gate.py` betiğini çalıştırır. Betik `{"decision": "deny", "reason": "..."}` döndürürse araç çağrısı atlanır ve ret nedeni model bağlamına iletilir.
• `auto-format` grubu, her araç çağrısından sonra `auto_lint.py` betiğini çalıştırarak kod biçimlendirmesini zorlar.

Kancalar ayrıca harici bir uç noktaya (endpoint) POST isteği gönderen `http` tipi işleyicileri de destekler. Ekipler, bu kancaları kullanarak üretim kalitesinde doğrulama ardışık düzenleri (validation pipelines) oluşturuyor. Örneğin, yapay zeka odaklı yatırım bankası Offdeal, uzak sanal alanda otomatik görüntü doğrulama için `post_tool_execution` kancalarını kullanıyor.

Maliyet Kontrolü ve Otomasyon Özellikleri

Ücretsiz Katman Erişimi: Yönetilen ajanlar artık ücretsiz katman projelerinde kullanılabiliyor. Geliştiriciler, aktif faturalandırması olmayan bir projeden API anahtarı ile ajan iş akışlarını deneyebilir.

Bütçe Kontrolleri: Yönetilen ajanlar çok adımlı otonom döngüler (multi-turn autonomous loops) yürüttüğü için karmaşık görevler büyük token bütçeleri tüketebilir. `agent_config` içinde `max_total_tokens` parametresi ile toplam token tüketimi (girdi + çıktı + düşünme) sınırlanabilir. Sınıra ulaşıldığında yürütme güvenle duraklatılır ve etkileşim `status: "incomplete"` döndürür. Ortam durumu korunur; `previous_interaction_id` ile yeni bir bütçe belirleyerek kaldığı yerden devam edilebilir.

Örnek:

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

Zamanlanmış Yürütme (Scheduled Execution): Tetikleyiciler (triggers) ile tekrarlayan ajan görevleri otomatikleştirilebilir. Bir tetikleyici, bir ajan, ortam, istem (prompt) ve cron zamanlamasını kalıcı bir kaynağa bağlar ve manuel müdahale olmadan çalışır. Her çalıştırma aynı sanal alanı kullanır, böylece dosyalar yürütmeler arasında kalıcı olur.

Ortamlar API'si (Environments API): Bu API, kod üzerinden sanal alan oturumlarını listeleme, inceleme ve silme imkanı sunar. Bağlantı kesildikten sonra ortam kimliklerini kurtarmak veya 7 günlük TTL'yi beklemeden sanal alanları temizlemek için kullanılabilir.

Neden Önemli?

Bu güncellemeler, yönetilen ajanları maliyet kontrollü, zamanlanmış ve otonom çalışan işçilere dönüştürüyor. Türk geliştiriciler ve işletmeler için bu, özellikle bulut tabanlı otomasyon ve yapay zeka destekli iş akışlarında önemli avantajlar sunuyor. Örneğin, bir e-ticaret sitesi stok yönetimi veya müşteri hizmetleri için otonom ajanlar kullanabilir; ortam kancaları sayesinde her işlem öncesi güvenlik denetimi yapılabilir. Ücretsiz katman erişimi, küçük ölçekli projelerin ve startup'ların bu teknolojiyi denemesine olanak tanır. Bütçe kontrolleri ise beklenmedik maliyetlerin önüne geçerek kurumsal kullanımı daha öngörülebilir hale getirir. Google'ın bu adımı, yapay zeka ajanlarının üretim ortamlarında daha yaygın kullanılmasının önünü açıyor.