« Tüm yayınlar

Vercel AI SDK 6: Otonom Ajan Döngülerini Sınırlı Kurmak

Vercel AI SDK 6'nın ToolLoopAgent, tipli araçlar ve MCP desteğiyle üretim düzeyinde güvenli ajan mimarisi nasıl kurulur? Adım sınırları, şema doğrulama ve onay noktaları.

Vercel AI SDK 6, TypeScript ekipleri için ToolLoopAgent, tipli araçlar, streaming çıktı, MCP adaptörleri ve OpenTelemetry desteğiyle çok adımlı otonom döngüler kurmayı pratik hale getiriyor. Vercel'in duyurusuna göre yeni Agent arayüzü ve ToolLoopAgent, tekrar kullanılabilir çok adımlı davranışları basitleştirmeyi hedefliyor ve AI SDK 5'e kıyasla daha az kırıcı değişiklik içeriyor. Ancak asıl mesele SDK'nın 'ajan gibi' davranmasının üretimi otomatik olarak güvenli kılmadığı: her döngü adımının sınırlı, tipli, gözlemlenebilir ve onaylanabilir olması gerekiyor.

Kaynak, ToolLoopAgent'ın ne zaman kullanılacağını netleştiriyor: model bir aracı çağırıp sonucu inceleyip devam etmesi gereken durumlarda. Migration rehberi, varsayılan adım sayısını 20 olarak sınırlıyor ama bunun bir tavan olduğu, öneri olmadığı vurgulanıyor; müşteri destek veya kodlama asistanı gibi ajanlar için 4-8 adımla başlanması öneriliyor. Sınıflandırma, özetleme ve çıkarım gibi tek seferlik işler ise generateText veya streamText ile şema tabanlı çıktıya bırakılmalı, ajan döngüsüne sokulmamalı.

Araçların (tool) sözleşme gibi tasarlanması gerektiği vurgulanıyor: Zod veya JSON Schema ile giriş kısıtlanmalı, para harcayan veya kayıt değiştiren eylemler için needsApproval kullanılmalı. GitHub tartışmalarında görülen eksik tool-call alanları sorunu, şemanın tek başına yeterli olmadığını, iş kuralı doğrulamasının kodda da yapılması gerektiğini gösteriyor. Ayrıca kullanıcıya gösterilen akışın (streamText) ile iş akışının tükettiği tipli çıktının (generateText + Output.object) ayrı tutulması, üretim sistemlerinde yaygın bir hata modunu -serbest metnin regex ile ayrıştırılması- önlüyor. MCP ise HTTP taşıması üzerinden Next.js sürecinin dışında yaşayan paylaşılan araçlar (issue tracker, arama, faturalama) için önerilen üretim seçeneği olarak gösteriliyor.