Įskiepiai „Telegram“ AI agento robotui: diegimas ir patikra

Mano agentas veikia serveryje, o komandas jam siunčiu per „Telegram“: rašau pokalbyje, jis skaito failus, vykdo užduotis ir atsiunčia man rezultatą. Galiausiai pasiekiama riba: pagrindinis robotas gali labai nedaug, o jūs norite, kad jis peržiūrėtų kodą, sukurtų „GitHub“ įrašą arba parengtų suplanuotą suvestinę. Sprendimas – įskiepiai.

Žmonės būtent dėl to ieško „kaip įdiegti įskiepį „Telegram““. Jie nekalba apie lipdukų parduotuvę. Jie nori sužinoti, kaip suteikti robotui naujų gebėjimų. Toliau žingsnis po žingsnio paaiškinsiu, kas yra įskiepis, kur jis iš tikrųjų įdiegiamas, kaip jį įdiegti per penkias minutes ir kaip apsaugoti agentą nuo kenkėjiško kodo. Šis aprašymas parengtas remiantis oficialia dokumentacija.

Praktinės informacijos apie darbą su „Ailoot“ rasite dokumentacijoje.

Kas yra AI agento įskiepis, paprastai tariant?#

Paaiškinkime išsamiau. Vos paleistas AI agentas gali atlikti pagrindines užduotis: skaityti failus, rašyti kodą ir atsakyti į klausimus. Įskiepis – tai aplankas su papildomais gebėjimais, kuriuos agentas perima ir pradeda naudoti. Oficialioje „Claude Code“ dokumentacijoje įskiepis apibūdinamas būtent taip: jis išplečia agento galimybes įgūdžiais, atskirais pagalbiniais agentais, automatiniais veiksmais ir jungtimis su išorinėmis paslaugomis.

Štai paprastas pavyzdys. Įdiekite darbui su „GitHub“ skirtą įskiepį, ir agentas gaus komandas įrašui sukurti, „pull request“ atidaryti ir pakeitimų istorijai peržiūrėti. Įdiekite kodo peržiūros įskiepį, ir agentas pagal iš anksto parengtą kontrolinį sąrašą patikrins, ar jūsų kode nėra klaidų ir saugumo spragų. Nieko iš to nekonfigūravote rankiniu būdu: įskiepio autorius viską paruošė, o jums tereikėjo jį prijungti.

Dar vienas svarbus dalykas: įskiepis neišmoko agento ko nors „visam laikui“. Tai pašalinamas modulis. Prijunkite jį šiandien, atjunkite rytoj, ir robotas grįš prie gebėjimų, kuriuos turėjo prieš įskiepį. Todėl įskiepius patogu išbandyti: išsirinkite vieną, panaudokite realiai užduočiai, o jei jis jums netinka, pašalinkite be pėdsakų.

Kuo įskiepis skiriasi nuo įgūdžio, MCP ir pagalbinio agento?#

Su agentais susiję terminai gali klaidinti, todėl skirtumus apibendrinau lentelėje. Ji atsako ir į pusę pradedantiesiems kylančių klausimų.

„Claude Code“ pasaulyje jungtis su išorine paslauga vadinama MCP. Tai standartas, leidžiantis agentui pasiekti „GitHub“, duomenų bazę arba naršyklę. Pirmosios keturios lentelės eilutės – atskiri pagrindiniai elementai.

Pažvelkite į paskutinę eilutę. Įskiepis yra vienu lygmeniu aukščiau už kitus keturis elementus. Jis sujungia įgūdį, pagalbinį agentą, automatinį veiksmą ir MCP į vieną dėžutę. Autorius viską sudėjo, pridėjo aprašo failą ir paskelbė. Viena komanda gaunate paruoštą visumą, užuot atskirai rinkę keturias dalis.

Todėl galite vadovautis paprasta pasirinkimo taisykle. Jei užduočiai reikia vieno nedidelio gebėjimo, susikurkite įgūdį patys – tai užtruks penkiolika minučių. Jei jums reikia paruošto rinkinio iš žmonių, kurie jau išsprendė jūsų problemą, įsidiekite įskiepį. Turiu atskirą vadovą, kaip pasirinkti „Claude Code“ įgūdžius, kuriame taip pat paaiškinu, kaip neperkrauti agento papildomais įgūdžiais.

