Hub para desenvolvedores
Informações de integração para quem cria fluxos de trabalho com as ferramentas.
Esta página documenta os recursos legíveis por máquina que Paperlane oferece a desenvolvedores, integradores e agentes, além dos limites que se espera que essas integrações respeitem.
Metadados dos recursos das ferramentas#
Cada ferramenta oferece uma definição com seus formatos de entrada e saída, o esquema de opções, se é executada localmente no navegador ou exige acesso à rede e uma descrição honesta das limitações conhecidas. Por exemplo, algumas ferramentas recusam intencionalmente operações que não conseguem realizar corretamente — consulte o exemplo Criptografar PDF na página Segurança.
Rotas de descoberta para agentes#
/llms.txt fornece um índice curto e estruturado do site, feito para ser consultado rapidamente por ferramentas e agentes baseados em LLM. Ele inclui uma seção WebMCP com o nome e a finalidade de cada ferramenta em texto simples.
/llms-full.txt amplia esse índice com o catálogo completo de ferramentas — uma descrição de uma linha e uma resposta direta de 40 a 60 palavras para cada ferramenta — além das rotas de confiança e suporte, incluindo esta página. É útil para agentes que precisam consultar todas essas informações de uma vez.
/pricing.md apresenta as informações de preços em Markdown simples, para que um agente ou script não precise interpretar o HTML renderizado para responder a perguntas sobre preços.
/agents/webmcp.json (também disponível em /.well-known/webmcp.json, o caminho convencional da comunidade que alguns rastreadores compatíveis com WebMCP e auditorias do Lighthouse verificam) descreve a interface WebMCP nativa do navegador e lista cada identificador de ferramenta, sem exigir que um agente extraia essas informações do diretório visual.
Limite entre privacidade e metadados#
Os bytes dos documentos e os metadados de tarefas que preservam a privacidade — qual ferramenta foi executada, quanto tempo levou e se teve êxito — são mantidos estritamente separados. Se você criar uma integração ou camada de registro com base em Paperlane, preserve essa separação: nunca registre conteúdo de documentos, texto extraído ou nomes de arquivos como dados analíticos, nem mesmo para depuração.
Os nomes de arquivos são a única exceção, e somente na ferramenta list_loaded_files WebMCP da própria página da ferramenta, criada especificamente para que um agente possa informar ao usuário quais arquivos estão carregados. Nenhuma ferramenta, em nenhum lugar, retorna os bytes dos documentos, seja qual for o nome usado.
Expectativas de uso e escopo#
Trate as ferramentas locais como recursos que sua integração aciona na sessão do navegador do próprio usuário, não como uma API de processamento em lote no servidor — a execução local está intencionalmente vinculada ao dispositivo do usuário. Use recursos que dependem de uma conexão com o servidor em uma frequência razoável e acionada por uma pessoa, em vez de executá-los em lote por script.