Automatitzar tasques amb agents d'IA, sense perdre el control

Quan treballes amb un agent d'IA a l'ordinador, cada cop que vol fer alguna cosa delicada et demana permís. Un agent programat per a les tres de la matinada no pot preguntar a ningú: el que pot fer ho decideix, per endavant, la seva configuració. I aquí apareixen tres riscos:

• Que faci més del que li has demanat: escriure on no toca, executar ordres o publicar alguna cosa.
• Que gasti sense límit, si s’embolica en una tasca que no sap acabar.
• Que falli en silenci: que deixi d'executar-se i ningú se n'adoni durant setmanes.

Són les que apliquem a les automatitzacions que muntem:

• Una sola carpeta on escriure. L'agent pot llegir el que necessiti, però només escriu a la seva carpeta de treball. Mai a la teva còpia del projecte.
• Eines en llista tancada. Llegir, cercar i editar, segons la tasca. Executar ordres, mai: el que calgui executar va en un pas a part, sense IA, a la vista a la configuració.
• Un límit de despesa a cada pas. Si l'agent s'embolica, el pas s'atura en arribar al límit.
• El que diu l'agent ho comprova un pas que no és IA. Que digui que ha desat un fitxer no prova que existeixi.
• Si deixa de funcionar, te n'assabentes. L'error més car és el silenciós: una tasca que fa dies que no s'executa ha d'avisar igual que una que falla.

agentic-pipelines és el motor de codi obert que hem construït per a això. Cada automatització és un fitxer pipeline.yaml amb els seus passos: passos de shell per al que es pot fer sense IA i passos d'agent, que fan servir el Claude Agent SDK, per al que necessita criteri.

Les regles no depenen que l'agent es porti bé: les imposa el motor. Abans de cada acció de l'agent comprova si l'eina està permesa i si escriu dins de la seva carpeta; si no, la denega i ho deixa anotat. Cada execució queda desada amb el que va fer cada pas, el seu cost i les seves denegacions, i es pot consultar en un tauler local amb pipelines web.

Les automatitzacions es programen amb el planificador de macOS (launchd), així que de moment només funciona en Mac.

pipelines web obre al navegador un tauler local, de només lectura, amb totes les teves automatitzacions: quines estan programades, quines van fallar a l'última execució, quant va costar cadascuna i què va fer cada pas. Si una tasca deixa d'executar-se, surt en vermell encara que no hi hagi cap error per avisar. I a cada execució es veuen les accions que el motor va denegar a l'agent: en una de les nostres proves, l'agent va intentar llegir un fitxer fora de la seva carpeta i el motor ho va bloquejar sense que la tasca deixés de funcionar.

A pipelines-starter n'hem publicat set, provades amb dades reals:

• site-checks: revisa les teves webs cada matí (errors, lentitud, certificats a punt de caducar) i només avisa si alguna cosa va malament.
• stale-prs: pull requests dels teus repositoris de GitHub que fa dies que ningú toca.
• issues-already-fixed: issues obertes que un commit ja fusionat esmenta, així que probablement ja estan resoltes.
• dev-machine-doctor: l'estat del teu Mac de desenvolupament: disc lliure, les memòries cau que ocupen més, ports oberts i processos oblidats.
• weekly-briefing: cada divendres, un agent resumeix la setmana dels teus projectes en llenguatge planer, per a algú que no llegeix pull requests.
• docs-drift: un agent compara la documentació d'un repositori amb el codi i prepara les correccions en una branca local.
• news-digest: cada matí, un agent llegeix les teves fonts RSS i canals de YouTube i escriu un resum amb idees de contingut.

Totes són de només lectura per defecte: cap publica, fusiona, tanca ni esborra res. Deixen un informe en Markdown i t'avisen amb una notificació del Mac o, si ho prefereixes, al mòbil.

Primer, el motor:

git clone https://github.com/startcat/agentic-pipelines.git ~/agentic-pipelines
cd ~/agentic-pipelines && bun install
alias pipelines="bun run ~/agentic-pipelines/src/cli/index.ts"

Després, les automatitzacions:

git clone https://github.com/startcat/pipelines-starter.git ~/pipelines-starter
cd ~/pipelines-starter && cp .env.example .env

Si faràs servir les que porten agent, posa la teva clau de l'API d'Anthropic al .env, a ANTHROPIC_API_KEY. I, per acabar, instal·la les que vulguis, cadascuna amb la seva configuració. Per exemple, la revisió de webs:

pipelines install site-checks --set urls="https://la-teva-web.cat"

install comprova que el teu Mac té tot el que cal, desa la configuració i la programa. Per provar-la sense esperar a demà, fes servir pipelines run amb les mateixes opcions. Cada automatització té la seva pàgina a GitHub amb totes les opcions.

El motor i les automatitzacions són gratuïts. Les quatre que només fan servir shell (site-checks, stale-prs, issues-already-fixed i dev-machine-doctor) no fan servir IA i no costen res. Les tres que fan servir un agent criden l'API d'Anthropic amb la teva clau i tenen un límit de despesa a cada execució. A preus de l'API i amb el model que porten configurat (Sonnet), les nostres proves van costar uns 0,25 $ per resum setmanal, uns 0,15 $ per resum de notícies i entre 0,20 i 0,35 $ per revisió de documentació, que només s'executa les setmanes en què canvia el codi.

Si vols que surti més barat, cada agent pot fer servir un model més petit: canviant model: sonnet per model: haiku al seu fitxer, el preu per token baixa a la meitat. A la nostra prova del resum de notícies, l'execució va passar d'uns 0,15 $ a 0,11 $. Convé comprovar que el resultat et serveix.

Cada automatització de l'starter és un pipeline.yaml que pots copiar i adaptar. pipelines validate comprova que la configuració és correcta abans de programar-la, i el README del motor explica com escriure'n una des de zero en deu minuts.

Si prefereixes que la muntem nosaltres, connectada a les eines de la teva empresa, és el que fem a IA i automatització.