← notlar · 2026-09-13 · 2 dk okuma · ai · agents
Agent döngüleri: plan, araç, doğrula, tekrar
Bir yapay zeka ajanının işe yarayıp yaramadığını model değil döngü belirler. On uygulamayı tek başıma çıkarırken ve DevDNA'yı yazarken döngü tasarımı üzerine öğrendiklerim.
"Agent" kelimesi çok şey anlatıyor gibi görünür, aslında tek bir şeydir: bir döngü. Gözlemle, planla, bir araç çağır, sonucu doğrula, tekrar et, bir durma koşulu gelene kadar. Modelin kalitesi bu döngünün her adımını daha iyi yapar; ama döngü kötüyse en iyi model de kötü sonuç üretir. Buna "loop engineering" diyorum: prompt'u değil, döngüyü tasarlamak.
Döngünün dört parçası
- Gözlem. Ajan neye bakabiliyor? Dosya sistemi, bir API, bir tarayıcı ekran görüntüsü. Görmediği şeyi yönetemez. Uygulama yayınlarken en büyük kazanım, App Store Connect API'yi ajanın gözü yapmaktı: sürüm durumu, review sepeti, fiyat tabloları hep sorgulanabilir hale geldi.
- Plan. Kısa ve gözden geçirilebilir olmalı. Uzun planlar ilk aracın çıktısıyla bayatlar.
- Araç. İyi araç dar, deterministik ve dürüst hata veren araçtır. "Submit" tek başına tehlikeli; önünde bir kapı gerekir. Bizde bu
presubmit_gate.py: IAP yok mu, fiyat sadece ABD'de mi, gizlilik yayınlanmamış mı; hepsini yakalar, ajan bunları geçmeden gönderemez. - Doğrulama. Ajanın "yaptım" demesi yetmez. Ekran görüntüsü, HTTP 200, bir sayacın artması. İkinci uçtan doğrulama kuralı: bir bulguyu raporlamadan önce başka bir yoldan da gör. Yanlış alarmların çoğu buna takıldı.
Bellek
DevDNA'yı yazarken en çok üzerinde durduğum şey buydu: ajan konuşma bitince unutur. Takım için kararlar, standartlar ve alışkanlıklar yazılı bellek dosyalarında durmalı; ajan her döngüde önce onları okumalı. Kişisel iş akışımda da aynı: her app için bir proje notu, her tuzak için bir referans notu. Ajanın hafızası konuşma değil, dosya.
Durma koşulu
En çok gözden kaçan parça. "Tamamlandı" ne demek? Test geçti mi, sayfa 200 döndü mü, kullanıcı onayladı mı? Durma koşulu yazılmamış döngü ya erken bırakır ya da sonsuz döner. Geri dönüşü zor işlerde (silme, yayınlama, para) durma koşulu bir insan olmalı.
Kısa özet
Model kiralanır, döngü senindir. Gözlem yüzeyini genişlet, araçları daraltıp kapılarla koru, her iddiayı ikinci bir uçtan doğrula, belleği dosyaya yaz, durma koşulunu baştan yaz. On uygulamayı bu döngüyle çıkardım; model üç kez değişti, döngü değişmedi.