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 digita una frase: «Pubblica i certificati di prodotto per le celle presenti in questo elenco.»

L’assistente legge 1240 numeri di serie con i relativi lotti, verifica su Transpareo quali dati siano necessari per la scheda tecnica di quel prodotto, crea le schede tecniche e le sottopone a verifica rispetto alle norme del regolamento. Risultato: 1237 sono pronti, 3 no, poiché in un lotto manca l’impronta di CO₂. Lei fornisce il valore mancante e l’assistente procede alla pubblicazione. Due giorni dopo le celle lasciano lo stabilimento, ciascuna con un codice QR tramite il quale è possibile consultare la relativa scheda tecnica.

Non si tratta di una scena futuristica: con Transpareo è già possibile oggi. Un assistente svolge qui **un’attività di conformità, dall’ordine fino al certificato firmato **, e la piattaforma gli fornisce lungo il percorso tutte le informazioni necessarie a tal fine.

Provatelo subito

Avete un account su Claude, ChatGPT, Grok o Gemini che consenta di collegare applicazioni? Allora collegatelo al nostro Demo. Si tratta di un ambiente di prova: ogni ora si ricrea da zero, e ciò che vi fate al suo interno viene cancellato entro quel momento.

1. Collegamento. Crei una nuova applicazione nel Suo assistente, inserisca https://demo.transpareo.com/mcp come indirizzo e clicchi su «Collega».
2. Condivisione. Effettuate l’accesso con tester e DemoPass2027
   • i dati di accesso sono riportati qui intenzionalmente. La schermata successiva elenca singolarmente ogni autorizzazione. Per quelle in lettura può concederle in modo permanente; per quelle in scrittura è preferibile confermarle singolarmente.
3. Richiesta. Tornato alla finestra di chat, formuli la richiesta in linguaggio quotidiano, ad esempio «Elenchi i nostri schede prodotto».

La richiesta era un elenco; è stato letto lo stato.

Come risposta non riceve solo ciò che ha richiesto, ma anche in quale stato si trova. Ciò è possibile perché l’interfaccia fornisce più informazioni rispetto alle righe stesse: quante sono, dove si trovano nel curriculum, cosa manca.

Questo è il motivo di questo articolo. Il resto spiega perché funziona.

Detto, fatto

Si trattava di collegare esattamente una pagina: l’assistente a Transpareo, i tre passaggi di cui sopra. L’altra era un file che il sistema di produzione genera comunque. Nessuno ha stabilito quale colonna corrisponda a quale campo, nessuno si occupa della manutenzione di un’interfaccia: l’assistente ha letto l’elenco e ha scritto i passaggi, e ciò che doveva fare era indicato in una sola frase. Se l’elenco cambia, cambia un’istruzione all’assistente, **nessun codice di programma **.

Il Vostro sistema non deve essere in grado di fare nulla per questo. Deve solo produrre ciò che produce comunque: il file di esportazione, l’elenco dal report, la tabella di fine turno.

Lo stesso elenco potrebbe essere importato anche manualmente. L’importatore nell’ Application Manager 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, rapporto e inserire autonomamente i tre valori mancanti . **Un assistente non modifica ciò che è possibile, ma il tempo necessario per farlo. **

Il lavoro di integrazione, che finora era all’inizio di ogni progetto di conformità, oggi si riassume in una frase di linguaggio quotidiano.

Questo è il vero e proprio cambiamento epocale. A condizione che la piattaforma dall’altra parte sia in grado di comunicare a un programma ciò che richiede.

I programmi sono sempre stati i principali lettori

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

Transpareo è pertanto strutturato attorno alla propria interfaccia. Ogni certificato pubblicato è un documento firmato e leggibile da una macchina, e l’interfaccia copre l’intero ciclo di vita: dalle caratteristiche di un prodotto, passando per la verifica e la creazione, fino alla pubblicazione e agli eventi relativi a un singolo pezzo sul campo. Inoltre, è versionata: chi oggi sviluppa qualcosa basandosi su di essa non costruisce sulla sabbia. La novità, quindi, non sta nel fatto che i programmi lavorino con i passaporti. La novità sta in quali programmi.

Ed è per questo che il lavoro di un assistente non si esaurisce con la creazione. Lo stesso tipo di istruzione si ripete per tutto il resto del ciclo di vita:

• «Richiamate tutti i certificati del lotto B-2214.»
• «Aggiungete 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 frasi si traduce nelle stesse operazioni che una persona avvia nell’Application Manager, lasciando la stessa traccia.

Un assistente deve poter chiedere, non indovinare

Un assistente è un collaboratore molto veloce senza conoscenze preliminari sulla vostra azienda. Fa ciò che gli viene detto e colma le lacune con supposizioni, se non gli vengono fornite risposte. Quattro elementi trasformano le supposizioni in lavoro effettivo.

Deve poter chiedere cosa è richiesto. 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 identificatori; il terzo è già presente sul prodotto. Si tratta di una procedura operativa, non di una lezione di indovinelli.

Deve poter effettuare una verifica senza dover scrivere codice. Una verifica esegue gli stessi controlli di una pubblicazione e non crea nulla. Proprio per questo motivo, il numero 1237 è stato aggiunto al 3 prima che fosse pubblicato qualsiasi contenuto.

