Paper Agentes de IA
Reglas y guion para que una IA use el cuaderno de alguien con cuidado.
Esta página habla directamente con los agentes de IA. Si eres una persona que configura un agente, envíale el texto del botón Copiar instrucciones para la IA y el enlace del mapa:
https://wire.ia.br/documentation/agents/raw.jsonGuion
Confirma a quién atiendes. Llama a GET /api/v1/me con Authorization y X-Paper-Account. Si la cuenta no coincide, detente y avisa a la persona.
Mira qué puedes hacer. La respuesta de /me trae el tipo de token y los permisos. GET /vaults muestra las bóvedas que alcanzas. Si el id de la bóveda empieza con copia-, trabajas en una copia y la persona revisa todo después.
Lee antes de escribir. Lista las páginas, lee las que importan para el pedido. Guarda la lista en memoria durante la tarea en vez de pedirla de nuevo en cada paso.
Cambia lo mínimo. Prefiere append a reescribir la página entera. Al reescribir, conserva lo que la persona escribió y el formato de los bloques (mira Formato de las páginas).
Cuenta lo que hiciste. Al final, dile a la persona qué páginas creaste, cambiaste o mandaste a la papelera, con los títulos.
Haz
- Respeta los permisos.
403significa no: no intentes otro camino. - Trata las páginas protegidas (
423) como cerradas. No le pidas la contraseña a la persona ni intentes adivinar el contenido. - Ante un
429, detente, espera y vuelve a un ritmo menor. Mira Límites. - Escribe en un español claro, como escribe la persona. Usa los bloques de Paper cuando ayuden: tareas con
@fecha, tablas, tableros. - Crea una carpeta para lo que produzcas, si la persona no dijo dónde ponerlo.
- Envía
Accept-Languagecon el idioma de la persona, para que los mensajes de error lleguen en un idioma que lea.
No hagas
- No uses el cuaderno como tu memoria a largo plazo, base de datos, cola de tareas o registro de ejecución.
- No envíes archivos para alojarlos en otro lugar.
- No consultes en bucle para saber si algo cambió. Una revisión por minuto, como máximo.
- No copies el contenido del cuaderno fuera de la conversación con la persona sin que lo pida.
- No muestres el token en respuestas, registros ni archivos.
- No borres en masa. Para más de 10 páginas a la vez, pide confirmación.
Romper estas reglas lleva al baneo permanente de la cuenta de la persona que te confió el token. Los términos completos están en Términos de la API.
Instrucciones de ejemplo
Tienes acceso a mi cuaderno de Paper mediante la API personal.
Token (envíalo en el encabezado Authorization: Bearer): paper_…
Mi cuenta: 3f2a… (envíala también en el encabezado X-Paper-Account)
Base de la API: https://wire.ia.br/api/v1
Lee primero el mapa de la documentación: https://wire.ia.br/documentation/agents/raw.json
Respeta los límites y los términos de uso de la API descritos ahí. Usa el cuaderno como cuaderno, no como base de datos.Herramientas para el agente
Si tu agente acepta herramientas definidas por ti, estas cinco cubren casi todo:
| Herramienta | Solicitud |
|---|---|
listar_paginas(boveda) | GET /vaults/{boveda}/pages |
leer_pagina(boveda, id) | GET /vaults/{boveda}/pages/{id}?format=md |
buscar(boveda, texto) | GET /vaults/{boveda}/search?q= |
crear_pagina(boveda, titulo, texto, carpeta?) | POST /vaults/{boveda}/pages |
agregar(boveda, id, texto) | PATCH /vaults/{boveda}/pages/{id} con append |
Ejemplos listos en Ejemplos.