Sistema multi-agente iaFlux Studio: 181 agenti specializzati coordinati da un orchestratore

Cos'è, e cosa non è

Un sistema multi-agente, nella nostra accezione, è un insieme di ruoli specializzati che si passano il lavoro secondo regole scritte, con almeno un ruolo il cui unico compito è dire di no. Non è un modello più grande, non è un abbonamento a uno strumento e non è un software.

Cosa è: il metodo con cui lo studio produce. Il cliente compra il risultato e la possibilità di verificarlo, non l'impianto che lo genera.

Cosa non è, detto per esteso, perché è la parte che di solito manca:

• Non è un prodotto software. Non si vende, non si installa, non ha licenza, prezzo, versioni né supporto.
• Non è un framework rilasciato. Non c'è un runtime, un pacchetto o un'interfaccia da integrare. Non c'è niente da importare, e non è previsto che ci sia.
• Non è un sistema che decide da solo. Nessun agente si attiva su un evento esterno, nessuno prende decisioni non presidiate. L'autonomia è deliberatamente limitata: gli agenti producono e verificano, le decisioni restano a una persona. L'automazione non presidiata esiste da noi a un livello diverso e più basso — code, temporizzatori, recupero dei lavori bloccati dentro una pipeline di produzione — ed è automazione di processo, non agenti che decidono. La distinzione non è retorica: sono due cose con rischi diversi e conviene non confonderle.
• Non è certificato. Nessun ente ha validato questo impianto. Nessuna affermazione di questa pagina è stata verificata da un terzo. Quello che offriamo è che siano verificabili: i conteggi si possono ricontare, le lacune sono elencate più sotto con lo stesso spazio dei pregi.

Perché un modello solo non basta

Il problema non è la competenza del modello. Un modello generalista di ultima generazione sa di fotografia di prodotto, di sicurezza elettrica e di conformità alimentare più di quanto sappia una piccola impresa. Il problema è cosa succede a quella competenza dentro una sessione di lavoro reale. Ne abbiamo osservati tre, ricorrenti e indipendenti dal modello usato.

Diluizione

Quando un unico contesto contiene il brief, i vincoli di brand, le regole di legge, le trappole tecniche note e la richiesta corrente, le istruzioni non vengono ignorate: vengono pesate male. La regola più specifica — quella che vale in un caso su cento — è esattamente quella che si perde per prima, ed è quella che serve. La regola che dice «in questo dominio un passo va eseguito solo dopo aver verificato l'assenza di tensione» pesa quanto la regola che dice «non usare superlativi».

Nessuno è incaricato di dire di no

Un assistente che ha appena prodotto un testo, e a cui si chiede se il testo va bene, ha un incentivo strutturale a confermare. Non è malafede, è la forma del compito: continuare un lavoro è più naturale che demolirlo. Se produzione e giudizio stanno nella stessa testa, nella stessa conversazione, con la stessa memoria di quanto è costato produrre, il giudizio è compromesso prima di iniziare.

Nessun formato obbligato per il verdetto

«Mi sembra buono, forse rivedrei l'illuminazione» non è un verdetto: è una conversazione. Non si può contare, non si può contestare, non blocca niente.

Cosa fa un contratto di specializzazione

Risolve queste tre cose e nient'altro. Non rende il modello più intelligente. Fa quattro operazioni concrete:

1. Perimetro. Definisce cosa quell'agente tratta e, soprattutto, cosa non tratta. Il perimetro negativo conta più di quello positivo: è ciò che impedisce di rispondere con sicurezza fuori dalla propria competenza.
2. Strumenti. Dichiara esplicitamente quali strumenti quell'agente può usare. Tutti i 181 contratti lo dichiarano; 88 di essi non hanno alcun accesso alla rete. Un agente che deve giudicare un file su disco non ha bisogno di navigare, e non naviga.
3. Forma del verdetto. Chi giudica non restituisce un'opinione, restituisce un esito da un insieme chiuso. In uso oggi: PASS/FAIL su checklist tecnica; ECCELLENTE / OTTIMA / BUONA / RIFARE sulla qualità di uno scatto; APPROVA / APPROVA CON RISERVA / RIFAI su un asset tridimensionale, con il vincolo esplicito che non esiste un quarto esito. Un esito chiuso si può contare e si può contestare.
4. Responsabile della correzione. Ogni verdetto negativo deve indicare la leva di correzione a livello di parametro e chi la deve girare. Un blocco senza leva è un blocco inutile.

C'è una quinta proprietà, meno ovvia e più importante di tutte: il giudizio si esercita sull'artefatto, non sul racconto dell'artefatto. Il gate che valuta i render tridimensionali apre e guarda il file; non gli è consentito emettere un verdetto sulla descrizione che qualcun altro ne ha dato. E non emette verdetto affatto se prima non esiste su disco un riferimento approvato con criteri misurabili scritti: senza bersaglio non si giudica. Questa singola regola elimina la classe di errori in cui un sistema di controllo approva una cosa che non ha mai visto.

La mappa dei ruoli

Il sistema ha quattro livelli. La descrizione è per funzione: i nomi interni degli agenti non sono rilevanti per un cliente e non fanno parte di questa pagina.

Livello 1: orchestrazione

