Vercel Academy ha appena rilasciato un corso completo, Build Your Own AI Coding Agent Harness, che smonta pezzo per pezzo come si scrive da zero un framework per AI coding agent davvero funzionante. Niente roba tipo “chiama tre API e hai finito”: qui si mettono le mani su tool loop, context pruning, delega ai subagent e gestione del ciclo di vita. Roba tosta.

Per chi vuole monetizzare con l’AI in freelance, questo corso è un segnale spartiacque. Chi sa usare Cursor per scrivere codice ce n’è a bizzeffe. Chi sa consegnare un “framework Agent su misura” lo paghi molto di più del solito outsourcing.

Prima di tutto: cos’è un Agent Harness

Un Agent Harness è l’impalcatura che permette all’AI di lavorare in autonomia, gestire il contesto e stare dentro i limiti di sicurezza. In pratica è il project manager + l’addetto alla sicurezza + il blocco appunti dell’AI. Senza harness, l’AI è solo un modello che chiacchiera. Con l’harness, diventa un junior che riceve task, esegue, riporta e sa quando tornare dall’umano per chiedere aiuto.

Il corso usa tre componenti con ruoli ben separati:

• AI SDK: fa parlare l’AI (chiama modelli, genera testo)
• Vercel Sandbox: fa agire l’AI (esegue comandi in ambienti isolati)
• just-bash: fa obbedire l’AI (interfaccia tool standardizzata, comportamento shell controllabile)

Insieme formano una fabbrica di Agent completa.

Il problema: perché i tuoi Agent restano sempre demo

Joel Hooks apre il corso sparando dritto nel punto dolente del settore: “un tool loop con tre tool è solo una demo; il problema esplode quando lo metti a lavorare sul serio”. Fai leggere all’Agent un file da 5000 righe, lo infila tutto nel contesto e non riesce più a sputare fuori niente. Gli dai accesso a bash, e un rm -rf ti cancella la produzione. Gli fai fare venti step di fila, e al decimo ha già dimenticato cosa sta facendo.

I clienti non pagano la scatola, pagano il risultato. Il 90% dei “tutorial AI coding assistant” in giro spiega come impacchettare prompt, attaccare l’API di GPT e fare un frontend carino. Ma le aziende pagano per un Agent che completa in sicurezza un’intera catena di task. È un problema architetturale, non si risolve tuneando i parametri.

L’ambizione di Vercel con questo corso è chiara: trattare l’Agent Harness come un prodotto ingegneristico serio, non come uno script giocattolo.

L’opportunità: l’ingegnere Agent è la risorsa freelance più scarsa

Il mercato dell’outsourcing si sta polarizzando. Da un lato chi sa solo usare Cursor per completare codice e compete al ribasso. Dall’altro chi consegna “soluzioni Agent AI custom” e fa preventivi ben sopra la media, con clienti in lista d’attesa.

Perché? Perché le aziende vogliono “flussi automatizzati”, non “code completion”. Un e-commerce non ti chiede uno script Python: ti chiede un Agent che monitora i prezzi dei concorrenti, genera i testi delle listing, lancia A/B test e produce report. Questo lo sa fare solo chi conosce l’architettura di un Agent Harness.

⚠️ Secondo il post originale, su Upwork i progetti nella categoria “AI agent customization” hanno un valore medio di qualche migliaio di dollari. Non verificato in modo indipendente.

Percorso 1: padroneggia i moduli core e costruisci un vantaggio tecnico

I moduli più preziosi del syllabus vanno digeriti uno per uno. Per ognuno: problema → soluzione → analogia in tre righe.

Tool Loop: il cuore dell’Agent.

• Problema: tool che falliscono, timeout, conflitti di concorrenza mandano tutto in crash.
• Soluzione: AI SDK usa la condizione stopWhen per terminare il loop e maxSteps per limitare i passi, con retry automatici.
• Analogia: è il metronomo della catena di montaggio. Se un pezzo è difettoso, la linea si ferma e non passa oltre.

Tool Design: la granularità dei tool decide il tetto massimo delle capacità dell’Agent.

• Problema: tool troppo grossolani non fanno lavori fini, troppo fini fanno perdere l’Agent nei meandri.
• Soluzione: spezza “operazioni sul filesystem” in cinque tool atomici (read, write, edit, glob, grep), invece di dargli un bash onnipotente.
• Analogia: dai all’operaio strumenti dedicati (cacciavite, trapano, chiave), non tutto il garage in blocco.