Deve comprendere il motivo per cui qualcosa è stato rifiutato. Un rifiuto indica il campo in questione e spiega cosa occorre fare:

PRODUCT_INVALID: Prodotto non valido
Corregga gli attributi elencati nei campi e invii nuovamente la richiesta.
  brand: Il marchio deve essere specificato - non è stato indicato alcun marchio
  componentsInput: Mancano i dati relativi ai componenti

Un assistente che legga questo messaggio integra due dati e invia nuovamente la richiesta. Chi riceve solo un codice di errore, invece, prova diverse soluzioni. Si tratta dello stesso testo che una persona vede nella riga di comando .

Non deve sbagliare il conteggio. Se una connessione si interrompe e l’assistente riprova, viene comunque generato un solo pass, non due. Le chiamate in scrittura contengono una chiave, grazie alla quale la piattaforma riconosce una ripetizione come tale.

Ogni accesso può essere revocato

Più programmi lavorano sui Suoi dati, più diventa importante chi è autorizzato a fare cosa. Un accesso viene creato nell’Application Manager 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 al punto in cui vengono emessi i token. Essa viene memorizzata nel portachiavi del sistema operativo, mai in un argomento della riga di comando, che altrimenti figurerebbe in ogni elenco di processi.

Ogni autorizzazione comporta esattamente i diritti che Le vengono concessi: la lettura è una cosa, la scrittura un’altra, la pubblicazione una terza, e può essere limitata fino al singolo prodotto. Le operazioni irreversibili richiedono inoltre una conferma.

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

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

I vostri dati rimangono presso di voi

Transpareo non invia nulla di propria iniziativa a un fornitore di IA. Ciò che giunge a un fornitore è ciò che voi richiamate tramite il vostro assistente - e chi sia questo e se il trattamento avvenga all’interno dell’UE lo decidete voi, non noi. Lo strumento che stabilisce la connessione gira sul Suo computer e il suo codice sorgente è aperto: il Suo reparto di sicurezza può verificare cosa fa, invece di limitarsi a crederci.

Per un’azienda europea questo è il punto decisivo. La piattaforma stessa si trova in centri di calcolo certificati ISO 27001 in Germania; dove vengono inviati i dati oltre a ciò, lo determina esclusivamente la scelta dell’assistente. Potete sceglierne uno che effettui il trattamento all’interno dell’UE, oppure uno che non azienda: transpareo mcp gestisce il protocollo sul Suo computer e quale modello vi sia dietro, è una Sua scelta.

A ciò si aggiunge ciò che è effettivamente riportato in un passaporto del prodotto. Si tratta, di norma, di dati relativi al prodotto: numeri di serie, lotti, materiali, valori di misurazione. Laddove dovesse esserci un riferimento a persone fisiche, sono le vostre regole a stabilire chi può visualizzarlo, e l’ autorizzazione può essere personalizzata con precisione: solo lettura, solo determinati prodotti, disattivabile in qualsiasi momento.

La configurazione richiede pochi minuti

Lo stesso vale per la vostra area di lavoro personale, con il proprio indirizzo, ad esempio https://dpp.example.com/mcp: gli stessi tre passaggi, senza necessità di installazione.

Chi preferisce digitare o automatizzare le procedure tramite script, può utilizzare la riga di comando. transpareo è un unico programma i cui comandi vengono generati dalla descrizione dell’interfaccia: ciò che la piattaforma è in grado di fare, lo può fare anche lo strumento, senza che qualcuno debba adattare manualmente entrambi. È open source e si trova su GitHub. Tre righe: installare, effettuare l’accesso, verificare quali autorizzazioni sono concesse.

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

Il nome utente viene letto da auth login dall’input standard o da una variabile d’ambiente, mai da un argomento, che altrimenti risulterebbe nella lista dei processi e nella cronologia della shell. Successivamente, lo stesso file binario esegue le operazioni seguenti:

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 sulla propria macchina è in esecuzione una procedura guidata, un’ulteriore riga la collega:

transpareo setup claude

Le stesse operazioni saranno 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 un assistente è la stessa cosa. A ciò si aggiunge una guida per gli assistenti che descrive le consuete procedure, affinché nessuno debba imparare la sequenza per tentativi ed errori. E chi preferisce programmare direttamente, troverà la descrizione completa dell’interfaccia su ogni area di lavoro in /apidocs.

Un assistente non comporta costi aggiuntivi

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

Il lavoro inizia prima che diventi obbligatorio

A partire da febbraio 2027, il passaporto di prodotto per le batterie sarà obbligatorio; seguiranno altri gruppi di prodotti. Il vero onere non risiede nel passaporto, bensì nell’organizzazione dei dati di prodotto, ed è proprio questo lavoro che le aziende stanno affidando proprio agli assistenti: raccogliere i campi, individuare le lacune, verificare i dati dei fornitori, controllare, ripetere. Come questi dati vengano effettivamente inseriti nel passaporto è descritto in «Una corrente, una direzione»; come si presenta un collegamento dedicato a tale scopo, lo illustra la guida al collegamento ERP.

Un assistente costretto a tirare a indovinare produce certificati che sembrano plausibili ma non reggono a un controllo. Un assistente in grado di porre domande produce certificati corretti. La differenza non sta nell’assistente, bensì nella piattaforma a cui si rivolge.