Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.
Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.
Pasos de configuración
Delimita la prueba
Define agente, periodo y gasto máximo de ensayo. Usa llamadas pequeñas, sin concurrencia inicial, y decide cómo se notificará un bloqueo sin reintentar indefinidamente.
Configura Paperclip
Sigue Paperclip, incluidos sus requisitos, configuración y comprobación actuales. Completa su prueba con un solo agente y conserva el identificador de tarea, ejecución, resultado y coste del panel.
Configura LiteLLM
Sigue LiteLLM, incluidos sus requisitos, configuración y comprobación actuales. Completa la prueba de la biblioteca desde el proyecto uv y comprueba proveedor, modelo y tratamiento de errores; esa instalación no crea una pasarela.
Para este caso se necesita además Proxy Server con PostgreSQL y una identidad virtual limitada. Continúa por el inicio rápido oficial de la pasarela y los presupuestos por ámbito, enlazados en los recursos del caso. Comprueba una llamada autenticada y su identidad antes de conectar Paperclip; si falta una configuración documentada del adaptador, detente.
Datos que pasan entre piezas
Los archivos siguientes son entregables de este caso preparados por el agente; no implican exportadores ni sincronización automática.
Relaciona el identificador del agente y de su ejecución en Paperclip con el identificador de la clave virtual limitada de LiteLLM en presupuesto.md; guarda los identificadores de petición, importe observado y rechazo sin incluir la clave. No continúes si no puedes demostrar que una petición de ese agente atraviesa la pasarela con esa identidad.
Monta el flujo
Paso 1
Prepara LiteLLM con PostgreSQL y una clave virtual de prueba. Configura el presupuesto documentado para su ámbito y prueba una llamada válida desde el cliente de ensayo.
Paso 2
Configura en Paperclip un agente con adaptador compatible. Sigue la documentación del adaptador para dirigir su inferencia a la pasarela y entrega la identidad limitada por su mecanismo seguro. Comprueba en ambos registros una ejecución concreta antes de activar tareas recurrentes.
Paso 3
Ensaya una llamada sin saldo o con el límite de prueba agotado y conserva el rechazo. Verifica que el agente marca el trabajo pendiente por presupuesto y no reintenta en bucle. Comprueba por separado la política de pausa de Paperclip.
Paso 4
Revisa alcance y retrasos con concurrencia pequeña y controlada si tu caso la requiere. Documenta cómo restablecer el presupuesto con intervención del responsable, sin elevarlo automáticamente ante el bloqueo.
Comprobación
El ensayo debe demostrar una petición permitida y otra rechazada por presupuesto, con la misma identidad. Si no puedes demostrar que el adaptador pasa por el proxy, el control queda sin validar.
Si algo falla
Si el límite no bloquea, revisa base de datos, ámbito e identidad antes de continuar. Si los gastos difieren, comprueba cobertura y retrasos; no ajustes cifras a mano para igualarlas.
Esta composición de WISD no se ha ejecutado como prueba integral. La configuración se consulta en las guías enlazadas; las etapas describen cómo coordinar las piezas.
Prompt para tu agente
Sustituye los campos entre <> antes de pegarlo.
Lee y sigue las instrucciones publicadas de las piezas: Paperclip: /hub/paperclip-orchestration/instrucciones.md; LiteLLM: /hub/litellm-agent-platform/instrucciones.md. Completa los requisitos, configuración y comprobación de cada pieza antes de usarla; comprueba su uso desde el cliente o arnés elegido, no solo su presencia en disco. Si falta un campo entre <>, una fuente obligatoria, acceso o una operación documentada, detén la etapa dependiente, informa qué falta y pídemelo; usa una alternativa manual solo cuando esté descrita y comprobada. No inventes datos ni des por superada una comprobación pendiente.
La guía de LiteLLM cubre su biblioteca: para la pasarela sigue además https://docs.litellm.ai/docs/proxy/docker_quick_start y https://docs.litellm.ai/docs/proxy/users. Prepara destino e identidad limitada y prueba una llamada antes de conectar el adaptador.
Prepara un ensayo de <agente y adaptador> con presupuesto <importe y periodo>. Usa Paperclip para el trabajo y LiteLLM con PostgreSQL y clave virtual limitada para inferencia. Verifica que el adaptador enruta por la pasarela; si no admite esa ruta, detente y documenta el límite. Registra en <archivo> una petición permitida y otra bloqueada por presupuesto. Comprueba que no haya reintentos en bucle y revisa la pausa en Paperclip por separado. Informa cobertura y retrasos, sin subir cuotas automáticamente.
Relaciona el identificador del agente y de su ejecución en Paperclip con el identificador de la clave virtual limitada de LiteLLM en presupuesto.md; guarda los identificadores de petición, importe observado y rechazo sin incluir la clave. No continúes si no puedes demostrar que una petición de ese agente atraviesa la pasarela con esa identidad.
Qué es
Un ensayo de control de gasto con dos puntos de observación: las tareas del agente y las peticiones al proveedor. La prueba documenta qué consumo ve cada sistema y cómo se comporta el trabajo cuando deja de disponer de presupuesto.
Para qué te sirve
Cuando un agente mantiene varias tareas y necesitas atribuir consumo a su identidad.
Cuando el panel muestra un límite pero quieres demostrar que la siguiente petición se bloquea.
Cuando un proceso falla por presupuesto y no debe entrar en un bucle de reintentos.
Cómo funciona
Paperclip coordina trabajo y dispone de controles sobre gasto registrado. LiteLLM permite establecer límites de acceso y gasto en una pasarela con base de datos. Usa una identidad acotada por agente y confirma que el adaptador enruta por ella. Los contadores no se sincronizan automáticamente.
Antes de empezar
Paperclip requiere Node.js ≥24.11 y npm/npx; el uso de suscripciones locales de Claude o Codex pide Python 3 y su CLI. Para LiteLLM usa Docker con Compose y PostgreSQL, más un proveedor de prueba. Sin base de datos no se aplican sus presupuestos. El adaptador elegido debe aceptar una ruta de inferencia compatible; no des por hecho que una suscripción local pase por el proxy.
Límites y alternativas
El gasto registrado y las peticiones en curso pueden retrasar la pausa. Los límites solo cubren tráfico que pasa por la ruta configurada; no son un tope global de todos los servicios. Las alertas y los límites de frecuencia son controles distintos del presupuesto monetario.
