Siz bir cümlə yazdınız, Enter-i basdınız - və terminalda sətirlər axmağa başladı. Faylı açdı. Əmri işə saldı. Yenə həmin faylı açdı. Kənardan bu, mənasız qaçaqaça oxşayır: guya sadə bir iş istəmişdiniz, amma uzun və anlaşılmaz nəsə baş verir.

Orada heç bir qaçaqaç yoxdur. Agent üç hissədən ibarət təkrarlanan dövr üzrə işləyir və ekranda gördüyünüz demək olar ki, hər şey eyni dövrün müxtəlif turlarıdır.

Agent niyə çatdan daha çox iş görür

Çat cavabı yazıb verir, qalanını isə özünüz əl ilə edirsiniz: kopyalamaq, yapışdırmaq, saxlamaq, işə salmaq. Agent isə layihənizdə özü işləyir - faylları açır, onlara düzəliş edir, əmrləri işə salır, nəticəyə baxır və dəyişikliklər həqiqətən diskinizdə qalır.

Bu məqalə də məhz buradan çıxan nəticəyə görə yazılıb. Agent məsləhət vermir, işi özü görür, deməli, bir hərəkətlə iş bitmir. Sizin cümləniz ilə hazır nəticə arasında bir neçə addım var və onların hamısı ekranda görünür.

Bir addım nədən ibarətdir

Soldakı sorğu üç addımlı dövrə daxil olur, nəticə tapşırığa uyğun gələnə qədər dövr təkrarlanır və sağda hazır nəticə çıxırAgent dövrüSorğunuzKonteksttoplamaqƏməliyyatıicra etməkNəticəniyoxlamaqHazırdır
Dövrdən bir keçid. Nəticə tapşırığa uyğun gəlməsə, agent başlanğıca qayıdır

Sorğunuzdan sonra agent bu dövrə girir və ondan neçə dəfə lazımdırsa, o qədər keçir. Hər keçid üç hissədən ibarətdir.

Kontekst toplamaq. Agent bilmədiklərini oxuyub öyrənir: lazımi faylları açır, layihənin strukturuna baxır, əvvəlki əmrin çıxışını oxuyur. Ən çox təəccübləndirən məqam budur: o, layihənizi əzbər bilmir, onu oxuyur. Hər dəfə hansısa detal lazım olanda gedib baxır.

Əməliyyatı icra etmək. Konkret bir əməliyyat: fayla düzəliş etmək və ya əmri işə salmaq. Bütün plan birdən yox, yalnız növbəti addım.

Nəticəni yoxlamaq. Nə alındığına baxmaq və onu sizin istədiyinizlə müqayisə etmək.

Sonra yol ayrıcı gəlir. Məqsədə çatılıb - agent dayanır və növbəti sorğunu gözləyir. Çatılmayıb - kontekst toplamağa qayıdır və dövrü bir daha keçir.

Üstəlik, dövr cədvəl üzrə işləmir, sorğuya uyğunlaşır. Kod haqqında sadə sual kontekst toplanması mərhələsində də bitə bilər: agent oxudu, cavab verdi, heç nəyi dəyişmədi. Xətanın düzəldilməsi isə, əksinə, hər üç hissədən bir neçə dəfə keçəcək. Hissələr arasındakı sərhədlər də həmişə dəqiq olmur - agent alətlərdən bütün dövr boyu istifadə edir.

Qəribə görünən hər şeyin izahı elə buradadır. Agent eyni faylı iki dəfə açdı - düzəlişdən sonra ona yenidən baxmaq lazım gəldi. Sorğu ilə cavab arasında bir neçə dəqiqə keçdi - bir yox, dörd tur olub. Başlanğıca qayıtmaq nasazlıq deyil, bu, normal iş qaydasıdır.

Düşünmə və alət çağırışı

Agentin etdiyi hər şey layihədəki faylları dəyişmir. Sərhəd onun işinin düz ortasından keçir və onu görə bilmək faydalıdır.

Düşünmə - agent növbəti addımda nə edəcəyini, hansı fayla gedəcəyini, xətanın səbəbinin nə ola biləcəyini fikirləşir. Bu zaman diskdə heç nə dəyişmir. Nə qədər inandırıcı düşünsə də, hələlik bu, sadəcə niyyətdir.

Alət çağırışı - real iş elə burada baş verir. Faylı oxumaq və ya yazmaq, layihədə axtarış etmək, əmri işə salmaq, internetdə sənədlərə nəzər salmaq. Bu əməliyyatların hər biri terminalda ayrıca sətir kimi görünür və layihədə baş verənlər məhz onlardan ibarətdir.

Çağırışın nəticəsi agentə qayıdır və növbəti turda onun bildiklərinin bir hissəsinə çevrilir. Faylı oxudu - indi onun məzmununu bilir. Testi işə saldı - indi testin keçib-keçmədiyini bilir.

Xəta da nəticədir

Əmr çökdü, fayl tapılmadı, test keçmədi - agent bunu görür və növbəti addımda nəzərə alır. Çıxışda xəta mesajının olması hər şeyin xarab olduğu və işi atmaq lazım olduğu anlamına gəlmir. Çox vaxt bu, ona çatmayan elə həmin məlumatdır və növbəti tur əvvəlkindən daha dəqiq olacaq.

Praktik nəticə sadədir. Alət çağırışları haqqındakı sətirlər baxmadan sürüşdürülən texniki səs-küy deyil. Fayllarınızla indi nə baş verdiyi məhz orada görünür.

