Managed Agent Runs: Agenti Autonomi che Lavorano sulla Tua Architettura Mentre Dormi

Due settimane fa abbiamo lanciato Agent Hub con le guardrail di conformance, regole che indicano agli agenti AI cosa possono e cosa non possono fare. Quello era il livello difensivo. Oggi aggiungiamo quello offensivo.

I Managed Agent Runs ti permettono di inviare agenti AI autonomi direttamente da Archyl. Assegna loro un compito, collegali ai tuoi strumenti, imposta una pianificazione e lasciali lavorare. Clonano il tuo repository, leggono la tua architettura, chiamano servizi esterni e ti restituiscono un resoconto completo di tutto quello che hanno fatto: ogni chiamata a tool, ogni decisione, ogni token speso.

Questo non e' "chatta con la tua architettura." Questo e' un agente che svolge lavoro reale, in autonomia, sulla tua codebase.

Perche' i Managed Runs?

Lo schema che continuavamo a osservare era questo: i team configuravano le regole di conformance, generavano il file CLAUDE.md, e poi eseguivano manualmente gli agenti nel terminale. Copiare il contesto, incollarlo in Claude Code, eseguire il compito, controllare l'output. Ogni singola volta.

Il tassello mancante era l'automazione. Non dovresti dover supervisionare un agente che esegue un compito di routine. Controllare le dipendenze obsolete ogni lunedi' mattina? Quello dovrebbe essere una pianificazione. Verificare le PR aperte rispetto alle regole architetturali dopo ogni merge? Quello dovrebbe essere automatico. Generare un report settimanale sulla deriva architetturale? Impostalo e dimenticatene.

I Managed Runs chiudono questo ciclo. Definisci il compito, scegli una pianificazione e Archyl si occupa del resto: clonazione, iniezione del contesto, esecuzione e monitoraggio.

Anatomia di un Run

Ogni managed run segue lo stesso ciclo di vita:

Clone — L'agente clona il repository del tuo progetto in uno spazio di lavoro isolato. Copia pulita, nessuna contaminazione da esecuzioni precedenti.
Iniezione del contesto — Prima che l'agente scriva una singola riga di codice, riceve il tuo contesto architetturale completo: modello C4, ADR, regole di conformance, stack tecnologico, contratti API. Gli stessi dati di get_agent_context che alimentano le guardrail, iniettati automaticamente.
Esecuzione — L'agente lavora sul tuo compito. Puo' leggere file, scrivere codice, chiamare strumenti esterni e prendere decisioni. Ogni azione viene registrata come evento in un feed in tempo reale.
Reporting — Quando l'esecuzione si completa (o raggiunge il limite di iterazioni), ottieni una traccia completa: ogni chiamata a tool con input e output, badge di stato, conteggio dei token, tempo trascorso.

La pagina di dettaglio del run mostra tutto. Le chiamate ai tool sono schede espandibili con JSON evidenziato sintatticamente. Ogni scheda mostra da quale connector proviene lo strumento: "github" per le chiamate alle API GitHub, "archyl" per le query sull'architettura, "linear" per il tracciamento delle issue. Puoi tracciare esattamente cosa ha fatto l'agente e perche'.

Connector: Collega Qualsiasi Servizio MCP

Qui le cose si fanno interessanti. I Managed Runs non parlano solo con Archyl. Possono comunicare con qualsiasi cosa che parli MCP (Model Context Protocol).

I connector ti permettono di collegare servizi esterni ai tuoi agent run. Fin da subito, supportiamo:

GitHub — Leggere PR, controllare lo stato della CI, elencare le issue, fare review del codice
GitLab — Le stesse funzionalita' per i progetti ospitati su GitLab
Linear — Leggere e aggiornare le issue, controllare l'avanzamento dello sprint
Slack — Inviare messaggi, leggere i canali, notificare i team
Qualsiasi server MCP — Se espone tool MCP, puoi collegarlo

Configurare un connector richiede trenta secondi. Dagli un nome, incolla l'URL del server, aggiungi gli header di autenticazione se necessario e Archyl esplorera' il server per scoprire i tool disponibili. Vedrai ogni tool esposto dal connector prima di salvare.

Quando crei un run o una pianificazione, scegli quali connector collegare. L'agente ottiene accesso a tutti i tool di tutti i connector collegati, organizzati per namespace in base al nome del connector. Un tool GitHub appare come github__list_pull_requests. Un tool Linear appare come linear__get_issue. Nessuna collisione, nessuna ambiguita'.

Questo namespacing e' importante. Quando guardi il feed degli eventi di un run, ogni chiamata a tool mostra la sua origine. Puoi immediatamente capire se l'agente stava interrogando il tuo modello architetturale, leggendo una PR su GitHub o postando su Slack. Piena visibilita' su cosa ha toccato l'agente e dove.

