Miten agentti saa ajatella

Agentti tarvitsee kielimallin, muuten se on vain ohjekortti ja muutama tiedosto. Valinta kannattaa tehdä rauhassa, koska sama päätös vaikuttaa rahaan, turvallisuuteen ja siihen, kuinka helposti uskallat harjoitella.

Tässä kurssissa aloitamme ennustettavasta polusta: käytät olemassa olevaa kuukausitilausta omalta koneeltasi ja pidät harjoitukset näkyvinä. Tarkat komennot ja tekninen sanasto ovat moduulin lopussa.

Kolme tapaa ajatella valinnasta

Ensimmäinen kysymys ei ole "mikä malli on paras". Parempi kysymys on: "mikä tapa antaa minun oppia ilman yllätyslaskua ja salaisuusvuotoa?"

Alussa tarvitset mallipolun, joka on:

• helppo käynnistää käsin
• riittävän vahva lukemiseen ja kirjoittamiseen
• ennustettava kulujen kannalta
• sellainen, ettei salaisuuksia tarvitse sirotella harjoitustiedostoihin

Siksi kuukausitilaukseen nojaava käyttötapa on hyvä ensimmäinen askel. Se ei tee käytöstä ilmaista, mutta yksittäinen harjoitus ei muutu heti erilliseksi laskuriviksi.

Milloin paikallinen malli riittää

Paikallinen malli voi olla hyvä apuri yksityisiin tai pieniin tehtäviin. Se sopii esimerkiksi lyhyiden muistiinpanojen järjestämiseen, otsikkovaihtoehtojen tekemiseen tai vaarattoman tekstin muotoiluun.

Paikallinen ei automaattisesti tarkoita parempaa. Laatu voi vaihdella, kone voi hidastua ja asetukset voivat vaatia kärsivällisyyttä. Ajattele sitä toisena työkaluna, ei uskonnollisena valintana.

Milloin käyttöperusteinen polku on järkevä

Käyttöperusteinen malliyhteys voi myöhemmin olla oikea valinta, jos rakennat oikeaa sovellusta, tarvitset tarkkaa mittausta, palvelet useita käyttäjiä tai haluat hallita käyttöä tiimin tasolla. Silloin mukaan tulee myös hallintatyötä: avainten säilytys, kulurajat, lokit, käyttöoikeudet ja virheiden käsittely.

Jos nämä sanat tuntuvat vielä etäisiltä, älä aloita sieltä. Oma Digitiimi oppii ensin tekemään yhden rajatun työn hyvin.

Kustannuspuhe ihmisen kielellä

Kustannus ei karkaa yhdestä hyvästä pyynnöstä. Se karkaa yleensä rytmistä, joka toistaa huonoa pyyntöä liian monta kertaa. Siksi agentille ei anneta alussa lupaa käynnistää loputtomia ajoja, korjata itseään silmukassa tai vaihtaa kallimpaan polkuun omin päin.

Hyvä kustannussääntö sanoo neljä asiaa: käytän alussa kuukausitilauksen kautta toimivaa mallipolkua, en lisää salaisia avaimia harjoitusympäristöön, en ajasta raskaita malliajoja ennen käsin tehtyä testiä ja jos mallipolku ei vastaa, tehtävä epäonnistuu näkyvästi eikä vaihda reittiä itse.

Kirjoitettu sääntö on tärkeä, koska myöhemmin agentti voi lukea sen. Ilman sääntöä jokainen uusi tehtävä voi vahingossa kiertää vanhan päätöksen.

Miten arvioit tehtävän koon

Pieni tehtävä lukee lyhyen tekstin ja palauttaa selkeän tuloksen. Keskikokoinen tehtävä lukee muutaman tiedoston ja järjestää niiden sisällön. Suuri tehtävä tekee analyysia, kirjoittaa koodia, vertailee vaihtoehtoja tai vaatii erillisen tarkastuksen.

Aloita pienestä. Kahvilaketjun tilaushelppari voi ensin järjestää viisi kuvitteellista puutetta kolmeen ryhmään. Vasta myöhemmin se saa lukea koko viikon tilausmuistion. Sama koskee pienen toiminimen kirjanpidon esikäsittelijää: ensin keksityt rivit, sitten rajattu kansio, lopuksi oikea työ vasta kun ihminen tarkistaa kaiken.

Ennen seuraavaa moduulia: tee savutesti

Tee yksi lyhyt pyyntö valitulla mallipolulla. Hyvä vastaus on yksi ymmärrettävä lause. Jos se ei onnistu, älä jatka ensimmäiseen agenttiin. Korjaa kirjautuminen, työkalu tai tilaus ensin.

Kirjaa päivä, käytetty polku, pyyntö, vastaus, onnistuiko ajo ja mitä korjaat ennen jatkoa.

Kun savutesti toimii, agentilla on moottori. Seuraavaksi annamme sille roolin ja rajat.

codex exec "Vastaa yhdellä suomenkielisellä lauseella: agentti valmistelee, ihminen päättää."
printf '%s Codex CLI testattu\n' "$(date '+%Y-%m-%d %H:%M')" >> ~/Agentit/logs/activity.log

claude -p "Vastaa yhdellä suomenkielisellä lauseella: agentti valmistelee, ihminen päättää."
printf '%s Claude CLI testattu\n' "$(date '+%Y-%m-%d %H:%M')" >> ~/Agentit/logs/activity.log

cat > ~/Agentit/secrets/check-no-api-env.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

for key in OPENAI_API_KEY ANTHROPIC_API_KEY GOOGLE_API_KEY OPENROUTER_API_KEY; do
  if [ -n "${!key:-}" ]; then
    echo "VAROITUS: $key näkyy ympäristössä."
    exit 1
  fi
done

echo "OK: yleisiä API-avaimia ei näy ympäristössä."
EOF

chmod 700 ~/Agentit/secrets/check-no-api-env.sh
~/Agentit/secrets/check-no-api-env.sh

printf '%s planned model=subscription size=small task=short-summary\n' "$(date '+%Y-%m-%d %H:%M')" >> ~/Agentit/logs/cost-awareness.log

Tiivistelmä

• Agentti tarvitsee kielimallin, mutta käyttötavan pitää olla hallittu.
• Kuukausitilaukseen nojaava polku on aloittelijalle ennustettava.
• Käyttöperusteinen yhteys kuuluu myöhempään vaiheeseen, jossa kulurajat ja salaisuudet ovat kunnossa.
• Agentti ei saa vaihtaa mallipolkua itse.
• Seuraavaksi kirjoitamme ensimmäisen agentin roolin.