# Límites y planes

Todo lo que un plan define se aplica en la base, no en esta página: el tope de modelo frena la cola al 100 %, y cada techo por ventana rechaza lo que se pasa hasta que la ventana se libera. Una organización puede **bajar** sus límites; subirlos por encima del plan lo hace un cambio de plan (Consumo → Plan) o YoRobot.

## Por plan

| | Prueba | Starter | Pro | Piloto | Unidad de negocio | Dedicado |
|---|---|---|---|---|---|---|
| Precio | gratis | US$ 100 por mes | US$ 500 por mes | US$ 1500 por mes | US$ 5000 (desde) por mes | conversado |
| Agentes propios (las plantillas de YoRobot no cuentan) | 2 | 5 | 20 | 10 | sin límite | sin límite |
| Documentos en el Cerebro | 50 | 200 | 1.000 | 1.000 | sin límite | sin límite |
| Ambientes | dev, staging, prod | dev, staging, prod | dev, staging, prod | dev, staging, prod | dev, staging, prod | dev, staging, prod |
| Modelo por mes | US$ 10.00 | US$ 50.00 | US$ 200.00 | US$ 150.00 | US$ 500.00 | sin tope nuestro |
| Bloque de modelo prepago | — | US$ 10 | US$ 10 | US$ 100 | US$ 500 | — |
| Quién ejecuta | el pool de YoRobot | el pool de YoRobot | el pool de YoRobot | el pool de YoRobot | worker dedicado | worker dedicado |
| tareas pedidas por una persona, por día | 25 | 100 | 400 | 500 | 5.000 | sin techo |
| tareas creadas por automatizaciones y descomposiciones, por día | 25 | 200 | 800 | 1.000 | 10.000 | sin techo |
| tareas que entraron por un canal público, por día | 25 | 100 | 400 | 500 | 5.000 | sin techo |
| tareas que creó un token de la API, por día | 25 | 200 | 800 | 1.000 | 10.000 | sin techo |
| ejecuciones del agente, por hora | 20 | 40 | 160 | 200 | 2.000 | sin techo |

Los techos por ventana cuentan en el huso de la organización. `ver_cuotas` (MCP) devuelve cada uno con lo usado, lo que queda y cuándo se libera; `ver_plan`, el plan con su tope vigente.

## El freno por minuto

Cada token entra hasta **60 pedidos por minuto**, en la API y en el MCP juntos: un token no tiene dos techos según por dónde entre. La ventana es el minuto calendario (UTC).

Cada respuesta de un token que autenticó trae:

| Cabecera | Qué dice |
|---|---|
| `X-RateLimit-Limit` | Cuántos entran por minuto. |
| `X-RateLimit-Remaining` | Cuántos quedan en este minuto. |
| `X-RateLimit-Reset` | Cuándo se renueva la ventana, en segundos desde epoch. |
| `Retry-After` | Sólo en el `429`: cuántos segundos esperar. |

## Cada pedido tiene su id

Toda respuesta de `/api/v1` y de `/api/mcp` trae `X-Request-Id` (`req_…`). Los pedidos de la organización se guardan 30 días —la ruta o la herramienta, el status, cuánto tardó, con qué token, el ambiente y el motivo si falló; nunca el cuerpo— y se buscan en Accesos → Pedidos o con `listar_pedidos`.

## Los tokens se reconocen

Los tokens empiezan con su clase: `yrb_api_` (API), `yrb_mcp_` (MCP), `yrb_wk_` (worker). Si uno aparece en un repositorio público de GitHub, lo revocamos solos. Los de antes, `est_…`, siguen andando.
