Ajanlar için Next.js anı: Vercel'in ajan framework'ü eve

Sorun: Her ajan aynı tesisatı baştan yazıyor

Bir yapay zekâ ajanının “akıllı” kısmı modelde. Ama onu gerçek işte çalıştırmak için bir sürü sıkıcı parça gerekiyor. Ajan saatlerce çalışırken sunucu yeniden başlarsa ne olacak? Ajanın yazdığı kod nerede çalışacak? Riskli bir işlemden önce kim onay verecek? Ajan bir hata yaptığında, ne yaptığını nasıl göreceksin?

Vercel’in duyuru yazısına göre şirket içinde yüzlerce ajan yapılmış ve her ekip bu tesisatı yeniden kurmuş. Syntax’ın 1016. bölümünde Wes Bos, Scott Tolinski ve CJ, bu soruna gelen iki cevabı konuştu: Vercel’in eve’i ve Astro ekibinin Flue’su.

eve: Dosya ağacı ajanın tarifi

Vercel 17 Haziran’da eve’i tanıttı. Açık kaynak ve TypeScript ile yazılıyor. Fikir, Next.js’in sayfa klasörlerini adrese dönüştürmesine benziyor. eve’de de her dosya ajanın bir parçasını tanımlıyor:

• Bir dosya hangi modelin kullanılacağını söylüyor.
• Bir markdown dosyası ajanın kişiliği ve kuralları, yani sistem istemi.
• tools klasöründeki her TypeScript dosyası bir araç. Dosyanın adı aracın adı oluyor.
• Skill’ler markdown dosyaları. Sadece konu açıldığında yükleniyor.
• Başka bir klasör, iş devredilecek alt ajanları tanımlıyor.

Altyapı tarafında hazır gelenler:

• Kalıcı çalışma. Her konuşma adım adım kaydedilen bir iş akışı. Sunucu çökse ya da yeni sürüm yüklense bile ajan kaldığı yerden devam ediyor.
• Kum havuzu (sandbox). Ajanın yazdığı kod, uygulamanın kendisinden ayrı, izole bir ortamda çalışıyor. Yerelde Docker ile, Vercel’de Vercel Sandbox ile.
• İnsan onayı. Bir araca “onay gerekli” demek tek bir alan. Ajan orada bekliyor, beklerken işlem gücü harcamıyor.
• Bağlantılar. Bir MCP sunucusu ya da OpenAPI belgesi olan bir servis tek dosyayla bağlanıyor. Şifreleri model görmüyor.
• Kanallar ve kayıt. Aynı ajan Slack, Discord, Teams ya da GitHub’da çalışabiliyor. Her çalıştırma, OpenTelemetry standardında adım adım izlenebiliyor.

Flue: Astro ekibinden, her yerde çalışan bir alternatif

Flue’yu sitede ayrıca anlattık. Kısaca: Astro ekibinin GitHub hesabında geliştirilen açık kaynak bir ajan framework’ü. eve ile aynı hafta, Astro’nun kurucularından Fred K. Schott da Flue’yu tanıtan bir paylaşım yaptı. Sitesine göre altında, küçük kalmayı seçen kodlama ajanı Pi’nin çekirdeği çalışıyor.

Flue’nun öne çıkardığı şey taşınabilirlik. Cloudflare’in anlatımına göre ajan Node.js’te, Cloudflare Workers’ta, GitHub Actions ya da GitLab gibi CI ortamlarında çalışabiliyor. Modeli de sen seçiyorsun. Kalıcı çalışma, kum havuzu, MCP desteği ve kanallar Flue’da da var.

Hangisi?

İkisi de çok yeni ve hızla değişiyor. Kabaca:

• Zaten Vercel kullanıyorsan ve “dosyaları koy, gerisi hazır” rahatlığını istiyorsan eve doğal bir seçim.
• Ajanın farklı ortamlarda çalışması gerekiyorsa ya da bir sağlayıcıya bağlanmak istemiyorsan Flue’ya bak.

Hangisini seçersen seç, bu listeyi kendi ajanın için bir kontrol listesi olarak da kullanabilirsin. Kalıcılık, izolasyon, onay, gizli bilgilerin korunması ve izlenebilirlik. Bunlardan biri eksikse, ajan demoda çalışır ama gerçek işte zorlanır.

Kod yerine tek bir YAML dosyasıyla ajan tanımlayan başka bir yaklaşım için Docker Agent yazısına bak.

Düşün

• Yazdığın ya da kullandığın bir ajanda, sunucu yeniden başlarsa yarım kalan iş ne oluyor?
• Ajanının hangi işlemleri senin onayın olmadan yapmamalı?

Kendi cümlelerimizle yazılmış bir özettir, çeviri değildir. Tüm kaynaklar yukarıda.