Ensimmäinen työpari joka tietää rajansa

Ensimmäinen agentti ei tarvitse suurta tehtävää. Se tarvitsee hyvän rajauksen. Tässä moduulissa kirjoitat agentille roolin, lähteet, kiellot ja palautusmuodon. Kun nämä ovat selvät, tulosta voi arvioida. Ilman niitä agentti kuulostaa ehkä sujuvalta, mutta et tiedä tekikö se oikeaa työtä.

Tarkat komennot ja tekninen selostus ovat moduulin lopussa.

Valitse pieni rooli

Aloita roolista, jossa agentti auttaa mutta ei päätä. Hyviä ensimmäisiä rooleja ovat:

• LUKIJA, joka tiivistää yhden tekstin
• KIRJOITTAJA, joka tekee ensimmäisen luonnoksen
• TARKASTAJA, joka etsii puutteet
• MUISTAJA, joka kirjaa mitä tehtiin

Valitse yksi. Älä rakenna ensimmäiseksi kaikkea. Remonttiyrityksen tarjouspohjan luonnostelija voi olla hyvä harjoitus, jos se saa vain keksityn tarjouspyynnön. Kotitalouden viikko-ostoslistaaja voi olla hyvä harjoitus, jos se ei tilaa mitään vaan ehdottaa listaa.

Kirjoita agenttikortti

Agenttikortti kertoo, miksi agentti on olemassa. Sen pitää olla lyhyt, konkreettinen ja hieman tylsä. Tylsyys on etu, koska agentin ei pidä keksiä itselleen sankaritarinaa. Kirjoita korttiin rooli, vahvuudet, rajat ja palautusmuoto. Esimerkiksi LUKIJA lukee rajatun tekstin, löytää päätökset ja avoimet kysymykset, ei lisää lähteiden ulkopuolista tietoa ja palauttaa pääasiat, avoimet kysymykset sekä seuraavan askeleen.

Tämä on ensimmäinen sopimus. Agentti saa olla hyödyllinen vain sopimuksen sisällä.

Tee harjoituslähde

Kirjoita lyhyt vaaraton lähde. Esimerkiksi: kuvitteellisen yrityksen viikkopalaverissa sovittiin, että asiakasviesteihin vastataan jatkossa kahden arkipäivän sisällä. Tarjouspohja päivitetään niin, että toimitusaika ja rajaukset näkyvät ensimmäisellä sivulla. Epäselväksi jäi, kuka tarkistaa vanhat avoimet tarjoukset.

Älä käytä vielä oikeita asiakasviestejä. Harjoituksen tarkoitus on nähdä, seuraako agentti ohjetta.

Hyvä tehtäväpyyntö

Hyvä tehtäväpyyntö sisältää viisi osaa:

1. tavoite
2. lähde
3. rajat
4. palautusmuoto
5. tarkistuskysymys

Esimerkiksi pyydät agenttia tiivistämään harjoitustekstin, kerrot missä lähde on, kiellät lisäämästä tietoa lähteen ulkopuolelta, pyydät palautukseksi pääasiat, avoimet kysymykset ja seuraavan askeleen sekä käsket merkitsemään lopuksi epävarmat kohdat.

Tämä ei ole loitsu. Se on työmääräin. Mitä paremmin työmääräin on kirjoitettu, sitä helpompi tulos on tarkistaa.

Arvioi vastaus

Ensimmäisen ajon jälkeen älä kysy "kuulostaako tämä hyvältä". Kysy:

• Mainitsiko agentti kaikki lähteen tärkeät asiat?
• Erottiko se päätökset avoimista kysymyksistä?
• Lisäsikö se jotain, mitä lähteessä ei ollut?
• Oliko palautus sovitussa muodossa?
• Pystyisinkö jatkamaan työtä tästä?

Jos vastaus epäonnistui, älä vaihda heti mallia. Korjaa ensin roolia tai tehtäväpyyntöä. Usein ongelma on siinä, että ihminen jätti jonkin itselleen selvän asian sanomatta.

Roolin rajat käytännössä

Ensimmäinen agentti on valmis vasta, kun tiedät myös mitä se ei tee. LUKIJA ei kirjoita vastausta asiakkaalle. KIRJOITTAJA ei lähetä viestiä. TARKASTAJA ei korjaa omin päin. MUISTAJA ei muuta alkuperäistä lähdettä.

Rajat eivät vähennä agentin hyötyä. Ne tekevät hyödyn käytettäväksi.

Harjoitus ennen seuraavaa moduulia

Tee agentille pieni testipaketti:

1. selkeä lähde
2. epäselvä lähde
3. lähde, jossa on puuttuva tieto

Kirjoita jokaisen jälkeen, mikä ohje auttoi ja mikä ei. Merkitse onnistuiko selkeä lähde, onnistuiko epäselvä lähde, kysyikö agentti puuttuvasta tiedosta vai arvasiko se ja mitä muutat agenttikorttiin. Näin kortista tulee vähitellen parempi.

Pidä ensimmäinen agentti näkyvissä

Älä piilota ensimmäistä agenttia heti toistuvan ajon taakse. Avaa roolikortti, lähde, tehtävä ja vastaus samaan aikaan. Katso miten ohje muuttuu tulokseksi. Tämä näkyvä vaihe on arvokas, koska myöhemmin osaat korjata ongelmia nopeammin.

Oma Digitiimi saa seuraavassa moduulissa lisää rooleja. Ensimmäisen agentin tehtävä on opettaa sinulle, miltä hyvä rajaus tuntuu.

mkdir -p ~/Agentit/agents/lukija ~/Agentit/groundtruth ~/Agentit/wiki
nano ~/Agentit/agents/lukija/AGENTTI.md
nano ~/Agentit/groundtruth/harjoitus.md

codex exec "$(cat ~/Agentit/agents/lukija/AGENTTI.md)

TEHTÄVÄ:
Lue ~/Agentit/groundtruth/harjoitus.md ja palauta sovitussa muodossa."

claude -p "$(cat ~/Agentit/agents/lukija/AGENTTI.md)

TEHTÄVÄ:
Lue ~/Agentit/groundtruth/harjoitus.md ja palauta sovitussa muodossa."

printf '%s LUKIJA testipaketti ajettu\n' "$(date '+%Y-%m-%d %H:%M')" >> ~/Agentit/logs/activity.log

Tiivistelmä

• Ensimmäinen agentti tarvitsee pienen roolin ja selvät rajat.
• Agenttikortti on sopimus, ei persoonallisuusessee.
• Harjoituslähteet pidetään vaarattomina.
• Tulos arvioidaan lähteiden, rajojen ja palautusmuodon mukaan.
• Seuraavaksi rakennamme useamman roolin Oma Digitiimiksi.