Ką reiškia „įdiegti įskiepį „Telegram““ ir kuo čia dėtas „Telegram“?#

Čia dažnai kyla painiava. Pats „Telegram“ įskiepių neturi: susirašinėjimo programėlė nesaugo roboto gebėjimų. Ji perduoda jūsų žinutes agentui ir rodo jo atsakymus. Agentas veikia kitur – jūsų nešiojamajame kompiuteryje arba serveryje, kuriame veikia, pavyzdžiui, „Hermes Agent“, „OpenClaw“ arba su pokalbiu susietas „Claude Code“.

Įskiepį galima įdiegti dviem būdais, ir abu veikia:

1. Tiesiai iš pokalbio. Parašykite agentui „Telegram“ programėlėje paprasta kalba: „įsidiek „GitHub“ įskiepį sau“. Agentas įdiegs jį savo kompiuteryje ir atsakys, kad jau paruošta. Tai patogu, kai serveris toli, o jūs turite telefoną.
2. Terminale. Prisijunkite prie kompiuterio, kuriame veikia agentas, ir ten įdiekite įskiepį komanda. Pirmą kartą šis būdas patikimesnis: matysite visą išvestį ir nieko nepraleisite.

Kurį būdą pasirinkti, priklauso nuo to, ar pasitikite robotu, kad jis be priežiūros pats diegs plėtinius. Pirmuosius įskiepius įdiegiau rankiniu būdu terminale, kad tiksliai matyčiau, kas prijungiama. Kai įgudau, pradėjau pasitikėti, kad agentas juos pats įdiegs iš pokalbio. Toliau parodysiu abu būdus.

Kaip įdiegti įskiepį agente per penkias minutes?#

Parodysiu, kaip tai atlikti su „Claude Code“, nes procesas išsamiai aprašytas dokumentacijoje ir jį lengva pakartoti. Komandos vienodos tiek terminale, tiek siunčiant jas agentui per „Telegram“.

1. Atidarykite įskiepių sąrašą. Komanda /plugin atidaro skydelį tiesiai terminale, kuriame yra kortelė su visais prieinamais plėtiniais ir katalogu adresu claude.com/plugins. Tai parduotuvė, kurioje galite pasižvalgyti prieš diegdami.
2. Prijunkite oficialią prekyvietę. Įveskite /plugin marketplace add anthropics/claude-plugins-official. Prekyvietė – tai katalogas, iš kurio agentas atsisiunčia įskiepius. Oficialiąją valdo „Anthropic“.
3. Įdiekite reikiamą įskiepį. Nurodykite įskiepio pavadinimą, po jo – prekyvietės pavadinimą; juos atskirkite ženklu @:

/plugin install github@claude-plugins-official

4. Iš naujo įkelkite įskiepius. Jei įdiegus robotas pasako “Run /reload-plugins to activate.”, paleiskite /reload-plugins. Kol jų neįkelsite iš naujo, naujos komandos dabartiniame pokalbyje nepasirodys. Jei gaunate įspėjimą, kad įkėlus iš naujo pokalbis bus perskaitytas dar kartą, pakartokite komandą taip: /reload-plugins --force.

Štai ir viskas. Dabar agentas turi įskiepio komandas. „Claude Code“ jos naudoja įskiepio pavadinimą kaip priešdėlį, pavyzdžiui, /commit-commands:commit, todėl iškart matote, kad komanda gauta iš įskiepio.

Kai komandą robotui siunčiate per „Telegram“, o ne naudojate terminalą, „Claude Code“ taip pat turi atskirą diegimo komandą be interaktyviojo skydelio: claude plugin install. Dokumentacijoje nurodoma viena svarbi detalė: ši komanda neįkelia įskiepio į jau atidarytą pokalbį. Agentas jį perims kitą kartą paleistas arba po /reload-plugins. Kitaip tariant, įdiegę turite iš naujo paleisti robotą, antraip naujų komandų negausite.

