Ajan çalıştı, dosyayı yazdı ve sonuç istediğin gibi değil. Ya kod hata verdi, ya araç açılmadı, ya da açıldı ama yanlış çalışıyor. Bu an, çoğu kişinin "demek ki bu iş bana göre değil" deyip bıraktığı andır. Oysa hata, sürecin kazası değil, adımlarından biridir. Bu yazıda ajan yanlış yaptığında ne yapacağını sırayla anlatıyoruz.
Kısa cevap
Ajan hata yaptığında yapılacak ilk şey, hata mesajını olduğu gibi kopyalayıp ajana geri vermektir; çoğu sorun bu tek adımda çözülür. Çözülmezse sıra şudur: neyin beklendiğini ve neyin olduğunu tek cümleyle yaz, işi küçük parçalara böl, çalışan son sürüme geri dön ve gerekirse sohbeti sıfırdan başlat. Aynı cümleyi tekrar tekrar denemek, denenecek en verimsiz yoldur.
Adım 1: hatayı kopyala, yorumlama
Ekranda kırmızı bir yazı çıktığında onu anlamaya çalışman gerekmiyor. Tek yapman gereken, olduğu gibi kopyalayıp ajana yapıştırmak: "şu hatayı aldım, sen düzelt." Hata mesajı ajanın en çok işine yarayan bilgidir; senin özetlemen ise bilgiyi eksiltir. "Bir şeyler ters gitti" demek yerine üç satırlık teknik metni yapıştırmak sonucu tamamen değiştirir.
Adım 2: beklenen ile olanı ayır
Kod hata vermiyor ama sonuç yanlışsa, ajan neyin yanlış olduğunu bilemez. İşe yarayan kalıp iki cümledir: "Beklediğim: dosyadaki tarihleri yeniden eskiye sıralaması. Olan: karışık sırada bıraktı." Bu ayrım, ajanın kendi çıktısını denetlemesini sağlar. Aynı mantığı baştan kurmak istersen iş emri yazma rehberi tam bu konuyu anlatıyor.
Adım 3: işi küçült
Bir araç aynı anda üç iş yapıyorsa ve sonuç bozuksa, hangi parçanın bozduğu belli olmaz. Ajana "önce yalnız dosyayı okuyup ekrana yazdır, başka bir şey yapma" demek, sorunu ilk adımda yakalar. Sonra ikinci adımı ekletirsin. Küçük adımlarla ilerlemek yavaş görünür ama toplamda daima daha hızlıdır; hataların büyük kısmı zaten ilk iki adımda çıkar.
Adım 4: çalışan sürüme dön
Bir noktada her şey çalışıyorduysa, o hale dönmek en temiz çözümdür. Bunun için tek alışkanlık yeter: bir şey çalışır hale geldiğinde klasörün kopyasını al ve tarihini yaz. Kod bilgisi gerektirmeyen bu basit yedek, saatlerce süren kurtarma denemelerinin yerini alır. Ajana "şu klasördeki çalışan sürümle bunu karşılaştır, farkı bul" da diyebilirsin.
Adım 5: sohbeti sıfırla
Uzun bir konuşmada ajan bazen kendi eski kararlarına takılır: bir yaklaşımı denemiş, olmamış, ama o yaklaşımı savunmaya devam eder. Böyle bir döngüye girdiğini üç dört başarısız denemeden sonra anlarsın. Çözüm, yeni bir sohbet açıp işi baştan ve net biçimde tarif etmektir; çalışan dosyaları da yanında verirsin. Bu bir başarısızlık değil, ajanla çalışmanın normal bir hamlesidir.
Hangi hatalar bu yöntemle çözülmez?
Bir sınır var: istediğin şey aracın erişemediği bir yerdeyse hata döngüsü bitmez. Ajan senin bilgisayarındaki dosyalara ulaşır; başka bir hizmetin içindeki veriye ulaşmak için bağlantı gerekir. Bu durumda çözüm daha çok denemek değil, doğru bağlantıyı kurmaktır; MCP yazısı bu kapıların nasıl açıldığını anlatıyor. Sık düşülen diğer tuzaklar için hatalar yazısına bakabilirsin.