Úvod: Agent, kterého chce každý, bez zbytečného humbuku
Problém s agenty pro tvorbu kódu je ten, že se většina z nich snaží být vaším šéfem, kopilotem i terapeutem – a pak zapomenou prostě psát kód. Postup je následující: přidejte tucet vektorových úložišť, posypte to trochou orchestrátorského kouzelného prachu, připoutejte k tomu prohlížeč a máte hotovo. Při demonstraci to vypadá dobře. Ale rozpadne se to ve chvíli, kdy ho požádáte, aby opravil nestabilní integrační test v 16:52 v pátek odpoledne.
Vytvořit odlehčeného agenta pro tvorbu kódu s je – překvapivě – vlastně docela jednoduché, pokud přestanete snít o univerzálním softwarovém sluhovi a místo toho vytvoříte nástroj, který čte kód, plánuje, upravuje, spouští a opakuje. Žádné kázání o tom, že „AI nahradí vývojáře“. Žádné složité mechanismy. Jen těsná smyčka, která dobře dělá ty очевидné věci.
Tohle je návod, jak toho dosáhnout, aniž byste museli tahat celé oddělení AI operací. Použijeme jako mozek, systém souborů a shell jako ruce a malou paměť pro krátkodobé soustředění. To je vše. Odlehčený znamená, že tomu porozumíte na jedno posezení, spustíte to lokálně a budete tomu věřit, protože každý krok je kontrolovatelný. Což je, pokud jste v poslední době používali něco z této oblasti, téměř podvratné.
Proč funguje pro minimálního agenta
má temperament, který pro kód skutečně chcete: pečlivý při dodržování instrukcí, překvapivě slušný ve čtení diffů a nijak zvlášť dychtivý halucinovat frameworky, o které jste nežádali. Model je kompetentní v postupném uvažování, aniž by vyžadoval celou novelu v promptu. Tato kombinace – uvažování plus zdrženlivost – je ideální pro smyčku agenta pro tvorbu kódu:
- Pozorování: Čtení aktuálních souborů, chybových protokolů a testů.
- Plánování: Navrhování konkrétních úprav s odůvodněním.
- Akce: Oprava souborů, spouštění příkazů.
- Reflexe: Vyhodnocení výstupu, iterace nebo zastavení.
Tohle můžete připojit k jakémukoli repozitáři a získat hodnotu během odpoledne. Triк je odolat nutkání proměnit to v „AI platformu“. Pokud udržíte agenta odlehčeného, odvede těžkou práci, aniž by vám překážel.
Odlehčená architektura: Pět částí, žádné drama
Tady je celý stack, který potřebujete:
- Základní smyčka: Jeden proces, který volá a interpretuje jeho zprávy o použití nástrojů.
- Nástroje: Malá sada – read_file, write_file, list_dir, run_tests (nebo run_cmd), search_code.
- Sestavovač kontextu: Sestavení krátkého, cíleného promptu s metadaty repozitáře a nedávnými diffy.
- Krátkodobá paměť: Posuvné okno konverzace plus explicitní scratchpad pro plán a omezení.
- Ochranná opatření: Limity tokenů, času a zápisu do souborů; režim suchého spuštění; a rollback snímky.
To je vše. Můžete to spustit bez hlavičky v terminálu nebo to zabalit do minimálního UI, pokud musíte. Důvod, proč to funguje, je nudný: každá akce je pozorovatelná a ověřitelná. Agent navrhne změnu, ukáže diff, spustí testy, přečte výstup a buď pokračuje, nebo se zastaví. Uprostřed není žádné tajemné maso.
Jak vytvořit agenta (aniž byste ztratili nit)
Krok 1: Definujte kontrakt – Prompt a nástroje
Váš agent je tak dobrý, jak dobrý je jeho kontrakt s modelem. Udržujte systémový prompt krátký, striktní a neúprosně praktický.
Systémový prompt, destilovaný:
- Jste agent pro tvorbu kódu. Vaším úkolem je provádět malé, správné změny v repozitáři, abyste splnili úkol uživatele.
- Přemýšlejte nahlas v skrytém scratchpadu; uživateli odhalujte pouze plány a diffy.
- Preferujte minimální diffy, fungující testy a inkrementální pokrok.
- Když si nejste jisti, navrhněte experiment a spusťte ho.
- Nikdy nevymýšlejte soubory nebo příkazy – před úpravou vypište a přečtěte.
Schéma nástrojů (nepřemýšlejte o tom příliš):
- read_file(path, offset?, length?)
- write_file(path, content, create_if_missing=false)
- run_cmd(command, timeout=60, cwd=repo_root)
- search_code(query, path=repo_root, max_results=50)
Volitelné vychytávky: git_diff a git_revert(sha), pokud chcete rollbacks bez nutnosti zásahu. Můžete přeskočit vektorové úložiště; většina užitečných úkolů závisí na několika souborech v pracovní paměti plus rychlém vyhledávání.
Krok 2: Udržujte kontext úsporný
Napěchování kontextu je cargo cult návrhu agenta. Nevhazujte do promptu celý svůj monorepozitář. Místo toho:
- Souhrn repozitáře: Jedno-odstavcový výtah z README; vstupní body; příkaz pro spuštění testů.
- Aktivní soubory: Pouze soubory, kterých se agent plánuje dotknout – čtěte je po částech podle potřeby.
- Úkol: Cíl uživatele, stručně formulovaný: „Opravte neúspěšný test FooTest.test_bar v tests/foo_test.py.“
- Omezení: Limity běhu, whitelist pro zápis do souborů, pravidla stylu a očekávání sémantického verzování, pokud jsou relevantní.
- Nedávná historie: Poslední dva diffy a jejich výsledky testů. Nic jiného.
je naprosto schopný načíst si více kontextu, když to potřebuje, prostřednictvím search_code a read_file. Dejte mu mapu, ne území.
Krok 3: Smyčka (Pozorování → Plánování → Akce → Reflexe)
- Pozorování: Začněte výpisem adresářů, přečtením neúspěšného testu, kódu, který se testuje, a chybového protokolu. Požádejte , aby shrnul příznaky selhání ve dvou nebo třech bodech.
- Plánování: Nechte navrhnout plán s:
- Soubory ke kontrole nebo úpravě
- Testovací příkaz k ověření
- Akce: Použijte navržený diff prostřednictvím write_file. Ukažte diff doslovně. Spusťte testy.
- Reflexe: Vraťte stdout/stderr zpět. Zeptejte se : pokračovat, vrátit se nebo zastavit? Pokud se plán změní, vyžadujte zdůvodnění jednou větou odkazující na skutečný výstup.
- Ukončení: Zastavte, když testy projdou, nebo po N iteracích, podle toho, co nastane dříve.
Tohle je oslavené párové programování, kde ve skutečnosti udržujete párování čestné.
Krok 4: Ochranná opatření, která vám zachrání víkend
- Whitelist pro zápis: Povolte zápis pouze v rámci src/, lib/ nebo explicitně schválených cest.
- Limit velikosti diffu: Omezte úpravy na 200–500 řádků na krok. Pokud je větší, rozdělte na dílčí kroky.
- Allowlist příkazů: Testovací spouštěče, lintery a několik vývojářských skriptů. Zakažte síť. Chcete reprodukovatelnost, ne divoký západ curl.
- Časový limit a opakování: Krátké časové limity, maximálně jedno opakování – nekonečné smyčky opakovaného spouštění jsou místa, kde agenti umírají.
- Režim suchého spuštění: Vytiskněte navrhované diffy, ale nezapisujte. Skvělé pro kontrolu kódu.
se bude držet pravidel, pokud je uděláte explicitní. Pokud to neuděláte, nebuďte překvapeni, když se pokusí „pomoci“ reorganizací celého vašeho repozitáře tak, aby odpovídal nějakému blogovému příspěvku z roku 2017.
Krok 5: Paměť, která je skutečně užitečná
Krátkodobá paměť řeší 80 % problému. Udržujte:
- Scratchpad pro aktuální hypotézu a plán.
- Seznam souborů, kterých se tato relace dotkla.
- Poslední dva výstupy příkazů.
To stačí k tomu, aby uvažoval koherentně. Dlouhodobá paměť – protokoly úkolů, vkládání – může být užitečná pro opakující se kódové základny, ale berte to jako volitelný cukr. Pokud váš agent nemůže opravit test bez 500MB vektorového indexu, není to agent – je to závislost.
Minimální náčrt implementace
V pseudokódu můžete tohoto agenta implementovat v několika stovkách řádků:
- inicializace: načtení metadat repozitáře, omezení a modelového klienta
- pozorování: čtení neúspěšných testů, souborů, protokolů
- plán = model.navrhni_plán(kontext)
- dokud není hotovo a kroky < MAX:
- diff = model.navrhni_opravu(plán)
- výstup = spusť_příkaz(plán.test_příkaz)
- reflexe = model.vyhodnoť(výstup)
- pokud reflexe == projít: hotovo = pravda
- jinak pokud reflexe == vrátit: git_revert(poslední_commit)
- jinak: plán = model.reviduj_plán(výstup)
Všimnete si chybějících částí: žádní agenti, kteří by řídili agenty, žádní „delegáti“, žádný samostatný „model plánovače“ a „model exekutora“. zvládne obě práce dobře, pokud ho nesabotujete složitým mechanismem.
Promptování, které se nesnaží příliš
Špatné prompty se snaží být chytré. Dobré prompty jsou nudné a specifické. Zde je rozumná kostra pro váš základní instrukční blok:
- Cíl: Uveďte přesný úkol kódování a kritéria úspěchu.
- Kontext: Struktura projektu, vstupní body a testovací příkaz.
- Omezení: Whitelist pro zápis, limit velikosti diffu, žádná síť.
- Preferovaný styl: Verze jazyka, formátovač, pravidla linteru.
- Proces: Pozorování → Plánování → Akce → Reflexe; zobrazujte diffy; spouštějte testy; iterujte až N kroků; zastavte, když testy projdou.
s touto strukturou nebude potřebovat 100řádkový scénář hraní rolí. Prostě to funguje.
Praktický příklad: Oprava neúspěšného testu
Řekněme, že test selhává v tests/time_test.py, protože parse_time("09:00") vrací 5400 místo 32400. Smyčka agenta by měla vypadat takto:
- Pozorování: Přečtěte time.py a time_test.py; spusťte pytest -k parse_time.
- Plánování: Hypotéza – matematická chyba v sekundách vs minutách; navrhněte úpravu parse_time; přidejte okrajový případ jednotky.
- Akce: Opravte parse_time, přidejte test pro hodiny s počáteční nulou; spusťte testy.
- Reflexe: Pokud testy stále selhávají, přečtěte si chybu, upravte matematiku nebo regulární výraz, znovu spusťte.
Minimální úspěšná oprava může být změna dvou řádků. O to jde. Malé úpravy, rychlé cykly, skutečný pokrok.
Kde odlehčený agent poráží kuchyňský dřez
- Latence: Jeden model, jedna smyčka, žádná orchestrátorská režie.
- Transparentnost: Každý krok je auditovatelný. Můžete to rozdílovat, můžete to vrátit, můžete to znovu spustit.
- Kontrola: Ochranné prvky udržují škody lokální. Agent nemůže zabloudit do vaší infrastruktury.
- Cena: Méně volání, méně kontextu, предсказуемые токени.
- UX: Rozumíte tomu. Vaši spoluhráči tomu rozumí. Vaše budoucí já vás nebude nenávidět.
A kompromisy:
- Šíře: Odlehčený agent pro tvorbu kódu nebude refaktorovat váš pěti-jazykový monorepozitář v jednom průchodu. Ani by neměl.
- Iniciativa: Nevymyslí více-týdenní plány. Dáte mu úkoly.
- Stavovost: Bez velké paměťové vrstvy zapomíná vzdálenou historii podle návrhu. To je funkce, dokud to není chyba.
’s Sweet Spot pro agenti kódování
vyniká na:
- Čtení a odůvodňování o rozdílech a protokolech.
- Produkování koherentních, minimálních změn kódu.
- Dodržování omezení a explicitní vyjádření nejistoty.
Je méně skvělý na:
- Hádání API chování, které nemůže číst.
- Těžká choreografie nástrojů (zde není potřeba).
- Dlouhé refaktory s více soubory bez lidského vedení kroků.
Poslední bod je důležitý. Nejlepší způsob, jak dosáhnout silných výsledků, není zvětšit agenta – je to zmenšit úkol. Použijte svůj mozek k vymezení rozsahu a k provedení v rámci tohoto rozsahu.
Slovo o integraci IDE
Odolejte nutkání zapékat to přímo do okna IDE s padesáti přepínači. Smyčka založená na terminálu s prostými textovými rozdíly je snazší důvěřovat a ladit. Pokud chcete editor cukru, udržujte ho hloupý:
- Příkazy ke spuštění/zastavení smyčky.
- Zobrazení rozdílů v rozděleném zobrazení.
- Schvalovací výzva pro zápisy (volitelné, ale moudré).
Můžete integrovat později. Nejprve to rozchodte.
Sider.AI, používaný střídmě, skutečně pomáhá Pokud chcete pragmatické prostředí pro spuštění tohoto druhu smyčky bez opětovného vynalézání lešení, Sider.AI skutečně funguje – alespoň když ho používáte pro to, v čem je dobrý. Udržuje konverzaci a rozdíly uklizené, umožňuje spouštět příkazy a nenutí vás k nějakému грандиозному „autonomnímu agentnímu frameworku“. Triком je držet se vlastních pravidel: krátké výzvy, těsné smyčky, viditelné rozdíly. Sider se vám dostane z cesty, což je vzácnější, než by mělo být. Běžné nástrahy (a jak se vyhnout tomu, abyste vypadali hloupě)
- Příliš nacpaný kontext: Pokud váš prompt vypadá jako výkupné, děláte to špatně. Načtěte soubory na vyžádání.
- Předčasný refactoring: Agent navrhuje reorganizaci modulů? Nechte ho nejprve projít testy. Refaktorujte později.
- Halucinované soubory: Vyžadujte list_dir a read_file před jakýmkoli write_file na novou cestu.
- Nekonečné smyčky opakovaného spouštění: Omezte kroky. Vyžadujte zdůvodnění pro každou novou hypotézu.
- Jeden obří rozdíl: Rozdělte změny. Menší rozdíly selhávají rychleji a je snazší o nich uvažovat.
Zabezpečení a bezpečnost bez паранойи
- Místní provedení: Spusťte v sandboxovém adresáři. Ve výchozím nastavení žádná síť.
- Izolace závislostí: Použijte místní venv nebo kontejner. Připněte verze.
- Tajemství: Agent je nepotřebuje. Pokud příkaz vyžaduje token, zastavte se a zeptejte se.
- Auditování: Uchovejte každý plán, rozdíl a příkaz v protokolu.
Jak poznat, že to funguje
- Zmenšuje se průběžná doba: Opravy chyb, které trvaly hodinu, nyní trvají deset minut.
- Méně hrubých chyb: Rozdíly se zmenšují, testy se stávají zelenějšími.
- Důvěřujete tomu: Přestanete se vznášet nad každou akcí, protože vás to nespálilo.
- Spoluhráči to používají: Definice úspěchu je, že si to ostatní osvojí bez schůzky.
Opatrné škálování
Pokud opravdu musíte škálovat, dělejte to s disciplínou:
- Paralelní dílčí úkoly, ne paralelní mozky: Rozdělte práci, spusťte více odlehčených smyček v samostatných adresářích a sloučte, když je zelená.
- Epizodická paměť, ne výpis mozků: Ukládejte úspěšné opravy a mapování příznaků na opravy. Načtěte chirurgicky.
- Pravidelné „větší“ průchody: Vyhraďte si relaci s lidským vedením pro refaktory; agent pomáhá, nevede.
Minimální referenční implementace (Náčrt)
Pseudokód v Pythonu, abyste se mohli pohybovat:
- def init(self, repo_root, model):
- self.history = [] # poslední dva rozdíly a výstupy testů
- "repo": summarize_repo(self.root),
- "constraints": {"write_whitelist": ["src/", "tests/"], "max_diff_lines": 300, "no_network": True},
- "history": self.history[-2:],
- plan = self.model("propose_plan", self.context(task))
- diff = self.model("propose_patch", {"plan": plan})
- out = run_cmd(plan.test_cmd)
- eval = self.model("evaluate", {"output": out, "plan": plan})
- self.history.append({"diff": diff, "out": tail(out)})
Konec v lidské velikosti
Průmysl neustále slibuje autonomní vývojářské agenty. Co vlastně potřebujeme, je poctivý asistent, který čte, plánuje, upravuje, spouští a zastavuje. je v tom dobrý, za předpokladu, že ho nepohřbíte pod frameworky, které existují hlavně proto, aby se ospravedlnily. Odlehčenost není kompromis – je to pointa. Sestavte smyčku, přidejte ochranné prvky a nechte nástroj dělat to jediné, co nástroje vždy dělaly, když je udržíte jednoduché: zmenšit práci.
Závěr: Nudná zkratka, která vyhrává
Zde je váš kontrolní seznam pro odlehčeného kódovacího agenta s :
- Jedna smyčka, jeden model, malé nástroje.
- Těsný kontext: úkol, několik souborů, poslední výstupy.
- Minimální rozdíly, časté testy, tvrdé limity.
- Místní, sandboxové spouštění; žádná síť.
- Volitelný editor cukru; nikdy není vyžadován.
Pokud přimhouříte oči, vypadá to podezřele jako dobré softwarové inženýrství, jen rychlejší. A to je pointa. Nejmoudřejší věc, kterou zde můžete udělat, není honit se za „autonomií“ – je to kodifikovat disciplínu. Čím méně od agenta žádáte, tím více získáte.
FAQ
Q1:Jak začnu budovat odlehčeného agenta pro tvorbu kódu s ?
Definujte malou sadu nástrojů (čtení, zápis, vyhledávání, spuštění), napište striktní systémový prompt a implementujte smyčku Pozorování → Plánování → Akce → Reflexe. Udržujte malý kontext a podávejte skutečné protokoly a rozdíly – funguje nejlépe, když je úkol úzký a zpětná vazba je konkrétní.
Q2:Potřebuji pro kódovacího agenta vektorovou databázi nebo paměťovou vrstvu?
Ne. Pro většinu úkolů stačí krátkodobá paměť plus search_code. Dlouhodobou paměť přidejte pouze v případě, že opakovaně navštěvujete stejný repozitář a můžete dokázat, že to šetří tokeny, aniž by agenta otupilo.
Q3:Jaké ochranné prvky jsou nezbytné pro kódovacího agenta ?
Přidejte na whitelist zapisovatelné cesty, omezte velikosti rozdílů, omezte příkazy a protokolujte každou akci. Tato jednoduchá omezení udržují agenta предсказуемым a dělají rollbacks nudnými – v dobrém slova smyslu.
Q4:Může odlehčený agent zvládnout refaktory s více soubory?
Ano, pokud rozdělíte práci na malé kroky a udržíte smyčku těsnou. může spravovat refaktory, ale vy vedete rozsah; jinak získáte jeden obří, křehký rozdíl, který nebudete chtít zkontrolovat.
Q5:Kam zapadá Sider.AI s kódovacím agentem ?
Sider.AI je užitečný jako uklizený pracovní prostor: konverzace, rozdíly a příkazy na jednom místě, aniž by nutil k těžkopádnému agentnímu frameworku. Použijte ho ke spuštění smyčky, ne k jejímu opětovnému vynalezení. 
