Compilare moduli PDF con un agente IA del browser con SimplePDF
Gli agenti IA vivono ormai dentro il browser: il browser integrato dell'app desktop di ChatGPT e Chrome possono leggere la pagina su cui ti trovi e agire su di essa. La maggior parte dei siti lascia che questi agenti procedano a tentoni tra pulsanti e caselle di testo. SimplePDF no. L'editor comunica all'agente esattamente cosa può fare con il documento aperto tramite WebMCP, uno standard web in via di definizione (una bozza di un W3C Community Group) che espone le azioni di un sito agli agenti IA, così l'agente compila il modulo come farebbe uno script e tu rivedi il risultato prima che vada da qualche parte.
Non c'è nulla da installare o configurare lato SimplePDF. Apri l'editor in un browser dotato di agente e chiedi.
#A chi serve
Lasciare che sia un agente a compilare un modulo non è un gioco di prestigio. Per molte persone abbatte una barriera che mouse e tastiera non abbatteranno mai:
- Chi non può vedere il modulo. Una persona cieca o ipovedente guida l'agente con la voce: «Leggimi questo modulo», «Metti il mio nome nel primo campo», «Spunta la casella per un unico richiedente». L'agente legge il documento tramite
get_document_content, elenca i campi, li compila e rilegge ciò che ha inserito. Il PDF diventa una conversazione invece di una griglia di caselle senza etichetta con cui uno screen reader fa fatica. - Chi compila un modulo in una lingua che non legge. Un contratto di affitto in olandese, un modulo fiscale in tedesco, un'iscrizione scolastica in giapponese: l'agente legge il documento nella sua lingua, ti spiega ogni campo nella tua e inserisce le tue risposte nella lingua del modulo. Continui a vedere ogni valore sulla pagina prima che venga inviato qualcosa.
- Chiunque si trovi davanti a un contratto fitto. Chiedi all'agente di spiegarti il documento in parole semplici prima di firmarlo: a cosa ti impegni, a cosa si impegna la controparte, quali clausole sono insolite. L'agente ha il testo completo tramite
get_document_content, quindi la spiegazione riguarda questo documento, non un modello generico. - Chi ha difficoltà motorie, o semplicemente un modulo da 40 campi. Di' le risposte una volta sola. L'agente le colloca una per una e tu correggi l'errore occasionale invece di digitare tutto.
In ogni caso vale la stessa regola: l'agente propone, tu rivedi. Nell'editor gratuito l'agente non può inviare al posto tuo: lo strumento di invio risponde con un errore che chiede di registrarsi, quindi completare un modulo condiviso resta a una persona che ha effettuato l'accesso. Anche scaricare è uno strumento, quindi chiedi all'agente di lasciarlo a te (le istruzioni già pronte sulla pagina iniziale fanno esattamente questo) e controlla ogni valore prima che il documento vada da qualche parte.
#Quali agenti funzionano oggi
WebMCP è in fase di standardizzazione presso il W3C, con Google e Microsoft alle spalle, e il supporto dei browser arriva per gradi:
- App desktop di ChatGPT, browser integrato: funziona già oggi. ChatGPT individua gli strumenti di SimplePDF come strumenti del sito (elencati dalla barra degli indirizzi) e li usa quando gli chiedi di lavorare sul documento. Gli strumenti del sito richiedono GPT-5.6 Sol o Terra e non sono disponibili negli spazi di lavoro Enterprise o Edu (documentazione di OpenAI sugli strumenti del sito).
- Chrome 149 e versioni successive: disponibile tramite l'origin trial di WebMCP. Per provarlo, attiva
chrome://flags/#enable-webmcp-testing, riavvia il browser e installa l'estensione Model Context Tool Inspector per vedere e richiamare gli strumenti. Il supporto di Gemini in Chrome è annunciato. - Altri browser: ancora nulla. L'editor funziona esattamente come prima; gli strumenti semplicemente non vengono offerti.
#Compilare un modulo con l'agente
- Apri l'editor SimplePDF in un browser dotato di agente e apri il tuo PDF dal dispositivo o da un link
- Chiedi all'agente ciò che ti serve, per esempio: «Compila questo modulo con i miei dati: nome Jane Doe, nata il 12 marzo 1990, e-mail jane@example.com, e spunta la casella della newsletter»
- Osserva l'agente al lavoro sulla pagina: elenca i campi, legge il documento quando gli serve contesto, poi imposta ogni valore
- Rivedi ogni valore, correggi ciò che vuoi, poi scarica o invia tu stesso il documento
Fornisci i dati all'agente nella tua richiesta, oppure indicagli una pagina che può leggere, come un'e-mail precedente o una pagina di profilo aperta in un'altra scheda. Gli strumenti del sito non possono leggere i file sul tuo computer.
#Cosa può fare l'agente
Ogni strumento corrisponde a qualcosa che puoi fare anche tu nell'editor. L'agente vede lo stesso documento che vedi tu, e ogni modifica compare sulla pagina mentre avviene.
| Strumento | Cosa fa |
|---|---|
get_fields | Elenca i campi compilabili con i loro identificativi, tipi e valori attuali |
get_document_content | Legge il testo del documento, così l'agente capisce cosa chiede il modulo |
get_annotated_page | Mostra una pagina con ogni campo numerato, così un agente in grado di vedere le immagini riconosce i campi |
detect_fields | Rileva i campi modulo nel documento, così una scansione o un PDF senza campi diventa compilabile |
set_field_value | Scrive un valore in un campo di testo, spunta una casella oppure inserisce una firma o un'immagine |
create_field, delete_fields | Aggiunge un campo in una posizione della pagina, oppure rimuove campi |
select_tool | Cambia lo strumento attivo dell'editor (testo, caselle a caratteri, casella, firma, immagine) |
focus_field, go_to | Scorre fino a un campo o a una pagina, così puoi seguire quello che succede |
rotate_page, move_page, delete_pages | Organizza le pagine del documento |
load_document | Apre un PDF da un link o da una data URL, sostituendo il documento aperto e le sue modifiche |
download, submit | Salva il documento compilato sul tuo dispositivo, oppure lo invia quando il documento è stato condiviso come modulo. Nell'editor gratuito l'invio risponde con un errore che chiede di registrarsi; nel tuo editor si applicano i permessi del tuo piano |
Nell'editor SimplePDF i nomi degli strumenti hanno il prefisso simplepdf_embed_, così non entrano mai in conflitto con gli strumenti di un altro sito.
#Cosa resta privato
Mentre lo modifichi, il PDF viene elaborato nel tuo browser, come ogni documento che modifichi con SimplePDF: un file che apri dal tuo dispositivo non raggiunge mai un server SimplePDF, e un PDF aperto da un link viene scaricato direttamente da quel link (SimplePDF fa da tramite solo quando l'host del link impedisce ai browser di scaricarlo direttamente). Quando invii un modulo, il documento compilato viene salvato dove lo ha configurato il proprietario del modulo, nel suo spazio di archiviazione o in quello di SimplePDF, esattamente come accadrebbe senza un agente. Ciò che l'agente legge tramite gli strumenti, come l'elenco dei campi, i loro valori e il testo estratto, arriva al fornitore del modello dell'agente, esattamente come un testo che incolleresti in una chat. Tratta l'agente come tratteresti chiunque altro a cui mostri il documento compilato.
Nulla è definitivo finché il documento non viene scaricato o inviato. Nell'editor gratuito l'agente non può inviare affatto (lo strumento chiede di registrarsi), e puoi chiedergli di lasciare a te anche il download: rivedi i campi, poi concludi. Le modifiche ai campi fatte dall'agente sono modifiche normali: annullale, cambiale oppure chiudi la scheda.
#Attivarlo sul tuo editor
WebMCP è attivo nell'editor SimplePDF gratuito. Sul tuo editor personalizzato resta disattivato finché non lo abiliti dalla configurazione dell'editor nella tua dashboard, disponibile con il piano Pro.
Stai integrando l'editor nella tua app? Attiva l'opzione WebMCP dell'SDK Embed: registra gli strumenti dell'editor sulla tua pagina e inoltra ogni chiamata all'iframe dell'editor. È l'unico posto in cui gli agenti li trovano: l'editor integrato non registra strumenti propri e, in ogni caso, il browser di ChatGPT non guarda mai dentro un iframe:
import { EmbedPDF } from '@simplepdf/react-embed-pdf';
<EmbedPDF
mode="inline"
companyIdentifier="acme"
document={{ url: 'https://example.com/form.pdf' }}
// Keep the decision with the person: withhold submit
webMCP={{ enabled: true, exclude: ['submit'] }}
/>import { createEmbed } from '@simplepdf/embed';
createEmbed({
target: '#editor',
companyIdentifier: 'acme',
document: { url: 'https://example.com/form.pdf' },
// Keep the decision with the person: withhold submit
webMCP: { enabled: true, exclude: ['submit'] },
});webMCP: { enabled: true } registra come strumento ogni operazione esposta dall'SDK, loadDocument compreso; exclude accetta nomi di metodi dell'SDK ('submit', 'loadDocument', 'deletePages', …) e trattiene quelli che vuoi riservare a una persona. Il riferimento completo delle opzioni si trova nella documentazione dell'SDK Embed.
Per gli agenti che non girano in un browser, come Claude, Cursor o un'automazione di backend, usa invece il server MCP remoto o l'API di precompilazione: vedi come precompilare moduli PDF con agenti IA.
#Nessun agente nel tuo browser? Usa SimplePDF Copilot
WebMCP richiede un browser dotato di agente. Se non ne hai uno, o se preferisci avere l'assistente integrato nella pagina anziché nel browser, SimplePDF Copilot riprende la stessa idea come pannello di chat accanto all'editor, e funziona in qualsiasi browser:
- Porta la tua IA, già da oggi. Apri copilot.simplepdf.com, collega l'IA che già usi (Anthropic, OpenAI, Google Gemini, Mistral, DeepSeek) oppure un modello in esecuzione sulla tua macchina (Ollama, LM Studio), e chatta con il modulo. Il PDF resta nel browser; il traffico dell'IA va al fornitore che hai scelto.
- Un'esperienza completamente integrata nella tua app. Copilot è un'implementazione di riferimento con licenza MIT: forkala, collegala al tuo fornitore di IA, ai tuoi strumenti e al tuo storage, modifica i prompt e l'interfaccia e pubblicala sul tuo dominio (l'editor incorporato richiede il piano Pro per funzionare lì). Vedi come ospitare autonomamente SimplePDF Copilot.
Cos'è SimplePDF Copilot descrive in dettaglio il flusso di revisione e il percorso dei dati.
Ecco fatto! L'agente nel tuo browser compila il PDF, e tu lo rivedi e lo invii.
Se hai domande, non esitare a contattare support@simplepdf.com