Transpareo nell’era degli agenti di intelligenza artificiale

È appena terminato il turno. La responsabile della conformità esporta l’elenco dei turni dal sistema di produzione, lo inserisce nel suo assistente e scrive una frase: «Pubblicare i passaporti di prodotto relativi alle celle presenti in questo elenco.»

L’assistente legge 1240 numeri di serie con i relativi lotti, verifica presso Transpareo quali documenti siano necessari per quel prodotto, crea i documenti e li sottopone a verifica rispetto alle norme del regolamento. Risposta: 1237 sono conformi, 3 no, poiché in un lotto manca l’impronta di CO₂. L’azienda fornisce il valore successivamente e l’assistente lo pubblica. Due giorni dopo, le celle lasciano lo stabilimento, ciascuna con un codice QR tramite il quale è possibile consultare il relativo passaporto.

Non si tratta di una visione futuristica: con Transpareo Connect è già possibile oggi. Un assistente si occupa qui di un’attività di compliance, dall’incarico al pass firmato, e Transpareo gli fornisce lungo tutto il percorso tutte le informazioni necessarie a tal fine.

Lo provi subito

Dispone di un account su Claude, ChatGPT, Grok o Gemini che consenta di collegare applicazioni? In tal caso, lo colleghi alla nostra demo aperta. Si tratta di un ambiente di prova: ogni ora viene ricreato da zero, e qualsiasi operazione vi effettui verrà cancellata entro quel momento.

1. Collegamento. Crei presso il Suo fornitore di IA un nuovo server MCP con l’indirizzo https://demo.transpareo.com/mcp . A seconda del fornitore, lo troverà nella sezione Connector, Integration o App.
2. Condividi. Effettui l’accesso con tester e Tester@12345
   • i dati di accesso sono riportati qui intenzionalmente. La schermata successiva elenca singolarmente ogni autorizzazione. Per quelle di sola lettura può concedere l’autorizzazione in modo permanente; per quelle di scrittura è preferibile richiedere una conferma per ciascuna di esse.
3. Domande. Tornando alla finestra di chat, formuli la domanda in un linguaggio quotidiano, ad esempio: «Elenchi i passaporti di prodotto dei nostri prodotti.»

Si chiedeva un elenco; invece è stata letta la situazione.

Non vi verrà restituito solo ciò che avete richiesto, ma anche in che stato si trova. Ciò è possibile perché l’interfaccia fornisce ulteriori informazioni oltre alle righe stesse: quante sono, dove si trovano nel curriculum, cosa manca.

Questo è il motivo per cui è stato scritto questo articolo. Il resto spiega perché funziona.

Detto, fatto

Si doveva collegare esattamente un lato: l’assistente a Transpareo, i tre passaggi di cui sopra. L’altro era un file che il sistema di produzione genera comunque. Nessuno ha stabilito quale colonna corrisponda a quale campo, nessuno gestisce un’interfaccia: l’assistente ha letto l’elenco e ha generato i dati di passaggio, e ciò che doveva fare era indicato in una sola frase. Se l’elenco cambia, cambia un’istruzione all’assistente, non il codice di programma.

Il Suo sistema non deve essere in grado di fare nulla in proposito. Deve semplicemente fornire ciò che fornisce comunque: il file di esportazione, l’elenco tratto dal report, la tabella relativa alla fine del turno.

E non deve necessariamente trattarsi di una tabella. La scheda tecnica di un fornitore, un PDF, una cronologia di e-mail: anche da questi documenti un assistente estrae i valori e li adatta al formato richiesto da Transpareo. Infatti, Transpareo specifica tale formato, anziché lasciare che si deve indovinare. I dati di prodotto raramente sono disponibili in forma strutturata, ma si trovano nei documenti, e ricaverli da lì è stato per anni il punto di strangolamento.

Lo stesso elenco potrebbe essere importato anche manualmente. L’importatore presente nel gestore dell’applicazione accetta le tabelle, assegna un nome alle colonne che ha riconosciuto, verifica l’esecuzione prima che venga generato alcun risultato e, se richiesto, annulla l’operazione. Il risultato sarebbe stato lo stesso. Solo che qualcuno avrebbe dovuto confermare l’assegnazione, leggere il report e inserire personalmente i tre valori mancanti. Una procedura guidata non modifica ciò che è possibile fare, ma il tempo necessario per farlo.

Il lavoro di integrazione, che finora ha sempre costituito la fase iniziale di ogni progetto di compliance, oggi può essere sintetizzato in una sola frase in linguaggio comune.

Questa è la vera rivoluzione. A condizione che la piattaforma all’altra estremità sia in grado di comunicare a un programma ciò che richiede.

I programmi sono sempre stati i principali lettori

