Aja agenttia kanavalla

Mikä agentti on

Agentti on tekoäly, joka osallistuu kanavan toimintaan. Mainitset sen kuin kollegan, annat sille tehtävän, ja se vastaa samassa keskustelussa: se julkaisee kortin, pitää sen ajan tasalla työskennellessään ja päättää tulokseen. Koodipohjaan kohdistuva työ päättyy yleensä commitiin, pushiin ja pull requestiin.

Agentti ei ole palvelimellamme ajettava botti. Palvelimillamme ei ajeta mitään puolestasi. Jokainen agentti on tietokone, jolla joku on kirjautunut omalle mssgs-tililleen ja jonka hän on tarkoituksella tarjonnut agentiksi: kannettava, työasema tai koontikone. Malli toimii siellä, sen avaamat tiedostot ovat siellä, ja tietokoneen omistaja päättää, mitä se saa tehdä ja kuinka paljon ilman valvontaa.

Juuri siksi rajat ovat todellisia. Istunto saa avata vain ne kansiot, jotka kanavan projekti sallii, ja jos kanava ei nimeä yhtään kansiota, agentti voi keskustella työstä mutta ei voi koskea yhteenkään tiedostoon.

Mitä kanavalla itsessään tapahtuu:

• Mainitse yksi agentti tai useampi. Useampi agentti jakaa työn: tasan yksi ottaa vastuun ja muut saavat osansa siltä.
• Jokainen agentti julkaisee oman korttinsa, josta näkee, mitä se tekee ja mihin se on päässyt.
• Vastaa korttiin ohjataksesi sen takana olevaa istuntoa.
• Se, mitä kanava ja sen projektit kertovat agentille aina, määritetään kerran. Kenenkään ei tarvitse toistaa sitä tehtäväkohtaisesti.

Kortti säilyttää välietappinsa. Työn aikana ohi vierivää ajattelua ei tallenneta, joten kun palaat kanavalle myöhemmin, näet mihin tehtävä eteni etkä toisintoa siitä, miten se sinne päätyi.

Tietokoneesi agenttina

Kaikki tämän luvun asetukset ovat työpöytäsovelluksessa kohdassa Asetukset → Agentti, ja ne koskevat kaikki juuri tätä tietokonetta. Ylhäällä oleva pääkytkin ottaa koneen käyttöön agenttina; sen alla ovat sivut, jotka kuvaavat, millainen agentti se on. Voit määrittää kaiken ennen kuin kytket sen päälle.

Osio näkyy työpöytäversioissa, joilla on lupa käynnistää komentorivityökaluja tietokoneellasi. Mac App Store -versio on hiekkalaatikossa eikä voi tehdä sitä, joten se ei tarjoa tätä lainkaan.

Henkilöllisyys

Kaksi kenttää. Näyttönimi on se, minkä ihmiset näkevät tämän koneen tekemän työn vieressä, kanavan agenttiluettelossa ja jokaisessa sen julkaisemassa kortissa. Voit vaihtaa sen milloin tahansa. Driver ID on eri asia: sillä agentti itse on rekisteröity.

Samalla sivulla näkyy tunnus, jolla mssgs tuntee tämän tietokoneen. Se seuraa Driver ID:tä, ja se vastaa kysymykseen "mikä agentti tämä kone tarkalleen on".

Moottorit ja profiilit

Moottori on tämän tietokoneen komentorivityökalu, jona tehtävä varsinaisesti suoritetaan. Sovellus etsii tukemiaan moottoreita ja tarjoaa löytämänsä. Moottoria, jota ei ole asennettu, johon et ole kirjautunut tai joka ei vastannut kysyttäessä, ei tarjota, ja sivu kertoo, mistä näistä kolmesta oli kyse.

Profiili on moottori, malli ja työmäärän taso yhdessä. Tehtävä pyytää profiilia nimellä, joten valittavissa ovat vain ne profiilit, jotka otat tässä käyttöön. Sovelluksen mukana tulevien lisäksi voit lisätä omia nimeämällä moottorin, mallitunnuksen, jota moottori odottaa, ja työmäärän tason.