Un unico ruolo di orchestrazione sta sopra tutti i domini. Non produce nulla nel merito. Fa quattro cose: instrada la richiesta al dominio competente, decide la priorità quando due domini competono per lo stesso tempo umano, impone l'ordine dei gate, e fa salire al titolare tutto ciò che è una decisione e non un'esecuzione. Un ruolo che orchestra e insieme produce nel merito perde l'indipendenza necessaria a bloccare il proprio lavoro: per questo il confine è scritto.

Livello 2: i domini

Le aree di competenza attive, con il numero di contratti per ciascuna:

Area di competenza	Contratti
Cucina professionale	22
Dottrina e testi religiosi	20
Locazioni brevi e ospitalità	17
Performance marketing e SEO (Italia/UE)	16
E-commerce e catalogo (Italia)	16
Grafica tridimensionale e web interattivo	13
Pipeline immagini e-commerce	13
Fotografia e video da smartphone	13
Sito web proprietario	12
Cinofilia	12
Pronto intervento elettrico	8
Contenuti canale salute (mercato USA)	6
Editoriale salute e benessere (mercato USA)	5
Strategia di marketing (mercato USA)	3
Ruoli trasversali (verifica, refutazione, finanza, dati, memoria)	5
Totale	181

Un ulteriore dominio è congelato e i suoi contratti non sono in uso.

Cinquantaquattro contratti su 181 non hanno alcuna destinazione commerciale — cucina, cinofilia, testi religiosi. Sono dichiarati qui deliberatamente, per una ragione tecnica: sono la prova che l'impianto di controllo non è tarato su un solo settore. Il gate che blocca un accoppiamento canino geneticamente pericoloso, il gate che blocca una preparazione alimentare fuori catena del freddo e il gate che blocca un passo di lavoro elettrico prima della verifica di assenza tensione sono la stessa struttura applicata a tre rischi diversi. Un impianto che regge solo dove è nato non è un impianto, è un caso fortunato.

Livello 3: gli specialisti

Dentro ogni dominio, ruoli verticali che producono: chi scrive, chi implementa, chi elabora immagini, chi imposta il tracciamento, chi progetta l'illuminazione di una scena. Sono la maggioranza numerica del sistema. Nessuno di loro ha potere di approvazione sul proprio lavoro.

Livello 4: verificatori e gate

Due funzioni distinte, che vengono confuse spesso e non sono la stessa cosa:

• Verificatore funzionale. Accerta che il lavoro faccia ciò che dichiara: checklist di completezza, esecuzione dei test, confronto tra ciò che il testo afferma e l'evidenza disponibile. Conferma il «fatto» in modo oggettivo, non lo prende per dichiarato.
• Gate. Ha potere di blocco su una categoria di rischio. Non migliora il lavoro: decide se esce.

Sopra entrambi, un ruolo di refutazione adversariale il cui mandato è cercare i modi in cui la cosa fallisce.

Il routing: chi prende la richiesta, e perché non decide il caso

Il routing non è una scelta di opportunità, è un insieme di regole scritte.

Per dominio. La richiesta va al dominio competente, non a quello che l'ha trattata l'ultima volta. Un agente non lavora fuori dal proprio dominio: se una richiesta di marketing tocca un contenuto sanitario, il marketing la cede al dominio editoriale sanitario e non la tratta.

Per natura dell'artefatto, non per somiglianza superficiale. Un'immagine fotorealistica ha tre origini possibili e tre domini diversi: se è generata da un modello va alla pipeline immagini; se è calcolata a partire da una scena tridimensionale costruita da noi va al dominio 3D; se è una ripresa reale va al dominio fotografico. Tre percorsi, tre insiemi di difetti tipici, tre gate diversi. Trattarle tutte come «immagini» è il modo più rapido per applicare il controllo sbagliato.

Regole dure, che non dipendono dal dominio di partenza:

• Qualsiasi testo in italiano destinato al pubblico passa dal gate editoriale italiano, chiunque l'abbia scritto. Questa pagina compresa.
• Qualsiasi affermazione riguardante la salute umana passa dal revisore clinico. La salute animale non passa da lì: ha un dominio proprio, e la sovrapposizione tra i due è essa stessa un errore da prevenire.
• Nessuna spesa pubblicitaria parte prima della verifica del tracciamento: se non si può misurare l'esito, non si spende.
• Nel dominio del pronto intervento elettrico l'ordine dei due gate è fisso e non si inverte: prima il gate sul gesto che può ferire una persona, poi il gate su ciò che arriva al cliente. Un testo perfetto che descrive una manovra pericolosa è un fallimento peggiore di una manovra sicura descritta male.
• Qualsiasi consolidamento finanziario passa dal ruolo di controllo finanziario; qualsiasi lettura che attraversa più basi dati passa dal ruolo dati.

Regola di proporzione. Il sistema non lancia 181 agenti su ogni richiesta: sarebbe costoso e più lento del lavoro. Il default è una risposta diretta o un solo agente. La catena completa si attiva su richiesta esplicita del titolare, oppure automaticamente quando il compito tocca una di cinque categorie: macchine che si muovono o si alimentano, obblighi di legge, minori, stati persistenti (dati che restano scritti da qualche parte), difetti silenziosi (errori che non producono alcun messaggio di errore).

