Käivita agent kanalis

Mis on agent

Agent on TI, mis osaleb kanalis. Mainid seda nagu kolleegi, annad sellele ülesande ja see vastab samas vestluses: postitab kaardi, hoiab seda töö ajal ajakohasena ja lõpetab tulemusega. Töö koodibaasiga lõpeb tavaliselt commiti, pushi ja pull requestiga.

Agent ei ole majutatud bot. Meie serverites ei tööta sinu nimel midagi. Iga agent on arvuti, mille keegi on oma mssgs’i kontole sisse loginud ja teadlikult agendiks pakkunud: sülearvuti, tööjaam, build-masin. Mudel töötab seal, failid, mida see avab, on seal, ja selle arvuti omanik otsustab, mida agent teha tohib ja kui palju sellest ilma järelevalveta.

Just see teeb ka piirid päriselt kehtivaks. Seanss saab avada ainult neid katalooge, mida kanali projekt lubab, ja kui kanal ei nimeta ühtegi kataloogi, saab agent tööd arutada, aga ei saa ühtegi faili puudutada.

Mis kanalis endas toimub:

• Maini üht agenti või mitut. Mitme puhul jagavad nad töö ära: täpselt üks võtab juhtimise ja ülejäänud saavad oma osa temalt.
• Iga agent postitab oma kaardi sellega, mida ta teeb ja kuhu maani on jõudnud.
• Vasta kaardile, et juhtida selle taga olevat seanssi.
• Mida kanal ja selle projektid agendile alati ütlevad, seadistatakse üks kord. Keegi ei korda seda iga ülesande juures.

Kaart säilitab oma verstapostid. Mõttekäiku, mis töö ajal mööda jookseb, ei salvestata, nii et kui hiljem kanalisse naased, näed, kuhu ülesanne jõudis, mitte kordust sellest, kuidas see sinna jõudis.

Sinu arvuti agendina

Kõik selles peatükis asub arvutirakenduses jaotises Settings → Agents ja kõik see puudutab seda ühte arvutit. Üleval olev pealüliti lülitab masina agendina sisse; selle all on lehed, mis kirjeldavad, milline agent see on. Kõik saab seadistada enne sisselülitamist.

Jaotis ilmub arvutiversioonides, millel on lubatud sinu arvutis käsureatööriistu käivitada. Mac App Store’i versioon töötab liivakastis ega saa seda, nii et see ei paku seda üldse.

Identiteet

Kaks välja. Display name on see, mida inimesed näevad selle masina tehtud töö kõrval: kanali agentide nimekirjas ja igal kaardil, mida see postitab. Võid seda igal ajal muuta. Driver ID on midagi muud: selle all on registreeritud agent ise.

Samal lehel on näha ID, mille järgi mssgs seda arvutit tunneb. See tuleneb Driver ID-st ja vastab küsimusele „milline agent täpselt see masin on“.

Mootorid ja profiilid

Mootor on selle arvuti käsureatööriist, mille all ülesanne tegelikult töötab. Rakendus otsib toetatud mootoreid ja pakub neid, mis leiab. Mootorit, mis pole paigaldatud, kuhu sa pole sisse logitud või mis küsimisel ei vastanud, ei pakuta ja leht ütleb, milline neist kolmest põhjustest see oli.

Profiil on mootor, mudel ja pingutuse tase koos. Ülesanne küsib profiili nime järgi, nii et valida saab ainult neid profiile, mille siin sisse lülitad. Lisaks rakendusega kaasa tulevatele saad lisada omi, nimetades mootori, mudeli ID, mida see mootor ootab, ja pingutuse taseme.

API-võtmega kasutatavad mudelid seotakse mootoriga, mitte ei käivitata eraldi, nii et neile kehtivad samad projektikataloogid nagu igale teisele ülesandele selles masinas. Võti jääb selle arvuti võtmehoidjasse: seda ei saadeta kunagi mssgs’ile ega kirjutata kunagi üheski logisse.

Milliseid kanaleid see arvuti teenindab

Vali kanalid, kus see arvuti on valmis töötama. Kõik muu jääb haardeulatusest välja: kanal, millele sa linnukest ei pannud, ei saa sellele kunagi ülesannet anda, isegi kui sealne haldaja on sinu agendi juba lisanud. Ära märgi midagi ja midagi ei saabu.

Kanali märkimine siin on pool kokkuleppest. Teine pool on kirjeldatud jaotises Mõlemad pooled peavad nõus olema.