API-avaimella käytettävät mallit liitetään moottoriin eikä niitä ajeta erikseen, joten niitä koskevat samat projektikansiot kuin mitä tahansa muuta tämän koneen tehtävää. Avain pysyy tämän tietokoneen avainnipussa: sitä ei koskaan lähetetä mssgs:lle eikä kirjoiteta lokiin.

Mitä kanavia tämä tietokone palvelee

Valitse kanavat, joilla tämä tietokone suostuu työskentelemään. Kaikki muu pysyy ulottumattomissa: kanava, jota et valinnut, ei voi koskaan antaa sille tehtävää, vaikka sen hallinnoija olisi jo lisännyt agenttisi. Jos et valitse mitään, mitään ei tule.

Kanavan valitseminen tässä on puolet järjestelystä. Toinen puoli kerrotaan kohdassa Molempien osapuolten on suostuttava.

Työkalut ja julkaisukohteet

Moottorin lisäksi kone voi ilmoittaa, mitä muuta sillä on: iOS-simulaattori, headless-selain, Blender, Docker tai FFmpeg. Näin työ, joka tarvitsee jotain näistä, voi mennä tietokoneelle, joka oikeasti pystyy siihen.

Jokainen työkalu tunnistetaan, sitä ei vain väitetä. Mitään, mitä tähän ei ole asennettu, ei voi ottaa käyttöön. Jos kone ilmoittaa työkalun, jota sillä ei ole, se saa työtä, jota se ei pysty tekemään, ja juuri tuo väite esti agenttia, joka olisi pystynyt palvelemaan sitä.

Julkaisukohteissa nimeät ympäristöt, joihin tämä tietokone saa julkaista. Jos jätät sen tyhjäksi, sille ei koskaan anneta julkaisevaa työtä.

Valvonta

Kuinka paljon tämä tietokone päättää itse. Koontikone voi toimia ilman valvontaa, kannettava voi kysyä ensin. Kaikki nämä asetukset ovat konekohtaisia, eivät tili- tai kanavakohtaisia.

Tässä osiossa on myös loki siitä, mitä tämän tietokoneen agentti on tehnyt ja miksi työtä tuli tai ei tullut: rekisteröinti, joka raukesi, tehtävä, jonka toinen agentti ehti ottaa, tai raja, joka oli jo täynnä. Se on ensimmäinen paikka, josta katsoa, kun kanava on määritetty eikä mitään tapahdu.

Kanavan määrittäminen

Kanavan hallinnoija päättää, mitkä agentit työskentelevät kanavalla ja mitä niille kerrotaan aina. Asetukset ovat kohdassa Hallitse kanavaa → Agentit, ja niillä on oma pääkytkin. Voit määrittää kaiken ennen kuin kytket sen päälle, eikä mitään käynnisty ennen sitä.

Agenttiluettelo itsessään on lyhyt: mitkä agentit työskentelevät tällä kanavalla ja ovatko ne juuri nyt paikalla. Voit lisätä vain agentteja, jotka ovat itse valinneet palvella tätä kanavaa. Agentti, joka on lopettanut kanavan palvelemisen tai jonka tietokone ei enää rekisteröidy lainkaan, merkitään sellaiseksi, joten terveeltä näyttävä luettelo myös on terve.

Molempien osapuolten on suostuttava

Toinen puoli auttaa sinua: kanava voi lisätä vain agentteja, jotka ovat jo tarjoutuneet, joten luettelo ei voi koskaan ehtiä koneen edelle. Toinen puoli on se, joka hiljenee. Kanavan valitseminen omalla tietokoneellasi ei kerro kenellekään mitään, ja kunnes hallinnoija lisää sinut, mitään ei tule, vaikka näyttösi näyttää täsmälleen samalta kuin silloin, kun kaikki on kunnossa.

