Pekin Üniversitesi’nden araştırmacılar, kodlama ajanlarının gerçek oturumlarında hangi belgelere başvurduğunu ampirik olarak inceledi. Sonuçlar, yaygın varsayımların tamamen yanlış olabileceğini ortaya koydu.
API Referansları Değil, Kendi Notlarınız Daha Kritik
Araştırma, 557 gerçek kodlama oturumu ve 33 binden fazla ajan tarafından yazılan pull request’ten elde edilen verilerle destekleniyor. Bulgular şaşırtıcı:
- AGENTS.md, CLAUDE.md gibi yönerge dosyaları: Tüm belge etkileşimlerinin %35.4’ü
- Ajanın kendi planları ve notları: %25.1
- API referansları: Yalnızca %1.3
- Sorun giderme rehberleri: %0.4
Belgeleri Okumak Kod Yazmayı Tetiklemiyor
Geleneksel varsayım, ajanın önce belgeleri okuyup ardından kod yazdığı yönündeydi. Ancak araştırma bu döngüyü bulamadı. 1,328 belge okuma olayından yalnızca 3’ü doğrudan bir kod düzenlemesiyle sonuçlandı. Ajanların belge tabanlı bir doğrulama gerçekleştirdiği tek bir örnek bile tespit edilemedi.
Belgeleri Çoğunlukla Ajanlar Yazıyor
En ilginç bulgu: Ajanlar belgeleri okudukları kadar sıklıkla da yazıyorlar. Bu durum, ajan odaklı belgelerin — talimatlar, planlar, notlar — aslında ajan topluluğu tarafından oluşturulduğunu ve sürekli güncellendiğini gösteriyor.
Nelere Dikkat Edilmeli?
Araştırmacılar, yaygın varsayılan “eylemlenebilirlik” ve “doğrulanabilirlik” özelliklerinin gerçek davranış verileriyle tutarlı destek bulmadığını belirtiyor. Eğer bir yapay zeka ajanıyla çalışıyorsanız, API belgelerinizden çok AGENTS.md dosyanız daha kritik öneme sahip.
Kaynak: Rohan Paul (@rohanpaul_ai), arxiv.org/abs/2608.20195
Henüz yorum yok. İlk yorumu siz yapın!