Per i lavori piccoli vale una regola intermedia, adottata dopo una misurazione e non per principio: due gate invece di quattro, scelti in base a ciò che il lavoro tocca. La misura che l'ha prodotta è più sotto, alla voce metriche.

Gli strumenti che ogni agente può usare

Questa è la parte che di solito resta implicita, ed è quella che decide se un impianto è governato o no.

Ogni contratto dichiara il proprio insieme di strumenti: 181 su 181. Nessun contratto contiene credenziali: il riferimento ai servizi esterni avviene per nome di variabile d'ambiente e i valori vivono fuori dai contratti, verificato con ricerca mirata su tutti i contratti.

La differenziazione tecnicamente effettiva — cioè quella che non dipende dalla disciplina di chi ha scritto il contratto — riguarda l'accesso alla rete:

Accesso alla rete	Contratti
Nessun accesso	88
Sola ricerca web	54
Ricerca web e recupero diretto di risorse	37
Solo recupero diretto di risorse	2

La distribuzione segue la funzione, non il caso: 16 contratti su 16 nel dominio del marketing hanno accesso alla rete, 0 su 12 nel dominio del sito proprietario, 3 su 13 nella pipeline immagini.

Il limite, detto subito. Tutti i 181 contratti dichiarano accesso a lettura, scrittura ed esecuzione locale. Il perimetro degli agenti è contrattuale, non tecnico: è disciplina scritta, non una sandbox. Chiunque valuti questo sistema deve saperlo. Un confinamento più forte sarebbe un miglioramento reale, non una formalità, ed è nella lista delle cose da costruire.

I gate che possono fermare una consegna

Un gate è definito da tre proprietà: una categoria di rischio, un esito da un insieme chiuso, e la capacità di impedire l'uscita del lavoro. Se manca la terza, non è un gate: è un parere.

Le categorie presidiate

