Este destul de probabil să fi auzit termenul "agent AI" sau "agent" folosit în ultimele luni, iar pentru un număr de oameni, este posibil să fi folosit un agent AI înainte. Eu sunt a despre AI și despre modelele lingvistice mari (LLM), așa că nu am pătruns prea mult în instrumente și fluxuri de lucru ca unii dintre colegii mei. Autoproclamat „sceptic precaut” La sfârșitul anului trecut, Thomas Ptacek a scris , care mi-a atras interesul în a săpa în modul în care funcționează. Ar trebui să scrie un agent La începutul anului 2025, am citit Thorsten Ball. Și deși nu am mers și am implementat-o după pașii lui Thorsten, am fost puțin surprins de cât de simplu părea. Cum să construiești un agent? Ca o oportunitate de a "câștiga anvelopele" a ceea ce agenții sunt și cum funcționează, am pus la o parte câteva ore pentru a vedea construi unul - și m-a explodat. Am crezut că este o idee bună să împărtășesc acest lucru cu toată lumea și să reiterez cum poți obține ceva care funcționează rapid. Ce este renovat? Pentru cei care nu sunt conștienți, Renovate este un proiect open source pentru automatizarea actualizărilor de dependență pe zeci de manageri de pachete și ecosisteme de pachete, pe 9 platforme diferite (GitHub, GitLab, Azure DevOps și multe altele) și se mândrește cu suport pentru ajustarea comportamentului său pentru a se potrivi cu modul în care doriți actualizările de dependență. Mănăstire renovată Renovate găzduit de cloud este utilizat de 1.3M+ de depozite, iar CLI-ul Renovate este utilizat de milioane de depozite într-un mod auto-hosted, de asemenea. Ce este un agent? În ciuda buzzword-ului hype în jurul a ceea ce agenții sunt de fapt, am găsit Pentru a fi sănătos și digestiv: Definiția lui Simon Willison Un agent LLM rulează instrumente într-o buclă pentru a atinge un obiectiv. Acest lucru ia LLM-ul nostru și îi oferă capacitatea de a apela la instrumente (aka "instrumente de apel"), care sunt furnizate direct (ca vom implementa noi înșine) sau prin intermediul . Protocolul de context model (MCP) Întrucât modelele de ultimă oră sunt acum instruite în ceea ce privește „calling-ul instrumentelor”, înseamnă că putem oferi modelului un instrument și va înțelege cum să-l numească. Ce vrem să construim? Am crezut că o modalitate bună de a explora acest lucru ar fi să înveți un LLM un pic mai mult despre cum să creezi configurația Renovate. Deoarece Renovate se mândrește cu susținerea multor ecosisteme și are Pentru a regla comportamentul exact la ceea ce doriți, există o mulțime de posibilități diferite de configurare pe care le-ați putea adăuga la depozitul dvs. Câteva configurații LLM-urile au deja o bună înțelegere a configurației Renovate pe baza datelor lor de formare și, dacă au capacitatea de a căuta pe web, documentația noastră actuală, dar pot să nu aibă documentația exactă pentru versiunea Renovate pe care o folosim. Avem o comunitate vibrantă și datorită naturii rapide a contribuțiilor la proiect, poate fi dificil să ținem pasul cu cele mai recente schimbări - chiar și pentru mine ca unul dintre întreținătorii! Având în vedere acest lucru, am decis următoarele caracteristici pe care le-am dorit de la agentul meu: capacitatea de a regla agentul la o anumită versiune Renovate înțelegerea funcționalității disponibile în această versiune Capacitatea de a propune modificări de configurare cunoașterea a ceea ce este o configurație validă (folosind renovate-config-validator, care este livrat ca parte a pachetului Renovate npm) Capacitatea de a verifica ce ar însemna modificările de configurație, prin executarea renovării și confirmarea faptului că s-au produs modificările așteptate, folosind același flux de lucru pe care l-aș lua Construiește agentul Crearea unui input loop de bază Pentru început, am urmărit foarte atent postarea lui Thorsten (și a lui Geoffrey Huntley). ) pentru a obține o cochilie de bază a agentului meu și a alerga. Workshop, bazat pe postarea de pe blog Pentru a mă salva de nevoia de a crea un abonament Anthropic separat, am făcut câteva ajustări pentru a utiliza setarea AWS Bedrock și am fost în funcțiune! Postul lui Thorsten este excelent, iar natura pas cu pas, combinată cu un stil de scriere de invidiat, oferă o bază foarte bună asupra elementelor de bază. Învățarea agentului cum arată configurația "validă" Odată ce am avut o buclă de bază care rulează cu un instrument minim read_file, am început să am conversații pentru a obține o bază a ceea ce modelul știa deja despre configurația Renovate. Am observat că unele dintre configurațiile sugerate ar folosi caracteristici depreciate, pe care le știu ca un "utilizator de putere" al Renovate, dar nu toată lumea ar face acest lucru, până când nu rulează Renovate. Ca o îndepărtare rapidă, datorită dezvoltării continue a Renovate, uneori redenumim sau refactorăm opțiunile existente. Acest lucru se aplică atât atunci când Renovate rulează, pentru a nu forța utilizatorii să facă imediat modificări ale fișierului de configurare - dar este, de asemenea, sugerat să fie angajat la depozit. „Migrația config” Renovarea are un instrument, care pot raporta atunci când se utilizează o configurație nevalidă, dar pot evidenția și atunci când se utilizează ceva depreciat care necesită o migrare a configurației. renovate-config-validator Primul meu instrument Renovate-y pe care l-am adăugat agentului a fost , pentru a învăța LLM cum să vă asigurați că oferă doar o configurație validă, migrată. validate_config După ce am implementat instrumentul și l-am furnizat LLM, am văzut că LLM folosește în mod fiabil instrumentul, dar nu părea să asculte avertismentele privind migrarea configurației. Pentru a împinge agentul să urmeze acest lucru mai clar, m-am asigurat că promptul meu de sistem a inclus: [...] Ar trebui să vă asigurați că orice configurație pe care o prezentați este apoi validată de instrument, și că orice migrare de configurare sugerat în răspuns este adaptată - nu lăsați utilizatorii cu o configurație care are nevoie de migrare! Verificare_config Verificare_config Nu este surprinzător faptul că agentul s-a descurcat mult mai bine și a început să returneze configurația în forma migrată. Cu această funcționalitate în loc, agentul a fost deja semnificativ mai util, deoarece acum nu a putut "halucina" un câmp de configurare și să-l returneze utilizatorului, deoarece l-ar rula prin , înțelegeți că a returnat config invalid, și încercați din nou, până când am avut o config validă. validate_config Poluarea textului rendering În acest moment, am avut un agent care putea începe să răspundă la câteva întrebări rezonabile de la mine și să ofere o configurație validă și am putut începe să o folosesc puțin. LLM-urile răspund în mare măsură la întrebări cu Markdown și, deși este a doua natură de a citi, aș prefera să fie renderat Markdown, mai ales că avem multe biblioteci pentru a face acest lucru! În acest moment, am integrat în Charm Bracelet's bibliotecă pentru a renderiza Markdown, rezultând o schimbare de la: Glamoură În versiunea cea mai frumoasă: Împachetarea instrumentelor Am vrut să fiu un pic mai explicit cu privire la versiunile de Renovate, instrumentele și documentația, dar nu am putut face acest lucru la fel de ușor când am avut câteva versiuni de Renovate instalate pe mașina mea. Pentru a simplifica ambalajul, am ajuns să creez o imagine Docker ușoară care ar permite agentului meu să: să aibă o versiune specifică de renovate-config-validator instalată să știe ce versiune de Renovate rulează (și să spună agentului) să aibă o copie a docurilor pentru acea versiune descărcată Acum că există o versiune explicită a Renovate, mi-am modificat promptul de sistem pentru a spune agentului că: 		System: []anthropic.TextBlockParam{
			// ...
			{
				Text: "Renovate is a fast-moving project, so you may know about outdated configuration at any time. You are currently running as Renovate " + a.meta.Version + ", which may not be the latest at this point in time. [config validation prompt as above]",
			}
 să Citește Docs Următorul pas logic ar fi ca LLM să poată utiliza documentația pentru versiunea Renovate dată în mod corespunzător și să poată interoga exemple de utilizare pentru diferite configurații pentru a-și regla răspunsurile. Am implementat a instrument, care ar returna toate documentele (~66k linii de Markdown), care, fără surprindere, nu au funcționat, deoarece LLM-urile au un set limitat de contexte (AKA "fereastra lor de context"), și aruncarea acelora multe date ar costa o mulțime de bani, precum și reducerea contextului disponibil pentru a procesa restul conversației. read_docs Chiar dacă privesc , care ar fi probabil cea mai utilă pagină de docuri, care a fost în prezent ~13k linii de Markdown, și așa că a trebuit să ia în considerare o modalitate de a diviza acest fișier într-un mod în care un LLM ar putea digera mai ușor. Documentația pentru toate setările de configurare a depozitului Acesta este unul pe care nu l-am rezolvat încă, dar a fost interesant să luăm în considerare cum să descompunem fișierele mari în dimensiuni mai mici care vor funcționa mai bine pentru LLM-uri și, eventual, și pentru oameni. Am început prin introducerea unei instrument, care poate enumera toate fişierele din director (descărcat din versiunea GitHub pentru Renovate), și apoi putem folosi pentru a citi fiecare fișier individual, deși putem încă atinge probleme de lungime de context cu unele fișiere docs. list_docs docs read_file Într-adevăr a renovat Ultima caracteristică pe care am vrut să o implement ar oferi posibilitatea de a rula Renovate (în modul de rulare uscată) și de a valida dacă modificările pe care agentul le propunea ar funcționa de fapt. Pentru a face acest lucru ca om, aș rula Renovate în mod, apoi verificați jurnalele pentru a vedea dacă s-a făcut modificarea relevantă. Înghețată Înghețată Din fericire, agentului i s-ar putea spune să facă exact același lucru, cu un apel la un instrument, , care ar executa CLI-ul Renovate împotriva unei copii locale a unui repository, pe baza configurației pe care agentul o sugerează. run_renovate După completarea comenzii, agentul primește o linie specială de logare ( care oferă informații despre fișierele pe care Renovate le-a analizat și despre eventualele actualizări detectate și este extrem de utilă atunci când se face debugging. packageFiles with updates După cum descoperim, fiecare instrument incremental furnizat agentului îl face mai puternic și am început să-l văd mai rezonabil capabil să confirme dacă, adică, adăugând un regex pentru a analiza Versiunea a ar detecta de fapt versiunea curentă și actualizările de versiune în așteptare. golangci-lint Makefile Nu am terminat încă tuning-ul sistemului pentru a-l învăța exact ce aș căuta atunci când mă uit prin liniile de logare, dar este interesant cât de mult poate face deja. Lecții învățate Prin acest proces, am învățat mult mai multe despre agenți și LLM-uri și mi s-a învățat că nu există atât de multă "magie" cum pare uneori și că poate fi simplu să faci ceva interesant. Surprinzător de direct Am fost surprins să văd cât de simplu a fost să ajungi la o buclă minimă de agenți (pe baza postării lui Thorsten) și apoi cum a fost doar câteva sute de linii suplimentare de Go pentru a ajunge la rezultatul final, cu un total de ~700 de linii de cod. Îmi dau seama că o mulțime de muncă este făcută de LLM sub capac, dar este încă impresionant! Clădirea în creștere a fost distractivă Mi-a plăcut foarte mult să văd cum schimbările incrementale, cum ar fi adăugarea unui nou instrument sau o ajustare a promptului de sistem, ar îmbunătăți viabilitatea generală a agentului. Pe măsură ce am făcut schimbări, am rulat din nou aceleași invitații pentru a obține un sentiment pentru diferență (în timp ce amintirea LLM-urilor nu este deterministă). Obținerea UX-ului corect este mai ușoară cu un agent specializat Atunci când aveți un agent care este specializat în caracteristici specifice, puteți controla mai ușor cum arată acest lucru. În cazul meu, facem în mare măsură ajustări la un fișier JSON care se află într-un depozit și ne uităm la ce schimbări vede Renovate CLI după aceste modificări. Nu am terminat încă implementarea, dar ceea ce vreau cu adevărat este să am un panou lateral pe interfața agentului, care arată configurația actuală Renovate despre care vorbim în prezent, astfel încât, pe măsură ce se schimbă în funcție de feedback-ul LLM, se schimbă pe UI. Contextul este greu După cum sa menționat mai sus, încercarea de a juca dimensiunea documentației noastre cu fereastra de context a unui LLM a fost un pic dificilă. Adăugați acest lucru la faptul că unele dintre liniile de jurnal ale Renovate pot fi deosebit de lungi (mai ales într-un depozit mare) și apoi avem locuri suplimentare pentru a lua în considerare cum să limităm utilizarea tokenului la un moment dat. De asemenea, am descoperit că, deși promptul meu de sistem împinge LLM către o acțiune specifică bazată pe formulare (adică în Schema JSON utilizată pentru definirea unui anumit instrument), uneori trebuie să împing mai mult, adică. Dacă mă aştept să alerge cu . can you lookup what updates are available --dry-run=lookup Acesta ar putea fi un server MCP Cei dintre voi care sunt mai familiarizați cu LLM-urile, agenții și Protocolul Context Model au observat că multe dintre acestea nu sunt de fapt specifice agentului și că instrumentele în sine ar putea fi extrase într-un server MCP. Acesta este absolut planul, dar în scopul acestui post de blog, a avut sens să arate că a fost mai ușor să-l implementați pe toate într-un singur agent, decât să încercați să adăugați și un server MCP care trebuia să interacționeze cu. Acum am mult mai mult de făcut Din păcate, acum am multe alte lucruri pe care vreau să le fac cu asta! De asemenea, mă uit la modul în care acest lucru poate fi folosit pentru a-mi îmbunătăți propria viață, lucrând ca Managerul Comunității Renovate, răspunzând la întrebările utilizatorilor. Și păstrați-vă ochii peeling, vreau foarte mult să obțin acest Open Source'd atunci când este într-un loc mai bun. Concluzie Ca cineva care nu a făcut mult cu LLM-uri și agenți, am găsit-o cu adevărat deschisă pentru a vedea cât de simplu poate fi de fapt. Vă las cu un alt memento că ar trebui să construiți un agent. lui Jamie Tanna Senior Developer și Open Source Project Maintenance Jamie este un susținător al Mend Renovate, unde deține și rolul de manager al comunității, așa că probabil îl veți vedea în jur! menținerea proiectelor open source despre care ați auzit în ultimul deceniu și ați petrecut ultimii ~ 5 ani lucrând din greu în spațiu de gestionare a dependențelor și de a ajuta întreprinderile să livreze software mai bun.

Acest audio este produs în limba originală a poveștii!

Ce am învățat construind un agent pentru Renovate config (ca un sceptic precaut al AI)

About Author

COMENTARII

Etichete suspendate

ACEST ARTICOL A FOST PREZENTAT IN

Related Stories

Elon Just Made Gambling Define the News - And It's More Honest Than Journalism Ever Was

The #bitcoin Writing Contest by Rootstock and HackerNoon: Round 2 Results 🎉

The Spacecoin Writing Contest by Spacecoin and HackerNoon: Round 2 Results 🎉

Holy 🎅 HackerNoon's Web 2.5 Documentary is Out! 😮

Elon Just Made Gambling Define the News - And It's More Honest Than Journalism Ever Was

The #bitcoin Writing Contest by Rootstock and HackerNoon: Round 2 Results 🎉

The Spacecoin Writing Contest by Spacecoin and HackerNoon: Round 2 Results 🎉

Holy 🎅 HackerNoon's Web 2.5 Documentary is Out! 😮

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps