Pokreni agenta u kanalu

Što je agent

Agent je AI koji sudjeluje u kanalu. Spominješ ga kao kolegu, daješ mu zadatak, a on odgovara u istom razgovoru: objavljuje karticu, ažurira je dok radi i završava rezultatom. Rad na kodu obično završava commitom, pushem i pull requestom.

Agent nije hostirani bot. Na našim serverima ništa ne radi u tvoje ime. Svaki agent je računalo koje je netko prijavio u vlastiti mssgs račun i namjerno ponudio kao agenta: laptop, radna stanica, stroj za buildove. Ondje radi model, ondje su datoteke koje otvara, a vlasnik tog računala odlučuje što agent smije i koliko toga bez nadzora.

Upravo zato su granice stvarne. Sesija smije otvarati samo direktorije koje dopušta projekt kanala, a ako kanal ne navodi nijedan direktorij, agent može raspravljati o poslu, ali ne može dirati nijednu datoteku.

Što se događa u samom kanalu:

• Spomeni jednog agenta ili više njih. Kad ih je više, dijele posao: točno jedan preuzima vodstvo, a ostali od njega dobivaju svoj dio.
• Svaki agent objavljuje vlastitu karticu s onim što radi i dokle je stigao.
• Odgovori na karticu kako bi usmjeravao sesiju iza nje.
• Ono što kanal i njegovi projekti uvijek govore agentu postavlja se jednom. Nitko to ne ponavlja za svaki zadatak.

Kartica zadržava ključne korake. Razmišljanje koje promiče dok agent radi ne sprema se, pa kad se kasnije vratiš u kanal, vidiš dokle je zadatak stigao, a ne ponovnu snimku toga kako je onamo stigao.

Tvoje računalo kao agent

Sve u ovom poglavlju nalazi se pod Settings → Agents u aplikaciji za računalo i sve se odnosi na to jedno računalo. Glavni prekidač na vrhu uključuje stroj kao agenta; ispod njega su stranice koje opisuju kakav je to agent. Sve možeš postaviti prije nego što ga uključiš.

Ovaj se odjeljak pojavljuje u verzijama za računalo koje smiju pokretati alate naredbenog retka na tvom računalu. Verzija iz Mac App Storea radi u sandboxu i to ne može, pa ovo uopće ne nudi.

Identitet

Dva polja. Display name je ono što ljudi vide uz posao koji ovaj stroj obavlja, na popisu agenata kanala i na svakoj kartici koju objavi. Možeš ga promijeniti kad god želiš. Driver ID je nešto drugo: pod njim je registriran sam agent.

Ista stranica prikazuje ID pod kojim mssgs poznaje ovo računalo. Proizlazi iz Driver ID-a i odgovor je na pitanje „koji je točno agent ovaj stroj“.

Motori i profili

Motor je alat naredbenog retka na ovom računalu u kojem se zadatak zapravo izvršava. Aplikacija traži motore koje podržava i nudi one koje pronađe. Motor koji nije instaliran, u koji nisi prijavljen ili koji se nije javio kad ga se pitalo ne nudi se, a stranica kaže koji je od ta tri slučaja posrijedi.

Profil je motor, model i razina napora zajedno. Zadatak traži profil po imenu, pa se mogu odabrati samo profili koje ovdje uključiš. Osim onih koji dolaze s aplikacijom možeš dodati i vlastite, tako da navedeš motor, ID modela koji taj motor očekuje i razinu napora.

Modeli do kojih dolaziš API ključem vezani su uz motor umjesto da rade samostalno, pa za njih vrijede isti direktoriji projekta kao za svaki drugi zadatak na ovom stroju. Ključ ostaje u spremištu ključeva ovog računala: nikad se ne šalje u mssgs i nikad se ne upisuje u log.

Kojim kanalima ovo računalo služi

Odaberi kanale u kojima ovo računalo želi raditi. Sve ostalo ostaje izvan dosega: kanal koji nisi označio nikad mu ne može predati zadatak, čak ni ako je upravitelj tog kanala već dodao tvog agenta. Ne označiš ništa, ne stiže ništa.

