Centre des développeurs
Notes d’intégration pour créer des workflows autour de la boîte à outils.
Cette page décrit les interfaces lisibles par machine mises à disposition par Paperlane pour les développeurs, les intégrateurs et les agents, ainsi que les limites que ces intégrations doivent respecter.
Métadonnées sur les capacités des outils#
Chaque outil expose une définition qui précise ses formats d’entrée et de sortie, son schéma d’options, s’il s’exécute localement dans le navigateur ou nécessite un accès réseau, ainsi qu’une description honnête de ses limites connues (par exemple, les outils qui refusent délibérément une opération qu’ils ne peuvent pas effectuer correctement — voir l’exemple de l’outil Chiffrer un PDF sur la page Sécurité).
Routes de découverte pour les agents#
/llms.txt fournit un index bref et structuré du site, conçu pour être récupéré rapidement par les outils et agents basés sur des LLM. Il comprend une section WebMCP qui répertorie en texte clair le nom et la fonction de chaque outil.
/llms-full.txt complète cet index avec le catalogue complet des outils — pour chacun, une description en une ligne et une réponse directe de 40 à 60 mots — ainsi que les pages sur la confiance et l’assistance, dont celle-ci, pour les agents qui souhaitent obtenir une vue d’ensemble plus complète en une seule requête.
/pricing.md fournit les informations tarifaires en Markdown brut. Un agent ou un script peut ainsi répondre à une question sur les tarifs sans avoir à analyser le code HTML affiché.
/agents/webmcp.json (également disponible à l’adresse /.well-known/webmcp.json, le chemin utilisé par convention communautaire et vérifié par certains robots d’exploration compatibles avec WebMCP et certains audits Lighthouse) décrit l’interface WebMCP native du navigateur et répertorie les identifiants de tous les outils. Un agent n’a donc pas besoin d’analyser le répertoire visuel.
Séparation entre confidentialité et métadonnées#
Les données des documents et les métadonnées des tâches respectueuses de la vie privée (outil utilisé, durée, réussite ou échec) sont strictement séparées. Si vous créez une intégration ou une couche de journalisation pour Paperlane, préservez cette séparation : ne consignez jamais le contenu des documents, le texte extrait ni les noms de fichiers à des fins d’analyse, même pour le débogage.
Les noms de fichiers constituent l’unique exception, et uniquement dans l’outil WebMCP list_loaded_files propre à la page d’un outil, qui permet précisément à un agent d’indiquer à l’utilisateur quels fichiers sont chargés. Aucun outil, où que ce soit, ne renvoie les données des documents, quel que soit leur nom.
Attentes concernant la fréquence et le périmètre#
Votre intégration doit déclencher les outils locaux dans la session de navigation de l’utilisateur, et non les traiter comme une API de traitement par lots côté serveur : l’exécution locale est volontairement liée à l’appareil de l’utilisateur. Les fonctionnalités avec assistance réseau qui font appel à un serveur doivent être utilisées à une fréquence raisonnable et à la demande d’une personne, plutôt qu’en masse par script.