Google Genkit Agents API Preview: Detached Turns ve HITL TypeScript/Go’da

google, genkit Agents API’yi preview olarak duyurdu. TypeScript ve Go desteğiyle gelen sürüm, tek bir chat() arayüzünde mesaj geçmişi, tool loop, streaming, state persistence ve frontend protokolünü birleştiriyor. Öne çıkan primitifler: detached-agent-turns ve interruptible tool’larla human-in-the-loop onayı. Preview olduğu için API kırılabilir; Python ve Dart planlanıyor.

Ana Gelişme

Agents API, in-process veya HTTP ajanlarında aynı sohbet modelini kullanmayı hedefliyor. Detached turns ile bir görev başlatılıp bağlantı kesilebilir; ilerleme snapshot polling ile izlenir. Interruptible tools, anti-forgery korumalı HITL onayı bekleyebilir — uzun süren ajan işlerinde insan müdahalesini birinci sınıf hale getirir.

Oturum yönetimi server-managed (Firestore, in-memory, file) veya client-managed olabilir. Custom state ile artifact’ler ayrılıyor. Middleware katmanı multi-agent delegation, retry, model fallback ve SKILL.md yükleme gibi senaryoları destekliyor. Model eklentileri Gemini, Vertex, Anthropic, OpenAI ve Ollama’yı kapsıyor; framework model-agnostic konumlanıyor. Lisans: Apache 2.0.

Neden Önemli?

Türk full-stack ekipler için pratik kazanım, LangChain/CrewAI “hangi framework daha iyi” yarışından ziyade oturum, artifact ve HITL primitiflerinin hazır gelmesi. agentic-coding-infrastructure ve multi-agent-systems kuranlar, özellikle Go/TS backend’lerde Genkit’i Managed Agents (Gemini API) alternatifine tamamlayıcı OSS katmanı olarak değerlendirebilir. Production’a almak için preview uyarısı zorunlu.

Teknik Detaylar

Geliştiriciye sunulan temel parçalar:

  • Unified chat() — history, tools, streaming, persistence
  • Detached turns + snapshot polling
  • Interruptible HITL tools (anti-forgery)
  • State vs artifacts ayrımı
  • Middleware: delegation, retries, fallbacks, SKILL.md
  • Model plugin’leri: Gemini, Vertex, Anthropic, OpenAI, Ollama

InfoQ ve Google Developers Blog, API’nin henüz kararlı olmadığını vurguluyor. Python/Dart yol haritası duyuruldu; zaman çizelgesi net değil.

Bağlam

ai-agents ekosisteminde kalıcı oturum ve insan onayı, toy demolar ile production arasındaki en büyük boşluklardan. Genkit’in Firebase/Google ekosistemiyle bağlanması, enterprise TypeScript ekipleri için dağıtım kolaylığı vaat ediyor. mcp ve diğer protokol katmanlarıyla birlikte düşünüldüğünde, Genkit uygulama katmanı framework’ü rolünde.

Sonraki Adımlar

Ekipler staging’de detached turn + HITL akışlarını deneyebilir; breaking change riskini kabul ederek. GA öncesi Python/Dart ve oturum depolama olgunluğu izlenmeli. Production checklist: preview pin’leme, middleware retry politikası, HITL anti-forgery doğrulaması.


Kaynaklar