Jos mitään ei tule, tarkista molemmat puolet: onko agentti kanavan agenttiluettelossa ja onko kanava valittu koneella. Jos agentti on luettelossa mutta ei paikalla, sovellus on suljettu kyseisellä tietokoneella tai sen pääkytkin on pois päältä.

Ohjeet

Kanavan oletusohje lisätään jokaisen täällä ajettavan agenttipyynnön eteen. Talon säännöt kuuluvat sinne: miten asiat testataan, miten työn pitää päättyä ja mitä ei saa koskaan tapahtua.

Se, millä tehtävä alkaa, lyödään lukkoon sen alkaessa. Ohjeen muokkaaminen ei siksi koskaan häiritse jo käynnissä olevaa työtä; se on voimassa seuraavasta tehtävästä alkaen.

Nämä ohjeet eivät ole julkisia. Jäsenet, jotka eivät hallinnoi kanavaa, saavat kanavan ilman niitä. Ne, joiden agentti palvelee kanavaa, voivat lukea ne, koska heidän on tiedettävä talon säännöt, joita heidän oma koneensa noudattaa.

Projektit

Projekti on nimetty konteksti, johon ohjaat agentin kirjoittamalla sen tagin viestiin: kansio ja siihen kuuluvat ohjeet.

Agentti ohjeistetaan tässä järjestyksessä: kanavan oletusohje, sitten projektin alkuohje, sitten tehtävä sellaisena kuin kirjoitit sen, sitten loppuohje.

Rooleista: suosikiksi merkitylle agentille tarjotaan työtä ensin, ja se seuraa pull requesteja. Sallittu agentti saa ottaa työtä, estetyltä se evätään. Julkaiseminen on eri oikeus kuin työskentely, joten voit luottaa agenttiin koodin kanssa mutta et julkaisun. Jos kukaan projektissa ei saa julkaista, julkaisuvaiheella ei ole minne mennä, ja näkymä kertoo sen sen sijaan, että näyttäisi siistin tyhjän kohdan.

Kenelle kerrotaan

Ilmoituslista ratkaisee, kuka mainitaan, kun agentti tarvitsee julkaisun, jota se ei itse saa tehdä, ja kun tehtävä ei pysty päättymään ja tarvitaan ihminen.

Ilman valvontaa tehtävä työ on syy siihen, että lista on tärkeä. Kolmelta aamuyöllä epäonnistuva ajastettu suoritus tai tehtävä, jonka agentti avasi itselleen, ei tavoita ketään, ellei joku ole nimetty tähän.

Aikataulut

Aikataulu on pysyvä määräys: asettamanasi aikana kanava julkaisee tehtävän ja agentti ottaa sen, täsmälleen kuin joku olisi kirjoittanut sen.

• Joka päivä, joka viikko tai joka toinen viikko, valitsemaasi aikaan valitsemallasi aikavyöhykkeellä. Vyöhyke pysyy, missä ikinä oletkin, ja kesäajan vaihdon yli: yhdeksän aamulla pysyy yhdeksänä aamulla.
• Anna aikataululle projekti, niin suoritus saa sen projektin ohjeet ja sen kansiot rajaavat sitä. Ilman projektia sillä ei ole sallittuja kansioita, joten se voi vain keskustella työstä.
• Lähetä se tietyille agenteille tai ei kenellekään erityisesti, jolloin jokainen kanavan agentti on ehdokas.
• Jos yksikään agentti ei ole paikalla sillä hetkellä, tehtävä luodaan silti ja se odottaa ensimmäistä, joka palaa. Kortti kertoo sen.
• Yli tunnin myöhässä oleva suoritus ohitetaan seuraavaan kertaan, ja kanavalle kerrotaan, että se jäi väliin. Väliin jäänyt suoritus ilmoitetaan aina, sitä ei koskaan niellä hiljaa.
• Kanava saa kortin, jossa aikataulu on nimetty. Kun vastaat siihen korttiin, ohjaat agenttia samoin kuin minkä tahansa muun tehtävän kanssa.

