Agentne inseneeria: täielik juhend AI-põhise tarkvaraarenduse kohta pärast vibe codingut
Märts 2026 — 2025. aastal tutvustas Andrej Karpathy meile vibe codingut — kirjeldad, mida soovid, ja lased AI-l lahenduse välja mõelda. See oli lõbus, kiire ja sobis hästi prototüüpide jaoks.
Seejärel üritati vibe-coded tarkvara tootmisse paisata. Tulemused ei olnud suurepärased.
- aasta alguses võttis Karpathy kasutusele uue termini selle kohta, mis järgneb: agentne inseneeria (agentic engineering) — distsipliin süsteemide projekteerimiseks, kus AI-agendid planeerivad, kirjutavad, testivad ja tarnivad koodi struktureeritud inimjärelevalve all. See pole suvaline suunamine. See pole "looda ja kontrolli". See on professionaalne insenerimetoodika, mis on loodud AI-põhiseks arenduseks.
Seda muutust toetavad numbrid on tõesed: TELUS säästis üle 500 000 tunni 13 000 AI-lahendusega. Zapier saavutas 89% AI kasutuselevõtu kogu organisatsioonis. Stripe'i "Minionid" toodavad üle 1000 liidetud PR-i nädalas. See ei ole teoreetiline — nii ehitatakse tarkvara praegu.
Vibe codingust agentse inseneeriani: mis muutus
Vibe codingu probleem
Vibe coding töötab suurepäraselt järgneva puhul:
- Kiired prototüübid ja demod
- Isiklikud skriptid ja ühekordsed tööriistad
- Õppimine ja avastamine
- Häkatoni projektid
Vibe coding ebaõnnestub katastroofiliselt järgneva puhul:
- Tootmissüsteemid, millel on tööaja nõuded
- Meeskondade poolt hooldatavad koodibaasid
- Rakendused, millel on turbe- ja vastavusnõuded
- Tarkvara, mis peab arenema kuude ja aastate jooksul
Ebaõnnestumise režiimil on nimi: AI slop — kood, mis näeb pealtnäha mõistlik välja, kuid puudub korralik veakäsitlus, mis tekitab turvahaavatavusi, lõhub olemasoleva funktsionaalsuse või loob hooldamatu arhitektuuri. Ilma struktureeritud järelevalveta genereerib AI koodi, mis kasvatab tehnilist võlga kiiremini kui loob väärtust.
Evolutsioon
| Etapp | Ajastu | Lähenemine | Inimese roll |
|---|---|---|---|
| Manuaalne koodimine | Enne 2023 | Inimesed kirjutavad kogu koodi | Autor |
| AI-toetatud koodimine | 2023–2024 | AI soovitab täiendusi | Autor koos automaatse täitmisega |
| Vibe Coding | 2025 | AI genereerib kirjelduste põhjal | Suuniste kirjutaja |
| Agentne inseneeria | 2026 | AI-agendid planeerivad, kirjutavad, testivad, tarnivad autonoomselt | Arhitekt ja ülevaataja |
Peamine mõte: agentne inseneeria ei kaota vajadust insenerioskuste järele — see suunab need ümber. Koodi kirjutamise asemel projekteerite süsteeme, piiranguid ja tagasisideringe, mis võimaldavad AI-l koodi usaldusväärselt kirjutada.
Põhiraamistik: Planeeri → Teosta → Verifitseeri (PTV)
Agentne inseneeria asendab ebaformaalse "suuna ja looda" töövoo struktureeritud ringiga:
Planeeri
Enne kui ükski agent kirjutab rea koodi:
- Defineeri eesmärk — Milline näeb välja "valmis"? Millised on vastuvõtukriteeriumid?
- Dekomponeeri ülesanneteks — Jaga keerulised eesmärgid agendi-suurusteks tööüksusteks.
- Sea piirangud — Arhitektuurilised piirid, tehnoloogiapinu reeglid, stiilijuhised.
- Määra kvaliteediväravad — Millised testid peavad läbi minema? Millised ülevaatused on vajalikud?
- Määra agentide rollid — Milline agent tegeleb teostusega? Testimisega? Turbeülevaatusega?
Planeerimisfaas on see, kus inseneriteadmised on kõige olulisemad. Segane plaan toodab segast koodi. Täpne plaan koos selgete piirangutega toodab fokuseeritud ja kontrollitavat väljundit.
Teosta
Agendid töötavad autonoomselt planeerimisfaasis määratletud piirangute piires:
- Teostusagendid kirjutavad koodi järgides arhitektuurireegleid.
- Testimisagendid genereerivad ja käivitavad testikomplekte.
- Ülevaatusagendid kontrollivad stiili, turvalisust ja arhitektuurilist vastavust.
- Dokumentatsiooniagendid uuendavad dokumente vastavalt koodimuudatustele.
Agendid itereerivad seni, kuni nende töö läbib kvaliteediväravad. Inimese sekkumist on vaja ainult siis, kui agendid jäävad hätta või kui valikute tegemine nõuab otsustusvõimet.
Verifitseeri
Inimesed vaatavad agendi väljundi üle algsete eesmärkide valguses:
- Kas see vastab vastuvõtukriteeriumidele?
- Kas see tekitas turvahaavatavusi?
- Kas arhitektuur on kooskõlas olemasoleva koodibaasiga?
- Kas testid on tähendusrikkad või kontrollivad vaid ideaalstsenaariume?
- Kas iniminsener kiidaks selle PR-i heaks?
Verifitseerimine ei ole lihtsalt "templiga kinnitamine". See on faas, kus inseneri otsustusvõime on kriitilise tähtsusega — te hindate, kas agendi lahendus pole mitte ainult funktsionaalne, vaid ka hea.
Mitme agendi orkestreerimine: põhipraktika
Agentne inseneeria ei tähenda ühte AI-d, mis teeb kõike. See tähendab spetsialiseeritud agente, kellel on määratletud rollid ja kes töötavad koos inimese orkestreerimisel.
Agendi meeskonnamudel
| Agendi roll | Vastutus | Tööriista näide |
|---|---|---|
| Funktsionaalsuse autor | Kirjutab teostuskoodi | Codex, Claude Code, Cursor |
| Testide generaator | Loob üksus-, integratsiooni- ja E2E-teste | Codex, Claude Code |
| Koodi ülevaataja | Kontrollib stiili, mustreid, turvalisust | Kohandatud LLM-põhised linterid |
| Arhitektuuri valvur | Valideerib struktuurset vastavust | ArchUnit + LLM audiitor |
| Dokumentatsiooni kirjutaja | Uuendab dokumente vastavalt muudatustele | Codex, Claude Code |
| Turvaskanner | Tuvastab haavatavusi | AI-toega SAST tööriistad |
| Väljalaske haldur | Haldab CI/CD-d, juurutuskontrolle | Kohandatud agendid |
Kuidas nad koordineerivad
Praktikas järgivad mitme agendi töövood ahelat:
Ülesande kirjeldus (Inimene)
→ Funktsionaalsuse autor (kirjutab koodi)
→ Testide generaator (kirjutab testid)
→ Koodi ülevaataja (vaatab muudatused üle)
→ Arhitektuuri valvur (kontrollib vastavust)
→ Turvaskanner (haavatavuste kontroll)
→ Inimülevaatus (lõplik kinnitus)
→ CI/CD ahel (automaatne juurutamine)
Iga agent toodab artefakte, mis toidavad järgmist. Inimene jääb otsustajaks peamistes kontrollpunktides, kuid teostus kontrollpunktide vahel on täielikult autonoomne.
Reaalsed tulemused: mida ettevõtted saavutavad
TELUS: 13 000 AI-lahendust, 500 000 säästetud tundi
TELUS Digital rakendas agentset inseneeriat kogu organisatsioonis:
- Loodi üle 13 000 kohandatud AI-lahenduse.
- Insenerikoodi tarnimine on 30% kiirem.
- Kokku säästeti üle 500 000 tunni.
- Skaleerimine jätkus ka mitte-inseneride meeskondadesse.
Zapier: 89% organisatsiooniülene AI kasutuselevõtt
Zapier'i lähenemine keskendus agentsete tööriistade kättesaadavaks tegemisele kõigile:
- 89% AI kasutusmäär kogu organisatsioonis.
- Üle 800 agendi on sisemiselt rakendatud.
- Mitte-insenerid kasutavad agente töövoogude, andmeanalüüsi ja sisu jaoks.
Stripe: 1000+ liidetud PR-i nädalas agentidelt
Stripe'i sisemine Minions süsteem esindab küpset agentset inseneeriat:
- Arendaja postitab ülesande Slacki.
- Minion kirjutab koodi.
- Minion läbib CI.
- Minion avab PR-i.
- Inimene vaatab üle ja liidab.
Null interaktsiooni ülesande andmise ja PR-i ülevaatuse vahel. Raamistik tegeleb kõige muuga.
OpenAI: 1 miljon rida ilma inimese koodita
OpenAI oma Codexist meeskond ehitas tootmisrakenduse, millel on:
- 1 miljon+ rida koodi.
- Null manuaalselt kirjutatud rida.
- Umbes 1/10 ajast võrreldes traditsioonilise arendusega.
- Toode tarnitakse, juurutatakse, see läheb katki ja parandatakse — kõik agentide poolt.
Rakuten: 12,5 miljoni realine koodibaas 7 tunniga
Rakuten kasutas Claude Code'i, et viia lõpule keeruline vLLM-i juurutamine 12,5 miljoni realises koodibaasis vaid 7 tunniga ja 99,9% numbrilise täpsusega.
Agentse inseneeria oskuste pinu
Mis muutub
| Traditsiooniline oskus | Agentse inseneeria ekvivalent |
|---|---|
| Koodi kirjutamine | Kavatsuse täpne määratlemine |
| Koodi silumine | Agendi käitumise silumine |
| Koodi ülevaatus | Agendi väljundi valideerimine |
| Testimine | Testimisstrateegia projekteerimine |
| Arhitektuur | Piirangute süsteemi projekteerimine |
| Dokumenteerimine | Masinloetav teadmusinseneeria |
| Projektijuhtimine | Mitme agendi orkestreerimine |
Mis jääb samaks
- Valdkondlik ekspertiis — Te peate ikka teadma, milline näeb välja hea tarkvara.
- Süsteemne mõtlemine — Arusaamine, kuidas komponendid koos toimivad, on olulisem kui kunagi varem.
- Teadlikkus turvalisusest — Agendid ei tea iseenesest teie ohumudelit.
- Koodi lugemine — Loete rohkem koodi kui kunagi varem, lihtsalt ei kirjuta seda ise.
Mis on uut
- Suuniste (prompt) disain agentidele — Erineb vestlusroboti suunistest; agendi suunised on operatiivsed spetsifikatsioonid.
- Rakmete disain (harness design) — Piirangute, linterite ja tagasisideringide ehitamine, mis hoiavad agendid produktiivsena.
- Kontekstiinseneeria — Tagamine, et agentidel on õigel ajal õige teave.
- Agentide hindamine — Mõõtmine, kas teie agendid arenevad või taandarenevad.
Kuidas alustada agentse inseneeriaga
1. etapp: Ühe agendi töövoog
Kui tegelete praegu vibe codinguga, lisage struktuuri:
- Kirjutage spetsifikatsioon enne suunamist — Defineerige, milline on "valmis" seisund.
- Kasutage CLAUDE.md või .cursorrules faile — Kodeerige oma konventsioonid.
- Käivitage testid enne aktsepteerimist — Ärge kunagi liitke AI koodi, mida pole testitud.
- Vaadake diff-e hoolikalt läbi — Otsige AI slop mustreid (asjatu abstraktsioon, liigne veakäsitlus, hallutsineeritud API-d).
2. etapp: Mitme agendi ahel
Kui olete struktureeritud ühe agendi töövoogudega harjunud:
- Lisage testide genereerimise agent — Eraldage teostus testimisest.
- Lisage CI valideerimine — Automaatsed kvaliteediväravad agendi ja inimülevaatuse vahele.
- Lisage dokumentatsiooniagendid — Hoidke dokumendid koodimuudatustega kooskõlas.
- Alustage meetrikate jälgimist — Agentide edukuse määr, ülevaatuste tagasilükkamise määr, vigade tekkimise määr.
3. etapp: Organisatsiooniline kasutuselevõtt
Meeskondadele, kes skaleerivad agentset inseneeriat:
- Looge sisemised juhendid — Dokumenteerige, kuidas agente erinevate ülesannete puhul kasutada.
- Defineerige halduspoliitikad — Mis nõuab inimülevaatust? Mida saab automaatselt liita?
- Ehitage ühised rakmed — Standardiseeritud konfiguratsioonid, mis kodeerivad meeskonnaülesed konventsioonid.
- Koolitage agentide väljundi ülevaatamist — Erineb traditsioonilisest koodiülevaatusest; keskenduge struktuursetele ja turvamustritele.
- Mõõtke ärimõju — Säästetud tunnid, kiiruse kasv, kvaliteedinäitajad.
Agentne inseneeria vs. seotud mõisted
| Mõiste | Fookus | Ulatus |
|---|---|---|
| Vibe Coding | Vaba AI-toetatud arendus | Üksik arendaja, prototüübid |
| Kontekstiinseneeria | Mudeli sisendi/konteksti optimeerimine | Üksik interaktsioon |
| Prompt Engineering | Tõhusate suuniste koostamine | Üksik suunis |
| Rakmete inseneeria | Infrastruktuur agentide ümber | Agendisüsteemi disain |
| Agentne inseneeria | Täielik AI-põhine arendusmetoodika | Organisatsiooniülene |
Seosed:
- Prompt engineering → kuidas sa mudeliga räägid
- Kontekstiinseneeria → mida mudel teab
- Rakmete inseneeria → mis mudelit piirab
- Agentne inseneeria → kuidas sa mudeliga tarkvara ehitad
Agentne inseneeria hõlmab kõiki kolme, lisades meeskonna töövood, halduse, organisatsioonilise muutuse ja äriprotsesside integreerimise.
Turvalisuse dimensioon
Anthropicu 2026. aasta agentse koodimise raport rõhutab, et agentne inseneeria peab sisaldama turvalisust esimesest päevast alates:
- Agendid võivad tekitada haavatavusi suures mahus — Agent, kes kirjutab 1000 PR-i nädalas 1%-lise veamääraga, loob igal nädalal 10 uut haavatavust.
- Rünnakupind laieneb — Agentide ligipääs API-dele, andmebaasidele ja välisteenustele loob uusi vektoreid.
- Vajalik on automatiseeritud kaitse — Manuaalne turbeülevaatus ei suuda sammu pidada agentide loodud koodiga.
- Kvaliteediväravad peavad sisaldama turvalisust — Iga PTV tsükkel peaks sisaldama automaatset turvaskaneerimist.
Sama skaleeritavus, mis teeb agentse inseneeria võimsaks arenduses, kehtib ka ründajate kohta. Turvalisuse ehitamine otse rakmetesse — mitte selle lisamine hiljem — on vältimatu.
Meie vaatenurk: AI-toega toodete ehitamine agentse inseneeriaga
NxCode'is oleme viimaste kuude jooksul liikunud AI-toetatud arenduselt agentsele inseneeriale. Siin on see, mida oleme õppinud:
Mis töötab
- Struktureeritud spetsifikatsioonid enne agendi käivitamist — 10 minutit selge spetsifikatsiooni kirjutamiseks säästab tunde ümbertegemist.
- Mitme pakkuja agendi-ahelad — Claude'i kasutamine keeruliste arhitektuuriotsuste jaoks ja Codexi kasutamine suuremahuliste teostusülesannete jaoks.
- Agressiivne CI valideerimine — Meie CI püüab kinni umbes 15% agentide loodud koodist, mis oleks muidu vigu tekitanud.
- Dokumentatsiooni-põhine töövoog — Dokumentide uuendamine enne koodi kirjutamist (agentide abil) hoiab teadmusbaasi värskena tulevaste agentseansside jaoks.
Mis ei tööta (veel)
- Täielikult autonoomsed mitmepäevased projektid — Keerulise töö puhul vajavad agendid endiselt inimkontrolli iga paari tunni tagant.
- Süsteemiülene refaktoreerimine — Agendid saavad hästi hakkama ühe teenuse refaktoreerimisega, kuid hääbuvad koordineeritud muudatuste puhul üle mitme mikroteenuse.
- Uudsed arhitektuuriotsused — Kui koodibaasis pole eeskuju, kalduvad agendid üldiste mustrite poole, mis ei pruugi sobida konkreetse kontekstiga.
Kokkuvõte
Agentne inseneeria ei tähenda arendajate asendamist. See tähendab arendaja võimekuse mitmekordistamist. Meeskonnad, kes selle distsipliini omandavad, tarnivad 5–10 korda rohkem kui need, kes kirjutavad ikka iga rida käsitsi — mitte seetõttu, et AI on targem, vaid seetõttu, et inseneriprotsess on parem.
Peamised järeldused
- Agentne inseneeria on professionaalne evolutsioon pärast vibe codingut — struktureeritud järelevalve asendab vaba suunamist.
- PTV ring (Planeeri → Teosta → Verifitseeri) on põhiline töövoog, mis asendab "suuna ja looda" meetodit.
- Mitme agendi orkestreerimine kasutab spetsialiseeritud agente (autor, testija, ülevaataja, turvaskanner), kes töötavad koordineeritult.
- Reaalsed tulemused on märkimisväärsed: TELUS (500 000 tundi säästetud), Zapier (89% kasutusmäär), Stripe (1000+ PR-i nädalas agentidelt).
- Inseneri roll muutub koodi kirjutamiselt süsteemide projekteerimisele, kavatsuste määratlemisele ja väljundi valideerimisele.
- Turvalisus peab olema sisse ehitatud esimesest päevast — agent-skaalas arendus nõuab agent-skaalas turvalisust.
- Alustage struktuuriga: Kirjutage spetsifikatsioonid, kodeerige konventsioonid, käivitage testid, vaadake hoolikalt üle — ja seejärel skaleerige.
Seotud ressursid
- Rakmete inseneeria täielik juhend — Infrastruktuurikiht, mis toidab agentset inseneeriat.
- Agentne veeb selgitatud: AGENTS.md, MCP vs A2A — Protokollistandardid mitme agendi süsteemidele.
- Cursor Cloud Agents: autonoomne koodimine virtuaalmasinates — Agentne inseneeria praktikas koos pilve-VM-idega.
- Ehita oma veebileht NxCode-iga — AI-toega veebiarendus, mis kasutab agentse inseneeria põhimõtteid.