Un passaporto di prodotto viene raramente letto a mano. Viene scansionato, recuperato, verificato, trasmesso e archiviato, e la maggior parte di queste operazioni viene eseguita da un software: il registratore di cassa del rivenditore, il sistema del riciclatore, lo strumento di verifica di un’autorità, l’importatore che desidera sapere se un lotto è conforme. La maggior parte dei suoi lettori, quindi, non lo legge con gli occhi, ma tramite un programma.

Transpareo è quindi strutturato attorno alla propria interfaccia. Ogni pass pubblicato è un documento firmato e leggibile da macchina , e l’interfaccia copre l’intero ciclo di vita: dai tipi di proprietà di un prodotto, passando per la convalida e la creazione , fino alla pubblicazione e agli eventi relativi a un singolo pezzo sul campo. Inoltre, è gestita per versioni: chi oggi sviluppa qualcosa per questo sistema non costruisce sulla sabbia. La novità, quindi, non sta nel fatto che i programmi lavorino con i passaporti. La novità sta in quali programmi lo fanno.

Ed è per questo che il lavoro di un assistente non si esaurisce nella creazione del documento. Lo stesso tipo di frase ricorre in tutto il resto del curriculum:

• «Richiami tutti i pass del lotto B-2214.»
• «Inserisca il nuovo valore di CO₂ per il lotto 88.»
• «Mi mostri tutti i pass che sono stati inviati in riparazione questo mese.»

Ciascuna di queste istruzioni genera le stesse chiamate che un utente attiverebbe nel gestore dell’applicazione e lascia la stessa traccia nel registro di audit.

Un assistente deve essere in grado di chiedere, non di indovinare

Un assistente è un collaboratore molto veloce che non possiede alcuna conoscenza preliminare della vostra azienda. Fa ciò che gli viene detto e colma le lacune con delle supposizioni quando non gli vengono fornite delle risposte. Quattro elementi trasformano le supposizioni in lavoro concreto.

Deve poter chiedere quali siano i requisiti richiesti. Per ogni prodotto e ogni livello di dettaglio , la piattaforma indica quali identificativi e caratteristiche sono necessari per un pass e quali di questi sono già registrati nel prodotto. Per un singolo articolo, la situazione si presenta così:

{
  "identifiers": {
    "batchIdentifier": { "required": true },
    "modelIdentifier": { "required": true, "source": "product", "value": "4006381333931" },
    "serialIdentifier": { "required": true }
  }
}

L’assistente deve procurarsi due dei tre codici identificativi; il terzo è già riportato sul prodotto. Si tratta di una procedura operativa, non di un gioco a indovinelli.

Deve poter effettuare verifiche senza dover scrivere. Una convalida esegue gli stessi controlli di una pubblicazione e non crea nulla. È proprio per questo che, come indicato sopra, il numero 1237 è diventato 3 prima che fosse pubblicato alcunché.

Deve comprendere il motivo per cui una richiesta è stata respinta. Un messaggio di rifiuto indica il campo in questione e spiega cosa occorre fare:

PRODUCT_INVALID: Product invalid
Correct the attributes listed under fields and resend the request.
  brand: Brand needs a brand - none was given
  componentsInput: Components input missing

Un assistente che legge il messaggio aggiunge due informazioni e lo invia nuovamente. Chi riceve solo un codice di errore, prova diverse soluzioni. Si tratta dello stesso testo che una persona vede nella riga di comando .

Non deve commettere errori di conteggio. Se una connessione si interrompe e l’assistente riprova, si genera comunque un solo pass, non due. Le richieste in scrittura contengono una chiave, grazie alla quale la piattaforma riconosce una ripetizione come tale.

Ogni accesso può essere revocato

Più sono i programmi che elaborano i Suoi dati, più diventa importante stabilire chi è autorizzato a fare cosa. Un’autorizzazione viene creata nel gestore dell’applicazione e rivela la propria chiave segreta una sola volta. Successivamente, il programma opera con token che scadono dopo un’ora, e la chiave segreta viene trasmessa solo all’entità che emette i token. Viene memorizzata nel portachiavi del sistema operativo, mai in un argomento della riga di comando, che altrimenti risulterebbe in ogni elenco di processi.

Ogni accesso dispone esattamente dei diritti che gli attribuite: la lettura è uno, la scrittura un altro, la pubblicazione un terzo, e può essere limitato a singoli prodotti. Le operazioni irreversibili richiedono inoltre una conferma.

Quando un assistente si collega tramite il browser, prima dell’ autorizzazione viene visualizzata una schermata che elenca ogni singola autorizzazione da lui richiesta. Una volta concessa l’autorizzazione, la connessione viene visualizzata nella pagina degli accessi, con il nome e la data della persona che l’ha concessa, e viene disattivata proprio in quella stessa pagina.

Un accesso che non si può revocare non è un accesso, bensì una chiave nascosta sotto lo zerbino.

