Gemini Interactions API: 2026 Ajan Rehberi

Google, yapay zeka ajanlarını oluşturma şeklinizi az önce değiştirdi.

Interactions API, 23 Haziran 2026 tarihinde genel kullanıma sunuldu. Bu küçük bir güncelleme değil; Gemini'ın çalışma biçiminde köklü bir değişimdir.

Eğer eski GenerateContent uç noktasını (endpoint) kullanıyorsanız, mimariniz muhtemelen güncelliğini yitirmiş demektir.

Eski yöntem:

  • Durumsuz (stateless) bir API kullanırsınız.
  • Her adımda tüm sohbet geçmişini tekrar gönderirsiniz.
  • Bellek yükünün tamamını uygulamanız taşır.
  • Konuşma uzadıkça token maliyetleri artar.

Yeni yöntem:

  • Durum (state) sunucuda tutulur.
  • Bir oturum kimliğine (session ID) atıfta bulunursunuz.
  • Gemini geçmişi, araçları ve sonuçları hatırlar.
  • Sadece konuşmanın yeni kısmını gönderirsiniz.

Bütçeniz üzerindeki etkisi muazzamdır. Bir RAG hattı (pipeline) ile yaptığımız testlerde, sunucu tarafı duruma (server-side state) geçmek, 10.000 günlük oturumda girdi token harcamasını %34 oranında azalttı. 10 adımlık bir testte, girdi token kullanımında %82'ye varan bir düşüş gördük.

Bu sürümde neler yeni?

• Yönetilen Ajanlar (Managed Agents): Google, uzaktan bir Linux sandbox'ı sağlar. Ajanınız, sizin herhangi bir sunucu yönetmenize gerek kalmadan kod çalıştırabilir, web'de arama yapabilir ve dosyaları yönetebilir. • Arka Plan Çalıştırma (Background Execution): Uzun görevler için background=True kullanın. Artık açık bir bağlantı tutmanıza ve zaman aşımı (timeout) sorunlarıyla savaşmanıza gerek yok. • MCP Desteği: API, Model Context Protocol ile uyumludur. Google araçlarını kendi özel araçlarınızla kolayca harmanlayabilirsiniz.

Ne zaman geçiş yapmalısınız?

Her şeyi taşımayın.

Şu durumlarda GenerateContent kullanın:

  • Basit, tek seferlik (one-shot) görevlere ihtiyacınız varsa.
  • Temel sınıflandırma veya özetleme yapıyorsanız.
  • Belleğe ihtiyacınız yoksa.

Şu durumlarda Interactions API kullanın:

  • 3 veya daha fazla araç çağrınız (tool call) varsa.
  • Kalıcı bir konuşma durumuna (conversation state) ihtiyacınız varsa.
  • Uzun süreli arka plan işleri çalıştırıyorsanız.

Bir uyarı: Sunucu tarafı durum (server-side state), satıcıya bağımlılık (vendor lock-in) yaratır. Eğer geçmişiniz Google'ın bulutunda yaşıyorsa, oradan ayrılmak zordur. İlk günden itibaren kendi veritabanınıza bir dışa aktarma yolu (export path) oluşturun.

Durumsuz (stateless) yapay zeka dönemi sona eriyor. Artık gerçekten eyleme geçen ajanlar inşa etme zamanı.

Kaynak: https://blog.google/innovation-and-ai/technology/developers-tools/interactions-api-general-availability/

İsteğe bağlı öğrenme topluluğu: https://t.me/GyaanSetuAi