← Tutti gli articoli
VYNOROAgenti IANote di sviluppo

Come ho costruito VYNORO da solo: 8 scelte per un team di agenti IA di cui ci si può fidare

L’architettura di VYNORO, un team di agenti IA costruito da un solo sviluppatore: un manager che smista le richieste, un codice per ogni prova, controlli nel codice prima della revisione IA, sicurezza a livello di riga, missioni che sopravvivono a una scheda chiusa, limiti di costo e protezioni sugli strumenti.

Reda BellasseryReda Bellassery· ·7 min di lettura
vynoroai.com/office
L’ufficio 3D di VYNORO: sei specialisti IA alle loro scrivanie con Vyn e la bacheca delle missioni alla parete

Punti chiave

  • Far parlare tra loro gli agenti IA è la parte facile. Rendere il loro lavoro abbastanza sicuro da mandarlo a un cliente è il vero lavoro.
  • VYNORO è un’app Next.js, un progetto Supabase e un motore di missioni lato server su Gemini (Vertex AI): circa 40.000 righe di TypeScript, scritte da una persona sola.
  • Le scelte che contano di più: un manager che smista prima di pianificare, un codice su ogni prova, controlli nel codice prima di qualsiasi revisione IA, e l’IA che agisce come l’utente collegato, mai come amministratore.
  • I lavori lunghi girano sul server con un lease e un watchdog, ogni chiamata al modello ha un prezzo e gli agenti trattano ogni pagina web come input ostile.
  • L’approvazione umana prima di ogni invio non è un’impostazione. È il prodotto.

Ho costruito VYNORO da solo: prodotto, design, full stack e motore IA.

VYNORO è un team di intelligenza artificiale per fondatori e piccole agenzie. Sono specialisti IA, guidati da un manager di nome Vyn, che fanno lavoro vero per le piccole aziende: ricerche, audit, report e prime bozze dei messaggi. Lo trovi su vynoroai.com.

Ecco quello che nessuno ti dice quando inizi a costruire agenti. Farli parlare tra loro è la parte facile. Portare il loro lavoro al punto in cui lo lasceresti arrivare a un cliente è tutto il resto. Quasi ogni scelta qui sotto esiste perché la prima versione di qualcosa è andata storta.

Se ti interessa il lato del fondatore, cioè perché l’ho costruito, parti da questo articolo. Questo è per chi costruisce.

Lo stack, in una tabella

LivelloCosa ho usato
AppNext.js 16 (App Router), React 19, TypeScript, Tailwind v4
DatiSupabase: Postgres con sicurezza a livello di riga, Realtime, Storage privato, Auth
ModelliGemini su Vertex AI: Pro per Vyn, Flash per gli specialisti, Flash-Lite come riserva
Strumenti degli agentiRicerca e Maps con grounding, PageSpeed, lettore di pagine, esecuzione di codice, generazione di immagini
Ufficio 3Dthree.js con React Three Fiber e drei
EsportazioniPowerPoint, Excel, Word e PDF
~40krighe di TypeScript
7colleghi IA
9strumenti per gli agenti
25migrazioni, RLS su ogni tabella

1. Un manager che smista prima di pianificare

Se ogni messaggio diventa una missione con più agenti, una domanda semplice richiede un minuto e costa soldi veri. Per questo il primo compito di Vyn non è pianificare. È smistare.

In circa un secondo Vyn mette ogni richiesta in una di tre corsie: risponde subito (una domanda, un dato, un testo breve), fa una domanda (quando manca qualcosa di essenziale) oppure pianifica. Un piano indica lo specialista di ogni passaggio e cosa quel passaggio deve consegnare. I passaggi con gli input pronti partono in parallelo, fino a tre alla volta.

La regola a cui tengo di più: una domanda, non dieci. Nessuno vuole un’IA che lo intervista.

2. Un codice per ogni prova

Ogni risultato di uno strumento diventa una prova con un codice, per esempio E2.3. Vale per una pagina letta, una ricerca su Maps, un test PageSpeed o un calcolo. Il report deve citare quei codici, e ogni riferimento riporta alla pagina, alla ricerca o al calcolo da cui viene.

Questa sola scelta cambia il rapporto con l’utente: da “fidati” a “clicca qui e controlla”. E rende possibile la scelta successiva.

vynoroai.com/report
Ogni affermazione del report porta a una fonte, e le fonti sono elencate a fianco.
Ogni affermazione del report porta a una fonte, e le fonti sono elencate a fianco.

3. Prima controlla il codice, poi l’IA

