Hub per sviluppatori
Note d'integrazione per chi crea workflow con il toolkit.
Questa pagina documenta le interfacce leggibili dalle macchine che Paperlane espone a sviluppatori, integratori e agenti, e i limiti che tali integrazioni devono rispettare.
Metadati sulle capacità degli strumenti#
Ogni strumento espone una definizione che descrive i formati di input e output, lo schema delle opzioni, l'esecuzione locale nel browser o la necessità di accedere alla rete e un'indicazione sincera dei limiti noti (per esempio, gli strumenti che rifiutano intenzionalmente un'operazione che non sono in grado di eseguire correttamente: vedi l'esempio di Encrypt PDF nella sezione Sicurezza).
Percorsi per individuare gli strumenti#
/llms.txt fornisce un indice breve e strutturato del sito, pensato per essere recuperato rapidamente da strumenti e agenti basati su LLM. Include una sezione WebMCP che elenca in testo semplice il nome e lo scopo di ogni strumento.
/llms-full.txt amplia l'indice con il catalogo completo degli strumenti — la descrizione in una riga e una risposta diretta di 40–60 parole per ciascuno — oltre ai percorsi relativi a fiducia e assistenza, inclusa questa pagina, per gli agenti che vogliono un quadro più completo in un'unica richiesta.
/pricing.md fornisce le informazioni sui prezzi in Markdown semplice, così un agente o uno script può rispondere a una domanda sui prezzi senza dover analizzare l'HTML visualizzato.
/agents/webmcp.json (disponibile anche in /.well-known/webmcp.json, il percorso convenzionale della community verificato da alcuni crawler compatibili con WebMCP e dalle verifiche Lighthouse) descrive l'interfaccia WebMCP nativa del browser ed elenca tutti gli identificativi degli strumenti, senza richiedere a un agente di estrarli dalla directory visiva.
Il confine tra privacy e metadati#
I byte dei documenti e i metadati delle attività che rispettano la privacy (quale strumento è stato eseguito, quanto tempo ha richiesto, se è riuscito) restano rigorosamente separati. Se crei un'integrazione o un livello di logging basato su Paperlane, mantieni questa separazione: non registrare mai nei dati analitici il contenuto dei documenti, il testo estratto o i nomi dei file, nemmeno per il debug.
I nomi dei file sono l'unica eccezione, e solo nello strumento WebMCP list_loaded_files della pagina di uno strumento, creato appositamente per permettere a un agente di indicare all'utente quali file vede caricati: nessuno strumento restituisce mai i byte dei documenti, in nessuna forma e in nessun luogo.
Aspettative su frequenza e ambito#
Pensa agli strumenti locali come a funzioni che la tua integrazione avvia nella sessione del browser dell'utente, non come a un'API batch lato server: l'esecuzione locale è intenzionalmente legata al dispositivo dell'utente. Le funzionalità assistite dalla rete che contattano un backend vanno usate con una frequenza ragionevole e su iniziativa di una persona, non eseguite in massa tramite script.