Agent niyə suallar verir

İşin ortasında agent dayanıb sual verə bilər. Bu, dövrün normal hissəsidir, öhdəsindən gəlmədiyinin əlaməti deyil.

Suallar iki fərqli növdə olur və onları ayırd etmək faydalıdır:

  • tapşırıq haqqında məlumat çatmır - dəqiq nəyi dəyişmək lazımdır, iki oxşar fayldan hansını nəzərdə tutmusunuz, nəyi hazır saymaq olar. Agent qeyri-müəyyənliyə ilişib və təxmin etmək istəmir;
  • əməliyyat üçün icazə lazımdır - agent nəzərəçarpan nəsə etmək üzrədir və olarmı deyə soruşmaq üçün dayanır. Onun nə qədər müstəqil olması tənzimləmələrdən asılıdır.

Birinci növ sual yaxşı əlamətdir. Dövrün üç turu səhv istiqamətə getdikdən sonra işi yenidən görməkdənsə, indi dəqiqləşdirmək yaxşıdır.

Sualları əvvəlcədən istəyin

Sualları gözləmək məcburi deyil, onları özünüz istəyə bilərsiniz. Lap əvvəldə, ilk düzəlişlərdən qabaq ondan tapşırığı öz sözləri ilə izah etməsini və aydın olmayan hər şey barədə soruşmasını xahiş edin:

Tapşırığı necə başa düşdüyünü və onu necə həll etmək fikrində olduğunu yaz.
Tapşırığı və məqsədi daha yaxşı anlamağa kömək edəcəksə, suallar ver.

Belə olanda qeyri-müəyyənliklər işin yarısı görüləndə yox, ilk düzəlişdən əvvəl üzə çıxır. İş gedərkən də istənilən anda müdaxilə edə bilərsiniz: kontekst əlavə etmək, istiqaməti düzəltmək və ya agenti dayandırıb tapşırığı yenidən ifadə etmək.

Hazır olduğuna kim qərar verir

"Hazırdır" sözündən sonra insan dəyişikliklərə baxır və qərar verir: nəticəni qəbul etmək, yoxsa yenidən işlənməyə göndərib yeni sorğu yazmaqHazırdırNəyin dəyişdiyinəsiz baxırsınızQəbul edildiYenidən işləməYeni sorğu
"Hazırdır" sözü agentin dövrünü bitirir, amma işi yox: qərarı insan verir

Agentin "hazırdır" sözü yalnız bir şey deməkdir: onun dövrü bitdi. O, əməliyyatı icra etdi, nəticəni öz meyarlarına görə yoxladı və məqsədə çatıldığı qənaətinə gəldi. Amma iş hələ bitməyib.

Dəyişiklik agent onu edəndə yox, insan əslində nəyin dəyişdiyinə baxıb nəticənin məsuliyyətini üzərinə götürəndə qəbul edilmiş sayılır. Sonra iki yol var: qəbul edildi - iş bitdi; yenidən işləmə - nəyin düz olmadığını siz izah edirsiniz və dövr yeni sorğunuzla təzədən başlayır.

Bu zaman hesabata yox, dəyişikliklərin özünə baxmaq lazımdır: agent hansı sətirləri sildiyini və hansılarını əlavə etdiyini göstərir. "Nə dəyişdi" sualının dəqiq cavabı elə budur və o, agentin mətnində deyil.

İnandırıcı hesabat hələ sübut deyil

Agent gördüyü işi elə təsvir edə bilir ki, irad tutmağa yer qalmır: "üç metoda xətaların emalını əlavə etdim, yoxladım, hər şey işləyir". Fakt kimi səslənir. Amma cavabın mətni ilə faylların məzmunu iki ayrı şeydir və onlar həmişə üst-üstə düşmür. Həqiqəti bilməyin yeganə yolu dəyişikliklərin siyahısına baxmaqdır.

Claude Code ilə birlikdə bu necə işləyir

Dövrü başa düşmək praktikada nə verir:

  • sorğu nə qədər dəqiq ifadə olunsa, turlar bir o qədər az olur. Agent sizin istədiyinizə uyğun gələnə qədər dövrü təkrarlayır, dumanlı ifadə isə əlavə turlara başa gəlir;
  • fayllarda etdiyiniz öz düzəlişlərinizi agent onları növbəti dəfə açanda görəcək: axı o, layihəni yadda saxlamır, oxuyur. Nəyisə əl ilə dəyişmisinizsə, bu barədə ona deyin;
  • agentin dövrü "hazırdır" sözü ilə bitir. İş isə sizin yoxlamanızla bitir və bunlar fərqli anlardır.

Bütöv mənzərə belə görünür: agentin dövrü içəridə, sizin yoxlamanız kənarda.

Sorğunuz üç addımlı agent dövrünə daxil olur, dövr nəticə alınana qədər təkrarlanır, sonra siz dəyişikliklərə baxıb qərar verirsiniz: qəbul etmək, yoxsa yenidən işlənməyə göndərmək, yenidən işləmə isə hər şeyi yeni sorğuya qaytarırAgent dövrüSorğunuzKonteksttoplamaqƏməliyyatıicra etməkNəticəniyoxlamaqHazırdırNəyin dəyişdiyinəsiz baxırsınızQəbul edildiYenidən işləmə
Agentin dövrü çərçivənin içindədir, insanın qərarı isə ondan kənardadır. Yenidən işləmə hər şeyi yeni sorğuya qaytarır