Vercel, AI SDK HarnessAgent harness'ını sandbox dışına alıp host sürecine taşıdı

Vercel, AI SDK'nın HarnessAgent'ı için fx adapter'ını yeniden yapılandırdı: agent harness'ı ve gerçekleştirdiği model çağrıları artık uygulamanın kendisiyle aynı süreçte çalışırken, araç setine yerleşik filesystem ve shell işlemleri yalnızca sandbox içinde çalışmaya devam ediyor. 28 Ekim tarihli Vercel blog'undaki bir changelog yazısına göre bu değişiklik, fx'ün altyapısını oluşturan TypeScript kütüphanesi libfx üzerine kurulu bir yeniden yazım üzerinden geliyor.

Yeniden yazımın ortadan kaldırdıkları

Önceki tasarımda sandbox'lanmış bir agent çalıştırmak, host ile sandbox arasındaki sınırın iki yakasına yayılan bir mekanizma kurmayı gerektiriyordu. Vercel'e göre yeni adapter, fx'ü sandbox içine kurmuyor, sandbox köprüsü (bridge) çalıştırmıyor ve sandbox portu açmıyor. Bunun yerine harness host sürecinde yer alıyor ve riskli işleri — yani dosya erişimi ve shell komutlarını — izole ortama gönderiyor.

Güvenlik açısından önemli bir sonuç da, model kimlik bilgilerinin sandbox'a aktarılmak yerine host sürecinde kalması. Güvenilmeyen araç etkinliğini yürüten ortam böylece model sağlayıcısının anahtarlarına sahip olmuyor.

Adapter'daki yeni yetenekler

Mimari değişikliğin yanı sıra Vercel bir dizi yeni özellik de listeliyor:

• Yerleşik araç filtreleme: geliştiricilerin, paketle birlikte gelen araçlardan hangilerini agent'ın kullanabileceğini seçmesini sağlıyor.
• Tur ortasında yönlendirme (mid-turn steering): bir tur hâlâ sürerken agent'a yeni talimatlar ulaşmasını sağlıyor.
• Yapılandırılmış çıktı: şemaya uyan yanıtlar için.
• Görsel araç sonuçları: toModelOutput() aracılığıyla modele döndürülüyor.
• Oturum kalıcılığı: bir oturumun kaydedilip daha sonra yeni bir host sürecinde devam ettirilebilmesi.

Oturum devam ettirme ayrıntısı üzerinde durmaya değer: harness artık sandbox'a değil host'a ait olduğundan, kaydedilmiş bir oturum tamamen yeni bir host süreci tarafından devralınabiliyor — bu da tek bir dağıtımın ya da süreç ömründen daha uzun yaşayan agent'lar için gereken türden bir temel yapı taşı.

Nasıl benimsenir

Değişiklik @ai-sdk/harness-fx paketiyle geliyor. Vercel, yeni adapter'a geçmek için paketin en son sürümüne güncellemenin yeterli olduğunu belirtiyor ve ayrıntılar için okuyucuları fx harness dokümantasyonuna yönlendiriyor.

Neden önemli

Sandbox'lı agent mimarileri, güvenilen ve güvenilmeyen kod arasındaki çizgiyi nereye çektiklerine göre ayakta kalır ya da çöker. Önceki düzenleme, harness fiilen sandbox sınırının öteki tarafında yaşadığı ve sağlayıcı kimlik bilgilerinin o ortama iletilmesi gerektiği için tam olarak bir köprüye ve açık bir porta ihtiyaç duyuyordu. Yeni tasarım ise yalnızca gerçekten tehlikeli işlemleri — filesystem ve shell araçlarını — izolasyon duvarının arkasına yerleştiriyor.

Bu da daha küçük bir saldırı yüzeyi ve daha az işletilecek altyapı anlamına geliyor: sandbox içinde fx kurulumu yok, köprü süreci yok, açık port yok ve araç yürütmesinin erişebileceği sağlayıcı anahtarları yok. Yanında gelen özellikler de aynı yönü gösteriyor. Araç filtreleme agent'ın neler yapabileceğini daraltıyor, tur ortasında yönlendirme ve oturum devam ettirme uzun süren turlarda kontrol ve dayanıklılığı ele alıyor, yapılandırılmış çıktı ve görsel sonuçları ise harness'ın ifade edebildiği görev yelpazesini genişletiyor. AI SDK üzerinde agent geliştirenler için bu, dağıtım hikâyesinde anlamlı bir sadeleşme; agentic sistemler için sandbox tasarımı yapan herkes içinse hangi bileşenin sınırın hangi tarafında olması gerektiğine dair yararlı bir referans noktası.