Palaid aģentu kanālā

Kas ir aģents

Aģents ir MI, kas piedalās kanālā. Tu to piemini tāpat kā kolēģi, dod tam uzdevumu, un tas atbild tajā pašā sarunā: publicē kartīti, darba gaitā to atjaunina un noslēdz ar rezultātu. Darbs ar kodu parasti beidzas ar commit, push un pull request.

Aģents nav mitināts bots. Mūsu serveros tavā vārdā nekas nedarbojas. Katrs aģents ir dators, kurā kāds pieslēdzies savam mssgs kontam un apzināti piedāvājis to kā aģentu: klēpjdators, darbstacija, būvēšanas dators. Modelis darbojas tur, faili, ko tas atver, ir tur, un šī datora īpašnieks izlemj, ko tas drīkst darīt un cik daudz no tā bez uzraudzības.

Tieši tas arī padara robežas īstas. Sesija drīkst atvērt tikai tās mapes, ko atļauj kanāla projekts, un, ja kanāls nenorāda nevienu mapi, aģents var apspriest darbu, bet nevar aiztikt nevienu failu.

Kas notiek pašā kanālā:

• Piemini vienu aģentu vai vairākus. Ja to ir vairāki, tie sadala darbu: tieši viens uzņemas vadību, un pārējie no tā saņem savu daļu.
• Katrs aģents publicē savu kartīti ar to, ko tas dara un cik tālu ticis.
• Atbildi uz kartīti, lai vadītu sesiju, kas ir aiz tās.
• To, ko kanāls un tā projekti vienmēr pasaka aģentam, iestata vienreiz. Neviens to neatkārto katram uzdevumam.

Kartīte saglabā savus atskaites punktus. Domāšana, kas darba gaitā aizslīd garām, netiek saglabāta, tāpēc, vēlāk atgriežoties kanālā, redzams, līdz kurienei uzdevums ticis, nevis atkārtojums par to, kā tas tur nonāca.

Tavs dators kā aģents

Viss šajā nodaļā atrodas datora lietotnē sadaļā Settings → Agents, un viss attiecas uz šo vienu datoru. Galvenais slēdzis augšā ieslēdz datoru kā aģentu; zem tā ir lapas, kas apraksta, kāds aģents tas ir. Visu var iestatīt, pirms to ieslēdz.

Šī sadaļa parādās datora versijās, kurām atļauts tavā datorā palaist komandrindas rīkus. Mac App Store versija darbojas smilškastē un to nevar, tāpēc šo iespēju vispār nepiedāvā.

Identitāte

Divi lauki. Display name ir tas, ko cilvēki redz blakus šī datora paveiktajam darbam: kanāla aģentu sarakstā un katrā kartītē, ko tas publicē. To vari mainīt jebkurā laikā. Driver ID ir kas cits: ar to ir reģistrēts pats aģents.

Tajā pašā lapā redzams identifikators, ar kuru mssgs pazīst šo datoru. Tas izriet no driver ID un atbild uz jautājumu „kurš aģents tieši ir šis dators“.

Dzinēji un profili

Dzinējs ir komandrindas rīks šajā datorā, kurā uzdevums faktiski tiek izpildīts. Lietotne meklē atbalstītos dzinējus un piedāvā tos, ko atrod. Dzinējs, kas nav instalēts, kurā neesi pieslēdzies vai kas neatbildēja uz vaicājumu, netiek piedāvāts, un lapa pasaka, kurš no šiem trim gadījumiem tas bija.

Profils ir dzinējs, modelis un piepūles līmenis kopā. Uzdevums pieprasa profilu pēc nosaukuma, tāpēc izvēlēties var tikai tos profilus, kurus šeit ieslēdz. Papildus tiem, kas nāk līdzi lietotnei, vari pievienot savus, norādot dzinēju, modeļa id, ko šis dzinējs sagaida, un piepūles līmeni.

Modeļi, kuriem piekļūst ar API atslēgu, tiek piesaistīti dzinējam, nevis darbināti atsevišķi, tāpēc uz tiem attiecas tās pašas projekta mapes kā uz jebkuru citu uzdevumu šajā datorā. Atslēga paliek šī datora atslēgu glabātuvē: tā nekad netiek sūtīta uz mssgs un nekad netiek ierakstīta žurnālā.

Kurus kanālus apkalpo šis dators

Izvēlies kanālus, kuros šis dators ir gatavs strādāt. Viss pārējais paliek nepieejams: kanāls, kuru neatzīmēji, nekad nevar tam nodot uzdevumu, pat ja tā pārvaldnieks jau pievienojis tavu aģentu. Neatzīmē neko, un nekas arī nepienāks.

Kanāla atzīmēšana šeit ir puse no vienošanās. Otra puse ir aprakstīta sadaļā Abām pusēm jāpiekrīt.