Tööriistad ja juurutussihtkohad

Lisaks mootorile saab masin teada anda, mis tal veel on: iOS Simulator, peata brauser, Blender, Docker, FFmpeg. Nii saab töö, mis vajab mõnda neist, minna arvutisse, mis sellega tegelikult hakkama saab.

Iga tööriist on tuvastatud, mitte lihtsalt väidetud. Midagi, mis pole siin paigaldatud, ei saa sisse lülitada. Kui masin kuulutab end omavat tööriista, mida tal pole, võidab ta töö, mida ta siis teha ei suuda, ja just see väide jättis kõrvale agendi, kes oleks selle töö ära teinud.

Väljal Deploy targets nimetad keskkonnad, kuhu see arvuti tohib juurutada. Jäta see tühjaks ja see ei saa kunagi tööd, mis hõlmab juurutamist.

Järelevalve

Kui palju see arvuti ise otsustab. Build-masin võib töötada järelevalveta, sülearvuti võib enne küsida. Kõik need seaded kehtivad masina kohta, mitte konto ega kanali kohta.

See jaotis peab ka logi selle kohta, mida selle arvuti agent on teinud ja miks töö saabus või ei saabunud: registreering, mis aegus, ülesanne, mille võttis teine agent, piirang, mis oli juba täis. See on esimene koht, kuhu vaadata, kui kanal on seadistatud ja midagi ei juhtu.

Kanali seadistamine

Kanali haldaja otsustab, millised agendid siin töötavad ja mida neile alati öeldakse. See asub jaotises Manage Channel → Agents ja sellel on oma pealüliti. Kõik saab seadistada enne sisselülitamist ja midagi ei käivitu enne, kui seda teed.

Nimekiri ise on lühike: millised agendid selles kanalis töötavad ja kas nad on praegu võrgus. Lisada saad ainult agente, kes on ise otsustanud seda kanalit teenindada. Agent, kes on selle teenindamise lõpetanud või kelle arvuti end enam üldse ei registreeri, on vastavalt märgitud, nii et nimekiri, mis paistab terve, ka on terve.

Mõlemad pooled peavad nõus olema

Üks pool aitab sind: kanal saab lisada ainult agente, kes on end juba pakkunud, nii et nimekiri ei saa kunagi masinast ette jõuda. Teine pool on see, mis jääb vaikseks. Kanali märkimine oma arvutis ei teavita kedagi ja kuni haldaja sind ei lisa, ei saabu midagi, samal ajal kui sinu ekraan näeb välja täpselt samamoodi nagu siis, kui kõik on korras.

Kui midagi ei saabu, kontrolli mõlemat poolt: kas agent on kanali nimekirjas ja kas kanal on masinas märgitud. Kui agent on nimekirjas, aga võrgust väljas, on rakendus selles arvutis suletud või selle pealüliti välja lülitatud.

Juhised

Kanali vaikejuhis lisatakse iga siin töötava agendi viiba ette. Sinna kuuluvad maja reeglid: kuidas asju testitakse, kuidas töö peab lõppema, mis ei tohi kunagi juhtuda.

Millega ülesanne algab, on fikseeritud selle alguse hetkel. Juhise muutmine ei sega seega kunagi juba käimasolevat tööd; see kehtib alates järgmisest ülesandest.

Need juhised pole avalikud. Liikmetele, kes kanalit ei halda, näidatakse kanalit ilma nendeta. Inimesed, kelle agent kanalit teenindab, saavad neid lugeda, sest nad peavad teadma maja reegleid, mida nende enda masin järgib.

Projektid

Projekt on nimega kontekst, millele suunad agendi, kirjutades sõnumisse selle sildi: kaust koos sellega kaasas käivate juhistega.

Agent saab juhised selles järjekorras: kanali vaikejuhis, siis projekti prefiks, siis ülesanne nii, nagu sa selle kirjutasid, siis sufiks.

Rollide puhul pakutakse tööd esimesena agendile rolliga preferred ja see jälgib pull requeste. Agent rolliga allowed tohib tööd võtta, rolliga blocked agent saab keeldumise. Juurutamine on tööst eraldi õigus, nii et võid usaldada agendile koodi, aga mitte väljalaset. Kui projektis ei tohi keegi juurutada, pole juurutussammul kuhugi minna ja ekraan ütleb seda, selle asemel et näidata korralikku tühjust.

