Kun oma Mac muuttuu työpariksi

Ennen kuin agentti tekee mitään hyödyllistä, koneesta tehdään rauhallinen työtila. Tämä moduuli on tahallaan maanläheinen. Tarkistamme Macin, luomme kansiorakenteen ja päätämme, missä salaisuudet pidetään. Kun pohja on tylsä ja selkeä, agentti voi myöhemmin olla hyödyllinen ilman että se pääsee vahingossa liian pitkälle.

Tarkat komennot ja tekninen selostus ovat tämän moduulin lopussa.

Mitä valmius tarkoittaa

Valmis Mac ei tarkoita täydellistä kehittäjäkonetta. Se tarkoittaa, että tiedät neljä asiaa:

1. Millä koneella harjoittelet.
2. Missä agentin tiedostot asuvat.
3. Mistä agentti saa lukea.
4. Mihin se saa kirjoittaa.

Oma Digitiimi tarvitsee alussa oman pienen huoneen. Se huone on kansio, jossa on harjoituslähteet, agenttien ohjeet, lokit ja väliaikaiset tiedostot. Et aloita koko kotikansion avaamisesta. Aloitat laatikosta, jonka sisällön tunnet.

Työtilan periaate

Hyvä työtila on arkinen:

• agents sisältää agenttien roolikortit.
• groundtruth sisältää lähteet, joita agentti saa lukea.
• wiki sisältää agentin kirjoittamat muistiot.
• logs sisältää jäljen siitä, mitä tehtiin.
• secrets sisältää salaisuudet tiukemmin rajattuna.
• tmp on harjoittelun roskakori.

Tärkeintä ei ole kansioiden nimet vaan ajatus. Lähdeaineisto ja agentin tulkinta pidetään erillään. Salaisuudet eivät kuulu tavallisiin muistiinpanoihin. Lokit eivät ole koriste, vaan tapa nähdä mitä tapahtui.

Mallipolku ilman yllätyksiä

Agentti tarvitsee yhteyden kielimalliin. Aloittelijalle paras ensimmäinen polku on tavallinen kuukausitilaus, jota käytetään omalta koneelta. Silloin jokainen harjoitus ei muutu erilliseksi käyttöperusteiseksi laskuksi.

Tämä ei tarkoita, että muut tavat olisivat vääriä. Se tarkoittaa, että oppimisen alussa ennustettavuus voittaa hienouden. Kun ymmärrät työnkulut, voit myöhemmin valita tarkemman tai tuotantomaisemman tavan.

Salaisuuksien sääntö

Tee itsellesi yksi sääntö jo nyt: salaisuus ei koskaan kuulu keskusteluun, muistioon tai julkiseen projektikansioon. Salaisuus on esimerkiksi palvelun avain, puhelinhälytyksen tunnus tai salasana.

Jos agentti tarvitsee salaisuuden myöhemmin, se luetaan rajatusta tiedostosta ajon hetkellä. Et liitä sitä ohjeeseen. Et kopioi sitä lokiin. Et laita sitä esimerkkitiedostoon.

Tämä kuulostaa kireältä, mutta se tekee myöhemmästä rakentamisesta rennompaa. Kun rajat ovat selvät, sinun ei tarvitse joka kerta miettiä, vuotaako jokin.

Harjoituslähteet ensin

Kopioi työtilaan muutama vaaraton teksti. Hyviä harjoituslähteitä ovat esimerkiksi:

• kuvitteellisen kahvilaketjun viikon tilauslista
• remonttiyrityksen kuvitteellinen tarjouspyyntö
• pienen toiminimen esimerkkikuitit ilman oikeita henkilötietoja
• yhdistyksen keksitty kokousmuistio

Älä aloita terveys-, talous-, lapsi- tai asiakastiedoista. Opettele ensin rakenne aineistolla, jonka kanssa virhe ei haittaa.

Milloin kone on valmis

Kone on valmis seuraavaan moduuliin, kun pystyt vastaamaan kyllä näihin:

• Löydän agenttityötilan yhdellä komennolla tai Finderista.
• Tiedän, mikä kansio on lähteille ja mikä agentin kirjoituksille.
• Harjoituslähteissä ei ole oikeita salaisuuksia tai arkaluonteisia henkilötietoja.
• Tiedän, mitä mallipolkua käytän alussa.
• Minulla on lokikansio, johon voidaan kirjoittaa yksinkertainen merkintä.

Jos jokin puuttuu, korjaa se nyt. Seuraavissa moduuleissa oletamme, että agentilla on oma rajattu paikka.

Ennen seuraavaa moduulia: ota pieni varmuuskopio

Kun pohja toimii, tee siitä kopio. Kopion ei tarvitse olla hieno. Tavoite on, että uskallat kokeilla, koska voit palata alkuun.

Kirjoita myös lyhyt ympäristömuistio. Siihen riittää kone, työtilan sijainti, ensimmäinen mallipolku, harjoituslähteet ja lista asioista, joihin et vielä anna pääsyä.

Tämä muistio on ensimmäinen pieni pala Oma Digitiimin hallintaa. Agenttiorganisaatio tarvitsee muistia jo ennen ensimmäistä agenttia.

uname -m
sw_vers -productVersion

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install git node pnpm python

mkdir -p ~/Agentit/{agents,groundtruth,wiki,logs,secrets,tmp,bin}
chmod 700 ~/Agentit/secrets
printf '%s työtila luotu\n' "$(date '+%Y-%m-%d %H:%M')" >> ~/Agentit/logs/activity.log

cat > ~/Agentit/wiki/ymparisto.md <<'EOF'
# Oma agenttiympäristö

Kone:
macOS:
Mallipolku:
Työtila: ~/Agentit
Salaisuudet: ~/Agentit/secrets
EOF

curl -fsSL https://kurssi.hoitovirhe.fi/bin/tarkista-asennus.sh -o ~/Agentit/bin/tarkista-asennus.sh
chmod 700 ~/Agentit/bin/tarkista-asennus.sh
~/Agentit/bin/tarkista-asennus.sh pohja

Tiivistelmä

• Agentin ensimmäinen turvaraja on oma rajattu työtila.
• Lähteet, agentin kirjoitukset, lokit ja salaisuudet pidetään eri paikoissa.
• Harjoittelu tehdään vaarattomalla aineistolla.
• Kuukausitilaukseen nojaava mallipolku on alussa ennustettava.
• Seuraavaksi katsomme, mitä agenttityökalun asennus tekee koneelle.