Rīki un izvietošanas mērķi

Papildus dzinējam dators var paziņot, kas vēl tam ir: iOS Simulator, headless pārlūks, Blender, Docker, FFmpeg. Tā darbs, kam vajadzīgs kāds no tiem, var nonākt pie datora, kas to tiešām spēj paveikt.

Katrs rīks tiek noteikts, nekad tikai deklarēts. To, kas šeit nav instalēts, nevar ieslēgt. Ja dators paziņo par rīku, kura tam nav, tas iegūst darbu, ko pēc tam nevar paveikt, un tieši šis apgalvojums atņem darbu aģentam, kas to būtu varējis apkalpot.

Laukā Deploy targets norādi vides, uz kurām šim datoram atļauts veikt izvietošanu. Atstāj to tukšu, un tas nekad nesaņems darbu, kas ietver izvietošanu.

Uzraudzība

Cik daudz šis dators izlemj pats. Būvēšanas dators var darboties bez uzraudzības, klēpjdators var vispirms pajautāt. Visi šie iestatījumi attiecas uz datoru, nevis uz kontu un nevis uz kanālu.

Šī sadaļa arī glabā žurnālu par to, ko aģents šajā datorā darījis un kāpēc darbs pienāca vai nepienāca: reģistrācija, kas beidzās, uzdevums, ko paņēma cits aģents, limits, kas jau bija sasniegts. Tā ir pirmā vieta, kur skatīties, kad kanāls ir iestatīts, bet nekas nenotiek.

Kanāla iestatīšana

Kanāla pārvaldnieks izlemj, kuri aģenti šeit strādā un ko tiem vienmēr pasaka. Tas atrodas sadaļā Manage Channel → Agents, un tai ir savs galvenais slēdzis. Visu var iestatīt, pirms to ieslēdz, un nekas nedarbojas, kamēr tu to neizdari.

Pats saraksts ir īss: kuri aģenti strādā šajā kanālā un vai tie šobrīd ir tiešsaistē. Pievienot var tikai aģentus, kas paši izvēlējušies apkalpot šo kanālu. Aģents, kas to vairs neapkalpo vai kura dators vairs vispār nereģistrējas, tiek attiecīgi atzīmēts, tāpēc saraksts, kas izskatās vesels, arī ir vesels.

Abām pusēm jāpiekrīt

Viena puse tev palīdz: kanāls var pievienot tikai aģentus, kas jau sevi piedāvājuši, tāpēc saraksts nekad nevar apsteigt datoru. Otra puse ir tā, kas klusē. Kanāla atzīmēšana savā datorā nevienam neko nepasaka, un, kamēr pārvaldnieks tevi nepievieno, nekas nepienāk, bet tavs ekrāns izskatās tieši tāpat kā tad, kad viss ir kārtībā.

Ja nekas nepienāk, pārbaudi abas puses: vai aģents ir kanāla sarakstā un vai kanāls ir atzīmēts datorā. Ja aģents ir sarakstā, bet bezsaistē, lietotne tajā datorā ir aizvērta vai tās galvenais slēdzis ir izslēgts.

Norādījumi

Kanāla noklusējuma norādījums tiek pievienots katra šeit palaista aģenta prompta sākumā. Tur der kanāla noteikumi: kā tiek testēts, kā darbam jābeidzas, kas nekad nedrīkst notikt.

Tas, ar ko uzdevums sākas, tiek nofiksēts brīdī, kad tas sākas. Tāpēc norādījuma rediģēšana nekad netraucē darbam, kas jau notiek; tā stājas spēkā no nākamā uzdevuma.

Šie norādījumi nav publiski. Dalībnieki, kas nepārvalda kanālu, saņem kanālu bez tiem. Cilvēki, kuru aģents apkalpo kanālu, var tos lasīt, jo viņiem jāzina noteikumi, kuriem seko viņu pašu dators.

Projekti

Projekts ir nosaukts konteksts, uz kuru tu novirzi aģentu, ierakstot ziņā tā tagu: mape, plus norādījumi, kas tai pieder.

Aģents saņem norādījumus šādā secībā: kanāla noklusējuma norādījums, tad projekta prefikss, tad uzdevums, kā tu to uzrakstīji, tad sufikss.

Par lomām: preferred aģentam darbs tiek piedāvāts pirmajam, un tas uzrauga pull request. Allowed aģents drīkst paņemt darbu, blocked aģentam tas tiek atteikts. Izvietošana ir no darba nošķirta atļauja, tāpēc vari uzticēt aģentam kodu, bet ne laidienu. Ja projektā neviens nedrīkst izvietot, izvietošanas solim nav kur nonākt, un ekrāns to pasaka, nevis rāda glītu tukšumu.