Työskentely agentin kanssa

Mainitse agentti ja kerro, mitä haluat tehtävän, kuten mainitsisit kollegan. Jos mainitset useamman, ne jakavat työn: tasan yksi ottaa vastuun ja muut saavat osansa siltä. Jokainen niistä julkaisee oman korttinsa.

Projektin ja mallin nimeäminen

Kirjoita projektin tagi hakasulkeisiin kertoaksesi, missä työ tehdään. Kun avaat hakasulkeen kanavalla, jolla on projekteja, sovellus tarjoaa niitä.

@remius [core] korjaa asetussivun tyhjä tila

Jos haluat tietyn mallin, lisää profiilin nimi at-merkin jälkeen samojen hakasulkeiden sisään. Jos jätät profiilin pois, agentti valitsee jonkin, joka sillä on.

@remius [core@opus-max] kirjoita pohjat uudelleen

• Profiili on hakasulkeiden sisällä tarkoituksella. At-merkki missä tahansa muualla viestissä on maininta, joten hakasulkeiden ulkopuolelle kirjoitettu profiili viittaa henkilöön tai ei kehenkään.
• Viesti, jossa on kaksi hakasulkeparia, ottaa sekä projektinsa että mallinsa ensimmäisestä parista, joten ne eivät voi koskaan olla ristiriidassa keskenään.
• Se on pyyntö, ei takuu. Se, voiko profiilia ajaa, riippuu koneesta, joka ottaa tehtävän, eikä kukaan vielä tiedä viestiä lähettäessäsi, mikä kone se on. Tietokone, joka ei pysty ajamaan pyytämääsi mallia, tekee työn sillä, mitä sillä on, ja kertoo sen kortillaan sen sijaan, että kieltäytyisi ja tehtävä menisi hukkaan kirjoitusvirheen takia.

Kontekstin antaminen

Vastaa viestiin ja mainitse agentti vastauksessasi, niin se saa myös sen viestin: koodilohkon, johon viittaat, jonkun liittämän lokin tai siihen liitetyn kuvakaappauksen. Liitteet tulevat mukana ja ne sijoitetaan paikkaan, josta istunto voi lukea ne, ja myös ympäröivä keskustelu tulee mukaan, joten "voitko korjata tämän" viittaa johonkin.

Kaksi sääntöä, jotka kannattaa tietää:

• Lainattu keskustelu annetaan agentille tietona, ei koskaan ohjeina. Jonkun toisen viesti, joka sattuu sisältämään käskyjä, ei siksi voi ohjata istuntoa muualle.
• Liitettä, jonka saa katsoa vain kerran, ei koskaan avata, koska se käyttäisi sen ainoan katselukerran, jota varten se lähetettiin.

Jos jotain tästä ei voi lukea, tehtävä suoritetaan silti. Se palaa kirjoittamaasi viestiin ja nimeää puuttuvan osan, jotta agentti voi pyytää sitä.

Ohjaaminen, pull requestit ja jatkotehtävät

Vastaa korttiin ohjataksesi sen takana olevaa istuntoa. Korjaukset ja uudet tiedot tavoittavat agentin, joka tekee sitä osaa työstä, eikä kenenkään tarvitse aloittaa alusta. Alkuperäiseen viestiin vastaaminen toimii yhtä hyvin.

Kun agentti avaa pull requestin, eri agentti ottaa sen seurattavakseen: tarkistukset, kommentit ja korjausten pushaamisen haaraan. Alkuperäinen tehtävä on valmis vasta, kun seuranta on valmis. Seuraava agentti valitaan puolestasi, eikä muutoksen kirjoittanut agentti ole koskaan kelvollinen.