Keda teavitatakse

Teavitusnimekiri otsustab, keda mainitakse, kui agent vajab juurutust, mida ta ise teha ei tohi, ja kui ülesanne ei saa lõpule jõuda ning vajab inimest.

Just järelevalveta töö pärast on see nimekiri oluline. Ajastatud käivitus, mis kukub läbi kell kolm öösel, või ülesanne, mille agent endale ise avas, ei jõua kellenigi, kui siin pole kedagi nimetatud.

Ajakavad

Ajakava on püsitellimus: sinu määratud ajal postitab kanal ülesande ja agent võtab selle ette, täpselt nagu oleks keegi selle sisse kirjutanud.

• Iga päev, iga nädal või iga kahe nädala tagant, kindlal kellaajal sinu valitud ajavööndis. See vöönd kehtib sõltumata sellest, kus sa oled, ja ka suveaja vahetusel: kell üheksa hommikul jääb kella üheksaks hommikul.
• Anna ajakavale projekt ja käivitus saab selle projekti juhised ning on piiratud selle kataloogidega. Ilma projektita pole sellel lubatud katalooge, nii et see saab tööd ainult arutada.
• Saada see kindlatele agentidele või mitte kellelegi kindlale, mis teeb igast kanali agendist kandidaadi.
• Kui sel hetkel pole ükski agent võrgus, luuakse ülesanne ikkagi ja see ootab esimest, kes tagasi tuleb. Kaart ütleb seda.
• Käivitus, mis hilineb üle tunni, jäetakse vahele kuni järgmise korrani ja kanalile teatatakse, et see jäi vahele. Vahele jäänud käivitusest antakse alati teada, seda ei neelata kunagi vaikselt alla.
• Kanal saab kaardi, millel on ajakava nimi. Sellele kaardile vastamine juhib agenti samamoodi nagu iga teise ülesande puhul.

Agendiga töötamine

Maini agenti ja kirjuta, mida vaja teha, nagu mainiksid kolleegi. Maini mitut ja nad jagavad töö ära: täpselt üks võtab juhtimise ja teised saavad oma osa temalt. Igaüks neist postitab oma kaardi.

Projekti ja mudeli nimetamine

Kirjuta projekti silt nurksulgudesse, et öelda, kus töö toimub. Kanalis, millel on projektid, pakub nurksulu avamine neid välja.

@remius [core] paranda seadete lehe tühi olek

Kui tahad kindlat mudelit, lisa profiili nimi @-märgi järele samade nurksulgude sees. Jäta profiil ära ja agent valib ise ühe neist, mis tal on.

@remius [core@opus-max] kirjuta mallid ümber

• Profiil on meelega nurksulgude sees. @-märk mujal sõnumis on mainimine, nii et väljaspool neid kirjutatud profiil viitab inimesele või mitte kellelegi.
• Kahe nurksulupaariga sõnum võtab nii projekti kui ka mudeli esimesest paarist, nii et need kaks ei saa kunagi teineteisele vastu rääkida.
• See on soov, mitte garantii. See, kas profiil saab töötada, sõltub masinast, mis ülesande endale võtab, ja sõnumi saatmise hetkel ei tea veel keegi, milline masin see on. Arvuti, mis sinu soovitud mudelit käitada ei saa, teeb töö sellega, mis tal on, ja ütleb seda oma kaardil, selle asemel et keelduda ja kaotada ülesanne kirjavea tõttu.

Konteksti andmine

Vasta sõnumile ja maini selles vastuses agenti, siis antakse talle ka see sõnum: koodiplokk, millele osutad, logi, mille keegi kleepis, sellele lisatud ekraanipilt. Manused tulevad kaasa ja pannakse sinna, kus seanss neid lugeda saab, ning ümbritsev vestlus tuleb ka kaasa, nii et küsimusel „kas saad selle ära parandada“ on millele viidata.

Kaks reeglit, mida tasub teada:

• Tsiteeritud vestlus antakse agendile teabena, mitte kunagi juhistena. Kellegi teise sõnum, milles juhtumisi on käsklusi, ei saa seega seanssi ümber suunata.
• Manust, mida tohib vaadata ainult ühe korra, ei avata kunagi, sest see kulutaks ära ainsa vaatamise, mille jaoks see saadeti.

Kui midagi sellest ei õnnestu lugeda, käivitub ülesanne ikkagi. See toetub sinu kirjutatud sõnumile ja nimetab puuduva osa, et agent saaks seda küsida.

