Sözleşme-Öncelikli Yaklaşım, LLM Ajanlarına Karşı Koruma: API-Öncelikli Yöntem, Ön Uç ve Arka Ucun Uyumunu Sağlamak İçin Geri Dönüyor
Moonshot AI
Yazar, LLM ajanlarını kullanarak geliştirme yaparken projenin bozulması sorununu anlatıyor: ajanlar genellikle ön uç ve arka uç arasındaki gerçek sözleşmeleri göz ardı ediyor, sahte veriler oluşturuyor ve çalışma zamanı hatalarına yol açıyor. Çözüm, OpenAPI şartnamesinin birincil yapıt olduğu ve sunucu arayüzleri ile istemcilerin buradan türetildiği sözleşme-öncelikli yaklaşıma geri dönmektir; bu sayede sözleşmeden herhangi bir sapma derleme hatası haline gelir.
Yazar, iki yan projede LLM ajanlarının ön uç ve arka uç geliştirirken sözleşmelerde (contract) sıklıkla sapma gösterdiğini fark etmiş: ön uç ajanı yanıtları Record<string, unknown> olarak tipliyor, gevşek nesneler veya JSON düğümleri kullanıyor, farklı alan adlarıyla DTO'ları kopyalıyor ve hatta bazen yerel veri ve bildirimlerle (toast) var olmayan bir arka ucu simüle ediyor. Bu hataların hiçbiri derleyici, lint aracı veya mimari testler tarafından yakalanmıyor çünkü analizörler kod tabanları arasındaki HTTP isteklerini görmüyor. Çözüm ise sözleşme öncelikli yaklaşım: tek doğruluk kaynağı, derleme sırasında sunucu arayüzlerini (interfaceOnly ve skipDefaultInterface seçenekleriyle) ve bir istemciyi üreten OpenAPI spesifikasyonudur (YAML). Denetleyici, üretilen arayüzü uygular ve imza eşleşmesini garanti eder; sözleşmeden herhangi bir sapma derleme hatasına dönüşür. Yazar, bu yaklaşımın zaten gRPC ve GraphQL'de kullanıldığını ve REST'e geri döndüğünü belirtiyor, çünkü sözleşme okuyucusu artık bir insan değil, niyetleri geri kazanmayan ve varsayım yapmanın ucuz yolunu seçen bir LLM ajanıdır.
Kaynak: Habr — хаб ИИ —
orijinal