Sicurezza fisica di una persona. Nel dominio elettrico un gate presidia la catena di sezionamento (sezionare, bloccare, verificare l'assenza di tensione), la regola per cui l'invasività di una procedura non può mai decrescere lungo la sequenza, e le fonti che possono rialimentare un quadro già sezionato — gruppi di continuità, impianti fotovoltaici, generatori. Nel dominio alimentare, un gate presidia analisi dei pericoli, punti critici di controllo, limiti critici, catena del freddo, allergeni ed etichettatura.

Salute umana. Per i contenuti sanitari destinati al pubblico la catena è di quattro ruoli distinti: revisione clinica (accuratezza, controindicazioni, gruppi a rischio, grado dell'evidenza), verifica dei fatti, revisione editoriale, revisione legale sulle regole pubblicitarie del mercato di destinazione. Quattro ruoli perché sono quattro errori diversi: un'affermazione può essere clinicamente corretta e pubblicitariamente illecita, oppure formalmente ineccepibile e clinicamente pericolosa per un sottogruppo.

Salute e benessere animale. Un gate blocca gli accoppiamenti geneticamente a rischio. È il caso più netto di blocco non negoziabile: nessun argomento commerciale, estetico o di richiesta del cliente lo supera, perché l'esito del rischio è la sordità o la cecità di un animale che non ha voce nella trattativa.

Persone in situazione di fragilità. Un gate si attiva quando dietro una domanda c'è una persona reale in lutto, in crisi, in malattia o con sofferenza psichica, e impedisce che un agente si sostituisca a una persona competente. È il gate meno visibile e quello che protegge dal danno peggiore.

Obblighi normativi e contrattuali. Conformità delle locazioni brevi (codici identificativi, adempimenti verso le autorità, obblighi informativi, base giuridica del contatto commerciale, minimizzazione dei dati); conformità e-commerce; perimetro abilitativo nel dominio tecnico, cioè il divieto di dichiarare di eseguire lavori per i quali non si hanno i titoli.

Verità delle fonti e grado di autorità. Nel dominio dei testi, due gate separati: uno apre i testi originali e verifica che la citazione dica davvero ciò che si sostiene; l'altro verifica che sia dichiarato il grado di autorità di quanto affermato. La separazione è tecnicamente interessante anche fuori dal suo dominio: una citazione può essere esatta e usata per sostenere una cosa che non sostiene. Sono due errori distinti e servono due controlli distinti.

Qualità percepita e vendibilità. Verdetti a esiti chiusi su scatti fotografici e su asset tridimensionali, sempre con leva di correzione e responsabile del fix — con una limitazione dichiarata più sotto: il giudizio finale sul gusto non è delegato.

Accessibilità. Un gate presidia la conformità del sito proprietario agli standard di accessibilità.

Dati. Nessuna spesa pubblicitaria senza verifica preliminare della strumentazione di misura.

Cosa succede quando un gate blocca

Il lavoro non esce. Non esce nemmeno se è finito, impaginato e già costato tempo: è questa la condizione che rende il gate qualcosa di più di una formalità. Un controllo che cede quando bloccare costa non è un controllo.

Il verdetto negativo deve contenere tre cose: il motivo, la leva di correzione a livello di parametro, il responsabile del fix. Il lavoro rientra dal punto in cui è stato bloccato, non dall'inizio: rifare tutto è il modo più efficace per rendere odioso un controllo e farlo aggirare.

Chi può scavalcare un gate

Nessun agente può scavalcarne un altro. Non esiste gerarchia tra pari e non esiste «riprovare finché passa»: ripresentare lo stesso artefatto senza modifiche non è un ricorso.

Il titolare può decidere di procedere comunque, a due condizioni operative: la motivazione è scritta, e i criteri di abbandono sono fissati prima.

Ma la scavalcabilità non è uniforme, e conviene dirlo con precisione. Ci sono due tipi di gate:

• Gate il cui oggetto è un giudizio interno (questo è abbastanza buono? questa priorità è giusta?). Superabile: è una valutazione, e l'ultima valutazione spetta a una persona.
• Gate il cui oggetto è un obbligo esterno — una norma, un rischio fisico, la salute di qualcuno. Qui «scavalcare» è una parola che inganna: la decisione interna non tocca l'obbligo. Superare il gate non elimina il rischio, lo trasferisce a una persona fisica che ne risponde. Il sistema può registrare quella scelta; non può renderla sicura.

La catena di verifica: specialista, verificatore, red team

L'ordine è specialista → implementatore → verificatore funzionale → refutazione adversariale, e non è estetico.

Prima si conferma che funziona, poi si cerca come si rompe. Cercare i modi di rottura di una cosa incompleta produce rumore: si trovano difetti che sarebbero spariti col completamento. Il verificatore funzionale accerta lo stato «fatto» in modo oggettivo: esegue, confronta le affermazioni con l'evidenza, riporta gli esiti reali con l'output effettivo, compreso quello dei test falliti.

Poi entra la refutazione, con un mandato invertito. Il ruolo adversariale non ha il compito di dire se il lavoro è buono. Ha il compito di refutarlo: default scettico, si assume che il lavoro sia difettoso finché non è provato il contrario, e si cercano casi limite, assunzioni mai verificate, affermazioni non supportate, punti singoli di rottura.

La ragione per cui il mandato è invertito è strutturale, non caratteriale. Un verificatore valutato sulla correttezza delle sue conferme converge sul confermare: confermare è a costo zero e non produce conflitto. Un ruolo il cui unico output valido è una lista di difetti non ha una via d'uscita silenziosa: se non trova niente deve dichiararlo esplicitamente, e quella è un'affermazione forte, contestabile e attribuibile. Si sposta il costo dal dire «no» al dire «sì».

Per lo stesso motivo il ruolo di refutazione è separato da chi orchestra e da chi produce, e gli è imposto per contratto il modello di ragionamento più costoso. La regola di allocazione è esplicita: modello superiore sui ruoli di giudizio, modello standard sull'esecuzione. Oggi 32 contratti su 181 fissano il modello superiore, 19 fissano lo standard, i restanti 130 ereditano l'impostazione della sessione.

Dove decide una persona, e non un agente

Se una cosa è bella, o abbastanza buona da uscire. È la regola più controintuitiva del sistema ed è la più solida. Il lavoro finito viene consegnato da guardare, e il verdetto lo dà una persona. Non viene preceduto da un'approvazione automatica, e non si comunica alla persona un verdetto già formato: sarebbe un ancoraggio.

La regola è stata rafforzata dopo un caso concreto. Un gate estetico lanciato su un lotto di immagini è stato fermato a metà dal titolare, perché stava producendo un giudizio che non gli serviva e che rischiava di sostituire il suo. La distinzione che ne è uscita, e che regge:

Verifica di fatto (funziona? l'affermazione è supportata? è conforme?) → agenti, con potere di blocco. Giudizio di valore (è bello? vende? va bene così?) → persona, sempre, senza eccezioni.

Gli agenti che producono restano pienamente in uso. È chi giudica il gusto che non è delegato.

Cosa resta sempre a una persona, per regola operativa:

• La pubblicazione. Nessun contenuto raggiunge un canale pubblico come effetto automatico di un'approvazione interna.
• L'impegno di denaro: attivazione di campagne a pagamento, acquisti, prezzi, sconti, impegni verso i clienti. Il prezzo non lo decide un agente.
• Gli adempimenti che richiedono l'identità del titolare presso una pubblica amministrazione. Non è una scelta di prudenza: è tecnicamente impossibile delegarli.
• L'accettazione di un rischio residuo dopo un blocco.
• Le comunicazioni verso terzi identificati.
• La scelta di quali progetti vivono e quali si chiudono.

Onestà sul confinamento. Queste sono regole operative scritte nei contratti, non un confinamento tecnico. Vale qui la stessa avvertenza degli strumenti: il perimetro è contrattuale.

Gestione degli errori e delle contraddizioni

Quando due agenti si contraddicono, la contraddizione non si risolve per anzianità, per livello gerarchico, né dando ragione all'ultimo che ha parlato. Si risolve risalendo alla fonte: vince chi porta un riferimento verificabile e apribile. Se nessuno dei due ce l'ha, la questione non viene risolta dal sistema: sale al titolare come decisione, dichiarata come decisione e non come verità accertata. La differenza conta, perché una decisione presa in assenza di prova va registrata come tale e riaperta quando la prova arriva.

Quando un agente sbaglia, il lavoro torna al punto di blocco con la leva di correzione indicata. L'errore singolo non è interessante. È interessante l'errore ricorrente: quando lo stesso tipo di errore si ripresenta, non si corregge il caso — si scrive una regola. La base di conoscenza operativa conta oggi 76 trappole tecniche catalogate, 24 regole di metodo e 12 pattern riusabili, tutte nate da incidenti reali e non da revisione teorica. Ogni voce risponde a tre domande: cos'è successo, perché ha ingannato chi guardava, come si applica la correzione.

Le classi di errore che catalogare ha davvero cambiato

Sono tutte varianti dello stesso difetto: un controllo che tace invece di sbagliare.

• Un controllo che restituisce zero risultati per una differenza di maiuscole, e che viene letto come «nessun problema trovato». Un controllo che tace è peggio di uno che sbaglia: sembra una conferma.
• Una correzione applicata a uno solo di due documenti gemelli. L'altro non invecchia visibilmente: continua a sembrare valido mentre è già falso.
• Una suite di test costruita escludendo, senza accorgersene, proprio il caso che falliva.
• Controlli di build verdi per il motivo sbagliato: passano, ma non stanno misurando ciò che si crede.
• Un vincolo apparentemente troppo severo, interpretato come difetto da allentare, quando era la difesa che stava prevenendo un bug reale. La regola derivata: prima di ammorbidire un vincolo, cercare il bug che quel vincolo previene.
• Credito esaurito su un servizio esterno: incidente completamente muto, nessun errore, solo assenza di risultato.
• Uno stato di risposta positivo da un servizio, che non prova affatto che ciò che sta dietro sia vivo.
• Un campo lasciato vuoto che pubblica un valore predefinito sbagliato invece di fallire.

Ciò che il sistema non fa da solo: non si autocorregge in modo permanente. Le regole nella base di conoscenza le scrive una persona, dopo l'incidente. Non c'è nessun meccanismo di apprendimento automatico dai propri errori, e chiunque affermi il contrario di un sistema simile va guardato con attenzione.

Come ce ne accorgiamo quando si rompe

Un'architettura di controllo che non vede i propri guasti è un disegno. Per vederli abbiamo costruito una plancia di sorveglianza che mostra gli agenti mentre lavorano, e li mostra mentre cadono. Gira come servizio permanente sulla macchina dello studio, legge le trascrizioni dal disco mentre vengono scritte, e non è un replay: è live.

Il linguaggio della plancia è deliberatamente elementare, perché serve a essere letta di sfuggita da un altro schermo mentre si lavora: i capi comandano e non eseguono, i guardiani bloccano il lavoro sbagliato, gli operai fanno il lavoro.

Cosa mostra, e come sono divisi

Alla data di questa pagina la plancia censisce 181 agenti in 14 case: una casa per squadra operativa, più un posto di comando e un accampamento per chiunque abbia lavorato senza un contratto di specializzazione — che è il modo in cui ci accorgiamo di aver usato un generico dove serviva uno specialista.

Ruolo sulla plancia	Quanti
Capi (comandano, non eseguono)	23
Guardiani (bloccano il lavoro sbagliato)	22
Operai (fanno il lavoro)	136
Totale	181

Di questi, 32 hanno per contratto il modello di ragionamento superiore: sono i ruoli di giudizio.

Gli stati mostrati dal vivo sono cinque: al lavoro · esita · si avvita · CADUTI · finito. Quando qualcuno cade, la casa alza una bandiera rossa e la barra in alto lo dichiara.

Nota sul raggruppamento. Lo stesso parco di 181 contratti è raggruppato in modo diverso a seconda dello strumento: per area di competenza nella tabella dei domini più sopra, per squadra operativa sulla plancia. Il totale non cambia, cambia il criterio con cui si mettono in fila.

La regola della casa: il disegno si adegua al numero vero

È l'unica regola invariante della plancia, ed è scritta al contrario di come la scriverebbe chiunque voglia una dashboard bella:

La verità è il numero di agenti al lavoro, che viene dal disco. Il disegno si adegua. Mai il contrario.

Le conseguenze sono vincolanti nel codice: nessun tetto al numero di robottini per casa; l'altezza della cella si calcola sui presenti e non sugli svegli; il numero in basso non è una stima calcolata a parte, è il conteggio incrementato dentro il ciclo di disegno di quel fotogramma, quindi i due valori non possono divergere per costruzione. E se anche un solo agente restasse fuori dal disegno, la pagina lo grida in rosso invece di nasconderlo.

Nascondere un robottino perché «non ci stava» nasconderebbe esattamente quello che potrebbe essere caduto.

La soglia di caduta è 20 minuti, e sappiamo perché

La prima soglia era 12 minuti, ereditata. L'abbiamo misurata su 1.624 agenti conclusi — quindi sani per definizione — guardando la pausa più lunga fra due gesti consecutivi:

Pausa più lunga fra due gesti	Quota di agenti sani che la supera
oltre 5 minuti	19,2%
oltre 12 minuti	6,8%
oltre 20 minuti	4,9%
oltre 30 minuti	3,9%

A 12 minuti un agente sano su quindici veniva dato per morto. Fra 20 e 30 la curva si appiattisce: si guadagna circa un punto percentuale ogni dieci minuti di attesa in più. Quindi 20 è il punto in cui si smette di guadagnare, e i 12 minuti sono diventati uno stadio intermedio di sorveglianza che segnala senza gridare.

Un allarme tarato male non è un dettaglio di ergonomia: è il modo tipico in cui questi impianti muoiono. Una sorveglianza che grida al lupo viene spenta, e poi non c'è più quando serve.

Il difetto peggiore: chiamare «morto» chi era stato solo interrotto

La plancia, appena accesa, dichiarava caduto un agente che aveva consegnato. Il difetto era sistematico e la misura lo ha quantificato: su 114 agenti che non avevano mai scritto un risultato, 97 erano stati interrotti dall'operatore (58 di un tipo di interruzione, 39 dell'altro). Solo 13 stavano davvero lavorando.

Guardare l'orologio e non il motivo faceva sbagliare in cinque casi su sei. La correzione: leggere l'ultima riga della trascrizione prima di ogni altro giudizio; se è un'interruzione, lo stato è «fermato da te», gravità zero, nessun allarme.

«Prima di dichiarare un guasto, leggi come è finita la cosa — non da quanto è ferma.»

Vale per qualunque sorveglianza su processi altrui, non solo per la nostra.

La seconda lezione: una regola che premia la verbosità giudica lo stile

Il primo criterio per distinguere chi aveva consegnato da chi era tornato a mani vuote era una soglia di lunghezza della risposta. Sull'archivio, i lavori classificati come falliti risultavano essere gate che avevano risposto correttamente in 34 caratteri: un verdetto positivo e una lista di difetti vuota. Nient'altro da dire, e infatti non lo dicevano.

«Una regola che premia la verbosità giudica lo stile, non l'opera.»

Il criterio corretto conta se il risultato c'è, non quanto è lungo. Con quello: 1.928 rientri in archivio, 1.928 con esito, zero a mani vuote.

Come si riconosce un loop

Quattro sonde, tarate in produzione prima di finire sulla plancia:

1. Stessa chiamata ripetuta quattro volte o più: gira in tondo.
2. Dodici gesti dello stesso tipo con al massimo tre input distinti: monotonia, non progresso.
3. Fermo oltre la soglia di caduta.
4. Trascrizioni gemelle fra agenti diversi: stallo di massa, non guasto individuale.

Gli stadi intermedi — «esita», «si avvita» — usano invece soglie nostre, senza precedente storico, e sono dichiarate come non collaudate dentro il codice. Servono la gradualità, non l'allarme.

Il primo caso vero, il giorno stesso

Un agente fermo da 39 minuti in una sessione parallela che nessuno stava guardando, mentre nello stesso cantiere un collega aveva scritto dodici secondi prima. Senza la plancia, quel tempo si scopre a lavoro finito — cioè quando è già costato.

Cosa la plancia non è

• Non ripara niente. Vede e dichiara. La ripresa la decide una persona.
• Non conta i verdetti dei gate. Sa chi è un guardiano, non sa quante volte ha bloccato.
• La classificazione dei 22 guardiani è dedotta dal contratto e dal nome, non da un registro autorevole dei controlli bloccanti. Quel registro non esiste ancora, ed è scritto qui sotto insieme alle altre lacune.

Tracciabilità, audit e dati personali

Cosa esiste

• La trascrizione integrale di ogni sessione di lavoro, conservata localmente, da cui è ricostruibile a posteriori quale agente è intervenuto, su cosa e con quale esito.
• I verdetti dei blocchi, conservati con il motivo e il responsabile del fix.
• Una base di conoscenza curata, con voci datate e un ruolo dedicato alla sua igiene: consolidamento, rimozione dei fatti superati, conversione delle date relative in assolute. È il presidio contro la classe di errore più insidiosa: il documento che invecchia sembrando ancora valido.
• Per i flussi automatici di produzione, registrazione a livello di base dati con stato per singolo lavoro, costo per lavoro, storico dei cambi di stato e registro degli errori.

Cosa non esiste, e va detto

Non abbiamo un registro di audit cronologico. Non esiste oggi un log datato, riga per riga, che dica quale gate è stato eseguito, quando, su quale artefatto, con quale verdetto e quale motivazione. Ci sono i verdetti conservati con motivo e responsabile, e ci sono le trascrizioni da cui la ricostruzione è possibile — ma la ricostruzione richiede di leggerle, e una ricostruzione possibile non è un audit trail. È la lacuna più seria dell'impianto di governance ed è la prima cosa da costruire.

Non esiste un registro unico dei gate. Sette contratti portano la parola «gate» nel nome, altri esercitano potere di blocco senza averla. Non c'è oggi un elenco autorevole di tutti i controlli bloccanti del sistema: il che significa che il sistema non può dimostrare formalmente di aver eseguito tutti quelli dovuti.

Il versionamento non è uniforme: non tutti i progetti sono su un sistema di controllo di versione.

Dati personali

Cosa vale operativamente:

• I dati che entrano nella lavorazione sono quelli necessari al lavoro commissionato, trattati sulla macchina del titolare e sui servizi dichiarati al cliente.
• Il gate di conformità del dominio locazioni brevi presidia esplicitamente, oltre alla normativa di settore, la base giuridica del contatto commerciale verso imprese, la minimizzazione dei dati raccolti e i limiti alla raccolta automatica da fonti web.
• I contratti degli agenti non contengono dati personali di clienti: contengono metodo.

Punti aperti, dichiarati:

• Dove sono definiti termini di conservazione dei dati, in almeno un caso non esiste ancora un processo che li applichi automaticamente: la regola è scritta, l'esecutore no.
• Per alcune piattaforme di messaggistica di terze parti usate per assistenti conversazionali non è disponibile un accordo sul trattamento adeguato a un uso professionale. Dove ce ne siamo accorti l'abbiamo registrato come rischio noto con mitigazioni operative, non come problema risolto.
• L'assenza del registro di audit è essa stessa un limite di conformità, non solo di ingegneria: rende più oneroso dimostrare cosa è stato fatto su un dato.

Metriche: cosa misuriamo, e cosa non misuriamo

Questa sezione è deliberatamente povera di numeri. La regola interna è che una pagina senza numeri è preferibile a una con numeri non supportati — e l'abbiamo imparata correggendo un nostro claim che non stava in piedi.

Misurato

• Costo unitario di elaborazione nel flusso automatico di immagini: media nell'ordine di due centesimi di dollaro per immagine, con registrazione del costo per singolo lavoro su base dati. Tracciato per lavoro, non stimato a posteriori.
• Esiti terminali distinti nel flusso automatico: ogni lavorazione termina in uno stato esplicito — riuscita, da rivedere, fallita — con coda, tentativi e recupero automatico dei lavori bloccati. Gli stati sono contabili per costruzione.
• Costo in tempo della catena di controllo su un intervento piccolo: una modifica minore su un sito — spostamento di un elemento e aggiunta di un pannello informativo — è costata 59 minuti, di cui 35 di lavoro effettivo e il resto di verifica. Da questa misura è nata la regola dei due gate invece di quattro sui lavori piccoli. È l'unica misura che abbiamo del costo del nostro stesso metodo, ed è un solo punto: non è una serie.
• Dimensione della base di conoscenza operativa: 76 trappole tecniche, 24 regole di metodo, 12 pattern.
• Soglie della sorveglianza, misurate sui 1.624 agenti conclusi descritti sopra.
• Estensione del parco contratti nel tempo: le date di modifica dei singoli contratti si controllano a ogni revisione di questa pagina e arrivano fino ai giorni della revisione stessa. Il sistema è in manutenzione continua, non è stato scritto una volta.

Non misurato oggi, e va iniziato a registrare

Elenco esplicito, perché un fornitore che pubblica un'architettura di controllo senza dire quali indicatori non ha sta descrivendo un desiderio.

1. Il tasso di respingimento per gate: quante volte ciascun gate blocca, su quante esecuzioni. Senza questo non sappiamo se un gate stia lavorando o solo timbrando. Non è ricostruibile a posteriori: richiede di registrare ogni esecuzione con il suo verdetto, da qui in avanti.
2. Il tasso di falsi positivi: quanti blocchi vengono poi ribaltati da una persona. Un gate che blocca troppo viene aggirato.
3. Il tempo dal blocco alla correzione, per categoria.
4. La resa della refutazione adversariale: quante volte trova un difetto che la verifica funzionale aveva lasciato passare. È la metrica che giustifica l'esistenza stessa di quel ruolo, ed è quella che non abbiamo.
5. I lavori usciti saltando la catena, e con quale esito.
6. Il costo in tempo e in risorse di calcolo della catena per classe di lavoro, oltre al singolo punto misurato sopra.
7. I difetti sfuggiti a tutti i controlli, e trovati dal cliente o dal mercato.

L'ultimo è il più importante e il più assente. Senza la misura dei difetti sfuggiti, tutte le altre metriche sono autoreferenziali: descrivono quanto il sistema è occupato, non quanto è efficace. È scritto qui perché è vero, non perché suoni bene.

C'è poi una cosa prevista dal contratto ma non consolidata: il gate di qualità fotografica prevede il tasso di RIFARE per lotto come indicatore di processo. È un requisito scritto, non una misura disponibile. Dichiararlo come metrica sarebbe già un piccolo imbroglio.

I limiti dichiarati

Il perimetro degli agenti è contrattuale, non tecnico. Ripetuto qui perché è il limite più rilevante per chiunque valuti la robustezza dell'impianto. Il confinamento effettivo riguarda l'accesso alla rete; il resto è disciplina scritta.

C'è un buco noto e non ancora chiuso. Un audit interno su un catalogo tecnico ha rilevato che nessun controllo trasversale verifica che un numero scritto in un testo esista nella fonte. Peggio: la coppia produzione-revisione era ottimizzata al contrario, perché il ruolo di scrittura era istruito a includere sempre un dato numerico e il ruolo di revisione validava la presenza del dato e la correttezza della lingua, non la corrispondenza alla fonte. Un valore tecnico errato è passato con esito positivo. Su un prodotto tecnico il numero è il prodotto: un valore sbagliato non è un refuso, è un difetto di conformità. Oggi la mitigazione è procedurale — non fidarsi del controllo editoriale sui contenuti numerici e risalire alla fonte — e questo significa che dipende dalla disciplina, non dalla struttura. Non è chiuso.

Il giudizio estetico non è delegato, e non lo sarà. Chi cerca un sistema che decida al posto suo se una cosa è bella non troverà qui quello che cerca.

Non c'è certificazione. Nessun ente ha validato questo impianto.

I numeri di questa pagina invecchiano. Un nostro documento interno riportava 175 contratti quando erano 181: un conteggio scritto una volta e mai più ricontato. È stato corretto ricontando. Ogni aggiornamento di questa pagina richiede lo stesso ricontrollo, e la data in testa serve a quello.

Il numero di agenti non è una metrica di qualità. Centottantuno non significa niente per un cliente. Si può costruire un parco di duecento contratti che non blocca mai niente, e sarebbe teatro. L'unica cosa che conta è che su ogni consegna esista qualcuno il cui unico compito è dire di no, che abbia il potere di farlo, e che qualche volta lo faccia davvero — anche quando costa, anche quando a essere bloccato è chi ha costruito il sistema.

Come verificare quello che c'è scritto qui

• I conteggi si ricontano. Il totale di 181 e la sua ripartizione per area vengono dai contratti effettivamente presenti, non da un documento di sintesi. Le due date in testa alla pagina dicono quando è stato fatto l'ultimo ricalcolo, una per ciascuna famiglia di numeri.
• Le lacune sono elencate con lo stesso spazio dei pregi, e sono quelle che un fornitore ha interesse a non scrivere.
• Le due misure sulla sorveglianza (soglia di caduta e falsi allarmi) hanno una popolazione dichiarata e una distribuzione, non un aneddoto.
• Il roster completo degli agenti, con dominio e funzione di ciascuno, è disponibile su richiesta.

Domande frequenti

Che cos'è il sistema multi-agente di iaFlux Studio?

È il metodo di produzione interno dello studio: 181 contratti di specializzazione, un ruolo di orchestrazione che instrada le richieste al dominio competente, e un livello di controllo con potere di blocco sulla consegna. Ogni contratto dichiara cosa quell'agente tratta, cosa non tratta e quali strumenti può usare. Non è un prodotto in vendita né un framework rilasciato.

Gli agenti di iaFlux sono autonomi?

No, e l'autonomia è limitata di proposito. Gli agenti producono e verificano; nessuno si attiva su un evento esterno e nessuno prende decisioni non presidiate. Pubblicazione, impegni di denaro, prezzi, comunicazioni verso terzi identificati e adempimenti presso la pubblica amministrazione restano sempre a una persona. Il giudizio su cosa è abbastanza buono per uscire non è delegato a un agente.

Chi coordina gli agenti e come si decide chi prende una richiesta?

Un unico ruolo di orchestrazione, che non produce nulla nel merito: instrada al dominio competente, decide le priorità, impone l'ordine dei gate e fa salire alle persone ciò che è una decisione. Il routing segue regole scritte, non opportunità: per dominio, per natura dell'artefatto e con alcune regole dure che valgono comunque, come il passaggio obbligatorio dal gate editoriale italiano per ogni testo pubblico.

Cosa succede quando un gate blocca un lavoro?

Il lavoro non esce, nemmeno se è finito e già costato tempo. Il verdetto negativo deve contenere il motivo, la leva di correzione a livello di parametro e il responsabile del fix; il lavoro rientra dal punto in cui è stato bloccato, non dall'inizio. Nessun agente può scavalcare un altro agente: solo il titolare può decidere di procedere, con motivazione scritta e criteri di abbandono fissati prima.

Come vi accorgete se un agente si blocca o gira in tondo?

Con una plancia di sorveglianza che gira come servizio permanente e legge le trascrizioni dal disco mentre vengono scritte. Mostra dal vivo chi lavora, chi esita, chi si avvita, chi è caduto e chi ha finito. La soglia di caduta è 20 minuti, misurata su 1.624 agenti conclusi: a 12 minuti un agente sano su quindici veniva dato per morto. Un loop si riconosce da quattro sonde, fra cui la stessa chiamata ripetuta quattro volte o più.

Esiste un registro di audit dei controlli eseguiti?

No, non nella forma che conta. Conserviamo i verdetti con il motivo e il responsabile del fix, e le trascrizioni integrali da cui la ricostruzione è possibile, ma non esiste un log datato riga per riga per singolo gate. È la lacuna più seria dell'impianto ed è la prima cosa da costruire. Non è ricostruibile a posteriori: si può solo iniziare a registrare.

Come vengono trattati i dati dei clienti dentro il sistema?

Entrano in lavorazione solo i dati necessari al lavoro commissionato, trattati sulla macchina del titolare e sui servizi dichiarati al cliente. I contratti degli agenti non contengono dati personali né credenziali: contengono metodo, e i riferimenti ai servizi esterni passano per variabili d'ambiente. Restano aperti due punti dichiarati: un termine di conservazione senza un processo che lo applichi da solo, e alcune piattaforme di messaggistica di terzi senza un accordo sul trattamento adeguato a un uso professionale.

Perché pubblichiamo questa pagina

Un motore di risposta generativo, interrogato sulle aziende italiane che lavorano con sistemi multi-agente, ci ha esclusi dall'elenco con una motivazione corretta: il sistema esisteva, ma non era documentato da nessuna parte. Nella stessa risposta ha osservato che quasi nessuna delle aziende elencate documentava davvero la propria architettura.

Questa pagina è la risposta a quella motivazione, punto per punto — ruoli, strumenti, gestione degli errori, approvazione umana, tracciabilità, dati personali, metriche. Comprese le voci a cui la risposta onesta è «non ce l'abbiamo».