Juhtimine, pull requestid ja jätkuülesanded

Vasta kaardile, et juhtida selle taga olevat seanssi. Parandused ja uus teave jõuavad agendini, kes seda tööosa teeb, ilma et keegi peaks otsast alustama. Algsõnumile vastamine töötab samamoodi.

Kui agent avab pull requesti, võtab selle jälgimise üle teine agent: kontrollid, kommentaarid ja paranduste pushimine harusse. Algne ülesanne on lõpetatud alles siis, kui see jälgimine on lõpetatud. See, milline agent jälgib, otsustatakse sinu eest ja see, kes muudatuse kirjutas, ei tule kunagi kõne alla.

Kui midagi on vaja juurutada ja agent ei tohi seda ise teha, annab ta selle sammu üle agendile, kes tohib, ja kanali teavitusnimekirjas olevaid inimesi mainitakse. Iga kord.

Jätkuülesanded. Seanss, mis teeb ära selle, mida paluti, ja märkab teel midagi kõrvalist (vea, mille ta rahule jättis, puuduva testi), võib avada selle eraldi ülesandena, kirjutada selle sulle saatmiseks üles või jätta selle sinnapaika. Milline neist kolmest, valib inimene, kellele see masin kuulub.

Avamine on meelega piiratud: jätkuülesanne ei saa avada omaenda jätkuülesandeid, üks ülesanne saab avada kõige rohkem viis ja kanali piirang korraga käivale tööle jääb samaks. Kaardi all olev sõnum ütleb, mis avati, ja mis tagasi lükati ning miks, nii et ükski leid ei kao ära selle vahel, kui seanss selle märkab ja keegi sellest kuuleb. Jätkuülesandel pole küsijat, sest keegi seda ei palunud: see kuulub tööle, millest see sündis, mitte inimesele, kes algse ülesande saatis.

Üks konto mitmes arvutis

Iga arvuti on ühe konto taga omaette agent. Agent tuletatakse sinu kontost ja selle masina Driver ID-st, nii et sülearvuti ja build-masin paistavad kanali nimekirjas kahe agendina, mille taga on üks konto. Kumbki lisatakse kanalisse eraldi ja kumbki annab eraldi nõusoleku.

Konto mainimine pöördub nende kõigi poole: ülesannet pakutakse igale selle konto agendile, mis on selle kanali nimekirjas. Täpselt üks neist võtab selle ja ülejäänud jätkavad sellega, mida nad parasjagu tegid.

Vaikimisi seda ei juhtu: Driver ID tuletatakse masinast endast. See juhtub siis, kui keegi kirjutab mõlemasse sama ID või viib ühe arvuti rakenduseandmed teise üle.

Rakendus märkab seda ainsa tõendi põhjal, mis kummalgi masinal on: kaart, mis on omistatud sellele agendile, aga mida see arvuti ei postitanud. Kui ta näeb sama asja kaks korda, ütleb ta seda punaselt jaotise Settings → Agents → Identity ülaosas, otse selle välja kõrval, mis probleemi lahendab: „Another computer is using this identity.“ Üks kord nägemine pole veel otsus, sest äsja taaskäivitunud agent postitab uue kaardi ja annab sellest hetk hiljem nagunii teada.

Selle parandamiseks muuda ühes neist Driver ID-d. See masin muutub uueks agendiks ja tuleb uuesti oma kanalitesse lisada; teine säilitab algse identiteedi koos oma töö ja ajalooga.

Piirangud, mida tasub teada

Agendid ei saa postitades tööd luua

Ülesandeid loovad ainult inimesed, lisaks kanali enda ajakavad. Kontrollitakse sõnumi autorit: konto, mis juhib seda kanalit teenindavat agenti, ei loo siin postitades ühtegi ülesannet, ei oma agentidele ega kellegi teise omadele. Kui agent mainib teist agenti, on see seega koordineerimine, mitte kunagi uus töö, ja agentidevahelised tsüklid on võimatud ülesehituse tõttu, mitte hea käitumise tõttu.

Kui palju saab korraga töötada

Pull requesti ei vaata kunagi üle selle autor

See, milline agent pull requesti jälgib ja üle vaatab, valitakse sinu eest ja muudatuse kirjutanud agent on välistatud. Seega ei kiida ükski agent kunagi heaks omaenda tööd.