# Agentes de IA

Fuente: https://wire.ia.br/documentation/es/api/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:

```txt
https://wire.ia.br/documentation/agents/raw.json
```

## Guion [#guion]

<Steps>
  <Step>
    **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.
  </Step>

  <Step>
    **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.
  </Step>

  <Step>
    **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.
  </Step>

  <Step>
    **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](/es/api/formato-das-paginas)).
  </Step>

  <Step>
    **Cuenta lo que hiciste.** Al final, dile a la persona qué páginas creaste, cambiaste o mandaste a la papelera, con los títulos.
  </Step>
</Steps>

## Haz [#haz]

* Respeta los permisos. `403` significa 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](/es/api/limites).
* 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-Language` con el idioma de la persona, para que los mensajes de error lleguen en un idioma que lea.

## No hagas [#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](/es/termos/termos-da-api).

## Instrucciones de ejemplo [#instrucciones-de-ejemplo]

```txt
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 [#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](/es/api/exemplos).