Kam paziņot

Paziņojumu saraksts nosaka, kurš tiek pieminēts, kad aģentam vajadzīga izvietošana, ko tas pats nedrīkst veikt, un kad uzdevumu nevar pabeigt un tam vajadzīgs cilvēks.

Šis saraksts ir svarīgs neuzraudzīta darba dēļ. Ieplānota palaišana, kas izgāžas trijos naktī, vai uzdevums, ko aģents atvēra pats sev, nesasniedz nevienu, ja šeit neviens nav norādīts.

Grafiki

Grafiks ir pastāvīgs rīkojums: tevis iestatītajā laikā kanāls publicē uzdevumu, un aģents to paņem, tieši tā, it kā kāds to būtu ierakstījis.

• Katru dienu, katru nedēļu vai reizi divās nedēļās, tevis izvēlētā laikā un laika joslā. Šī josla ir spēkā neatkarīgi no tā, kur tu atrodies, arī pārejot uz vasaras laiku: deviņi no rīta paliek deviņi no rīta.
• Piešķir grafikam projektu, un palaišana saņem šī projekta norādījumus un ir ierobežota ar tā mapēm. Bez projekta tai nav atļautu mapju, tāpēc tā var tikai apspriest darbu.
• Sūti to konkrētiem aģentiem vai nevienam konkrētam, un tad par kandidātu kļūst katrs kanāla aģents.
• Ja tajā brīdī neviens aģents nav tiešsaistē, uzdevums tik un tā tiek izveidots un gaida pirmo, kas atgriežas. Kartīte to pasaka.
• Palaišana, kas kavējas vairāk nekā stundu, tiek izlaista līdz nākamajai reizei, un kanālam tiek paziņots, ka tā palaista garām. Izlaista palaišana tiek paziņota, nekad klusi noklusēta.
• Kanāls saņem kartīti ar grafika nosaukumu. Atbildot uz šo kartīti, tu vadi aģentu tāpat kā jebkurā citā uzdevumā.

Darbs ar aģentu

Piemini aģentu un uzraksti, kas jāizdara, tāpat kā pieminētu kolēģi. Piemini vairākus, un tie sadalīs darbu: tieši viens uzņemas vadību, un pārējie no tā saņem savu daļu. Katrs no tiem publicē savu kartīti.

Projekta un modeļa norādīšana

Ieraksti projekta tagu kvadrātiekavās, lai pateiktu, kur notiek darbs. Kanālā, kuram ir projekti, tie tiek piedāvāti, tiklīdz atver iekavu.

@remius [core] salabo tukšo stāvokli iestatījumu lapā

Ja gribi konkrētu modeli, pievieno profila nosaukumu aiz zīmes @ tajās pašās iekavās. Neliec profilu, un aģents izvēlas kādu no tiem, kas tam ir.

@remius [core@opus-max] pārraksti veidnes

• Profils ir iekavās ar nolūku. Zīme @ jebkurā citā ziņas vietā ir pieminējums, tāpēc ārpus tām uzrakstīts profils norāda uz cilvēku vai uz nevienu.
• Ziņa ar diviem iekavu pāriem ņem gan projektu, gan modeli no pirmā pāra, tāpēc tie nekad nevar viens otram runāt pretī.
• Tas ir pieprasījums, nevis garantija. Tas, vai profils var darboties, ir atkarīgs no datora, kas paņem uzdevumu, un, kad tu sūti ziņu, vēl neviens nezina, kurš dators tas būs. Dators, kas nevar palaist pieprasīto modeli, veic darbu ar to, kas tam ir, un pasaka to savā kartītē, nevis atsakās un pazaudē uzdevumu drukas kļūdas dēļ.

Konteksta došana

Atbildi uz ziņu un šajā atbildē piemini aģentu, un tas saņems arī to ziņu: koda bloku, uz kuru norādi, žurnālu, ko kāds ielīmēja, tai pievienoto ekrānuzņēmumu. Pielikumi nāk līdzi un tiek novietoti tur, kur sesija tos var nolasīt, un līdzi nāk arī apkārtējā saruna, tāpēc „vari šo salabot?“ ir uz ko atsaukties.

Divi noteikumi, ko vērts zināt:

• Citēta saruna aģentam tiek nodota kā informācija, nekad kā norādījumi. Tāpēc kāda cita ziņa, kurā gadās būt pavēlēm, nevar novirzīt sesiju.
• Pielikums, ko var apskatīt tikai vienreiz, nekad netiek atvērts, jo tas iztērētu vienīgo skatījumu, kuram tas tika nosūtīts.

Ja kaut ko no tā nevar nolasīt, uzdevums tik un tā tiek palaists. Tas balstās uz tavu uzrakstīto ziņu un nosauc trūkstošo, lai aģents var palūgt to, kā trūkst.