Un revisore IA tende a lasciar passare proprio gli errori che fanno più danni: un indirizzo email che sembra giusto, o un tempo di caricamento che nessuno ha misurato. Per questo, prima che Vyn riveda qualsiasi cosa, sull’output strutturato girano controlli deterministici:

  • Ogni codice di prova citato deve esistere.
  • Ogni email deve comparire su una pagina che il team ha davvero aperto, non solo in un frammento di ricerca.
  • Ogni numero che sembra una misura deve comparire nelle prove o nel profilo del titolare.

Gli errori tornano allo specialista per una breve riscrittura, senza bisogno di una chiamata all’IA per trovarli. Solo dopo Vyn rivede: approva, chiede una revisione (al massimo due) o passa la decisione al titolare.

Il revisore più economico è un’espressione regolare. Non si stanca mai, e non lascia mai passare un’email inventata.

Compromesso: una regex può segnalare un numero corretto scritto in modo diverso dalla fonte. Considerare noti i dati del titolare rende il caso raro.

4. L’IA lavora come l’utente, mai come amministratore

Gli spazi di lavoro contengono liste di clienti, prezzi e bozze. Una query che dimentica un filtro non deve far trapelare i dati di un altro titolare. Per questo tutte le 25 migrazioni mantengono attiva la sicurezza a livello di riga, con policy riservate al titolare su ogni tabella, e il motore IA gira come il titolare collegato, non con la service role. Un agente non può leggere quello che il titolare non può leggere.

I file stanno in un bucket privato sotto l’ID del titolare e vengono serviti con URL firmati validi dieci minuti. Ho imparato a mettere i permessi nel database a mie spese, su altri prodotti. Qualcuna di queste storie è nei miei appunti di sviluppo.

Compromesso: le esecuzioni in background richiedono una vera sessione del titolare creata sul server, con più parti in movimento rispetto a una chiave di servizio.

5. Le missioni devono sopravvivere alla scheda del browser

Una missione di ricerca clienti può durare minuti. Il titolare che chiude il portatile non deve perdere il lavoro, e nemmeno un deploy a metà strada deve farglielo perdere.

Le missioni girano sul server. Ogni esecuzione tiene un lease di quattro minuti che ogni chiamata all’IA rinnova. Un watchdog controlla ogni minuto e riprende un’esecuzione interrotta dall’ultimo passaggio completato. Dopo tre riprese automatiche, o dopo 30 minuti di inattività, la missione si chiude in modo pulito con un pulsante Riprova invece di restare appesa per sempre.

Lo stato in tempo reale arriva al browser tramite Supabase Realtime, così quando il titolare torna l’ufficio e la bacheca mostrano esattamente a che punto si è.

Compromesso: sugli host serverless il watchdog ha bisogno di una chiamata cron ogni minuto, e le esecuzioni lunghe si fermano tra un passaggio e l’altro dopo nove minuti.

6. Un prezzo su ogni chiamata

Gli agenti che girano in loop con gli strumenti possono consumare soldi senza farsi notare. Una piccola agenzia ha bisogno di un costo prevedibile.

Ogni chiamata a Gemini è registrata con modello, token, costo stimato e latenza. Ogni missione parte con un budget di 1 USD e si ferma al limite finché il titolare non decide di continuare. I modelli sono scelti per livello in un unico file: Pro per il ragionamento e le revisioni di Vyn, Flash per gli specialisti, Flash-Lite come riserva veloce, ognuno con tentativi e timeout. I limiti del piano sono verificati sul server prima che parta una missione, non solo nell’interfaccia.

Compromesso: i costi sono stimati dai token, quindi seguono da vicino la fattura del fornitore ma non sono la fattura.

7. Ogni pagina web è ostile

Gli agenti leggono il web aperto. Una pagina può provare a raggiungere indirizzi interni, o nascondere istruzioni rivolte al modello.

Un registro decide quale ruolo può usare quale strumento, e quante volte. Il lettore di pagine accetta solo http(s) e indirizzi IP pubblici, ricontrolla ogni redirect e limita dimensioni e tempi. Il testo scaricato entra nel prompt marcato come input non affidabile, così una pagina che dice “ignora le tue istruzioni” resta solo testo da leggere, non un ordine.

Compromesso: con limiti così stretti alcune pagine pesanti vengono lette solo in parte.

8. L’approvazione è il prodotto, non un’impostazione

Un’IA che scrive da sola a un ristorante, con un dettaglio sbagliato, danneggia il nome dell’agenzia. Le piccole agenzie vivono della loro reputazione.

