Napísali ste jednu vetu, stlačili Enter - a v termináli sa rozbehol prúd riadkov. Otvoril súbor. Spustil príkaz. Znova otvoril ten istý súbor. Zvonku to vyzerá ako zmätok: veď ste chceli len jednu jednoduchú vec, no deje sa niečo zdĺhavé a nejasné.
Žiadny zmätok v tom nie je. Agent opakovane prechádza cyklom z troch častí a takmer všetko, čo vidíte na obrazovke, je ten istý cyklus v rôznych kolách.
Prečo agent robí viac než chat
Chat vypíše odpoveď a všetko ďalej je na vás: skopírovať, vložiť, uložiť, spustiť. Agent pracuje vo vašom projekte sám - otvára súbory, upravuje ich, spúšťa príkazy, pozerá sa na výsledok. A zmeny vám na disku naozaj zostanú.
A tu je dôsledok, kvôli ktorému vznikol tento článok. Keďže agent veci robí, a nie radí, jeden ťah nestačí. Medzi vašou vetou a hotovým výsledkom je niekoľko krokov a všetky ich vidno na obrazovke.
Z čoho sa skladá jeden krok
Po vašej požiadavke agent vstúpi do tohto cyklu a prejde ním toľkokrát, koľkokrát treba. Každý prechod má tri časti.
Zozbierať kontext. Agent si doplní, čo nevie: otvorí potrebné súbory, pozrie sa na štruktúru projektu, prečíta výstup predchádzajúceho príkazu. Najčastejšie prekvapí toto: váš projekt nevie naspamäť, číta ho. Zakaždým, keď potrebuje nejaký detail, ide sa pozrieť.
Vykonať akciu. Jednu konkrétnu akciu: upraviť súbor alebo spustiť príkaz. Nie celý zámer naraz, ale ďalší krok.
Skontrolovať výsledok. Pozrieť sa, čo z toho vyšlo, a porovnať to s tým, o čo ste žiadali.
Potom prichádza rázcestie. Cieľ je splnený - agent sa zastaví a čaká na ďalšiu požiadavku. Nie je splnený - vráti sa k zberu kontextu a prejde ešte jedno kolo.
Cyklus sa pritom prispôsobuje požiadavke, nebeží podľa pevného rozvrhu. Jednoduchá otázka ku kódu sa môže skončiť už pri zbere kontextu: agent si prečítal, odpovedal, nič nemenil. Oprava chyby naopak prejde všetkými tromi časťami niekoľkokrát. A hranice medzi časťami nie sú vždy ostré - nástroje agent používa počas celého cyklu.
A práve odtiaľto pochádza všetko, čo vyzeralo čudne. Agent otvoril ten istý súbor dvakrát - po úprave sa naň potreboval pozrieť znova. Medzi požiadavkou a odpoveďou uplynulo niekoľko minút - kolá boli štyri, nie jedno. Návrat na začiatok nie je zlyhanie, je to bežný priebeh práce.
Uvažovanie a volanie nástroja
Nie všetko, čo agent robí, mení súbory v projekte. Hranica vedie presne stredom jeho práce a oplatí sa ju vidieť.
Uvažovanie - agent zvažuje, čo robiť ďalej, ku ktorému súboru ísť, v čom môže byť príčina chyby. Na disku pritom nula zmien. Nech uvažuje akokoľvek presvedčivo, zatiaľ je to len zámer.
Volanie nástroja - tu sa už deje niečo skutočné. Prečítať alebo zapísať súbor, vyhľadať niečo v projekte, spustiť príkaz, nazrieť do dokumentácie na internete. Každá taká akcia sa v termináli zobrazí ako samostatný riadok a práve z týchto akcií sa skladá to, čo sa s projektom stalo.
Výsledok volania sa vráti agentovi a v ďalšom kole je súčasťou toho, čo vie. Prečítal súbor - teraz pozná jeho obsah. Spustil test - teraz vie, či prešiel, alebo nie.
Príkaz spadol, súbor sa nenašiel, test neprešiel - agent to vidí a zohľadní to v ďalšom kroku. Chybová správa vo výstupe neznamená, že sa všetko pokazilo a treba to vzdať. Často je to presne tá informácia, ktorá mu chýbala, a ďalšie kolo bude presnejšie než predchádzajúce.
Praktický záver je jednoduchý. Riadky o volaniach nástrojov nie sú technický šum, ktorý sa len tak prelistuje bez čítania. Presne tam vidno, čo sa s vašimi súbormi deje v tejto chvíli.
Prečo sa agent pýta
Uprostred práce sa agent môže zastaviť a niečo sa opýtať. Je to bežná súčasť cyklu, nie znak, že si nevedel rady.
Otázky bývajú dvoch rôznych druhov a oplatí sa ich rozlišovať:
- chýbajú mu informácie o úlohe - čo presne zmeniť, ktorý z dvoch podobných súborov ste mali na mysli, čo považovať za hotové. Agent narazil na nejednoznačnosť a nechce hádať;
- potrebuje povolenie na akciu - agent sa chystá urobiť niečo podstatné a zastaví sa, aby sa spýtal, či môže. Do akej miery je samostatný, závisí od nastavení.
Prvý druh otázky je dobré znamenie. Lepšie si to ujasniť teraz, než všetko prerábať po troch kolách cyklu nesprávnym smerom.
Na otázky nemusíte čakať, môžete si ich vyžiadať sami. Hneď na začiatku, ešte pred prvými úpravami, požiadajte agenta, aby úlohu zopakoval vlastnými slovami a spýtal sa na všetko, čo je nejasné:
Napíš, ako si pochopil úlohu a ako ju plánuješ vyriešiť.
Pýtaj sa, ak ti to pomôže lepšie pochopiť úlohu a cieľ.Nejednoznačnosti tak vyplávajú na povrch ešte pred prvou úpravou, a nie vtedy, keď je polovica práce hotová. Zasiahnuť môžete aj priebežne, kedykoľvek: doplniť kontext, opraviť smer alebo agenta zastaviť a úlohu preformulovať.
Kto rozhoduje, že je hotovo
Slovo "hotovo" od agenta znamená presne jedno: skončil sa jeho cyklus. Vykonal akciu, skontroloval výsledok podľa vlastných meradiel a usúdil, že cieľ je splnený. Práca však ešte hotová nie je.
Zmena sa nepovažuje za prijatú vtedy, keď ju agent urobil, ale až keď sa človek pozrel, čo sa naozaj zmenilo, a prevzal zodpovednosť za výsledok. Potom sú dve možnosti: prijaté - práca je hotová; prepracovanie - sformulujete, čo nie je v poriadku, a cyklus začína odznova s vašou novou požiadavkou.
Nepozerajte sa pritom na hlásenie, ale na samotné zmeny: agent ukazuje, ktoré riadky odstránil a ktoré pridal. To je presná odpoveď na otázku "čo sa zmenilo" a nenájdete ju v texte agenta.
Agent dokáže opísať, čo urobil, tak, že niet čo vytknúť: "pridal som spracovanie chýb do troch metód, skontroloval som, všetko funguje". Znie to ako fakt. Lenže text odpovede a obsah súborov sú dve rôzne veci a nie vždy sa zhodujú. Jediný spôsob, ako zistiť pravdu, je pozrieť sa na zoznam zmien.
Ako to funguje pri práci s Claude Code
Čo vám pochopenie cyklu dá v praxi:
- čím presnejšie je požiadavka sformulovaná, tým menej kôl. Agent opakuje cyklus, kým výsledok nezodpovedá tomu, o čo ste žiadali, a vágna formulácia stojí kolá navyše;
- vaše vlastné úpravy v súboroch agent zachytí, keď ich nabudúce otvorí: projekt si predsa nepamätá, ale číta ho. Ak ste niečo upravovali ručne, povedzte mu to;
- cyklus agenta končí slovom "hotovo". Práca končí vašou kontrolou a to sú dva rôzne momenty.
Celkový obraz vyzerá takto: cyklus agenta vnútri, vaša kontrola zvonku.
GO TO FULL VERSION