„Hermes Agent“ plėtiniai įjungiami ir išjungiami komanda hermes tools, o įgūdžiai laikomi atskirame aplanke. „OpenClaw“ veikia panašiai: prijunkite rinkinį ir iš naujo paleiskite robotą. Pavadinimai skiriasi, bet veiksmų seka ta pati: prijunkite šaltinį, įdiekite pagal pavadinimą ir iš naujo paleiskite agentą.

Įskiepiai yra vienas iš konteksto inžinerijos elementų: prieš pirmąją užklausą nusprendžiate, kokius gebėjimus agentas turės po ranka.

Iš kur gauti įskiepių ir kuriais galima pasitikėti?#

Įskiepis yra kito žmogaus kodas, turintis tokias pačias teises kaip jūsų agentas: prieigą prie failų, terminalo ir paslaugų. Todėl šaltinis svarbesnis už gražų aprašymą. Štai šaltiniai nuo patikimiausio iki keliančio daugiausia abejonių.

Norėdami įdiegti iš bendruomenės prekyvietės, naudokite panašią komandą, tik nurodykite kitą prekyvietę: /plugin install plugin-name@claude-community. Dokumentacijoje konkrečiai nurodoma, kad šie įskiepiai praėjo automatinę saugumo patikrą ir kiekvienas jų yra susietas su konkrečia kodo versija. Tai reiškia, kad gausite būtent patikrintą versiją, o autorius vėliau slapta nieko joje nepakeis.

Prieš diegdamas „Claude Code“ parodo skyrių “Will install”: komandų, pagalbinių agentų, įgūdžių, automatinių veiksmų ir jungčių, kurias pridės įskiepis, sąrašą. Perskaitykite jį. Taip galite pastebėti, pavyzdžiui, pastabų plėtinį, kuris kažkodėl prašo prieigos prie terminalo. Oficialioje dokumentacijoje taisyklė suformuluota aiškiai:

Paprastai tariant, oficialios ir patikrintos prekyvietės suteikia daugiau ramybės; atsitiktine „GitHub“ saugykla naudokitės tik perskaitę jos turinį ir supratę, kodėl jai reikia prašomų leidimų. Pasitikėjimas trečiųjų šalių kodu svarbus ne vien diegiant įskiepius – apie tai rašau straipsnyje apie vibe-coding saugumą.

Kaip patikrinti, ar įskiepis įdiegtas ir veikia „Telegram“?#

Skirkite minutę patikrai: tai, kad rodoma „įdiegta“, dar nereiškia, kad robotas iš tikrųjų perėmė įskiepį. Atlikite šiuos veiksmus:

1. Patikrinkite sąrašą. Vėl atidarykite /plugin skydelį arba paprašykite agento parodyti prieinamas komandas. Sąraše turėtų būti naujo įskiepio komandos, o „Claude Code“ atveju – su įskiepio pavadinimo priešdėliu.
2. Duokite bandomąją užduotį. Pasirinkite ką nors saugaus, o ne veikiančios sistemos užduotį. Jei įdiegėte „GitHub“ įskiepį, paprašykite parodyti naujausius įrašus. Jei įdiegėte peržiūros įskiepį, pateikite nedidelį failą. Tikrinkite vieną dalyką: ar robotas imasi užduoties naudodamas naują gebėjimą?
3. Patikrinkite tame pačiame pokalbyje, kurį naudojate darbui. Jei agentą valdote per „Telegram“, bandomąją komandą siųskite „Telegram“. Kartais įskiepis matomas terminale, bet pokalbyje esantis robotas jo dar neįkėlė iš naujo.

Dažniausia priežastis, kodėl įdiegtas įskiepis neveikia, yra tai, kad pamiršote jį įkelti iš naujo. Diegimo komanda įvykdyta sėkmingai, bet atvirame pokalbyje veikiantis agentas vis dar naudoja seną gebėjimų rinkinį. Padeda /reload-plugins; jei tai nepadeda, visiškai iš naujo paleiskite robotą. Antroji priežastis – įdiegta iš kitos prekyvietės: įskiepio pavadinimas sutampa, tačiau katalogas neteisingas, todėl agentas pagrįstai praneša, kad prijungtose prekyvietėse tokio įskiepio nėra.

