Gli strumenti per gli agenti

Ultimo aggiornamento:

Un agente AI che lavora dentro il browser può leggere una pagina come la leggi tu, cercando fra titoli e paragrafi quello che gli serve. Oppure può chiedere al sito quali azioni offre e usarle direttamente, con domande e risposte strutturate. WebMCP è l'interfaccia che rende possibile la seconda strada, e questa pagina dice cosa ci trova un agente quando visita volcanicminds.com.

Cos'è WebMCP

WebMCP permette a una pagina web di dichiarare degli strumenti, ognuno con un nome, una descrizione e lo schema dei parametri che accetta, e permette a un agente ospitato nel browser di elencarli e chiamarli. L'idea viene dal Model Context Protocol, ma qui non c'è un server da raggiungere: gli strumenti vivono nella pagina e si registrano con document.modelContext.

La specifica è una bozza del Web Machine Learning Community Group del W3C, nella versione del 2 ottobre 2026. Non è ancora uno standard: la parte imperativa, quella degli strumenti registrati da JavaScript, è scritta; quella dichiarativa, che descrive i moduli HTML con degli attributi, è ancora da scrivere nella specifica e si basa sulla proposta che la accompagna.

Cosa può fare un agente qui

Su ogni pagina del sito, in italiano e in inglese, un agente trova otto strumenti in sola lettura: una panoramica di Volcanic Minds, la ricerca fra le applicazioni che costruiamo, il dettaglio di un servizio, la ricerca fra case study, articoli e domande frequenti, la definizione di un termine del glossario e i dati dell'azienda. Rispondono con gli stessi contenuti che leggi nelle pagine, con l'indirizzo della pagina da cui vengono.

L'unico strumento che scrive è il modulo della pagina dei contatti, dichiarato sul modulo stesso. Un agente può compilarlo per te, e il messaggio fa la stessa strada di quando lo scrivi tu, con gli stessi controlli e lo stesso limite di invii.

L'elenco completo, con i parametri di ogni strumento, è in fondo a questa pagina. Non è scritto a mano: viene dallo stesso registro che il sito usa per dichiarare gli strumenti al browser, quindi non può elencare uno strumento che il browser non vede.

Le garanzie

  • Sui browser senza WebMCP non cambia niente: il codice controlla se document.modelContext esiste prima di fare qualunque cosa, e se non esiste la pagina non scarica un byte in più.
  • I dati arrivano alla prima chiamata. Le risposte vengono da un file JSON per lingua, generato dai contenuti del sito a ogni pubblicazione e scaricato solo quando un agente usa uno strumento per la prima volta.
  • Gli strumenti in sola lettura non salvano niente, né sul tuo dispositivo né da noi, e non usano cookie. Il modulo di contatto tratta i dati come descritto nell'informativa privacy.
  • Ogni affermazione che uno strumento restituisce su applicazioni e ambiti di clienti si regge su una pagina del sito: se la prova manca, la pubblicazione si ferma.

Come provarlo

Verificato alla fonte il 6 ottobre 2026. Chrome offre WebMCP dalla versione 149 attraverso una prova a tempo per i siti che vi si iscrivono, e Microsoft Edge ha una prova analoga attiva fino al 30 marzo 2027. Questo sito non è iscritto a nessuna delle due, quindi per vedere gli strumenti serve attivare l'interfaccia a mano: in Chrome apri chrome://flags/#enable-webmcp-testing, impostalo su Enabled e riavvia il browser. Negli altri browser la pagina funziona come sempre, senza strumenti.

Un esempio di chiamata

Con l'interfaccia attiva, apri la console degli strumenti per sviluppatori su una pagina del sito e cerca fra le domande frequenti (provato su Chrome 155 l'8 ottobre 2026; le versioni precedenti volevano i parametri come testo JSON):

const tools = await document.modelContext.getTools();
const faq = tools.find((t) => t.name === 'cerca-faq');
const answer = await document.modelContext.executeTool(faq, { query: 'tempi', limit: 3 });
JSON.parse(answer);

La risposta contiene il numero totale di risultati e i primi tre, ognuno con la domanda, la risposta e l'indirizzo della pagina con l'ancora.

Gli stessi dati, senza WebMCP

Chi non ha un browser con WebMCP trova gli stessi contenuti in altre due forme: il file llms.txt, l'indice del sito pensato per i modelli linguistici, e la versione in Markdown di ogni pagina, che si ottiene aggiungendo .md all'indirizzo (per la home, /index.md).

Gli strumenti

Nome, descrizione e parametri come li riceve un agente sulle pagine in italiano. Le pagine in inglese offrono gli stessi strumenti con nomi e descrizioni in inglese e gli stessi parametri.

Panoramica di Volcanic Minds

panoramica-volcanic-minds, sola lettura.

Chi è Volcanic Minds: la presentazione, i tre valori, gli otto ambiti di clienti, i servizi con una riga e l’indirizzo, i case study con gli ambiti in cui sono stati realizzati e le applicazioni che costruiamo. Il punto da cui partire.

Nessun parametro.