Pianificazioni: Automazione Basata su Cron

Alcuni compiti non dovrebbero aspettare che un umano prema "Run." Le pianificazioni ti permettono di definire agent run ricorrenti con espressioni cron standard.

Ecco alcuni esempi di cosa stanno gia' facendo i team:

Revisione architetturale settimanale — Ogni lunedi' alle 9 di mattina, un agente controlla la codebase alla ricerca di deriva architetturale. Confronta la struttura effettiva del codice con il modello C4, segnala nuove dipendenze non documentate e identifica componenti che sono cresciuti oltre il loro ambito previsto.

Controllo di conformance sulle PR — Dopo ogni merge su main, un agente esamina il diff rispetto alle regole di conformance. Cattura i pattern che sono sfuggiti alla CI: non errori di sintassi, ma violazioni architetturali che hanno senso solo nel contesto dell'intero sistema.

Audit delle dipendenze — Ogni mercoledi', un agente scansiona l'albero delle dipendenze alla ricerca di vulnerabilita' note, pacchetti deprecati e disallineamenti di versione tra i servizi. Crea un riepilogo con livelli di gravita' e aggiornamenti suggeriti.

Sincronizzazione della documentazione — Ogni venerdi' pomeriggio, un agente confronta la codebase attuale con la documentazione del progetto. Endpoint mancanti, descrizioni obsolete, nuovi servizi senza documentazione: li segnala tutti.

Ogni pianificazione mostra la sua espressione cron, l'orario della prossima esecuzione, l'orario dell'ultima esecuzione e lo stato attivo/in pausa. Puoi mettere in pausa una pianificazione senza eliminarla, attivarla manualmente al di fuori della sua cadenza normale, oppure modificare il testo del compito e la tempistica in qualsiasi momento.

La Pagina di Dettaglio del Run

Abbiamo dedicato molto tempo all'esperienza di monitoraggio perche' la visibilita' e' tutto quando lasci un agente lavorare in autonomia.

La pagina di dettaglio del run ti offre:

Stato a colpo d'occhio — In esecuzione, completato, fallito o annullato. Badge con codice colore, visibile immediatamente.
Utilizzo dei token — Token di input e output, per poter tracciare i costi per ogni run.
Tempo trascorso — Quanto tempo ha lavorato l'agente, aggiornato in tempo reale durante l'esecuzione.
Run ID — Per la tracciabilita' e il debug.
Feed degli eventi in tempo reale — Ogni azione dell'agente appare come una scheda espandibile. Le chiamate ai tool mostrano l'origine del connector, il nome del tool, i parametri di input e l'output. I messaggi mostrano il ragionamento dell'agente. Gli errori sono evidenziati.

Il feed e' progettato per una scansione rapida. Le righe compresse mostrano il tipo di evento e un riepilogo su una riga. Passa il mouse per vedere il badge del connector ed espandi per i dettagli completi. Quando qualcosa va storto, non scavi nei log: scorri una timeline strutturata di esattamente cosa e' successo.

Consapevolezza Architetturale di Default

Ogni managed run ottiene automaticamente accesso al server MCP del tuo progetto Archyl. Questo significa che l'agente puo':

Interrogare il modello C4 per comprendere i confini del sistema
Leggere le ADR per comprendere le decisioni passate
Controllare le regole di conformance per sapere quali pattern seguire
Consultare i contratti API per comprendere le interfacce dei servizi
Verificare le assegnazioni tecnologiche per scegliere gli strumenti giusti

Questa non e' un'integrazione opzionale. E' la base. L'agente non parte da zero: parte dalla tua architettura. Quando deve creare un nuovo servizio, sa a quale container appartiene. Quando scrive codice, sa quali pattern sono imposti. Quando aggiunge una dipendenza, sa quali tecnologie sono approvate.

Combinato con i connector esterni, questo crea agenti che sono sia architetturalmente consapevoli che operativamente capaci. Conoscono il tuo sistema e possono interagire con i tuoi strumenti.

Per Iniziare

I Managed Agent Runs sono disponibili ora in Agent Hub per i piani Business e Scale.

Crea un connector — Vai su Agent Hub → Connectors. Aggiungi GitHub, Linear o qualsiasi servizio compatibile con MCP.
Avvia un run — Vai su Runs → New Run. Scrivi il tuo compito, collega i connector e lancia.
Imposta una pianificazione — Vai su Schedules → New Schedule. Scegli un'espressione cron, collega i connector e lascia che faccia il suo lavoro.

Gli agenti sono pronti. La tua architettura e' il contesto. I tuoi strumenti sono i connector. Ora mettili al lavoro.