Sandbox Abstraction: il punto chiave per la sicurezza.

• Problema: con accesso a bash, l’Agent può lanciare un rm -rf sul database di produzione.
• Soluzione: Vercel Sandbox offre ambienti di esecuzione isolati, l’Agent può smanettare senza toccare l’host.
• Analogia: è la cappa aspirante del laboratorio chimico. Se esplode qualcosa, esplode lì dentro.

Context Pruning: un file da 5000 righe non può finire tutto nel prompt.

• Problema: l’AI si intasa leggendo file enormi, e le vecchie conversazioni inquinano le decisioni nuove.
• Soluzione: usa l’hook prepareStep per tagliare il contesto prima di ogni step, tenendo solo gli ultimi N passi + un riassunto compresso del resto.
• Analogia: è come riordinare la scrivania. Sul tavolo solo quello che serve oggi, il resto in magazzino.

Subagent Delegation: i task complessi vanno spezzati.

• Problema: un singolo Agent che gestisce più moduli esplode nel contesto e confonde i ruoli.
• Soluzione: l’Agent principale pianifica, i subagent eseguono moduli specifici, i risultati tornano al principale.
• Analogia: il project manager che distribuisce il lavoro a frontend, backend e QA e tiene d’occhio solo tempi e rischi.

Lifecycle Management: avvio, esecuzione, pausa, ripresa, terminazione. Ogni stato va gestito con cura.

• Problema: task lunghi che si interrompono per rete caduta, utente che annulla, modello in timeout. Lo stato dell’Agent va perso.
• Soluzione: serializza ogni stato su disco, supporta ripresa dal punto di interruzione e intervento umano.
• Analogia: il salvataggio di un videogioco. Muori, riparti dall’ultimo save, non dall’inizio.

Percorso 2: usa lo stack del corso per chiudere i primi clienti

Finito il corso non hai finito, hai iniziato. Devi prendere subito Vercel AI SDK + Vercel Sandbox + just-bash e buttarti sul primo progetto vero.

La via più veloce: apri un servizio su Fiverr, Upwork o Mercari con un titolo tipo “Creo AI Agent custom per il tuo business con stack Vercel”. I primi tre clienti puoi anche farli a metà prezzo o gratis, in cambio di case study e recensioni.

⚠️ Secondo il post originale, fare tre clienti gratis richiede da pochi giorni a qualche settimana a seconda della complessità dell’Agent. Non verificato in modo indipendente. Il valore reale dipende dalla capacità di trasformare i case study in clienti paganti.

La scelta dei case study conta. Niente “fammi un chatbot”, che è la richiesta più inflazionata del pianeta. Punta su “automatizzami un flusso operativo”, che è dove stanno i budget veri. Esempi:

• Per un seller Amazon: Agent che monitora le recensioni, estrae le parole chiave negative, genera suggerimenti di miglioramento e li pusha su Slack.
• Per un creator su Lemon8 o Pinterest: Agent che raccoglie i post dei competitor, analizza i pattern dei contenuti virali e produce una lista di idee.
• Per uno sviluppatore indie: Agent che monitora le issue su GitHub, le classifica per priorità e genera bozze di PR.

⚠️ Secondo il post originale, progetti di questo tipo si quotano nell’ordine delle migliaia di euro. Non verificato in modo indipendente.

Cold start: zero clientela, come si parte

La maggior parte delle persone parte senza contatti aziendali. Tre canali concreti:

1. Post nelle community: pubblica case study su community di Vibe Coding, LinkedIn, Lemon8 con un template tipo “Ho creato un Agent per il settore X con Vercel AI SDK, fa risparmiare Y ore al mese”, allegando un video demo di 30 secondi. Quando il contenuto gira, i clienti scrivono da soli.
2. Lavoro gratis in cambio di testimonial: tramite amici, fai il primo progetto a 50-70€ chiedendo in cambio una recensione scritta + il permesso di usare il caso pubblicamente.
3. Strategia di pricing a gradini: 50-70€ per Agent mono-modulo → 300-400€ per workflow multi-modulo → 3.000-4.000€ per soluzione custom completa con sei mesi di manutenzione. Ogni gradino richiede i case study del gradino precedente.

Percorso 3: ricontenuti il corso e monetizza come creator

Il corso Vercel è in inglese e ha una barriera d’ingresso alta. È esattamente lì che sta il tuo margine di informazione.