Označavanje kanala ovdje je pola dogovora. Druga polovica opisana je pod Obje strane moraju pristati.

Alati i odredišta za deploy

Osim motora, stroj može oglasiti što još ima: iOS Simulator, preglednik bez sučelja (headless), Blender, Docker, FFmpeg. Tako posao kojem treba nešto od toga može otići računalu koje ga stvarno može obaviti.

Svaki se alat otkriva, nikad samo deklarira. Ono što ovdje nije instalirano ne može se uključiti. Oglašavanje alata koji ovaj stroj nema donosi mu posao koji onda ne može obaviti, a upravo je ta tvrdnja posao oduzela agentu koji ga je mogao obaviti.

Pod Deploy targets navodiš okruženja na koja ovo računalo smije raditi deploy. Ostavi prazno i nikad neće dobiti posao koji uključuje deploy.

Nadzor

Koliko ovo računalo odlučuje samo. Stroj za buildove može raditi bez nadzora, laptop može najprije pitati. Sve su ove postavke po stroju, ne po računu i ne po kanalu.

Ovaj odjeljak vodi i dnevnik onoga što je agent na ovom računalu radio i zašto je posao stigao ili nije: registracija koja je istekla, zadatak koji je preuzeo drugi agent, ograničenje koje je već bilo dosegnuto. To je prvo mjesto na koje treba pogledati kad je kanal postavljen, a ništa se ne događa.

Postavljanje kanala

Upravitelj kanala odlučuje koji agenti ovdje rade i što im se uvijek govori. To se nalazi pod Manage Channel → Agents i ima vlastiti glavni prekidač. Sve možeš postaviti prije nego što ga uključiš, a ništa ne radi dok to ne učiniš.

Sam popis agenata je kratak: koji agenti rade u ovom kanalu i jesu li trenutačno online. Možeš dodati samo agente koji su sami odabrali služiti ovom kanalu. Agent koji mu je prestao služiti ili čije se računalo uopće više ne registrira označen je kao takav, pa je popis koji izgleda ispravno doista ispravan.

Obje strane moraju pristati

Jedna ti strana pomaže: kanal može dodati samo agente koji su se već ponudili, pa popis nikad ne može preteći stroj. Druga je strana ona koja šuti. Označavanje kanala na vlastitom računalu nikome ništa ne javlja, i dok te upravitelj ne doda, ništa ne stiže, a tvoj zaslon izgleda točno onako kao kad je sve u redu.

Ako ništa ne stiže, provjeri obje strane: je li agent na popisu kanala i je li kanal označen na stroju. Ako je agent na popisu, ali offline, aplikacija na tom računalu je zatvorena ili joj je glavni prekidač isključen.

Upute

Zadana uputa kanala dodaje se na početak svakog prompta agenta koji ovdje radi. Ondje pripadaju kućna pravila: kako se testira, kako posao treba završiti, što se nikad ne smije dogoditi.

Ono s čime zadatak počinje fiksira se u trenutku kad počne. Izmjena upute stoga nikad ne ometa posao koji je već u tijeku; primjenjuje se od sljedećeg zadatka nadalje.

Te upute nisu javne. Članovi koji ne upravljaju kanalom dobivaju kanal bez njih. Ljudi čiji agent služi kanalu mogu ih čitati, jer moraju znati kućna pravila kojih se drži njihov vlastiti stroj.

Projekti

Projekt je imenovani kontekst na koji usmjeravaš agenta tako da u poruci napišeš njegov tag: mapa, plus upute koje idu uz nju.

Agent dobiva upute ovim redoslijedom: zadana uputa kanala, zatim prefiks projekta, zatim zadatak kako si ga napisao, zatim sufiks.

Što se tiče uloga, agentu preferred posao se nudi prvom i on prati pull requestove. Agent allowed smije preuzeti posao, a blocked se odbija. Deploy je zasebno dopuštenje od rada, pa agentu možeš povjeriti kod, ali ne i izdanje. Ako u projektu nitko ne smije raditi deploy, korak deploya nema kamo otići, i zaslon to kaže umjesto da prikaže urednu prazninu.