Per questo lo specialista di outreach scrive solo bozze. Le bozze diventano elementi da approvare nella missione, il titolare le rivede una per una e niente viene inviato finché la revisione non è finita. Modifiche e rifiuti con una nota diventano piccole lezioni salvate per ogni spazio di lavoro e aggiunte ai prompt successivi, così il team si avvicina ogni volta di più alla voce del titolare.

vynoroai.com/work/review
La coda di revisione: ogni bozza è legata al difetto trovato sul sito del potenziale cliente.
La coda di revisione: ogni bozza è legata al difetto trovato sul sito del potenziale cliente.

Il titolare deve dedicare qualche minuto alla revisione. È la posizione del prodotto, non un limite da eliminare.

Cosa ha richiesto davvero costruirlo da solo

Oltre alle otto scelte, tre abitudini hanno fatto gran parte del lavoro:

  • I prompt sono codice. Sono organizzati in quattro livelli con versione: una costituzione che ogni agente segue, un modello per ruolo, il profilo dello spazio di lavoro e il compito con i risultati dei colleghi. Cambiare un livello non cambia di nascosto gli altri.
  • Rendere visibile il lavoro. L’ufficio 3D non è decorazione. Mostra solo quello che il backend delle missioni pubblica, quindi senza missioni attive il team resta fermo. Vedere il lavoro vero è il modo in cui le persone imparano a fidarsi. I movimenti della camera e le animazioni hanno i loro test, così una modifica non rompe la vista.
  • Usarlo per primo. Gestisco la mia agenzia con VYNORO. La regola della revisione prima dell’invio e i controlli nel codice sono nati proprio da lì.

I prossimi passi sono soprattutto infrastruttura. Missioni e integrazioni saranno organizzate per spazio di lavoro invece che per titolare, e i file originali passeranno su Storage. Poi arriveranno più integrazioni per inviare il lavoro approvato e una suite di test più ampia intorno al motore delle missioni.

Vuoi un team di IA così per la tua azienda?

VYNORO è pensato per le piccole agenzie, ma questi schemi funzionano per qualsiasi azienda che voglia agenti IA al lavoro su cose concrete. Penso a leggere email e PDF, aggiornare un CRM, preparare report e scrivere bozze di risposta, con una persona che approva prima di ogni invio.

È il tipo di sistema che sviluppo per i clienti, di persona a Macerata e nelle Marche e da remoto in tutta Italia e in Europa. Leggi il case study completo di VYNORO, guarda i miei servizi oppure dimmi cosa vorresti far fare ai tuoi agenti.

Su numeri e immagini: vengono dal codice di VYNORO e dal mio spazio di lavoro per Barmjli, con missioni reali su dati pubblici.

Domande frequenti

Con quale stack tecnologico è costruito VYNORO?

Next.js 16 e React 19 in TypeScript, Supabase (Postgres con sicurezza a livello di riga, Realtime, Storage e Auth), modelli Gemini su Vertex AI e three.js con React Three Fiber per l’ufficio 3D. Sono circa 40.000 righe di TypeScript con 25 migrazioni del database.

Come si evita che gli agenti IA inventino dati?

Ogni risultato di uno strumento diventa una prova con un codice che il report deve citare. Prima che un revisore IA veda il lavoro, controlli deterministici nel codice scartano ogni email che non compare su una pagina aperta dal team e ogni numero che non è nelle prove.

Come si tengono sotto controllo i costi degli agenti IA?

Ogni chiamata al modello è registrata con modello, token, costo stimato e latenza. Ogni missione parte con un budget di 1 USD e si ferma al limite finché il titolare non decide di continuare, e i modelli sono scelti per livello: Pro per il manager, Flash per gli specialisti, Flash-Lite come riserva.

Come sopravvive un lavoro lungo a un browser chiuso o a un deploy?

Le missioni girano sul server come il titolare collegato. Ogni esecuzione tiene un lease di quattro minuti che ogni chiamata all’IA rinnova, e un watchdog controlla ogni minuto e riprende un’esecuzione interrotta dall’ultimo passaggio completato.

Puoi costruire un sistema di agenti IA simile per la mia azienda?

Sì. Progetto e sviluppo agenti IA e automazioni per aziende in Italia e in Europa: pianificazione, strumenti veri, controlli nel codice e approvazione umana prima di ogni invio. Scrivi a contact@stackreda.com o usa la pagina dei contatti.
Reda Bellassery
Reda BellasseryFondatore di VYNORO · Sviluppatore full-stack e IA a Macerata

Sviluppo agenti IA, applicazioni web e app mobile per le aziende e gestisco la mia agenzia, Barmjli. Qui scrivo di quello che costruisco e di cosa mi ha insegnato.

Continua a leggere