Cerca le applicazioni

cerca-applicazioni, sola lettura.

Che cosa costruisce Volcanic Minds per un ambito di clienti, un settore o un bisogno. Restituisce le applicazioni trasversali con il testo di ogni ambito, lo stato e le prove, e i case study come applicazioni realizzate. «delivered» vuol dire consegnata in un progetto in quell’ambito; «suited» vuol dire adatta, senza un progetto consegnato lì.

Parametri:

  • query (testo, facoltativo): Parole da cercare: tornano solo i risultati che le contengono tutte, senza distinguere maiuscole e accenti.
  • area (testo, facoltativo, valori studi-consulenza, aziende-servizi, aziende-prodotto, produzione, sanita, startup, commercio-distribuzione, pubblica-amministrazione): Solo questo ambito di clienti. Nome e perimetro di ogni ambito sono nella panoramica.
  • status (testo, facoltativo, valori delivered, suited): Solo gli ambiti in questo stato: delivered (realizzata) o suited (adatta).
  • limit (numero intero, facoltativo, da 1 a 50): Numero massimo di risultati, da 1 a 50; 10 se non indicato.

Dettaglio di un servizio

dettaglio-servizio, sola lettura.

Un servizio di Volcanic Minds: sintesi, tipo di servizio, i case study in cui è stato fornito, le applicazioni che lo citano come prova e il testo completo in Markdown.

Parametri:

  • service (testo, obbligatorio): Il servizio, per chiave (per esempio digital-factory) o per nome. Se non esiste, torna l’elenco dei servizi.

Cerca nei case study

cerca-case-study, sola lettura.

Cerca nei case study di Volcanic Minds per testo, ambito di clienti o servizio. Ogni risultato riporta il problema, i risultati, gli ambiti in cui il progetto è realizzato e quelli a cui è adatto, i servizi e l’indirizzo.

Parametri:

  • query (testo, facoltativo): Parole da cercare: tornano solo i risultati che le contengono tutte, senza distinguere maiuscole e accenti.
  • area (testo, facoltativo, valori studi-consulenza, aziende-servizi, aziende-prodotto, produzione, sanita, startup, commercio-distribuzione, pubblica-amministrazione): Solo i progetti realizzati o adatti in questo ambito di clienti.
  • relation (testo, facoltativo, valori delivered, suited): Con area: delivered per i progetti realizzati in quell’ambito, suited per quelli che vi si adattano senza esserci stati consegnati.
  • service (testo, facoltativo): Solo i progetti di questo servizio, per chiave o per nome.
  • limit (numero intero, facoltativo, da 1 a 50): Numero massimo di risultati, da 1 a 50; 10 se non indicato.

Cerca negli articoli

cerca-insights, sola lettura.

Cerca negli articoli di Volcanic Minds per testo o tema: titolo, sintesi, data, temi, indirizzo e versione Markdown.

Parametri:

  • query (testo, facoltativo): Parole da cercare: tornano solo i risultati che le contengono tutte, senza distinguere maiuscole e accenti.
  • tag (testo, facoltativo): Solo gli articoli di questo tema, per chiave o per nome.
  • limit (numero intero, facoltativo, da 1 a 50): Numero massimo di risultati, da 1 a 50; 10 se non indicato.

Cerca nelle domande frequenti

cerca-faq, sola lettura.

Cerca nelle domande frequenti di Volcanic Minds per testo o capitolo: domanda, risposta in una riga, risposta completa e indirizzo con l’ancora della domanda.

Parametri:

  • query (testo, facoltativo): Parole da cercare: tornano solo i risultati che le contengono tutte, senza distinguere maiuscole e accenti.
  • category (testo, facoltativo): Solo questo capitolo, per chiave (per esempio costi-e-contratti) o per nome.
  • limit (numero intero, facoltativo, da 1 a 50): Numero massimo di risultati, da 1 a 50; 10 se non indicato.

Definisci un termine

definisci-termine, sola lettura.

Un termine del glossario di Volcanic Minds, per nome o sigla: definizione e indirizzo. Se il termine non c’è, torna l’elenco dei termini definiti.

Parametri:

  • term (testo, obbligatorio): Il termine o la sigla, per esempio RAG.

Dati dell’azienda

dati-azienda, sola lettura.

I dati di Volcanic Minds: ragione sociale, sede, partita IVA, email, orari, profili e come mettersi in contatto.

Nessun parametro.

Invia un messaggio

invia-messaggio-volcanic-minds, scrive: invia il messaggio.

Invia un messaggio al team di Volcanic Minds, software house di Torino, per parlare di un progetto software, di agenti AI o di una consulenza. La risposta arriva via email entro un giorno lavorativo.

Parametri:

  • name (testo, obbligatorio): Nome e cognome di chi scrive.
  • company (testo, facoltativo): Azienda di chi scrive. Facoltativo.
  • email (testo, obbligatorio): Indirizzo email aziendale a cui rispondere.
  • message (testo, obbligatorio): Che cosa serve: il progetto, il problema o la domanda, in parole proprie. Almeno 10 caratteri.