Tutorial 2 How the Code Works eu

Tutorial 2 · Nola funtzionatzen duen kodeak

Helburua: proiektu hau AI agente batekin aldatzeko erraza — eta segurua — egiten duten diseinu-erabaki gutxi horiek ulertzea. Ez duzu kodea buruz ikasi behar; eredu mentala behar duzu, agentea zehaztasunez zuzendu ahal izateko.

← Aurrekoa: 1 Orientazioa · Hurrengoa: 3 Zure lehen ataza agentearekin

---

Mapa

lockedin-cli/
├── bin/lockedin.js      # sarrera-puntua — sarrera/irteera egiten duen parte BAKARRA
├── src/lockedin.js      # nukleoa — string-ak itzultzen dituzten funtzio puruak
├── test/
│   ├── unit.test.js     # nukleo-funtzioak zuzenean probatzen ditu
│   └── cli.test.js      # benetako bitarra abiarazi eta bere irteera egiaztatzen du
├── tools/screenshot.js  # docs/-en ikusten dituzun SVGak errenderizatzen ditu
└── package.json         # metadatuak + `npm test` scripta

Lau ideiak funtzionarazten dute. Ikasi hauek eta ia edozein aldaketa eska diezaiokezu agenteari konfiantzaz.

1. ideia — String-ak itzultzen dituen nukleo puru bat

Ireki src/lockedin.js. Ohartu render-funtzioek ez dutela inprimatzen — string-ak itzultzen dituzte:

function renderConnect() {
  const names = shuffle(NAMES).slice(0, 6);
  // ...lerro-array bat eraikitzen du...
  return out.join('\n');   // testua itzultzen du; ez du ezer inprimatzen
}

Benetako inprimatze guztia (eta zure teklakaden irakurketa) bin/lockedin.js-en gertatzen da. "nukleoak datuak itzultzen ditu, ertzak S/I egiten du" banaketa hau da hemengo gauzarik garrantzitsuena, string bat besterik itzultzen ez duen funtzio bat probatzeko hutsala delako:

const out = app.renderConnect();
assert.ok(out.includes("“Nire sare profesionalera gehitu nahi zintuzket.” — bidalia "));

Terminalik simulatu gabe, stdout-ik harrapatu gabe. Agenteari funtzionalitate bat gehitzeko eskatzen diozunean, horregatik gehi diezaioke ere proba azkar eta fidagarri bat.

2. ideia — Eduki-poolak

Txantxak src/lockedin.js-en goialdetik gertu dauden array soiletan bizi dira:

const HOOKS = [ 'Iritzi ez-popularra:', 'Utzi hori barneratzen.', /* ...~25 guztira... */ ];
const LESSONS = [ '→ Zure sarea zure ondare garbia da.', /* ... */ ];

Sortzaileek pool horietatik aukeratzen dute. v1.2.0-n pool bakoitza ~25 aldaeratara hazi zen, eta txantiloi-poolen bigarren geruza bat gehitu zen (POST_REVEALS eta REFLECT_TAGSETS bezalakoak) irteera bakoitzaren egitura alda dadin, ez hitzak soilik. Edukia gehitzea sarritan array bati string-ak gehitzea bezain erraza da — agente bati emateko lehen ataza ezin hobea.

3. ideia — Hazidun ausazkotasuna = proba deterministak

Ausazko irteera eta proba automatizatuak bateraezinak dirudite. Proiektu honek zirkulua koadratzen du hazi daitekeen zenbaki-sortzaile ausazko batekin:

setSeed(42);
const a = generatePost();
setSeed(42);
const b = generatePost();
// a === b  → hazi bera, post bera

Ausazko aukera bakoitza pick() / shuffle() laguntzaile partekatuetatik pasatzen da, hazidun sortzaile horretatik ateratzen dutenak. Ezarri LOCKEDIN_SEED=42 eta CLIa guztiz erreproduzigarria da. Edozein aldaketarako urrezko araua: ausazkotasun berriak pick / shuffle erabili behar du, inoiz ez Math.random zuzenean — bestela determinismoa (eta probak) hausten dira. Gorde hau patrikan; 3. kapituluan gogoraraziko diozu agenteari.

4. ideia — Bi proba-geruza

• test/unit.test.js-ek nukleo-funtzioak deitzen ditu eta itzultzen dituzten string-en gainean baieztapenak egiten (azkarra, zehatza).
• test/cli.test.js-ek benetan bin/lockedin.js abiarazten du eta bere benetako stdout eta irteera-kodea egiaztatzen ditu (dena hasieratik amaierara funtzionatzen duela frogatzen du).

Elkarrekin langa dira. Aldaezinak ere kodetzen dituzte — app-ak egiten dituen promesak. Adibidez, post batek beti hook ezagun batekin hasten da eta beti gutxienez hiru → ikasgai ditu; "connect" pantailak beti incalculable esaten du. Agente batek kodea aldatzen duenean, proba hauek promesa bat isilean hautsi duen edozer harrapatzen dute.

---

Zergatik den hau garrantzitsua agente batekin lan egiteko

Jarri lau ideiak elkarrekin eta agente batek honako hau egin dezakeen kode-base bat lortzen duzu:

1. Funtzionalitate bat gehitu string bat itzultzen duen funtzio puru gisa,
2. Proba bat gehitu horretarako inolako S/I gimnasiarik gabe,
3. Irteera erreproduzigarri mantendu hazidun RNGaren bidez, eta
4. Ezer hautsi ez duela frogatu existitzen den langa exekutatuz.

Hori da hurrengo kapituluan exekutatuko duzun begizta.

✅ Probatu zure agentearekin

Eskatu agenteari zure ulermena egiaztatzeko — irakurriz, ez editatuz:

1. "Zerrendatu src/lockedin.js-eko eduki-pool bakoitza eta bakoitzak zenbat sarrera dituen."
2. "Erakutsi test/unit.test.js-ek generatePost-i buruz betearazten duen aldaezin bat, eta azaldu zerk hautsiko lukeen."
3. "Non dago definituta hazidun RNGa, eta zein funtziok erabili behar dute Math.random-en ordez? Ez aldatu ezer — azaldu besterik ez."

Agentearen erantzunak kapitulu honekin bat datozenean, eraikitzeko prest zaude.

Hurrengoa: 3 Zure lehen ataza agentearekin