lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

sistema avanzado cloudflaretypescriptmcp

Cloudflare Agents: agentes con estado persistente

Construye agentes que conservan estado y combinan tiempo real, programación de tareas y herramientas MCP.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

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.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba que tienes Node.js 22.x ≥22.18.0 o ≥24.11.0, npm/npx y una cuenta de Cloudflare. La plantilla actual instala Babel 8, cuyo manifiesto fija ese intervalo; también cubre Node ≥22 de create-cloudflare y Wrangler. El README crea un proyecto inicial con:

npm create cloudflare@latest -- --template cloudflare/agents-starter

Entra en el directorio creado por el asistente (por defecto agents-starter) y sigue el inicio rápido de la plantilla:

cd agents-starter
npm install

Autentica Wrangler desde una terminal interactiva con npx wrangler login, como indica la plantilla, usando el ejecutable de la dependencia local. Después, desde esa misma carpeta:

npm run dev

Abre http://localhost:5173. La plantilla usa Workers AI remoto incluso en desarrollo. Para un proyecto existente, como ruta alternativa, el README documenta:

npm install agents

Prueba primero el estado y la comunicación sin añadir acciones externas.

Comprobación

Pide «Calcula 5000 por 3», el caso de aprobación del README de la plantilla. Comprueba que pide permiso y devuelve 15000 después de aprobar. Recarga la misma conversación y confirma que persiste su historial. Esto prueba la herramienta de cálculo y la persistencia de esa sesión; no presupone que la herramienta de tiempo de la demo consulte datos reales.

Si algo falla

Si falla la conexión, revisa el enrutamiento al agente y los ajustes de la plantilla. Para errores de despliegue o almacenamiento, consulta la documentación de Agents y Durable Objects.

Consulta el README oficial para requisitos y variantes de instalación.

ver en .md ¿Prefieres el recurso entero?

Qué es

Cloudflare Agents es un SDK para ejecutar agentes persistentes sobre Durable Objects. Cada agente dispone de estado, almacenamiento y ciclo de vida propios, con soporte para comunicación y tareas programadas.

Para qué te sirve

  • Cuando necesitas que una conversación conserve estado entre peticiones.
  • Cuando un agente debe coordinar una interfaz en tiempo real y trabajo posterior.

Cómo funciona

El SDK enlaza la lógica del agente con la infraestructura de Cloudflare. Sus APIs gestionan estado y comunicación; la aplicación sigue definiendo qué modelos y herramientas utiliza y qué acciones puede ejecutar.

Antes de empezar

Necesitas Node.js con npm/npx y una cuenta de Cloudflare incluso para ejecutar la plantilla localmente: utiliza Workers AI remoto. Comprueba las condiciones del alojamiento y de los proveedores de modelos; la licencia MIT del SDK no incluye esos consumos.

Límites y alternativas

No es una solución autoalojada equivalente a un proceso local. Frente a programar tu propia persistencia, delega parte del ciclo de ejecución en Durable Objects, a cambio de adoptar ese entorno.

Recursos