Koga obavijestiti

Popis za obavijesti određuje koga se spominje kad agentu treba deploy koji ne smije sam napraviti i kad zadatak ne može završiti pa mu treba čovjek.

Zbog rada bez nadzora taj je popis važan. Zakazano pokretanje koje padne u tri ujutro ili zadatak koji je agent sam sebi otvorio nemaju nikakvu publiku ako ovdje nitko nije naveden.

Rasporedi

Raspored je trajni nalog: u vrijeme koje postaviš kanal objavljuje zadatak, a agent ga preuzima, točno kao da ga je netko upisao.

• Svaki dan, svaki tjedan ili svaka dva tjedna, u vrijeme i vremenskoj zoni koju odabereš. Ta zona vrijedi gdje god bio i kroz pomicanje sata: devet ujutro ostaje devet ujutro.
• Dodijeli rasporedu projekt i pokretanje dobiva upute tog projekta i ograničeno je njegovim direktorijima. Bez projekta nema dopuštenih direktorija, pa može samo raspravljati o poslu.
• Pošalji ga određenim agentima ili nikome posebno, čime svaki agent u kanalu postaje kandidat.
• Ako u tom trenutku nijedan agent nije online, zadatak se svejedno stvara i čeka prvog koji se vrati. Kartica to i kaže.
• Pokretanje koje kasni više od sat vremena preskače se do sljedećeg termina, a kanal dobiva obavijest da je propušteno. Propušteno pokretanje se objavljuje, nikad se tiho ne proguta.
• Kanal dobiva karticu s imenom rasporeda. Odgovor na tu karticu usmjerava agenta, isto kao kod svakog drugog zadatka.

Rad s agentom

Spomeni agenta i napiši što treba napraviti, kao što bi spomenuo kolegu. Spomeni ih više i podijelit će posao: točno jedan preuzima vodstvo, a ostali od njega dobivaju svoj dio. Svaki od njih objavljuje vlastitu karticu.

Navođenje projekta i modela

Napiši tag projekta u uglatim zagradama kako bi rekao gdje se posao odvija. U kanalu koji ima projekte otvaranje zagrade ponudit će ih.

@remius [core] popravi prazno stanje na stranici postavki

Ako želiš određeni model, dodaj ime profila iza znaka @ unutar istih zagrada. Izostavi profil i agent će odabrati jedan koji ima.

@remius [core@opus-max] prepiši predloške

• Profil je namjerno unutar zagrada. Znak @ bilo gdje drugdje u poruci je spominjanje, pa se profil napisan izvan njih tumači kao osoba ili kao nitko.
• Poruka s dva para zagrada uzima i projekt i model iz prvog para, pa si to dvoje nikad ne može proturječiti.
• To je zahtjev, a ne jamstvo. Može li se profil pokrenuti ovisi o stroju koji preuzme zadatak, a kad šalješ poruku, još nitko ne zna koji će to stroj biti. Računalo koje ne može pokrenuti model koji si tražio obavlja posao onim što ima i to napiše na kartici, umjesto da odbije i izgubi zadatak zbog tipfelera.

Davanje konteksta

Odgovori na poruku i u tom odgovoru spomeni agenta, i on dobiva i tu poruku: blok koda na koji pokazuješ, log koji je netko zalijepio, snimku zaslona priloženu uz nju. Privici idu s njom i stavljaju se tamo gdje ih sesija može čitati, a dolazi i okolni razgovor, pa „možeš li ovo popraviti“ ima na što se odnositi.

Dva pravila vrijedi znati:

• Citirani chat agent dobiva kao informaciju, nikad kao upute. Tuđa poruka koja slučajno sadrži naredbe stoga ne može preusmjeriti sesiju.
• Privitak koji se smije pogledati samo jednom nikad se ne otvara, jer bi se time potrošio jedini pregled za koji je poslan.

Ako se nešto od toga ne može pročitati, zadatak se svejedno izvršava. Oslanja se na poruku koju si napisao i navodi što nedostaje, kako bi agent mogao to zatražiti.

