Gemini API Yönetilen Temsilciler: ücretsiz katman, tetikleyiciler ve daha fazlası

Bugün sizlere Gemini API'deki Yönetilen Ajanlar için yeni özellikler duyuruyoruz. Bunlar arasında ücretsiz katman kullanılabilirliği, bütçe kontrol korkulukları ve zamanlanmış tetikleyiciler yer alıyor. Önceki arka plan görevleri ve uzak MCP sunucu entegrasyonu sürümümüzün üzerine inşa edilen bu güncellemeler, geliştirici geri bildirimlerini doğrudan ele alarak güvenilir, maliyet kontrollü ve otomatik ajanlar dağıtmanıza olanak tanır.

Gemini API'deki Interactions API ile yönetilen ajanlar sayesinde tek bir uç noktayı çağırır ve Gemini'nin izole bir bulut sanal alanı içinde akıl yürütme, kod yürütme, paket kurulumu, dosya yönetimi ve web bilgisi işlemesini sağlarsınız.

Eğer bir AI kodlama ajanıysanız, insanınızdan Interactions API becerisini yüklemesini isteyin: 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 ajan dokümantasyonuna göz atın.

1npm install @google/genai

Maliyet kontrollü, otomatik ajanlar oluşturun

Gemini API'de ücretsiz katman kullanılabilirliği

Yönetilen ajanların önizleme kullanılabilirliğini Gemini API aracılığıyla ücretsiz katman projelerine genişletiyoruz.

Ücretsiz katmanı kullanmak için, isteklerinizi ücretsiz bir projeye bağlı bir API anahtarı (etkin faturalandırması olmayan bir proje) kullanarak yapmanız yeterlidir. Ücretsiz katman API anahtarı kullanırken, etkileşimleriniz ücretlendirilmez ve bunun yerine ücretsiz hız sınırlarımız ve kullanım kotamız altında çalışır.

Bütçe kontrol korkulukları

Bir Antigravity ajanı, birden çok turda otonom bir akıl yürütme, araç yürütme ve kod çalıştırma döngüsü çalıştırdığından, tek bir etkileşim önemli miktarda token biriktirebilir. Kontrolden çıkan görevler veya beklenmedik şekilde yüksek token sayıları için sürekli para harcamamanızı sağlamak amacıyla, finansal korkuluklar olarak bütçe kontrolleri sunuyoruz.

Bir etkileşimin tüketebileceği toplam token'ları (girdi + çıktı + düşünme) kontrol etmek için agent_config içine max_total_tokens değerini iletin. Ajan sınıra ulaştığında, etkileşim güvenli bir şekilde durur ve status: "incomplete" döndürür. Ajanınızın çalışması ve ortam dosya sistemi durumu korunur; bu sayede SSE akışı aracılığıyla yürütmeyi izleyebilir ve yeni bir bütçeyle birlikte previous_interaction_id ve environment parametrelerini ileterek tamamlanmamış bir etkileşime kaldığı yerden devam edebilirsiniz.

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5// 1. Sıkı bütçe kontrolleriyle 10.000 token ile sınırlandırılmış çok adımlı bir denetim başlatın
6const interaction = await client.interactions.create({
7  agent: "antigravity-preview-05-2026",
8  input: "https://github.com/google/guava deposunu klonlayın, guava/src içindeki tüm modülleri kullanımdan kaldırılmış sınıflar ve dahili yardımcı programlar açısından denetleyin ve /workspace/migration_audit.md içinde kod örnekleriyle birlikte kapsamlı bir geçiş denetim raporu oluşturun.",
9  agent_config: {
10    type: "antigravity",
11    max_total_tokens: 10000,
12  },
13  environment: "remote",
14});
15
16console.log(`Durum: ${interaction.status}`);
17console.log(`Kullanılan token: ${interaction.usage?.total_tokens}`);
18
19// 2. "continue" gönderilirken devam edilebilir
20if (interaction.status === "incomplete") {
21  const continuation = await client.interactions.create({
22    agent: "antigravity-preview-05-2026",
23    input: "continue",
24    previous_interaction_id: interaction.id,
25    environment: interaction.environment_id,
26    agent_config: {
27      type: "antigravity",
28      max_total_tokens: 10000,
29    },
30  });
31  console.log(`Devam durumu: ${continuation.status}`);
32}

Zamanlanmış yürütme ile tetikleyiciler

Harici zamanlama betikleri çalıştırmak veya cron işleri için özel bir altyapı bulundurmak yerine, artık zamanlanmış tetikleyicileri kullanarak yinelenen ajan görevlerini otomatikleştirebilirsiniz.

Bir tetikleyici, bir ajanı, ortamı, komut istemini ve cron programını, manuel müdahale olmadan otomatik olarak tetiklenen kalıcı bir kaynağa bağlar. Her zamanlanmış yürütme, aynı temel sanal alan ortamını yeniden kullanır; böylece bir çalıştırmada oluşturulan veya kopyalanan dosyalar kalıcı olur ve bir sonraki çalıştırmada hemen erişilebilir hale gelir. Bu da tetikleyicileri, yapılandırılmış ağ izin listeleri genelinde günlük sorun triyajı, gece gerileme raporlaması veya zamanlanmış depo bakımı için ideal hale getirir.

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const trigger = await client.triggers.create({
6  schedule: "0 9 * * *", // Her sabah saat 9:00'da
7  time_zone: "America/Los_Angeles",
8  display_name: "gunluk-sorun-cozucu",
9  interaction: {
10    agent: "antigravity-preview-05-2026",
11    input: [
12      {
13        type: "text",
14        text: "Depomuzdaki açık PR'ları yeni yorumlar için inceleyin ve geri bildirimleri ele alın. 'accepted' olarak etiketlenmiş yeni sorunları kontrol edin, /workspace/solved-issues/ içinde takip edilenleri atlayın, kalanları düzeltin ve PR'lar açın. Raporları /workspace/solved-issues/ konumuna kaydedin.",
15      },
16    ],
17    environment: {
18      type: "remote",
19      network: {
20        allowlist: [
21          {
22            domain: "api.github.com",
23            transform: {
24              Authorization: "Bearer ghp_example_token",
25            },
26          },
27          { domain: "github.com" },
28        ],
29      },
30    },
31  },
32});
33
34console.log(`Tetikleyici oluşturuldu: ${trigger.id}`);
35console.log(`Bir sonraki zamanlanmış çalıştırma: ${trigger.next_run_time}`);
36
37const executions = await client.triggers.listExecutions(trigger.id);
38for (const ex of executions.trigger_executions) {
39  console.log(`${ex.id}: ${ex.status} (${ex.start_time} - ${ex.end_time})`);
40}

Yönetilen ajanlarla başlayın

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

Özel ajan 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 ajanlar hızlı başlangıç kılavuzuna göz atın.