💡 3 Maddede Bu Yazının Özeti
Vercel, AI SDK 7.0.107 sürümünü 18 Eylül 2026'da yayımladı. Bu bir “patch”, yani küçük düzeltme sürümü; yeni bir model ya da baştan tasarlanmış bir API getirmiyor. Buna rağmen sürüm notundaki on düzeltme, gerçek uygulamalarda sık karşılaşılan üç hassas alana dokunuyor:…
Vercel, AI SDK 7.0.107 sürümünü 18 Eylül 2026’da yayımladı. Bu bir “patch”, yani küçük düzeltme sürümü; yeni bir model ya da baştan tasarlanmış bir API getirmiyor. Buna rağmen sürüm notundaki on düzeltme, gerçek uygulamalarda sık karşılaşılan üç hassas alana dokunuyor: sohbet akışının doğru zamanda tamamlanması, ajanların araçları doğru bağlamla keşfetmesi ve dosya, ses, video gibi medya verilerinin taşınırken anlamını kaybetmemesi.
Bu nedenle 7.0.107’yi yalnızca sürüm numarası yükseltmesi olarak görmek yanıltıcı olur. Düzeltmelerin ortak noktası, bir AI uygulamasının model yanıtından çok çevresindeki “tesisatı” sağlamlaştırmasıdır. Yeniden bağlanma adresindeki sorgu parametreleri, birden fazla Set-Cookie başlığı, ses biçimi meta verisi veya video durum isteğinin zaman aşımı gibi ayrıntılar kullanıcıya doğrudan görünmez. Ancak bu ayrıntılar bozulduğunda sohbet kaybolabilir, oturum bilgisi eksilebilir ya da arayüz işlemin bittiğini yanlış duyurabilir.
Sohbet akışında erken bitiş ve yeniden bağlanma sorunları
Sürümün en dikkat çekici düzeltmelerinden biri, “ön sonuç” niteliğindeki araç çıktılarının sohbeti tamamlanmış saymasını engelliyor. Araç kullanan bir ajan bazen nihai yanıtından önce ara veriler üretir. Arayüz bu veriyi son cevap sanarsa yükleniyor durumu erken kapanabilir, takip eden metin ekrana gelmeyebilir veya ekran okuyucu kullanıcıya işlemin tamamlandığına dair yanlış bir bildirim verilebilir. 7.0.107, bu ayrımı korumayı hedefliyor.
İkinci düzeltme, sohbet akışına yeniden bağlanmak için kullanılan URL’lerdeki sorgu parametrelerini muhafaza ediyor. Resmî “Chatbot Resume Streams” belgesi, bağlantı kesildikten sonra devam eden üretime yeniden bağlanma yaklaşımını açıklıyor. Uygulamalar bu parametrelere oturum, kiracı, dil ya da başka yönlendirme bilgileri koyabiliyor. Parametrenin düşmesi her projede aynı sonuca yol açmaz; fakat yanlış oturuma bağlanma veya devam mekanizmasının çalışmaması gibi riskler doğurabilir.
Taşıma katmanındaki iki ek düzenleme de aynı bütünlüğü destekliyor. Node akış yanıtlarında birden fazla Set-Cookie başlığının korunması, sunucunun gönderdiği çerezlerin tek bir değere indirgenmesini önlüyor. Sohbet taşıma isteklerinde yinelenen içerik türlerinin engellenmesi ise aynı isteğin çelişkili veya gereksiz Content-Type değerleriyle gönderilmesi ihtimalini azaltıyor. Bunlar, özellikle kimlik doğrulama ve akışlı yanıtların birlikte kullanıldığı uygulamalarda test edilmesi gereken değişiklikler.
WorkflowAgent için ertelenmiş araç keşfi
7.0.107 ile WorkflowAgent, ertelenmiş araç keşfini destekleyecek şekilde düzeltiliyor. Ertelenmiş keşif, bütün araç tanımlarını en başta yüklemek yerine gerektiğinde bulmayı amaçlayan bir yaklaşım. Bu, çok sayıda aracı olan sistemlerde başlangıç bağlamını daha küçük tutabilir ve ajanın yalnızca ilgili yetenekleri görmesini sağlayabilir. Ancak sürüm notu performans artışı için sayısal bir oran vermiyor; dolayısıyla burada kesin bir hız ya da maliyet kazanımı vaat etmek doğru olmaz.
Vercel’in resmî WorkflowAgent belgesi, bu yapıyı dayanıklı ve yeniden başlatılabilir ajanlar kurmak için sunuyor. Yeni düzeltme, araçların çalışma sırasında bulunabildiği düzenlerde keşif adımının boşa düşmemesini sağlıyor. Aynı sürümde araç giriş geri çağrılarına araca özgü bağlamın geçirilmesi de düzeltilmiş. Böylece bir giriş işlenirken hangi araca ait bağlamın kullanıldığı daha açık korunuyor.
Bu iki değişiklik birlikte değerlendirildiğinde geliştiricilerin özellikle üç senaryoyu yeniden sınaması yararlı olur: çalışma başladıktan sonra kullanılabilir hâle gelen araçlar, aynı ajan içinde farklı bağlam isteyen araçlar ve insan onayı gibi ara adımlardan sonra devam eden iş akışları. Sürüm notu bu senaryoların hepsini tek tek garanti etmiyor; öneri, düzeltmelerin dokunduğu yüzeylerden türetilmiş bir regresyon kontrolü.
Dosya, beceri, ses ve video verilerinde biçim bütünlüğü
wrapProvider kullanan projeler için dosya ve “skill” yükleme API’lerinin korunması önemli bir düzeltme. Sağlayıcıyı saran bir katman; günlükleme, ara yazılım veya ortak ayar eklemek için kullanılabilir. Sarma işleminden sonra sağlayıcıya özgü yükleme yeteneklerinin kaybolması, metin üretimi çalışırken dosya tabanlı bir özelliğin sessizce kullanılamaz hâle gelmesine neden olabilir. 7.0.107 bu API’leri koruyor.
Ham konuşma sesinde biçim meta verisinin korunması da erişilebilir deneyimler açısından önem taşıyor. Ses verisinin kendisi ulaşsa bile örnekleme, kodlama veya kapsayıcıya ilişkin bilginin kaybı oynatma ve dönüştürme zincirini etkileyebilir. Sürüm notu belirli bir ekran okuyucu ya da medya oynatıcı uyumluluğu vaat etmiyor; doğrulanan iddia, ham ses biçimi meta verisinin artık korunması.
Video üretiminde devam eden durum sorgularına zaman aşımı uygulanması ise süresiz bekleme riskini sınırlıyor. Bir video sağlayıcısı tamamlanma durumunu uzun süre döndürmezse istemcinin sonsuza dek yoklama yapması yerine tanımlı bir hata yoluna geçmesi beklenebilir. Kullanıcı arayüzünde bunun karşılığı; belirsiz bir yükleniyor göstergesi yerine anlaşılır hata, yeniden deneme seçeneği ve canlı bölgenin tekrarlayan gereksiz duyurular üretmemesi olmalı.
Karakter kodlaması ve metin veri URL’leri
Sürüm ayrıca Base64 kodlu metin veri URL’lerini, URL’de bildirilen karakter kümesine göre çözümlemeyi düzeltiyor. Her metin UTF-8 değildir. Türkçe karakterler içeren eski veri kaynakları veya farklı karakter kümesi bildiren içerikler yanlış çözümlendiğinde bozuk harfler, anlamsız dosya adları ya da erişilebilir adlarda okunması zor metinler ortaya çıkabilir. Bu değişiklik, beyan edilen karakter kümesini dikkate alarak dönüşümün doğruluğunu artırmayı amaçlıyor.
Burada da yükseltme sonrası örnek verilerle test yapmak önemli. Türkçe ç, ğ, ı, İ, ö, ş, ü karakterlerini içeren veri URL’leri; düz ASCII içerik; boş değer ve hatalı bildirim ayrı ayrı denenmeli. Düzeltme doğru bildirilmiş karakter kümesini destekliyor, yanlış etiketlenmiş kaynak veriyi kendiliğinden onardığı anlamına gelmiyor.
Yükseltmeden önce kısa kontrol listesi
- Bağımlılığı sabit bir dalda 7.0.107’ye yükseltin ve kilit dosyasındaki değişiklikleri inceleyin.
- Araç kullanan sohbetlerde ara çıktıdan sonra nihai yanıtın gelmeye devam ettiğini doğrulayın.
- Yeniden bağlanma URL’lerinde gerekli sorgu parametrelerinin korunduğunu ağ kayıtlarından kontrol edin.
- Birden fazla çerez gönderen Node akış yanıtlarını ve kimlik doğrulama devamlılığını sınayın.
- WorkflowAgent içinde sonradan keşfedilen araçları ve araca özgü giriş bağlamını test edin.
- Dosya, beceri ve ham ses yükleme yollarında meta verinin korunduğunu örnek içerikle doğrulayın.
- Video durum sorgusu zaman aşımında kullanıcıya anlaşılır ve klavyeyle erişilebilir bir hata sunun.
- Türkçe karakter içeren Base64 metin veri URL’leri için regresyon testi ekleyin.
AI SDK 7.0.107 büyük bir özellik sürümü değil; fakat sohbetin yaşam döngüsü, ajan araçları ve medya taşıma katmanlarında biriken küçük tutarsızlıkları hedefliyor. Üretim sistemleri için en güvenli yaklaşım, yalnızca paket sürümünü değiştirmek değil, uygulamanın kullandığı ilgili akışları gözlenebilir testlerle yeniden çalıştırmak. Özellikle ekran okuyucu duyuruları, klavye odağı, hata mesajları ve uzun süren işlemlerin durum bilgisi teknik regresyon testlerine dâhil edilmeli.