Spezzalo in 10-15 episodi e pubblicali su Lemon8, TikTok, Substack o YouTube. Titoli tipo: “Corso interno Vercel svelato: come si scrive davvero un Agent framework”, “Il loop a tre tool è un giocattolo: servono questi cinque moduli”, “Context pruning: come far smettere un Agent di perdere la memoria”.

Ogni video 5-8 minuti, un concetto tecnico per episodio, con codice in sovraimpressione. Operativo:

• Episodio 1 sul tool loop, con tre snippet di codice (generateText + tools di AI SDK, uso di stopWhen, esempio di prepareStep per il taglio del contesto), durata intorno ai 7 minuti.
• A/B test sui titoli: testa “Corso interno Vercel svelato” contro “Guida pratica per scrivere un Agent framework” con 100€ di budget adv ciascuno, misura il CTR, poi scala il template vincente.

La monetizzazione ha tre livelli: primo, sponsor di formazione tech; secondo, vendita di un corso tuo tipo “AI Agent Engineer in pratica”; terzo, consulenza ad alto ticket per aziende che vogliono costruire un team Agent. ⚠️ Secondo il post originale, un account con 10k follower può spuntare qualche centinaio di euro a post per sponsor di formazione tech. Non verificato in modo indipendente.

Quale percorso scegliere

• Programmatore dipendente che vuole un side hustle: percorso 2 + versione light del percorso 3. Nel weekend prendi 1-2 clienti piccoli per fare pratica, registra il processo e pubblicalo su Lemon8. Obiettivo: 500-1.000€ al mese.
• Freelance che punta a 5.000€ al mese: percorso 2 in modalità full immersion. Tre mesi di cold start senza fare i schizzinosi sui clienti, solo per accumulare case study. Dal quarto mese in poi scegli clienti ad alto budget, ticket medio sopra i 3.000€.
• Studente / cambio carriera: parti dal percorso 1, digerisci il corso, pubblica 5 progetti demo su GitHub come portfolio. Valuta i primi clienti dopo 6 mesi.

Case study: Joel Hooks è lui stesso la dimostrazione

Joel Hooks è l’autore del corso Vercel Academy e il docente di Build Your Own AI Coding Agent Harness. È la prova vivente che “ingegnere Agent che monetizza” funziona: ha costruito un brand personale fortissimo nella community dev grazie a tutorial di qualità, e i suoi contenuti vengono ripresi ovunque.

Il suo approccio è replicabile: stack centrato su Vercel AI SDK, deliverable che è un “sistema Agent funzionante” e non uno “snippet di codice”. È esattamente la fornitura più scarsa nel mercato attuale.

⚠️ Dati specifici su altri sviluppatori indipendenti (tipo “5.000€ al mese” o “120k follower in sei mesi”) non hanno fonti verificabili nel materiale originale e non vengono citati qui.

Percorso da zero assoluto

Se non hai mai toccato Node.js o TypeScript, segui quest’ordine:

1. Mese 1: basi di Node.js + sintassi TypeScript + concetti base LLM (cosa sono token, prompt, function calling). Risorse: documentazione ufficiale TypeScript, AI Engineering Handbook.
2. Mese 2: solo il modulo “tool loop” del corso, affiancato al quickstart ufficiale di AI SDK per portare a casa un demo funzionante.
3. Mese 3: aggiungi il modulo “sandbox abstraction” e costruisci un Agent che riordina cartelle in automatico.
4. Dal mese 4 in poi: inizia a monetizzare seguendo il percorso 2 o 3.

Aspettativa realistica: il primo mese studia solo il tool loop, non cercare di fare tutto insieme. Due ore al giorno per 30 giorni e saprai costruire una catena Agent minima ma funzionante.

Call to action: stasera apri Vercel Academy

Il corso Vercel Academy è gratuito, non serve account a pagamento. Vai su vercel.com/academy, cerca “Build Your Own AI Coding Agent Harness”, entra nella pagina del corso e inizia dal primo modulo.

Non provare a finirlo tutto in una volta. Due ore al giorno, prima digerisci tool loop e sandbox abstraction, poi costruisci subito un MVP. Anche solo un Agent che riordina file.

Quando riesci a mettere in piedi in 30 minuti una catena completa “leggi file → analizza contenuto → genera report → scrivi nuovo file”, hai già superato il 90% di chi ha seguito tutorial AI a caso. A quel punto hai contenuto vero da mostrare per chiudere clienti, registrare video o scrivere articoli.

Stasera apri Vercel Academy, parti dal tool loop. Tra 30 giorni ringrazierai te stesso.