Jei robotas atsako pokalbyje, bet nesupranta naujos komandos, tai nereiškia, kad agentas sugedęs ar kad padarėte ką nors ne taip. Beveik visada priežastis viena iš dviejų: jis iš naujo neįkėlė įskiepių arba prijungėte netinkamą prekyvietę. Abiem atvejais pataisyti užtrunka minutę.

Kaip atnaujinti ir pašalinti įskiepius neapkraunant agento?#

Atnaujinant yra viena neakivaizdi smulkmena. Kai autorius išleidžia naują įskiepio versiją, ji neatsiranda savaime. Pirmiausia atnaujinkite prekyvietės katalogą komanda /plugin marketplace update ir tik tada įdiekite naują versiją. Kol neatnaujinsite prekyvietės, agentas naujausia laikys versiją, kurią atsisiuntė paskutinį kartą. Taip siekiama, kad kitų žmonių pakeitimai nebūtų slapta įtraukti vėliau.

Įskiepį pašalinkite per tą patį /plugin skydelį, kurį naudojote diegdami: įdiegtų įskiepių sąraše jį raskite ir pašalinkite. Agente nelieka jokių pėdsakų, o komandos dingsta, kai įskiepius įkeliate iš naujo. Būtent todėl nebijokite eksperimentuoti su įskiepiais: įdiekite kelis, pasilikite du veikiančius, o kitus pašalinkite.

Palaikykite tvarką. Kiekvienas prijungtas įskiepis prideda komandų, kurias agentas turi prisiminti, o jų aprašymai užima dalį konteksto lango. Penki nenaudojami įskiepiai lėtina robotą ir be reikalo jį klaidina. Taisyklė paprasta: jei įskiepis nebuvo naudingas dvi savaites, pašalinkite jį. Viena komanda galėsite jį vėl įdiegti.

Kuriuos įskiepius įdiegčiau pirmiausia?#

Nepateiksiu 100 geriausiųjų sąrašo – tam reikėtų atskiro vadovo, o straipsnį apie 10 geriausių „Claude Code“ įskiepių jau turiu. Štai trys sritys, kurias rekomenduoju pradedantiesiems, valdantiems agentą per „Telegram“.

1. Darbas su „GitHub“. Įskiepis, suteikiantis agentui komandų įrašams, šakoms ir „pull request“ kurti. Parašykite robotui pokalbyje: „išsaugok darbą ir nusiųsk jį į saugyklą“, ir jis tai padarys. Taip sumažinama pagrindinė nepatyrusių vibe-coding naudotojų baimė – prarasti kodą.
2. Kodo peržiūra. Įskiepis su kontroliniu sąrašu, padedančiu tikrinti, ar nėra klaidų, saugumo spragų ir silpnų vietų. Jis ypač naudingas dirbant su „Telegram“: atsiųskite kodo fragmentą pokalbyje ir gaukite peržiūrą neatidarę redaktoriaus.
3. Vienodo stiliaus įrašai. Nedidelis įskiepis, kuris priverčia agentą formatuoti įrašus pagal vieną šabloną. Tai gali atrodyti menkniekis, tačiau po mėnesio projekto istorija bus tvarkinga kaip komandos, o ne virs chaosu.

Toliau rinkitės įskiepius konkrečioms užduotims. Dirbate su duomenų baze? Įsidiekite duomenų bazės įskiepį. Rengiate suvestines? Įsidiekite planavimo įskiepį. Bendra taisyklė ta pati: pradėkite nuo užduoties, tada raskite jai įskiepį. Iš anksto diegti įskiepius „dėl visa ko“ – patikimas būdas užversti robotą komandomis, kurių niekada nenaudosite.

Ko dar žmonės klausia apie įskiepius „Telegram“ agente?#

Atidarykite „Ailoot“.