Tek bir cümle yazdınız, Enter'a bastınız - ve terminalde satırlar akmaya başladı. Bir dosya açtı. Bir komut çalıştırdı. Aynı dosyayı yeniden açtı. Dışarıdan bakınca boş bir koşuşturma gibi görünüyor: tek bir basit şey istemiştiniz, ama uzun süren ve ne olduğu anlaşılmayan bir şeyler oluyor.
Ortada koşuşturma falan yok. Ajan, üç parçadan oluşan ve kendini tekrarlayan bir döngüyle çalışıyor ve ekranda gördüğünüz neredeyse her şey aynı döngünün farklı turları.
Ajan neden bir sohbet asistanından fazlasını yapar
Sohbet asistanı cevabı yazar, gerisi size kalır: kopyala, yapıştır, kaydet, çalıştır. Ajan ise projenizin içinde kendi başına çalışır - dosyaları açar, düzenler, komutları çalıştırır, sonuca bakar ve değişiklikler gerçekten diskinizde kalır.
Bu makalenin asıl meselesi de buradan çıkıyor. Ajan tavsiye vermek yerine işi kendisi yaptığı için iş tek hamlede bitmez. Sizin cümlenizle hazır sonuç arasında birkaç adım vardır ve hepsi ekranda görünür.
Tek bir adım nelerden oluşur
İsteğinizden sonra ajan bu döngüye girer ve gerektiği kadar tur atar. Her tur üç parçadan oluşur.
Bağlamı topla. Ajan bilmediği şeyleri okuyarak tamamlar: gereken dosyaları açar, projenin yapısına bakar, bir önceki komutun çıktısını okur. En çok şaşırtan nokta şu: projenizi ezbere bilmiyor, onu okuyor. Bir ayrıntıya ihtiyaç duyduğu her seferinde gidip bakıyor.
Eylemi gerçekleştir. Tek ve somut bir eylem: bir dosyayı düzenlemek ya da bir komut çalıştırmak. Planın tamamı değil, sadece bir sonraki adım.
Sonucu kontrol et. Ne çıktığına bakmak ve sizin istediğinizle karşılaştırmak.
Sonra yol ikiye ayrılır. Hedefe ulaşıldıysa ajan durur ve bir sonraki isteği bekler. Ulaşılmadıysa bağlam toplamaya geri döner ve bir tur daha atar.
Bu arada döngü sabit bir kalıba göre işlemez, isteğe göre şekillenir. Kodla ilgili basit bir soru bağlam toplama aşamasında bitebilir: ajan okudu, cevap verdi, hiçbir şeyi değiştirmedi. Bir hata düzeltmesi ise tersine üç parçanın hepsinden birkaç kez geçer. Parçalar arasındaki sınırlar da her zaman net değildir - ajan araçları döngünün her aşamasında kullanır.
Tuhaf görünen her şeyin açıklaması işte burada. Ajan aynı dosyayı iki kez açtı - düzenlemeden sonra ona yeniden bakması gerekti. İstekle cevap arasında birkaç dakika geçti - bir değil, dört tur atıldı. Başa dönmek bir arıza değil, işin olağan akışı.
Akıl yürütme ve araç çağrısı
Ajanın yaptığı her şey projedeki dosyaları değiştirmez. Sınır, işinin tam ortasından geçer ve bu sınırı görebilmek işe yarar.
Akıl yürütme - ajan bundan sonra ne yapacağını, hangi dosyaya gideceğini, hatanın nedeninin ne olabileceğini tartıyor. Bu sırada diskte sıfır değişiklik var. Ne kadar ikna edici akıl yürütürse yürütsün, şimdilik bu yalnızca bir niyet.
Araç çağrısı - asıl iş burada gerçekleşir. Bir dosyayı okumak ya da yazmak, projede arama yapmak, bir komut çalıştırmak, internette dokümantasyona göz atmak. Bu eylemlerin her biri terminalde ayrı bir satır olarak görünür ve projede olup bitenler tam da bu satırlardan oluşur.
Çağrının sonucu ajana geri döner ve bir sonraki turda bildiklerinin bir parçası olur. Dosyayı okudu - artık içeriğini biliyor. Testi çalıştırdı - artık testin geçip geçmediğini biliyor.
Komut çöktü, dosya bulunamadı, test geçmedi - ajan bunu görür ve bir sonraki adımda hesaba katar. Çıktıdaki bir hata mesajı her şeyin bozulduğu ve bırakmak gerektiği anlamına gelmez. Çoğu zaman bu, tam da eksik olan bilgidir ve bir sonraki tur öncekinden daha isabetli olur.
Pratikteki sonuç basit. Araç çağrılarıyla ilgili satırlar, bakmadan geçilen teknik gürültü değildir. Dosyalarınıza şu anda ne olduğunu gördüğünüz yer tam olarak orasıdır.
Ajan neden soru sorar
Ajan işin ortasında durup size bir şey sorabilir. Bu, döngünün olağan bir parçasıdır, işin üstesinden gelemediğinin işareti değil.
Sorular iki farklı türde olur ve bunları ayırt edebilmek işinize yarar:
- görev hakkında bilgi eksik - tam olarak neyin değiştirileceği, birbirine benzeyen iki dosyadan hangisini kastettiğiniz, neyin bitmiş sayılacağı. Ajan bir belirsizliğe takıldı ve tahmin yürütmek istemiyor;
- bir eylem için izin gerekiyor - ajan önemli bir şey yapmak üzere ve yapıp yapamayacağını sormak için duruyor. Ne kadar bağımsız hareket edeceği ayarlara bağlıdır.
İlk türden bir soru iyiye işarettir. Şimdi netleştirmek, döngüde yanlış yöne üç tur attıktan sonra işi baştan yapmaktan iyidir.
Soruları beklemek zorunda değilsiniz, onları kendiniz de isteyebilirsiniz. En başta, ilk düzenlemelerden önce, ajandan görevi kendi sözleriyle anlatmasını ve belirsiz olan her şeyi sormasını isteyin:
Görevi nasıl anladığını ve nasıl çözmeyi planladığını yaz.
Görevi ve amacı daha iyi anlamana yardımcı olacaksa soru sor.Böylece belirsizlikler işin yarısı bittiğinde değil, ilk düzenlemeden önce ortaya çıkar. Süreç içinde de istediğiniz an araya girebilirsiniz: bağlam eklemek, yönü düzeltmek ya da ajanı durdurup görevi yeniden ifade etmek için.
Bittiğine kim karar verir
Ajanın "bitti" demesi tek bir anlama gelir: döngüsü sona erdi. Bir eylem gerçekleştirdi, sonucu kendi ölçütlerine göre kontrol etti ve hedefe ulaşıldığına karar verdi. Ama iş henüz bitmedi.
Bir değişiklik, ajan onu yaptığında değil, bir insan gerçekte neyin değiştiğine bakıp sonucun sorumluluğunu üstlendiğinde kabul edilmiş sayılır. Sonrasında iki ihtimal var: kabul edildi - iş bitti; düzeltme - neyin yanlış olduğunu siz ifade edersiniz ve döngü yeni isteğinizle baştan başlar.
Bu noktada bakılacak yer rapor değil, değişikliklerin kendisidir: ajan hangi satırları sildiğini ve hangilerini eklediğini gösterir. "Ne değişti" sorusunun kesin cevabı budur ve bu cevap ajanın yazdığı metinde değildir.
Ajan yaptığı işi öyle anlatabilir ki itiraz edecek bir şey kalmaz: "üç metoda hata yönetimi ekledim, kontrol ettim, her şey çalışıyor". Kulağa bir gerçek gibi geliyor. Ama cevabın metni ile dosyaların içeriği iki ayrı şeydir ve her zaman örtüşmezler. Gerçeği öğrenmenin tek yolu değişiklik listesine bakmaktır.
Claude Code ile birlikte bu nasıl işler
Döngüyü anlamak pratikte size şunları kazandırır:
- istek ne kadar net ifade edilirse, o kadar az tur atılır. Ajan, istediğiniz şeyle örtüşene kadar döngüde tur atmaya devam eder ve belirsiz bir ifade fazladan turlara mal olur;
- ajan, dosyalarda kendi yaptığınız düzenlemeleri o dosyaları bir sonraki açışında fark eder: sonuçta projeyi hatırlamıyor, okuyor. Bir şeyi elle değiştirdiyseniz bunu ona söyleyin;
- ajanın döngüsü "bitti" sözüyle biter. İş ise sizin kontrolünüzle biter ve bunlar farklı anlardır.
Büyük resim şöyle görünüyor: ajanın döngüsü içeride, sizin kontrolünüz dışarıda.
GO TO FULL VERSION