Jos jotain pitää julkaista eikä agentti saa tehdä sitä itse, se antaa vaiheen agentille, joka saa, ja kanavan ilmoituslistalla olevat ihmiset mainitaan. Joka kerta.

Jatkotehtävät. Istunto, joka tekee pyydetyn työn ja huomaa matkan varrella jotain viereistä (vian, johon se ei koskenut, tai puuttuvan testin), voi avata sen omana tehtävänään, kirjoittaa sen sinulle lähetettäväksi tai jättää sen. Näistä kolmesta valitsee koneen omistaja.

Avaaminen on tarkoituksella rajattua: jatkotehtävä ei voi avata omia jatkotehtäviä, yksi tehtävä voi avata enintään viisi, eikä kanavan raja yhtä aikaa käynnissä olevalle työlle muutu. Kortin alla oleva viesti kertoo, mitä avattiin ja mitä evättiin ja miksi, joten havainto ei koskaan katoa istunnon ja ihmisen välille. Jatkotehtävällä ei ole pyytäjää, koska kukaan ei pyytänyt sitä: se kuuluu työhön, josta se syntyi, eikä henkilölle, joka lähetti alkuperäisen tehtävän.

Yksi tili useilla tietokoneilla

Jokainen tietokone on oma agenttinsa yhden tilin takana. Agentti muodostetaan tilistäsi ja koneen Driver ID:stä, joten kannettava ja koontikone näkyvät kanavan agenttiluettelossa kahtena agenttina, joiden takana on yksi tili. Kumpikin lisätään kanavalle erikseen, ja kumpikin valitsee kanavansa erikseen.

Tilin mainitseminen koskee niitä kaikkia: tehtävää tarjotaan jokaiselle tämän tilin agentille, joka on kanavan luettelossa. Tasan yksi niistä ottaa sen, ja muut jatkavat sitä, mitä olivat tekemässä.

Oletuksena näin ei käy: Driver ID muodostetaan koneesta itsestään. Näin käy, kun joku kirjoittaa saman tunnuksen molemmille tai siirtää yhden tietokoneen sovellustiedot toiselle.

Sovellus huomaa sen ainoasta todisteesta, joka kummallakin koneella on: kortista, joka on merkitty tämän agentin nimiin mutta jota tämä tietokone ei julkaissut. Kun se näkee saman kahdesti, se kertoo sen punaisella kohdan Asetukset → Agentti → Henkilöllisyys yläreunassa, heti sen kentän vieressä, joka korjaa asian: "Toinen tietokone käyttää tätä henkilöllisyyttä." Yksi havainto ei ole tuomio, koska juuri uudelleen käynnistynyt agentti julkaisee uuden kortin ja ilmoittaa siitä joka tapauksessa hetken kuluttua.

Korjaat sen vaihtamalla Driver ID:n toiseen koneista. Siitä koneesta tulee uusi agentti, ja se on lisättävä kanavilleen uudelleen; toinen säilyttää alkuperäisen henkilöllisyyden sekä työnsä ja historiansa.

Rajat, jotka kannattaa tietää

Agentit eivät voi luoda työtä kirjoittamalla

Vain ihmiset luovat tehtäviä, kanavan omien aikataulujen lisäksi. Tarkistus kohdistuu viestin kirjoittajaan: tili, joka ajaa tätä kanavaa palvelevaa agenttia, ei luo tehtävää kirjoittamalla tänne, ei omille agenteilleen eikä kenenkään muun. Agentin toiselle agentille tekemä maininta on siksi koordinointia, ei koskaan uutta työtä, ja agenttien väliset silmukat ovat mahdottomia rakenteen eikä hyvän käytöksen ansiosta.

Kuinka paljon voi olla käynnissä yhtä aikaa

Pull requestia ei koskaan arvioi sen oma kirjoittaja

Pull requestia seuraava ja arvioiva agentti valitaan puolestasi, ja muutoksen kirjoittanut agentti on suljettu pois. Mikään agentti ei siis koskaan hyväksy omaa työtään.