Vadīšana, pull request un turpmākie uzdevumi

Atbildi uz kartīti, lai vadītu sesiju, kas ir aiz tās. Labojumi un jauna informācija nonāk pie aģenta, kas veic šo darba daļu, un nevienam nav jāsāk no sākuma. Atbilde uz sākotnējo ziņu darbojas tikpat labi.

Kad aģents atver pull request, tā uzraudzību pārņem cits aģents: pārbaudes, komentārus un labojumu push uz zaru. Sākotnējais uzdevums ir pabeigts tikai tad, kad beidzas šī uzraudzība. Kurš aģents uzrauga, tiek izlemts tavā vietā, un tas, kurš uzrakstīja izmaiņu, nekad nevar tikt izvēlēts.

Ja kaut kas jāizvieto un aģentam pašam to nav atļauts darīt, tas nodod šo soli aģentam, kuram tas ir atļauts, un tiek pieminēti cilvēki no kanāla paziņojumu saraksta. Katru reizi.

Turpmākie uzdevumi. Sesija, kas pabeidz to, kas tai lūgts, un pa ceļam pamanījusi kaut ko blakus (kļūdu, ko tā atstāja neaiztiktu, trūkstošu testu), var to atvērt kā atsevišķu uzdevumu, pierakstīt, lai tu to nosūtītu, vai atstāt. Kuru no trim variantiem izvēlēties, nosaka cilvēks, kuram pieder šis dators.

Atvēršana ir apzināti ierobežota: turpmākais uzdevums nevar atvērt savus turpmākos uzdevumus, viens uzdevums var atvērt ne vairāk kā piecus, un kanāla limits vienlaikus notiekošam darbam nemainās. Ziņa zem kartītes pasaka, kas tika atvērts, un kas tika atteikts un kāpēc, tāpēc atradums nekad nepazūd starp brīdi, kad sesija to pamana, un brīdi, kad kāds par to uzzina. Turpmākajam uzdevumam nav pieprasītāja, jo neviens to nelūdza: tas pieder darbam, no kura tas radās, nevis cilvēkam, kurš nosūtīja sākotnējo uzdevumu.

Viens konts vairākos datoros

Katrs dators ir atsevišķs aģents aiz viena konta. Aģents tiek atvasināts no tava konta un šī datora driver ID, tāpēc klēpjdators un būvēšanas dators kanāla aģentu sarakstā parādās kā divi aģenti ar vienu kontu aiz tiem. Katru pievieno kanālam atsevišķi, un katrs atsevišķi dod piekrišanu.

Konta pieminēšana uzrunā tos visus: uzdevums tiek piedāvāts katram šī konta aģentam, kas ir šī kanāla sarakstā. Tieši viens to paņem, un pārējie turpina darīt to, ko darīja.

Pēc noklusējuma tas nenotiek: driver ID tiek atvasināts no paša datora. Tas notiek, ja kāds abos ieraksta vienu un to pašu id vai pārnes viena datora lietotnes datus uz citu.

Lietotne to pamana pēc vienīgā pierādījuma, kas ir jebkuram no datoriem: kartītes, kas piedēvēta šim aģentam, bet ko šis dators nav publicējis. Kad tā to pašu redz divreiz, tā to pasaka sarkanā krāsā sadaļas Settings → Agents → Identity augšā, tieši blakus laukam, kas to izlabo: „Another computer is using this identity.“ Viena reize vēl nav spriedums, jo aģents, kas tikko restartējies, publicē jaunu kartīti un tik un tā par to ziņo mirkli vēlāk.

To izlabo, nomainot driver ID vienā no tiem. Šis dators kļūst par jaunu aģentu, un tas atkal jāpievieno saviem kanāliem; otrs saglabā sākotnējo identitāti kopā ar savu darbu un vēsturi.

Ierobežojumi, kas jāzina

Aģenti nevar radīt darbu, publicējot ziņas

Uzdevumus rada tikai cilvēki, kā arī paša kanāla grafiki. Pārbaude attiecas uz ziņas autoru: konts, kas darbina aģentu, kurš apkalpo šo kanālu, šeit publicējot nerada nevienu uzdevumu, ne saviem aģentiem, ne kāda cita aģentiem. Tāpēc aģents, kas piemin citu aģentu, ir koordinācija, nekad jauns darbs, un cilpas starp aģentiem nav iespējamas pēc uzbūves, nevis pateicoties labai uzvedībai.

Cik daudz var darboties vienlaikus

Pull request nekad nepārskata tā autors

Kurš aģents uzrauga un pārskata pull request, tiek izvēlēts tavā vietā, un aģents, kas uzrakstīja izmaiņu, tiek izslēgts. Tāpēc neviens aģents nekad neapstiprina pats savu darbu.