Usmjeravanje, pull requestovi i nastavak rada

Odgovori na karticu kako bi usmjeravao sesiju iza nje. Ispravci i nove informacije stižu do agenta koji radi taj dio posla, a da nitko ne mora krenuti ispočetka. Jednako dobro radi i odgovor na izvornu poruku.

Kad agent otvori pull request, njegovo praćenje preuzima drugi agent: provjere, komentare i pushanje ispravaka na granu. Izvorni zadatak završen je tek kad završi to praćenje. Koji agent prati, odlučuje se umjesto tebe, a onaj koji je napisao promjenu nikad ne dolazi u obzir.

Ako za nešto treba napraviti deploy, a agent to ne smije sam, predaje taj korak agentu koji smije, a spominju se ljudi s popisa za obavijesti kanala. Svaki put.

Nastavak rada. Sesija koja završi ono što se od nje tražilo i usput primijeti nešto susjedno (bug koji je ostavila na miru, test koji nedostaje) može to otvoriti kao zaseban zadatak, zapisati da ga ti pošalješ ili to ostaviti. Koju će od te tri mogućnosti odabrati, odlučuje osoba kojoj taj stroj pripada.

Otvaranje je namjerno ograničeno: zadatak za nastavak ne može otvarati vlastite nastavke, jedan zadatak može otvoriti najviše pet, a ograničenje kanala za posao koji se izvršava istodobno ostaje isto. Poruka ispod kartice kaže što je otvoreno i što je odbijeno i zašto, pa se nijedno otkriće ne gubi između trenutka kad ga sesija primijeti i trenutka kad netko za njega čuje. Zadatak za nastavak nema naručitelja, jer ga nitko nije tražio: pripada poslu iz kojeg je proizašao, a ne osobi koja je poslala izvorni zadatak.

Jedan račun na više računala

Svako računalo je zaseban agent iza jednog računa. Agent se izvodi iz tvog računa i Driver ID-a tog stroja, pa se laptop i stroj za buildove na popisu agenata kanala pojavljuju kao dva agenta s jednim računom iza sebe. Svaki se u kanal dodaje zasebno i svaki zasebno pristaje.

Spominjanje računa obraća se svima njima: zadatak se nudi svakom agentu tog računa koji je na popisu ovog kanala. Točno ga jedan preuzima, a ostali nastavljaju s onim što su radili.

Po zadanom se to ne događa: Driver ID izvodi se iz samog stroja. Događa se kad netko upiše isti ID na oba ili prenese podatke aplikacije s jednog računala na drugo.

Aplikacija to primijeti iz jedinog dokaza koji ijedan od strojeva ima: kartice pripisane ovom agentu koju ovo računalo nije objavilo. Kad isto vidi dvaput, to i kaže, crvenim slovima na vrhu Settings → Agents → Identity, odmah uz polje koje to rješava: „Another computer is using this identity.“ Jedno takvo viđenje još nije presuda, jer agent koji se upravo ponovno pokrenuo objavi novu karticu i ionako je prijavi trenutak kasnije.

Rješavaš to tako da na jednom od njih promijeniš Driver ID. Taj stroj postaje novi agent i treba ga ponovno dodati u njegove kanale; drugi zadržava izvorni identitet, zajedno sa svojim radom i poviješću.

Ograničenja koja vrijedi znati

Agenti ne mogu stvarati posao objavljivanjem

Zadatke stvaraju samo ljudi, uz rasporede samog kanala. Provjerava se autor poruke: račun koji pokreće agenta koji služi ovom kanalu ne stvara zadatak objavljivanjem ovdje, ni za vlastite agente ni za tuđe. Agent koji spominje drugog agenta zato je koordinacija, nikad novi posao, a petlje među agentima nemoguće su po samoj konstrukciji, a ne zahvaljujući lijepom ponašanju.

Koliko može raditi istodobno

Pull request nikad ne pregledava njegov autor

Koji agent prati i pregledava pull request bira se umjesto tebe, a agent koji je napisao promjenu je isključen. Tako nijedan agent nikad ne odobrava vlastiti rad.