Entwicklerbereich
Integrationshinweise für alle, die Abläufe rund um das Toolkit erstellen.
Diese Seite dokumentiert die maschinenlesbare Schnittstelle, die Paperlane Entwicklern, Integratoren und Agenten bereitstellt, sowie die Grenzen, die diese Integrationen beachten sollen.
Metadaten zu Tool-Funktionen#
Jedes Tool stellt eine Definition mit seinen Ein- und Ausgabeformaten, seinem Optionsschema, Angaben zur Ausführung im Browser oder zum erforderlichen Netzwerkzugriff sowie einer ehrlichen Beschreibung bekannter Einschränkungen bereit. Dazu gehören etwa Tools, die eine Funktion bewusst ablehnen, wenn sie sie nicht korrekt ausführen können – siehe das Beispiel „PDF verschlüsseln“ unter „Sicherheit“.
Routen zur Agenten-Erkennung#
/llms.txt enthält einen kurzen, strukturierten Index der Website, den LLM-basierte Tools und Agenten schnell abrufen können. Dazu gehört ein WebMCP-Abschnitt mit allen Toolnamen und ihren Zwecken in Klartext.
/llms-full.txt ergänzt diesen Index um den vollständigen Toolkatalog – mit einer Kurzbeschreibung und einer direkten Antwort von 40–60 Wörtern zu jedem Tool – sowie um die Vertrauens- und Supportseiten, darunter diese Seite. So erhalten Agenten auf Anfrage einen umfassenderen Überblick.
/pricing.md stellt Preisinformationen in einfachem Markdown bereit. So müssen Agenten und Skripte kein gerendertes HTML auswerten, um eine Preisfrage zu beantworten.
/agents/webmcp.json (auch unter /.well-known/webmcp.json verfügbar, dem von der Community etablierten Pfad, den einige WebMCP-fähige Crawler und Lighthouse-Prüfungen abfragen) beschreibt die browsernative WebMCP-Schnittstelle und führt alle Tool-IDs auf. Ein Agent muss dafür das visuelle Verzeichnis nicht auslesen.
Die Grenze zwischen Datenschutz und Metadaten#
Dokumentdaten und datenschutzgerechte Auftragsmetadaten (welches Tool ausgeführt wurde, wie lange es gedauert hat und ob es erfolgreich war) bleiben strikt getrennt. Wenn Sie eine Integration oder Protokollierung auf Basis von Paperlane entwickeln, müssen Sie diese Grenze wahren: Protokollieren Sie niemals Dokumentinhalte, extrahierten Text oder Dateinamen als Analysedaten, auch nicht zur Fehlersuche.
Dateinamen sind die einzige Ausnahme, und auch das nur beim WebMCP-Tool list_loaded_files auf einer Toolseite. Es dient ausdrücklich dazu, einem Agenten mitzuteilen, welche geladenen Dateien er sieht. Kein Tool gibt irgendwo und unter irgendeinem Namen Dokumentbytes zurück.
Erwartungen an Umfang und Nutzungshäufigkeit#
Behandeln Sie lokale Tools als Funktionen, die Ihre Integration in der Browsersitzung der jeweiligen Person ausführt, nicht als serverseitige Stapelverarbeitungs-API. Die lokale Ausführung ist bewusst an das Gerät der Person gebunden. Netzwerkgestützte Funktionen, die ein Backend aufrufen, sollten in angemessener, durch Menschen ausgelöster Häufigkeit statt in großen Skriptläufen verwendet werden.