I Suoi dati rimangono di Sua proprietà

Ciò che perviene a un fornitore di IA è ciò che Lei richiede tramite il Suo assistente - e spetta a Lei, non a noi, decidere quale sia e se il trattamento avvenga all’interno dell’ UE. Un servizio di traduzione riceve un valore proveniente dai Suoi dati di prodotto solo laddove avete attivato la traduzione, e solo per voi stessi. Lo strumento che stabilisce la connessione gira sul vostro computer e il suo codice sorgente è aperto: il vostro reparto di sicurezza può verificare cosa fa, anziché limitarsi a crederci.

Per un’azienda europea, questo è il punto cruciale. La piattaforma stessa è ospitata in centri di elaborazione dati certificati ISO 27001 in Germania; la destinazione dei dati oltre tale limite dipende esclusivamente dalla scelta dell’assistente. Potete scegliere un assistente che effettui il trattamento all’interno dell’UE oppure uno che non lasci mai la vostra azienda: transpareo mcp gestisce il protocollo sul vostro stesso computer, e quale modello vi sia dietro, è una vostra scelta.

A ciò si aggiunge il contenuto stesso di un passaporto di prodotto. Si tratta, di norma, di dati relativi al prodotto: numeri di serie, lotti, materiali, valori di misurazione. Laddove dovesse esserci un riferimento a una persona, saranno le vostre regole a stabilire chi è autorizzato a visualizzarlo, e l’ autorizzazione potrà essere personalizzata con precisione: solo lettura, solo determinati prodotti, disattivabile in qualsiasi momento.

Si installa in pochi minuti

Lo stesso vale per il Suo spazio di lavoro, al proprio indirizzo, ad esempio https://dpp.example.com/mcp: gli stessi tre passaggi, non è necessario installare nulla.

Chi preferisce digitare o trasformare le procedure in script, utilizza la riga di comando. transpareo è un programma autonomo i cui comandi vengono generati dalla descrizione dell’interfaccia: ciò che la piattaforma è in grado di fare, lo fa anche lo strumento, senza che qualcuno debba allineare manualmente le due parti. È open source ed è disponibile su GitHub. Tre righe: installare, effettuare l’accesso, verificare quali autorizzazioni sono concesse all’account.

curl -fsSL https://transpareo.com/cli/install.sh | sh
transpareo auth login --host dpp.example.com --client-id <id>
transpareo me

auth login legge il segreto dall’input standard o da una variabile d’ambiente, mai da un argomento che altrimenti figurerebbe nell’ elenco dei processi e nella cronologia della shell. Successivamente, lo stesso file binario elabora le operazioni:

transpareo dpps requirements --product-id 8 --granularity item
transpareo dpps validate --file passport.json
transpareo dpps create --file passport.json
transpareo dpps publish <code>
transpareo events tail --follow

Se sul Suo computer è in esecuzione un assistente, lo collega un’ ulteriore riga:

transpareo setup claude

Le stesse operazioni sono quindi disponibili come strumenti, con nomi corrispondenti: dpp_requirements, validate_dpp, create_dpp, publish_dpp, tail_events. Ciò che digitate nella riga di comando e ciò che viene richiamato da una procedura guidata è la stessa cosa. A ciò si aggiunge una guida per gli assistenti che descrive le consuete procedure, affinché nessuno debba impararne la sequenza per tentativi ed errori. E chi preferisce programmare direttamente, troverà la descrizione completa dell’interfaccia su ogni spazio di lavoro all’indirizzo /apidocs.

Un assistente non comporta alcun costo aggiuntivo

Nulla in più. Un assistente si collega in qualità di utente API e l’accesso per i programmi è incluso in ogni piano tariffario Transpareo. Vengono conteggiati i pass pubblicati, non il numero di persone o di programmi che vi lavorano. Chi automatizza il proprio lavoro di conformità non deve ricevere alcuna fattura a tale titolo.

Il lavoro inizia prima degli obblighi

A partire da febbraio 2027, il passaporto di prodotto per le batterie diventerà obbligatorio; seguiranno altre categorie di prodotti. L’effettivo onere non risiede nel passaporto stesso, bensì nell’organizzazione dei dati di prodotto, ed è proprio questo lavoro che le aziende stanno attualmente affidando agli assistenti: raccogliere i campi, individuare le lacune, verificare i dati dei fornitori, controllare, ripetere. Il modo in cui questi dati vengono effettivamente inseriti nel pass è descritto in «Un flusso, una direzione»; mentre la guida all’integrazione ERP illustra come si presenta un collegamento dedicato a tale scopo.

Un assistente che deve formulare ipotesi genera documenti che sembrano plausibili ma non reggono a un controllo. Un assistente che è in grado di porre domande genera documenti corretti. La differenza non risiede nell’assistente, bensì nella piattaforma a cui egli si rivolge.